News

Search News Articles

Search for news articles from worldwide sources by keyword. Returns the article headline, URL, snippet, publication time in UTC, authors, photo and thumbnail URLs, and the source name, URL, favicon, and domain. Supports filtering by publication time, source, country, and language. The response also includes the requested limit and a count of the articles actually returned.

Price: $0.008 per request. Free tier: 50 requests/month.

get/v1/news/articles

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/news/articles
  • Auth: API key in header X-API-Key

Query parameters

querystring required

Search query (max 500 characters, cannot be blank)

limitinteger

Maximum number of results to return (1-100). Fewer may come back; the response count field reports how many articles were returned.

time_published'anytime' | '1h' | '1d' | '7d' | '1y'

Filter by publication time: anytime, 1h, 1d, 7d, or 1y

sourcestring

Filter by news source domain (e.g., bbc.com, reuters.com, cnn.com)

countrystring

2-letter ISO 3166-1 alpha-2 country code (e.g., us, gb, de, jp). Must be exactly 2 letters.

languagestring

2-letter ISO 639-1 language code (e.g., en, es, fr, de, ja). Must be exactly 2 letters.

Response

Successful response

countnumber nullable
limitnumber nullable

Changes

No recorded changes to this operation across all 1 revision of this API.