> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getclean.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> getclean's own MCP server is at https://mcp.getclean.ai/mcp. The /mcp path of this docs site is Mintlify's search over these pages, not getclean.
> Every answer of the API opens with outcome. A page that could not be read is a record whose outcome says why, never an HTTP error; read outcome before anything else.
> The API's contract is the OpenAPI 3.1 file at https://docs.getclean.ai/openapi.yaml; the SDKs are generated from it.
> The product's name is written getclean, in lower case.

# Source profiles

> A source profile says what a source is: the kind of its publisher, whether it is a primary source, whether it is independent of the subject, and what review it states. It has facts and no score.

A report can be trusted only as far as its sources can, and a research agent cannot judge a source by how its page looks. A source profile gives it the facts a careful researcher would ask for first. Every result of a search has one, and so does every fetched page.

## A profile has 4 facts

Each fact answers one question about the source.

| Field | The question it answers | Values |
| - | - | - |
| `kind` | Who publishes this? | One of 24 published kinds of publisher. |
| `role` | What is this as a source? | `primary`, `secondary`, or `tertiary`. |
| `independence` | Does the publisher write about itself? | `self` or `independent`. |
| `review` | What review does it state? | `kind`, one of `peer_reviewed`, `editorial`, `audited`, `externally_validated`, or `none`, and `by`, who reviewed it. |

Any of the 4 can be `unknown`. A fact that cannot be read from what the source declares is `unknown` and is not guessed.

## A publisher is one of 24 kinds

The kinds are grouped by the part of society the publisher belongs to.

| Group | Kinds |
| - | - |
| Public bodies | `state`, `court`, `regulator`, `statistics_office`, `intergovernmental`, `standards_body` |
| Knowledge | `academic`, `scholarly_publisher`, `archive`, `reference` |
| Media | `press`, `information_provider` |
| Economy | `company`, `professional_practice`, `trade_body`, `marketplace` |
| Society | `civil_society`, `political`, `religious`, `education`, `healthcare`, `cultural` |
| Individuals | `individual`, `community` |

The 6 kinds of public body are what a search means by an official source. The list of kinds can grow, so code should read a kind it does not know as a new one, not as an error.

## Role is about the item

`role` is read first from the type the item declares for itself, and then from the kind of its publisher. A law on a state's site is a primary source. A law firm's note about that law is a secondary one, although the firm is a primary source for its own fees.

## Independence needs a subject

A source is independent of something. So `independence` is `self` or `independent` only if the search knows the subject, which you give as an identifier, such as a company's registry number. A company's own annual report is then `self`, and a newspaper's article about the company is `independent`.

## A profile is not a score

A profile does not say that a source is good, and it does not rank sources. Which facts count depends on the question. For the wording of a law, only the state's text counts. For a view on a company's conduct, the company's own pages count least. The agent, or you, decide that for each question, and a search can then order or filter its results by these facts. For the request, see [Put primary sources first](https://docs.getclean.ai/find/rank-by-source.md).

The facts come from what a site declares about itself and from public registers. Finding them costs nothing extra. If a publisher has to be identified during a call, the response lists that step, and a request that sends `deterministic_only` as `true` gets only the profiles that are already known.

## A source also declares facts about itself

Beside the profile, a record reports what the page or the document says of itself. These declared facts are reported as found, and they are not checked against the content.

| Field | What the source declares |
| - | - |
| `published_date` and `modified_date` | Its dates, with `published_date_basis`, which says where the date was read. |
| `authors` and `publisher` | Who wrote and who published it. |
| `language_versions` | Its versions in other languages and, where the source says so, which of them is binding. |
| `declared_terms` | What it says about the use of its content, as found and as read. |

A date that a page prints is a claim of the page. The time a record was fetched, and the time an archive made a copy, are observations.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.