> ## 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.

# A claim traced to its first source

> Search for a claim and get the oldest source first. A story that 38 sites printed is one result with its copies counted, primary sources come before the reports on them, and a page can be read as it was before an edit.

A minister says that unemployment is at its lowest in 40 years, and by noon the sentence is on 38 news sites. A fact-checker has 2 questions: where the figure comes from, and what the first report said. A search ranked by relevance returns the 10 largest sites, all with the same agency text, and the release of the statistics office is on the second screen. This page builds a trace that counts the 38 sites as one story, puts the primary source first, and reads a page as it was on the day it was published.

## The run in 4 steps

### Search for the claim, oldest first

Send the claim as a phrase, and the question behind it in other wordings. `ranking_priorities` puts primary and official sources first, and `ranking_order` sorts each group by date, oldest first.

```json Request body of search theme={"theme":"css-variables"}
{
  "query": "\"lowest unemployment in 40 years\"",
  "alternate_queries": [
    "unemployment rate lowest since 1986 minister statement",
    "labour force survey unemployment rate October 2026",
    "\"el desempleo más bajo en 40 años\"",
    "tasa de desempleo octubre 2026 encuesta de población activa"
  ],
  "ranking_priorities": ["primary", "official"],
  "ranking_order": "oldest",
  "purpose": "Find where this claim was first published, and the primary source of the figure behind it.",
  "max_candidates": 20
}
```

### Read who published it on which day

Each result says what kind of source it is, when it was published, and how many other sites have the same text. This response is cut to 3 results and to those facts.

```json Part of the response theme={"theme":"css-variables"}
{
  "candidates": [
    {
      "source_profile": { "kind": "statistics_office", "role": "primary" },
      "published_date": "2026-11-03",
      "published_date_basis": "structured_data",
      "copy_count": 0
    },
    {
      "source_profile": { "kind": "state", "role": "primary" },
      "published_date": "2026-11-04",
      "published_date_basis": "meta_tag",
      "copy_count": 0
    },
    {
      "source_profile": { "kind": "press", "role": "secondary" },
      "published_date": "2026-11-04",
      "published_date_basis": "byline",
      "copy_count": 37
    }
  ]
}
```

The first result is the release of the statistics office, one day before the speech. The second is the ministry's own page with the speech. The third is the agency story: 37 other sites have the same text, and the copy that is shown is the one with the earliest date.

A date comes with where it was read from, such as the page's own data or its byline, so your agent can weigh it. A page that states no date has none, and is not given one.

### Check the claim against the primary source

Fetch the release, and send the claim's words and its question against it as highlights. A phrase that is in the release comes back as `exact`. If "40 years" is not in the release, the notice `highlight_not_found` says so, and the question "Since when is the rate this low?" returns the passage that a model judged to bear on it. Your agent then compares what the release says with what the minister said, and quotes both.

### Read a page as it was before an edit

A news site can change a story without a note. Fetch the story with `as_of_date` set to the day it was published, and the record is the copy that an archive stored on or before that day. Compare that record with a record of the page as it is, and the comparison lists each sentence that was changed, added, or removed.

The record of an archive copy says when the copy was made and when the next copy after it was made, so your agent can go forward copy by copy to the one in which a sentence first appears.

## What the editor can check

| The editor asks | What the trace has |
| - | - |
| Who said it first? | The results by date, each with where its date was read from. |
| How many sources is it, really? | The number of copies behind each result. |
| Is the figure in the primary source? | The passage of the release, in its own words, or a notice that the words are not there. |
| Did the story change? | The archive copy of the first day, and each changed sentence. |

## Know the limits

A date is the date that a page claims. The earliest claimed date is not proof of who published first.

The past comes from archives. A page that no archive stored on or before a day comes back with the reason `no_history`, and no other page is put in its place.

Copies are counted inside one search. A site that rewrote the story in its own words is a result of its own.

The profile of a source is a set of facts: who publishes it, and whether it is primary. It is not a score, and it does not say that a source is right.

For the calls, see [Put primary sources first](https://docs.getclean.ai/find/rank-by-source.md) and [Time machine: read a page as it was on a past day](https://docs.getclean.ai/read/time-machine.md).


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