Google News

News articles with source, publish date, snippet and thumbnail.


      POST
      https://api.serpkite.com/v1/news

Credits: 1 per page Try in playground

View as Markdown

Google News results for a query: headline, source, publish date, snippet and thumbnail. Combine with time to watch a topic over the last hour, day or week.

Request body

Send a JSON object with Content-Type: application/json. The same parameters also work as a query string on GET /v1/news. JSON arrays are rejected: to run many queries at once, use POST /v1/batches at half price. Unknown parameters return 400 invalid_request with a message that names the replacement; see strict validation.

Parameter	Type	Default	Description
`q` required	string		The search query. Required. Up to 2,048 characters.
`country`	string	`us`	Country to search from, as a two-letter ISO code (us, gb, de, in…).
`language`	string	`en`	Interface language, as a language code (en, de, fr, pt-BR…).
`location`	string		Canonical location for local results, e.g. "Austin, Texas, United States". Overrides country for geo.
`uule`	string		Google-encoded location string. Use instead of location if you already have it.
`num`	integer	`10`	Results per call. 10 per page; 100 fetches the top 100 as a depth bundle for 7 credits instead of 10. One of: `10`, `20`, `30`, `50`, `100`.
`page`	integer	`1`	Results page, 1–10. Each page is billed separately.
`time`	string		Restrict to recent results. Shorthand for tbs=qdr:*. One of: `hour`, `day`, `week`, `month`, `year`.
`tbs`	string		Raw Google tbs filter, e.g. qdr:w or cdr:1,cd_min:…
`format`	string	`json`	Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. One of: `json`, `compact`, `markdown`.
`fields`	string		Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens.
`max_age`	integer		Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits.
`engine`	string or array	`google`	Which search providers may answer. google is Google only (SerpKite still fails over across its own proxy pools); auto falls back to other providers when Google is blocked or times out; consensus (search only) asks several independent indexes in parallel, merges the results by URL, ranks them by agreement and lists each result's sources, at the sum of one page per provider that returned results; a provider name or a list (e.g. google,brave) restricts the request to those. meta.engine names the provider that answered. One of: `google`, `auto`, `consensus`, `brave`, `bing`, `yahoo`, `duckduckgo`, `mojeek`, `wikipedia`.

Example request

Authenticate with Authorization: Bearer $SERPKITE_API_KEY (GET requests may pass ?api_key= instead). The official SDKs read SERPKITE_API_KEY for you. See Authentication.

POST /v1/news

cURL

TypeScript

Python

curl https://api.serpkite.com/v1/news \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"AI agents funding","country":"us","time":"week"}'

Response fields

Field	Type	Description
`request`	object	The normalised request, with defaults filled in: `endpoint`, `engine`, `q`, `country`, `language`, `location`, `num`, `page`, `device`, `autocorrect`…
`results[]`	array	`position`, `title`, `link`, `domain`, `snippet`, `date`, `source`, `image_url`.
`meta`	object	`request_id`, `credits_used`, `cached`, `cached_at`, `engine` (the provider that answered), `route` (provider attempts, see Search providers), `latency_ms`, `parse_quality` (`ok`, `partial`, `empty`), `resolved_urls`.

Every billed response also carries credit and latency headers (X-Credits-Used, X-Credits-Remaining, X-Request-Id…).

Example response

200 OK · illustrative

{
  "request": {
    "endpoint": "news",
    "engine": "google",
    "q": "AI agents funding",
    "country": "us",
    "language": "en",
    "time": "week"
  },
  "results": [
    {
      "position": 1,
      "title": "Agent startups raised a record amount this quarter",
      "link": "https://news.example.com/2026/09/agent-startups-funding",
      "domain": "news.example.com",
      "snippet": "Investors poured money into companies building autonomous software agents…",
      "date": "3 hours ago",
      "source": "Example News",
      "image_url": "https://news.example.com/img/agents.jpg"
    }
  ],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 1,
    "cached": false,
    "engine": "google",
    "latency_ms": 1034,
    "parse_quality": "ok",
    "resolved_urls": true
  }
}

Errors

Errors use one shape: {"error":{"code","message","request_id"}}. Errors are never billed. Full list in Errors.

Status	Code	Meaning
400	`invalid_request`	A parameter is missing or invalid.
401	`unauthorized`	The API key is missing, invalid or revoked.
402	`insufficient_credits`	Your balance is too low. Buy a pack or wait for the monthly free grant.
429	`rate_limited`	Too many requests per second for your plan. Retry after the Retry-After header.
503	`upstream_error`	Google could not be fetched or parsed. Not billed; retry after Retry-After.

Notes

Dates are shown as Google displays them (e.g. "3 hours ago").