Google News results
dataforseo/serp_google_news_liveReturn news search results for a keyword in a given market.
- call
- $0.004
- DataForSEO
- 3 min
Overview
Queries the news vertical and returns the ranked articles it surfaces as structured records. Each carries the headline, publisher domain, article URL, snippet, and publication timestamp, along with its position, so coverage can be tracked over time or compared between publishers. Results are market-specific: the location and language select which regional edition is queried, which changes both the outlets shown and their ordering. The prominently featured stories block is reported separately from the ordinary result list.
One results page of news items with their headline, publisher, URL, snippet, timestamp, and rank.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| keyword | string | Yes | The search query to run, up to 700 characters. |
| location_code | integer | Yes | Which market to search from. |
| language_code | string | Yes | Interface and result language. |
| depth | integer | No | How many results to parse. |
| os | string | No | Which desktop operating system to emulate. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"dataforseo","endpoint":"serp_google_news_live","input":{"keyword":"electric vehicles","location_code":2840,"language_code":"en","depth":20}}'Pricing
$0.004 per call on the default plan. That is the list price; when the provider reports what a call actually cost, you are billed that instead. Every run carries its price in the response.