Live Top Headlines by Topic & Country API

Parameters

• topicstring

  Headline topic feed (TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH).

  Example: TECHNOLOGY

• countrystring

  Two-letter ISO country code (default US).

  Example: US

• langstring

  ISO 639-1 language code (default en).

  Example: en

• limitinteger (1 to 100)

  Maximum number of headlines to return (1 to 100, default 20).

  Example: 20

Example Request (cURL / Python / JavaScript)

curl "https://api.searchdataapi.com/v1/news/top" \
  -H "x-api-key: sr_live_your_api_key"

import requests

res = requests.get(
    "https://api.searchdataapi.com/v1/news/top",
    headers={"x-api-key": "sr_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.searchdataapi.com/v1/news/top", {
  headers: { "x-api-key": "sr_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://searchdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "topic": "TECHNOLOGY",
    "country": "US",
    "lang": "en",
    "count": 3,
    "articles": [
      {
        "position": 1,
        "title": "Zelda: Ocarina of Time Remake Sells 5 Million in Four Days, Yet Former Nintendo Leads Say The Series Sold \"Like Nothing\" Before Breath of the Wild",
        "url": "https://news.google.com/rss/articles/CBMirwFBVV95cUxPUklWZzlXU1gzQ3NWX2x3dVpOYnE5OU5WVE5pTFFjRVZNTlYzbTY4NWNqMzIxeXNNYlZwWTNDNkJMRWoxX3Boa3U5OU9WVmRLdDVfQldvYzBWWGdlN0kzcXhmUENtbEZja3pJa1NyLVpwcFA2TW96WlRwemk0ZHhoeU9CSTM1RGoxZ2hHdmxDcjc4YS14eVhwbUlrYkhGcV9kd3d5d0pTanctVmhQOWdF?oc=5",
        "snippet": "Zelda: Ocarina of Time Remake Sells 5 Million in Four Days, Yet Former Nintendo Leads Say The Series Sold \"Like Nothing\" Before Breath of the Wild    Wccftech The Legend of Zelda: Ocarina of Time for Nintendo Switch 2 sells over 5.2 million units worldwide in first four days    Nintendo The Legend of Zelda: Ocarina of Time Sets New Switch 2 Sales Record    Consequence of Sound Opinion: Nintendo Made Ocarina Of Time's Best Moment Even Better    Nintendo Life Legendary Game Returns in Remake of Nintendo’s “The Legend of Zelda: Ocarina of Time”    Roger Ebert",
        "published_at": "2026-11-13T12:24:10.000Z",
        "image_url": null,
        "authors": [],
        "source": {
          "name": "Wccftech",
          "url": "https://wccftech.com",
          "domain": "wccftech.com",
          "favicon": "https://www.google.com/s2/favicons?domain=wccftech.com&sz=64"
        }
      },
      {
        "position": 2,
        "title": "Space Shuttle Endeavour new LA home opens at California Science Center in Exposition Park",
        "url": "https://news.google.com/rss/articles/CBMitgFBVV95cUxNYnQ3REtQVWdMM0ViRGFHRVBiektOamtSSmJIUjBOdWM2ZE5fTnJ6NmllbXhQT2NvUk81SnNXOGhYdDlVU2pzaFdQWjRqMF9iOEh3VkZDc3lLdDBvVHlhdDJqVElkTi1Wb2pNV3Qtd1JKNW04WVlObFppYmhmZklfMEtPQzRaSXlNRWVKSmZTUzI3VDFFLTVGcEpxMmIzb0RuV0NQU2Jocm9xTXdBR3JrdWhLeW9Id9IBuwFBVV95cUxOUGVJX2lkTkxZa2RfcXBFM3BCUEVRSmRpSDZGUENzaERNQTRlcUtVUV9Cd0NQc1Fwa3JzSTE4ZEJjU3k3cW5hdXc5UUdRN1l5ellmQXpDbzdFendNZ013bHNSenN3dXZpcDRIcTFURVplRDE0UGc1NFlPUUNSdXQ0ZGhTZGZjTGNFc0pTTXdvRG96UUtzaXhBTHBBOVpXV3FHQTZTUUZCNFhBNkRYN05IeWlidkliSFhuTVFn?oc=5",
        "snippet": "Space Shuttle Endeavour new LA home opens at California Science Center in Exposition Park    ABC7 Los Angeles Astronauts, kids enjoy opening of Samuel Oschin Air and Space Center - Los Angeles Times    Los Angeles Times Through NASA’s Lens: Capturing Space Shuttle Endeavour’s Move to LA    NASA (.gov) Samuel Oschin Air and Space Center    Arup California's brand-new Air & Space Center, home of the space shuttle Endeavour, opens today    Space",
        "published_at": "2026-11-13T21:36:57.000Z",
        "image_url": null,
        "authors": [],
        "source": {
          "name": "ABC7 Los Angeles",
          "url": "https://abc7.com",
          "domain": "abc7.com",
          "favicon": "https://www.google.com/s2/favicons?domain=abc7.com&sz=64"
        }
      },
      {
        "position": 3,
        "title": "HomeView Tidbits: Mirror, Sleep Timer, and Other Details",
        "url": "https://news.google.com/rss/articles/CBMiZ0FVX3lxTFBkZ1owaFRKTFJrS0F3Ymw1MmNESGlCTWhiMk40a0xlN0t4VlRLQnRMWTlNeVdqS2tqVXJySkR0SHRhRXVKN3luVU1ESWV0R2p5N2NTbjZhQ3dNd3lFb2M2NXNlSHZBNWc?oc=5",
        "snippet": "HomeView Tidbits: Mirror, Sleep Timer, and Other Details    MacRumors I Spent a Week Testing Apple’s New HomeView. It’s ... Fine.    The New York Times Apple’s HomeView is my new favorite smart display — but not my daughter’s    The Verge Apple’s HomeView Makes Up for Late Arrival with Ecosystem Perks: Review    Bloomberg.com HomeView has one big problem: The iPad    Macworld",
        "published_at": "2026-11-13T22:04:35.000Z",
        "image_url": null,
        "authors": [],
        "source": {
          "name": "MacRumors",
          "url": "https://www.macrumors.com",
          "domain": "macrumors.com",
          "favicon": "https://www.google.com/s2/favicons?domain=macrumors.com&sz=64"
        }
      }
    ]
  },
  "meta": {
    "request_id": "0e3c3124-402a-4330-8cfc-4aaea87f0ed8",
    "endpoint": "/v1/news/top",
    "count": 3,
    "credits_charged": 2,
    "cached": false,
    "took_ms": 192
  }
}

Response Fields

Status Codes

200

Top breaking headlines for the requested topic and country.