WebScrapingAPI Docs

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.

Top Stories Results

Request

curl --get "https://serpapi.webscrapingapi.com/v2" \
  --data-urlencode "api_key=YOUR_API_KEY" \
  --data-urlencode "engine=google" \
  --data-urlencode "q=technology news"
ParameterTypeRequiredDescription
api_keystring✅Your WebScrapingAPI key.
enginestring✅Use google.
qstring✅Query likely to trigger Top Stories.

Response Fields

FieldTypeDescription
top_storiesarrayStory cards in Google's Top Stories module.
top_stories[].positionnumberStory position in the module.
top_stories[].titlestringStory headline.
top_stories[].linkstringStory URL.
top_stories[].sourcestringPublisher name.
top_stories[].datestringRelative or absolute publication time shown by Google.
top_stories[].thumbnailstringStory 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.

On this page