Real-Time News Search & Media Monitoring API

GET/v1/news/search2 Credits / query (0 if empty)($0.0002 / query ($0.11–$0.20 / 1K queries))· Updated 2026-11-14

Search breaking global news articles by keyword, company, ticker, or topic with optional recency window filtering (1h, 24h, 7d, 30d, 1y). Returns article title, canonical URL, snippet, UTC publication timestamp, thumbnail image, authors, and publisher domain/favicon.

Parameters

qstringrequired
News search query (company name, person, market event, or boolean phrase).
Example: electric vehicles
countrystring
Two-letter ISO edition country code (default US).
Example: US
langstring
ISO 639-1 language code (default en).
Example: en
whenstring
Optional freshness window (1h, 1d, 7d, 30d, 1y).
Example: 7d
limitinteger (1 to 100)
Maximum number of news articles to return (1 to 100, default 20).
Example: 20

Example Request (cURL / Python / JavaScript)

curl "https://api.searchdataapi.com/v1/news/search?q=electric+vehicles" \
  -H "x-api-key: sr_live_your_api_key"

import requests

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

const res = await fetch("https://api.searchdataapi.com/v1/news/search?q=electric+vehicles", {
  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": {
    "query": "electric vehicles",
    "country": "US",
    "lang": "en",
    "count": 3,
    "articles": [
      {
        "position": 1,
        "title": "Volkswagen may have just hinted at the name of its next affordable EV",
        "url": "https://news.google.com/rss/articles/CBMiggFBVV95cUxOdm5WZW54RUs0dkZrdnRzSFhaWDBXRGl5OHVKZFJiWi0xNFR2ek5kaklCanJ6dHYyMWk3ZlNtd1ZoNmhZbU1TTWhVZ0ctRTl0TDZabTBtUDUwekl2TFhDZHhxNTVlRk9xMmwtdi1keVZJdHViVUJlSVEwS3RsOTZldHdR?oc=5",
        "snippet": "Volkswagen may have just hinted at the name of its next affordable EV &nbsp;&nbsp; Electrek",
        "published_at": "2026-11-13T22:14:00.000Z",
        "image_url": null,
        "authors": [],
        "source": {
          "name": "Electrek",
          "url": "https://electrek.co",
          "domain": "electrek.co",
          "favicon": "https://www.google.com/s2/favicons?domain=electrek.co&sz=64"
        }
      },
      {
        "position": 2,
        "title": "The Death of the Cybertruck Is Actually Great News for the Electric Vehicle Market",
        "url": "https://news.google.com/rss/articles/CBMi1wFBVV95cUxQSFNlTDhSVzhUSnJtdExvZ2xFLVFxU1c3ZHYyUEVNVzgyWTQ4c2I3STNjXzlVeks5a2FlWkJTYjFhMmNyYjVaY19Ba3Z6dzF2UnFwWnBSdlVBQ3RIWUhmVHRmTUlRNlIycDIyVEZVSnNSMmx6aVFpeVZOcU9KYUxfUkZuZHR6bEcyd2ZVTWxZYk5rblVmWkQ5b1IyMjI3dnUyVWpoRTNNcmlUR3RsT216eF9GYU1jR25qOUhFS0p5cW5XVWRzR0t0OUduQjZmMV9WeEdldXRVZw?oc=5",
        "snippet": "The Death of the Cybertruck Is Actually Great News for the Electric Vehicle Market &nbsp;&nbsp; Mother Jones",
        "published_at": "2026-11-12T08:00:00.000Z",
        "image_url": null,
        "authors": [],
        "source": {
          "name": "Mother Jones",
          "url": "https://www.motherjones.com",
          "domain": "motherjones.com",
          "favicon": "https://www.google.com/s2/favicons?domain=motherjones.com&sz=64"
        }
      },
      {
        "position": 3,
        "title": "2026 Jeep Recon vs. 2027 Rivian R2 Tested: Which Electric SUV Is Better?",
        "url": "https://news.google.com/rss/articles/CBMiswFBVV95cUxNeWJlWUs0OXJycnZoQ09OQlZxOTZFUjkyQ25WRWgxaER2QXhZamRxWExpaU02RC1ycUhyZWtwd0RfakVHR1JZODZLeGY4dFBvZkZrU01tSVZndDNSYnRfT3VxYW95RUY3a3hjNVJGcGRqbmFxaFFRZm5HNWFGYlZka1hteDhxZmNUVGZsVjhwV3pWc280WDBPZDJ4LVl6T0JFTVN1Y1VWUHJKbl9pZ3RwaWdMSQ?oc=5",
        "snippet": "2026 Jeep Recon vs. 2027 Rivian R2 Tested: Which Electric SUV Is Better? &nbsp;&nbsp; Car and Driver",
        "published_at": "2026-11-13T15:06:21.000Z",
        "image_url": null,
        "authors": [],
        "source": {
          "name": "Car and Driver",
          "url": "https://www.caranddriver.com",
          "domain": "caranddriver.com",
          "favicon": "https://www.google.com/s2/favicons?domain=caranddriver.com&sz=64"
        }
      }
    ]
  },
  "meta": {
    "request_id": "2efdbdff-2c00-4e16-8494-38e2afb7a9cd",
    "endpoint": "/v1/news/search",
    "count": 3,
    "credits_charged": 2,
    "cached": false,
    "took_ms": 1832
  }
}

Response Fields

Real-time news articles matching the search query.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://searchdataapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`query`	string	Search query (for /v1/news/search).
`topic`	string	Topic code (for /v1/news/top).
`country`	string	ISO country code.
`lang`	string	ISO language code.
`count`	integer	Number of articles returned.
`articles`	array of NewsArticleItem
`position`	integer	1-based article position.
`title`	string	Headline title.
`url`	string	Article URL.
`snippet`	string	Article lead summary.
`published_at`	string	ISO 8601 UTC publication timestamp.
`image_url`	string	Article thumbnail image URL.
`authors`	array of string
`source`	object
`meta`	ResponseMeta
`request_id`	string	Unique UUIDv4 trace identifier.
`endpoint`	string	Normalized /v1/* endpoint path.
`count`	integer	Number of primary items returned.
`credits_charged`	integer	Credits deducted (0 on empty or error).
`cached`	boolean	Whether served from L1/L2 edge cache.
`took_ms`	integer	End-to-end gateway latency in milliseconds.

Status Codes

200: Real-time news articles matching the search query.