# API reference: News Search API

[ChatGPT ↗](https://chatgpt.com/?q=Read%20https%3A%2F%2Fnewssearchapi.com%2Fdocs%2Freference%2F%20and%20help%20me%20build%20with%20the%20News%20Search%20API.)[Claude ↗](https://claude.ai/new?q=Read%20https%3A%2F%2Fnewssearchapi.com%2Fdocs%2Freference%2F%20and%20help%20me%20build%20with%20the%20News%20Search%20API.)

# API reference

7 read-only endpoints over HTTPS. Pick one to see its parameters, response fields and errors, copy a sample in your language, or send a live request.

## Endpoints

### Articles

Search and retrieve articles (API key required).

-   [GET`/v1/articles`**Search articles**](/docs/reference/searchArticles)
-   [GET`/v1/articles/{id}`**Get one article**](/docs/reference/getArticle)

### Intelligence

News Intelligence aggregates — article volume trends and share of voice (API key required).

-   [GET`/v1/counts`**Count articles over time**](/docs/reference/countArticles)

### Public

Key-less endpoints used by the website. Not logged and not charged credits.

-   [GET`/v1/stats`**Coverage statistics**No key](/docs/reference/getStats)
-   [GET`/v1/headlines/sample`**Sample of latest headlines**No key](/docs/reference/sampleHeadlines)
-   [GET`/v1/publisher-icons/{domain}`**Get a publisher icon**No key](/docs/reference/getPublisherIcon)
-   [GET`/health`**Health check**No key](/docs/reference/health)

## Conventions

Base URL

`https://apis.newssearchapi.com`

Auth

Use the `X-Api-Key` header on servers or `apiKey` for browser tests. [Details](/docs/authentication)

Methods

`GET` and `HEAD` on every endpoint; `OPTIONS` answers CORS preflights.

Format

JSON. Success bodies carry `"status": "ok"`.

Tracing

Every response has an `X-Request-Id` header. Quote it when you contact support.

Limits

Per-second rate limit and daily quota, reported in response headers. [Details](/docs/rate-limits)

Errors always use this shape:

Error envelope

```
{
  "status": "error",
  "code": "notFound",
  "message": "No article found with id '123'.",
  "requestId": "01JBDX4Q8Z6M3N2P1R0S9T8V7W"
}
```

Codes, meanings and retry advice are in [Errors](/docs/errors).

## Developer tools

-   [**OpenAPI 3.1 (YAML)**Import into Postman, Insomnia, Bruno or a client generator.](/openapi.yaml)
-   [**OpenAPI 3.1 (JSON)**Same spec as JSON for tooling that prefers it.](/openapi.json)
-   [**TypeScript & Python SDKs**Typed clients with paging, polling and AI tool helpers.](/docs/sdks)
-   [**MCP server**Live news inside Claude, Cursor and VS Code agents.](/docs/mcp)
-   [**llms.txt**A compact index of these docs for AI assistants.](/llms.txt)
-   [**API status**Live health of the API and MCP endpoints.](/status)