Endpoints · 07/13
News
Fresh articles with source, date, snippet and image.
Endpoint
POSThttps://serp-api.ozymoz.com/newsCredits per call1
Parameters
| Name | Description | Default |
|---|---|---|
qrequired | The search query. | — |
gl | Country to search from, as a two-letter code (us, tr, de…).Default: us | us |
hl | Interface language, as a language code (en, tr, de…).Default: en | en |
num | Number of results per page.Default: 10 | 10 |
page | Results page, starting at 1.Default: 1 | 1 |
tbs | Time filter: qdr:h (hour), qdr:d (day), qdr:w (week), qdr:m (month), qdr:y (year). | — |
location | Free-text location to search from, e.g. “Istanbul, Turkey”. | — |
device | desktop (default) or mobile — the light page: real links, mobile ranking, no People also ask.Default: desktop | desktop |
resolveLinks | Resolve Google's /goto redirect links to the real URLs (desktop only).Default: true | true |
Example request
curl -X POST 'https://serp-api.ozymoz.com/news' \
-H 'X-API-KEY: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"q": "electric vehicles",
"gl": "us",
"hl": "en",
"tbs": "qdr:d"
}'Example response
Illustrative values in the real shape. Top-level keys: news.
response.json
{
"searchParameters": {
"type": "news",
"engine": "google",
"q": "electric vehicles",
"gl": "us",
"hl": "en",
"tbs": "qdr:d",
"device": "desktop"
},
"news": [
{
"title": "Battery prices fall again as EV sales climb",
"link": "https://www.example-news.com/ev-batteries",
"snippet": "Pack prices dropped another 8% this year…",
"date": "2 hours ago",
"source": "Example News",
"position": 1
}
],
"credits": 1
}Good to know
device and resolveLinks work as for search. Carousel items may have no snippet.