Associated Press News API reference

Two endpoints, one subscription. Search reads a section (world-news default), an apnews.com/hub/ topic, or site search. Article reads one story. Listing cards have no bylines — authors are on the article page. Section pages mix in right-rail / most-read cards. See the Associated Press News API: overview, pricing, and free tier.

Listing

GET /v1/ap/search · 1 request

curl -G https://api.clair.im/v1/ap/search \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "q=hurricane" \
  --data-urlencode "sort=newest" \
  --data-urlencode "page=1"

Parameter	Required	Contract
`q`	no	Site search. Do not send `section` or `topic` with `q`.
`section`	no	`world-news` (default), `us-news`, `politics`, `business`, `technology`, …
`topic`	no	`apnews.com/hub/` slug. Mutually exclusive with `section` and `q`.
`sort`	no	With `q`: `relevance`, `newest`, or `oldest`.
`page`	no	With `q`: 1–20. Section and topic hubs must stay on page 1.

Do not send limit or cursor. Search returns total_results and next_page. authors[] on cards is empty.

Article

GET /v1/ap/article · 1 request url must be an https://apnews.com/article/ link. The body is article: title, url, authors[], published_at, section, tags[], image, paragraphs[], word_count. access is always free. highlights is always empty. Same document as Reuters and Bloomberg. Auth, plans, rate limits, and error codes: Authentication.

​Listing

​Article

Listing

Article