Sample of latest headlines

Up to 100 most recently published articles with a non-empty title from the last 15 minutes (and not in the future), in descending publication order. If fewer than five are available, the response is supplemented with the newest older articles needed to reach five, limited to articles published within the last 2 hours. feedStatus: stale indicates supplementation; if no articles are available within the 2-hour maximum age, the response is empty with feedStatus: empty. No all-time fallback. No API key, not logged, cached server-side for 1 minute. Rate-limited to 30 requests per minute per client IP (token bucket, burst 30); over the limit returns 429 rateLimited with Retry-After. Accepts no query parameters other than apiKey.

GEThttps://apis.newssearchapi.com/v1/headlines/samplePublic · no key

Response 200 · application/json

Latest headlines.

statusstringalways
feedStatusstringalways
Current means no older articles were needed
One of currentstaleempty
articlesobject[]always
Show 8 child fields
- idstring
- titlestring
- urlstring
- publishedAtstring
- indexedAtstring | null
  Time this article version was last indexed; use with indexed_from for incremental sync; null when unavailable.
- languagestring | null
- countrystring | null
- sourceobject
  Show 2 child fields
  - namestring
  - domainstring
    Publisher website hostname.

Errors

Every error uses the same envelope with a stable code. See error handling for which ones to retry.

400Invalid parameter (`parameterInvalid`) — unknown/repeated parameter, bad format or out-of-range value.
405Only GET, HEAD and OPTIONS are supported (`methodNotAllowed`).
429More than 30 requests per minute from this IP (`rateLimited`); no credits are charged.
500Unexpected server error (`internalError`). Not billable.
503A backing service is unavailable or timed out (`serviceUnavailable`). Not billable.

curl "https://apis.newssearchapi.com/v1/headlines/sample"

const response = await fetch("https://apis.newssearchapi.com/v1/headlines/sample");
const data = await response.json();

import os
import requests

response = requests.get(
    "https://apis.newssearchapi.com/v1/headlines/sample",
)
data = response.json()

req, _ := http.NewRequest(
    "GET",
    "https://apis.newssearchapi.com/v1/headlines/sample",
    nil,
)
resp, err := http.DefaultClient.Do(req)

$response = file_get_contents(
    "https://apis.newssearchapi.com/v1/headlines/sample"
);
$data = json_decode($response, true);

Try it

No key needed

GET/v1/headlines/sample

Example response · 200

{
  "status": "ok",
  "feedStatus": "current",
  "articles": [
    {
      "id": "-4210765838120375291",
      "title": "Central bank holds rates steady amid cooling inflation",
      "url": "https://www.dailyledger.example/business/rates-hold",
      "publishedAt": "2026-11-01T05:42:10Z",
      "indexedAt": "2026-11-01T05:42:12Z",
      "language": "en",
      "country": "gb",
      "source": {
        "name": "The Daily Ledger",
        "domain": "dailyledger.example"
      }
    }
  ]
}

Stuck or found a mistake?Email developer support