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

# Associated Press News API

> Associated Press API: live scrape of apnews.com/world-news with public article body. Same hydrated article contract as Bloomberg and Reuters.

Scrapes AP's public **world-news** hub and hydrates each card from public
article HTML. Same result contract as Bloomberg and Reuters.

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

## Endpoint

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

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

## Parameters

| Parameter | Required | Contract                                           |
| --------- | -------- | -------------------------------------------------- |
| `engine`  | yes      | Must be `ap_news`.                                 |
| `q`       | no       | Keep listing cards whose title contains this text. |
| `page`    | no       | Must be 1. The hub is a single listing page.       |

Do not send `limit` or `cursor`.

## Response

Up to 5 full articles: `title`, `category`, `authors`, `publish_date`,
`article_content[]`, `article_url`, `featured_image`.

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