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

Conventions

Base URL

https://apis.newssearchapi.com

Auth

Use the X-Api-Key header on servers or apiKey for browser tests. Details

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

Errors always use this shape:

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

Codes, meanings and retry advice are in Errors.

Developer tools

• OpenAPI 3.1 (YAML)Import into Postman, Insomnia, Bruno or a client generator.
• OpenAPI 3.1 (JSON)Same spec as JSON for tooling that prefers it.
• TypeScript & Python SDKsTyped clients with paging, polling and AI tool helpers.
• MCP serverLive news inside Claude, Cursor and VS Code agents.
• llms.txtA compact index of these docs for AI assistants.
• API statusLive health of the API and MCP endpoints.