Top Stories Results
Understand Top Stories modules returned by the Google Search API.
Google may show Top Stories for newsworthy queries. When available, the API returns the parsed story cards in top_stories.

Request
curl --get "https://serpapi.webscrapingapi.com/v2" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "engine=google" \
--data-urlencode "q=technology news"| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | ✅ | Your WebScrapingAPI key. |
engine | string | ✅ | Use google. |
q | string | ✅ | Query likely to trigger Top Stories. |
Response Fields
| Field | Type | Description |
|---|---|---|
top_stories | array | Story cards in Google's Top Stories module. |
top_stories[].position | number | Story position in the module. |
top_stories[].title | string | Story headline. |
top_stories[].link | string | Story URL. |
top_stories[].source | string | Publisher name. |
top_stories[].date | string | Relative or absolute publication time shown by Google. |
top_stories[].thumbnail | string | Story thumbnail. Large base64 values are returned in full by the API. |
Response example
{
"top_stories": [
{
"position": 1,
"title": "Technology companies announce new AI tools",
"link": "https://example.com/technology-ai-tools",
"source": "Example News",
"date": "2 hours ago",
"thumbnail": "base64 image data omitted"
},
{
"position": 2,
"title": "Market reacts to new chip demand",
"link": "https://example.com/chip-demand",
"source": "Example Business",
"date": "1 day ago"
}
]
}Notes
Top Stories results are time-sensitive and can change between requests. If you compare story freshness, use the raw date string together with the request timestamp from your application.