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

# Reuters News API

> Reuters News API: search reuters.com or list latest /world, then hydrate public article HTML. 20 articles per page. Not Reuters Terminal.

Live scrape of public **reuters.com**. Pass `q` to search; omit it to list
latest `/world`. Each card is hydrated from public article HTML. This is not
Reuters Terminal or a private Reuters feed.

See the [product page](https://clair.im/dashboard/apis/reuters-news).

## Endpoint

`GET /v1/search?engine=reuters_news` · **8 credits**

```sh theme={null}
curl -G https://api.clair.im/v1/search \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "engine=reuters_news" \
  --data-urlencode "q=inflation" \
  --data-urlencode "page=1"
```

## Parameters

| Parameter | Required | Contract                                           |
| --------- | -------- | -------------------------------------------------- |
| `engine`  | yes      | Must be `reuters_news`.                            |
| `q`       | no       | Search Reuters. Omit to list latest `/world`.      |
| `page`    | no       | 1-based results page, 20 articles each. Default 1. |

Do not send `limit` or `cursor`. `next_cursor` is always null — increment
`page`.

## Response

Up to 20 full articles per page:

| Field                      | Meaning                                                           |
| -------------------------- | ----------------------------------------------------------------- |
| `title`                    | Headline. Trailing chrome such as `, includes video` is stripped. |
| `category` / `subcategory` | Derived from the public URL path when present.                    |
| `authors`                  | Byline names from the article page.                               |
| `publish_date`             | ISO-8601 publish time.                                            |
| `article_content`          | Paragraph array from public HTML.                                 |
| `article_url`              | Canonical article URL.                                            |
| `featured_image`           | Lead image URL when present.                                      |

Same article contract as [Bloomberg](/docs/news-api/bloomberg) and
[Associated Press](/docs/news-api/ap).

Auth, credits, and error codes: [Authentication](/docs/authentication).
