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

# Bloomberg News API

> Bloomberg News API: live scrape of bloomberg.com/latest with public article body. Up to 5 hydrated articles per call. Not Bloomberg Terminal.

Scrapes Bloomberg's public **latest** listing, then hydrates each card from
public article HTML or JSON. Not Terminal. Hard cap of **5** full articles per
request (hydration budget). Uses a managed browser, so it is slower and costs
more than Google News.

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

## Endpoint

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

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

## Parameters

| Parameter | Required | Contract                                           |
| --------- | -------- | -------------------------------------------------- |
| `engine`  | yes      | Must be `bloomberg_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`. Same article contract as
[Reuters](/docs/news-api/reuters) and [Associated Press](/docs/news-api/ap).

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