Historical news archive

Your API key. Alternatively send it in the X-ACCESS-KEY HTTP header. One of the two MUST be present.

Search articles by keywords or phrases (matches title, description, content, keywords, and URL). Supports AND / OR operators and quoted phrases. Maximum length depends on your plan (default 100 characters). Use only one of q, qInTitle, qInMeta.

Search articles by keywords in the title only. Maximum length depends on your plan (default 100 characters). Use only one of q, qInTitle, qInMeta.

Search articles by keywords in the title, description, keywords, and URL. Maximum length depends on your plan (default 100 characters). Use only one of q, qInTitle, qInMeta.

Filter by country. Comma-separated ISO 3166-1 alpha-2 country codes, up to your plan's filter limit (default 5). Cannot be combined with excludecountry.

Exclude countries. Comma-separated ISO country codes, up to your plan's filter limit (default 5). Cannot be combined with country.

Filter by category. Comma-separated category names, up to your plan's filter limit (default 5). Cannot be combined with excludecategory.

Exclude categories. Comma-separated category names, up to your plan's filter limit (default 5). Cannot be combined with category.

Filter by language. Comma-separated ISO 639-1 language codes, up to your plan's filter limit (default 5). Cannot be combined with excludelanguage.

Exclude languages. Comma-separated language codes, up to your plan's filter limit (default 5). Cannot be combined with language.

Filter by news source. Comma-separated source ids (the id value returned by /1/sources), up to your plan's filter limit (default 5). Cannot be combined with domainurl or excludedomain.

Filter by news source domain, e.g. bbc.com. Comma-separated, up to your plan's filter limit (default 5). Cannot be combined with domain or excludedomain.

Exclude news source domains, e.g. bbc.com. Comma-separated, up to your plan's filter limit (default 5). Cannot be combined with domain or domainurl.

Restrict results to a tier of news sources ranked by quality and popularity: top, medium, or low.

Fetch specific articles by their article_id. Comma-separated, up to your plan's page-size limit (default 50 paid, 10 free). Must be used alone — cannot be combined with any other filter.

Fetch a single article by its URL (tracking parameters such as utm_* are ignored). Maximum length 512. Must be used alone — cannot be combined with any other filter.

Get articles published on or after this date. Format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (UTC). Cannot be a future date. How far back you can search depends on your plan. Cannot be combined with timeframe.

Get articles published on or before this date. Format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (UTC). Cannot be a future date. Cannot be combined with timeframe.

Display article dates in a specific timezone (IANA name, e.g. Asia/Kolkata). Defaults to UTC.

Set to 1 to return only articles that include an image, or 0 to leave the image_url field out of the response.

Set to 1 to return only articles that include a video, or 0 to leave the video_url field out of the response.

Set to 1 to return only articles that include full content, or 0 to leave the content field out of the response. Available on plans with full-content access.

Set to 1 to exclude duplicate articles. Available for dates from 2024-07-24 onward.

Filter articles by sentiment. Available on Professional and Corporate plans, for dates from 2024-01-12 onward.

Minimum sentiment confidence (1-100) for the chosen sentiment. Requires the sentiment parameter.

Filter by AI-classified topic tags (e.g. politics,technology). Comma-separated, up to your plan's filter limit (default 5). Available on Professional and Corporate plans, for dates from 2024-01-12 onward.

Filter by AI-extracted geographic region. Join sub-regions with - to require them together (e.g. paris-france). Comma-separated, up to your plan's filter limit (default 5). Available on Corporate plans, for dates from 2024-01-29 onward.

Filter by AI-extracted organization names. Comma-separated, up to your plan's filter limit (default 5). Available on Corporate plans, for dates from 2024-05-24 onward.

Filter by article author / byline. Comma-separated, up to your plan's filter limit (default 5).

Filter by content type, e.g. news, blog, podcast. Comma-separated, up to your plan's filter limit (default 5). Available for dates from 2025-11-28 onward.

Number of articles per page: 1 to 50 on paid plans, 1 to 10 on the free plan. Defaults to your plan's maximum.

Pagination. With the default sort, pass the nextPage value from the previous response. With sort=relevancy|source|fetched_at, pass a page number instead.

Result ordering: pubdatedesc (default, newest first), pubdateasc, relevancy (requires q/qInTitle/qInMeta), source, or fetched_at. relevancy, source, and fetched_at are limited to the first 10,000 results. fetched_at is available on /latest, /news, /archive, and /market only.

Comma-separated list of response fields to leave out of each article. article_id cannot be excluded.