Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What is Parsing?

Parsing for SERP API is the process of transforming a raw HTML response into a structured JSON with fields and values of data. This advanced parsing functionality is supported specifically for Google & Bing. When parsing is activated, data from SERP HTMLs are further structured into usable fields and values (such as, rank, link, title, description, rating, and dozens more fields) enabling you to monitor competitor SERP rankings, analyze keyword trends, and gather valuable market insights.

​
Which type of responses does Bright Data SERP provide?

Bright Data provides the following parsing options:
  1. Raw HTML: no parsing at all. Get the HTML response as is.
  2. Full JSON: our full interpertation of Google’s SERP HTML to JSON.
  3. Light JSON: a subset of full JSON, including only the organic results and google’s “Top Stories” .
  4. Parsed Bing: our full interpertation of Bing’s SERP HTML to JSON.
  5. Markdown: our full interpertation of Google’s and Bing’s SERP HTML to markdown *.md file.
  6. Screenshot: an image capture of the SERP HTML page as interperted by a browser.

​
Overriding default configuration

In order to override default data format, learn how to use the designated header parameter here: https://docs.brightdata.com/scraping-automation/serp-api/features

​
Google response schema: Light JSON

This schema usually returns twice as fast as the Full JSON. It includes 10 organic reults and covers less components than full JSON.

​
Response Format

A successful response may contain the following top-level fields depending on the query. Only organic is guaranteed in every response.

​
organic array — required

The primary list of web search results.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
titlestringNoTitle of the result
linkstringNoURL of the result page
descriptionstringNoSnippet/summary shown in the search result
imagestringNoImage associated with the result
extensionsarrayNoSite links or other extensions (see below)

​
extensions items

FieldTypeRequiredDescription
typestringYesExtension type, e.g. "site_link"
textstringNoAnchor text of the extension link
linkstringNoURL of the extension link
descriptionstringNoDescription text, if available
extendedbooleanNoWhether the extension is in expanded form

​
top_ads / bottom_ads arrays

Paid advertisement results appearing above or below organic results.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the ad on the page
titlestringNoAd headline
linkstringNoDestination URL of the ad
display_linkstringNoDisplayed URL shown in the ad
referral_linkstringNoReferral tracking URL
descriptionstringNoAd description text
extensionsarrayNoAd extensions (same structure as organic extensions)

​
top_stories object

Google’s Top Stories news carousel. Contains a heading label and an items array of inline news items.
FieldTypeRequiredDescription
headingstringNoSection heading, e.g. "Top Stories"
itemsarrayNoList of inline news items (see below)
postsarrayNoList of post items (see below)

​
top_stories.items items

FieldTypeRequiredDescription
global_rankintegerYesRank position of the item on the page
titlestringNoHeadline of the article
linkstringNoURL of the article
storystringNoShort summary or excerpt
imagestringNoThumbnail image URL

​
article_sets array

Grouped article clusters organized by topic, each containing a heading label and an items array of inline news items. Not guaranteed to appear in every response — your implementation should handle its absence gracefully.
FieldTypeRequiredDescription
headingstringNoTopic heading for the article cluster
itemsarrayNoList of inline news items (same structure as top_stories.items)
postsarrayNoList of post items (see below)

​
news array

News results embedded in the search page.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
titlestringNoHeadline of the article
linkstringNoURL of the article
sourcestringNoPublisher name
source_logostringNoPublisher logo URL
datestringNoPublication date/time
descriptionstringNoArticle snippet
imagestringNoThumbnail image URL

​
videos array

Video results embedded in the search page.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
titlestringNoVideo title
linkstringNoURL to the video

​
shorts array

Short-form video results embedded in the search page.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
titlestringNoTitle of the short video
linkstringNoURL to the short video
imagestringNoThumbnail image URL

​
images array

Image results embedded in the search page.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
titlestringNoImage title
linkstringNoURL of the source page
imagestringNoThumbnail image URL
original_imagestringNoFull-resolution image URL
image_widthintegerNoDisplayed image width in pixels
image_heightintegerNoDisplayed image height in pixels
original_widthintegerNoOriginal image width in pixels
original_heightintegerNoOriginal image height in pixels
blurredbooleanNoWhether the image is blurred

​
shopping array

Shopping results embedded within web search results.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
pricestringYesDisplayed price of the product
linkstringYesURL to the product page
titlestringNoProduct name
shopstringNoMerchant name
old_pricestringNoOriginal price before discount, if applicable
ratingnumberNoProduct rating
reviews_cntintegerNoNumber of reviews
imagestringNoProduct image URL

​
snack_pack_map object

The map image associated with the local pack results.
FieldTypeDescription
imagestringMap image URL
linkstringURL to Google Maps

​
snack_pack array

Local business results shown in the map pack.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
namestringNoBusiness name
linkstringNoURL to the business website
cidstringNoGoogle Customer ID of the business
sitestringNoBusiness website domain
addressstringNoBusiness address
phonestringNoPhone number
maps_linkstringNoURL to the business on Google Maps
ratingnumberNoAverage customer rating
reviews_cntnumberNoTotal number of reviews
work_statusstringNoCurrent open/closed status
work_status_detailsstringNoDetailed status, e.g. "Open until 10:00 PM"
summarystringNoShort description of the business
tagsarray of stringsNoAttribute tags, e.g. ["Dine-in", "Takeaway"]
imagestringNoBusiness image URL

​
overview object

Knowledge panel overview for an entity, parsed from featured snippet elements.
FieldTypeDescription
titlestringEntity name
kgmidstringGoogle Knowledge Graph ID
itemsarrayList of overview items (see below)

​
overview.items items

FieldTypeDescription
typestringItem type, e.g. "fact", "image"
attridstringAttribute identifier from Google’s data
titlestringLabel of the attribute
valuesarray of stringsAttribute values
hrefstringURL associated with the attribute
sourcestringSource name
imagestringImage URL, if applicable
image_altstringAlt text for the image

​
perspectives array

Perspective results from forums, social media, and editorial sources.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
titlestringNoPerspective title
linkstringNoURL to the full post
imagestringNoImage URL

​
latest_posts array

Latest social or editorial posts widget.
FieldTypeRequiredDescription
global_rankintegerYesRank position of the result on the page
titlestringNoPost title
linkstringNoURL to the post
imagestringNoPost image URL

​
Example Response

{
  "organic": [
    {
      "global_rank": 1,
      "title": "Pizza - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/pizza.jpg/220px.jpg",
      "extensions": [
        { "type": "site_link", "text": "Neapolitan pizza", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza", "extended": false },
        { "type": "site_link", "text": "Pizzeria", "link": "https://en.wikipedia.org/wiki/Pizzeria", "extended": false }
      ]
    },
    {
      "global_rank": 2,
      "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
      "link": "https://www.pizzahut.com/",
      "description": "Order pizza online for fast delivery or carryout from a store near you.",
      "extensions": [
        { "type": "site_link", "text": "Menu", "link": "https://www.pizzahut.com/menu", "extended": false }
      ]
    },
    {
      "global_rank": 3,
      "title": "Domino's Pizza - Order Online for Delivery or Carryout",
      "link": "https://www.dominos.com/",
      "description": "Order Domino's pizza online for delivery or carryout. Find deals, coupons, and track your order in real time.",
      "extensions": []
    }
  ],
  "top_ads": [
    {
      "global_rank": 4,
      "title": "Order Pizza Online — Fast Delivery Guaranteed",
      "link": "https://www.example-pizza-ad.com/order",
      "display_link": "www.example-pizza-ad.com",
      "referral_link": "https://www.example-pizza-ad.com/ref=google",
      "description": "Hot fresh pizza delivered to your door in 30 minutes or less.",
      "extensions": [
        { "type": "site_link", "text": "Order Now", "link": "https://www.example-pizza-ad.com/order" }
      ]
    }
  ],
  "top_stories": {
    "heading": "Top Stories",
    "items": [
      {
        "global_rank": 5,
        "title": "NYC Pizza Festival Returns for Its Biggest Year Yet",
        "link": "https://www.example-news.com/nyc-pizza-festival-2026",
        "story": "The annual NYC Pizza Festival is back with over 50 vendors and live entertainment.",
        "image": "https://www.example-news.com/images/pizza-festival.jpg"
      },
      {
        "global_rank": 6,
        "title": "The Science Behind the Perfect Pizza Crust",
        "link": "https://www.another-outlet.com/pizza-crust-science",
        "story": "Researchers reveal the chemistry that makes a pizza crust perfectly crispy.",
        "image": "https://www.another-outlet.com/images/pizza-crust.jpg"
      }
    ]
  },
  "article_sets": [
    {
      "heading": "Latest pizza news",
      "items": [
        {
          "global_rank": 7,
          "title": "World Record Pizza Baked in Naples",
          "link": "https://www.example-news.com/world-record-pizza",
          "story": "A team of chefs in Naples broke the world record for the longest pizza ever made.",
          "image": "https://www.example-news.com/images/record-pizza.jpg"
        }
      ]
    }
  ],
  "news": [
    {
      "global_rank": 8,
      "title": "Pizza Sales Surge as Comfort Food Trend Continues",
      "link": "https://www.example-business.com/pizza-sales-surge",
      "source": "Example Business News",
      "source_logo": "https://www.example-business.com/logo.png",
      "date": "3 hours ago",
      "description": "Pizza delivery and carryout sales have hit record highs this quarter.",
      "image": "https://www.example-business.com/images/pizza-sales.jpg"
    }
  ],
  "videos": [
    {
      "global_rank": 9,
      "title": "How to Make Perfect Homemade Pizza",
      "link": "https://www.youtube.com/watch?v=abc123"
    },
    {
      "global_rank": 10,
      "title": "Classic New York Pizza At Home",
      "link": "https://www.youtube.com/watch?v=def456"
    }
  ],
  "shorts": [
    {
      "global_rank": 11,
      "title": "60-Second Pizza Dough Hack",
      "link": "https://www.youtube.com/shorts/xyz789",
      "image": "https://i.ytimg.com/vi/xyz789/hqdefault.jpg"
    }
  ],
  "images": [
    {
      "global_rank": 12,
      "title": "Classic Margherita Pizza",
      "link": "https://www.example-recipe.com/margherita",
      "image": "https://www.example-recipe.com/images/margherita-thumb.jpg",
      "original_image": "https://www.example-recipe.com/images/margherita-full.jpg",
      "image_width": 400,
      "image_height": 300,
      "original_width": 1200,
      "original_height": 900,
      "blurred": false
    }
  ],
  "shopping": [
    {
      "global_rank": 13,
      "title": "Ooni Koda 16 Gas Powered Pizza Oven",
      "link": "https://www.example-store.com/ooni-koda-16",
      "price": "$599.00",
      "old_price": "$699.00",
      "shop": "Example Store",
      "rating": 4.8,
      "reviews_cnt": 3120,
      "image": "https://www.example-store.com/images/ooni-koda.jpg"
    }
  ],
  "snack_pack_map": {
    "image": "https://maps.googleapis.com/maps/api/staticmap?center=40.7128,-74.0060&zoom=13",
    "link": "https://www.google.com/maps/search/pizza+near+me"
  },
  "snack_pack": [
    {
      "global_rank": 14,
      "name": "Joe's Pizza",
      "link": "https://www.joespizzanyc.com",
      "cid": "12345678901234567",
      "site": "joespizzanyc.com",
      "address": "7 Carmine St, New York, NY 10014",
      "phone": "+1 212-366-1182",
      "maps_link": "https://www.google.com/maps/place/Joe%27s+Pizza",
      "rating": 4.7,
      "reviews_cnt": 5230,
      "work_status": "Open",
      "work_status_details": "Open until 4:00 AM",
      "summary": "Iconic NY pizza slice joint",
      "tags": ["Dine-in", "Takeaway", "No delivery"],
      "image": "https://www.joespizzanyc.com/images/storefront.jpg"
    }
  ],
  "overview": {
    "title": "Pizza",
    "kgmid": "/m/0663v",
    "items": [
      { "type": "fact", "attrid": "place_of_origin", "title": "Place of origin", "values": ["Naples, Italy"], "href": "https://en.wikipedia.org/wiki/Naples", "source": "Wikipedia" },
      { "type": "fact", "attrid": "main_ingredients", "title": "Main ingredients", "values": ["Dough", "Tomato sauce", "Mozzarella", "Toppings"], "href": "" },
      { "type": "image", "attrid": "image", "title": "Pizza", "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/pizza.jpg/220px.jpg", "image_alt": "A classic Margherita pizza" }
    ]
  },
  "perspectives": [
    {
      "global_rank": 15,
      "title": "Why Neapolitan Pizza is the Gold Standard",
      "link": "https://www.reddit.com/r/pizza/comments/example",
      "image": "https://www.reddit.com/images/pizza-post.jpg"
    }
  ],
  "latest_posts": [
    {
      "global_rank": 16,
      "title": "I tried 30 NYC pizza slices in one weekend — here's my ranking",
      "link": "https://www.example-blog.com/nyc-pizza-ranking",
      "image": "https://www.example-blog.com/images/pizza-ranking.jpg"
    }
  ],
  "bottom_ads": [
    {
      "global_rank": 17,
      "title": "Best Pizza Deals Online — Order Now",
      "link": "https://www.example-pizza-ad2.com/order",
      "display_link": "www.example-pizza-ad2.com",
      "referral_link": "https://www.example-pizza-ad2.com/ref=google",
      "description": "Find the best pizza deals in your area. Fast delivery, great prices.",
      "extensions": []
    }
  ]
}
Response schema: https://api.brightdata.com/data_schemas/fast_serp/google_search.schema.json

​
Google response schema: Full JSON

A successful Google Search response is a JSON object that may contain the following top-level fields depending on the query and search context. Response schema: https://api.brightdata.com/data_schemas/serp/google_search.schema.json

​
general object

Metadata about the search request and results.
FieldTypeDescription
results_cntintegerTotal number of results reported by Google
search_timenumberTime taken by Google to process the search, in seconds
languagestringLanguage of the search results
countrystringCountry name associated with the search
country_codestringTwo-letter country code
search_typestringType of search, e.g. "text", "shopping"
is_mobilebooleanWhether the request was made as a mobile device
is_emptybooleanWhether the results page returned no results
consent_typestringConsent mode applied to the request

​
input object

Details about the original request.
FieldTypeDescription
original_urlstringThe URL that was requested
user_agentstringUser agent string used for the request
request_idstringBright Data internal request identifier

​
organic array

The primary list of web search results.
FieldTypeDescription
linkstringURL of the result page
amp_linkstringAMP version URL, if available
titlestringTitle of the result
display_linkstringDisplayed URL shown in the result
sourcestringSource name
descriptionstringSnippet shown in the search result
snippet_highlighted_wordsarray of stringsWords highlighted in the snippet
last_modified_datestringLast modified date of the page, if available
iconstringFavicon of the result
imagestringImage associated with the result
thumbnailstringThumbnail image URL
extensionsarraySite links or other extensions (see below)
subresultsarrayIndented sub-results under the main result (see below)
similar_linkstringLink to similar pages
cached_linkstringLink to Google’s cached version
translate_linkstringLink to translated version
global_rankintegerRank position of the result on the page

​
extensions items

FieldTypeDescription
typestringExtension type, e.g. "site_link"
textstringAnchor text
linkstringURL of the extension link
descriptionstringDescription text, if available
extendedbooleanWhether the extension is in expanded form
inlinebooleanWhether the extension is displayed inline

​
subresults items

FieldTypeDescription
linkstringURL of the sub-result
titlestringTitle of the sub-result
descriptionstringSnippet of the sub-result
display_linkstringDisplayed URL of the sub-result
global_rankintegerRank position of the sub-result

​
top_ads / bottom_ads arrays

Paid advertisement results appearing above or below organic results.
FieldTypeDescription
titlestringAd headline
linkstringDestination URL of the ad
display_linkstringDisplayed URL shown in the ad
referral_linkstringReferral tracking URL
descriptionstringAd description text
phonestringPhone number shown in the ad, if any
deal_linkstringLink to a deal associated with the ad
deal_textstringDeal text, if any
imagestringImage shown in the ad
extensionsarrayAd extensions (same structure as organic extensions)
global_rankintegerRank position of the ad

​
top_pla / bottom_pla / jackpot_pla arrays

Product Listing Ads (shopping ads) appearing at the top, bottom, or in a prominent carousel.
FieldTypeDescription
titlestringProduct name
linkstringURL to the product page
referral_linkstringReferral tracking URL
pricestringDisplayed price
old_pricestringOriginal price before discount, if applicable
shopstringMerchant name
shippingstringShipping information
ratingnumberProduct rating
reviews_cntintegerNumber of reviews
extensionsarray of stringsAdditional labels or badges
imagestringProduct image URL
view_allbooleanWhether this is a “view all” placeholder item
global_rankintegerRank position of the item

​
shopping array

Shopping results embedded within web search results.
FieldTypeDescription
titlestringProduct name
linkstringURL to the product page
shop_linkstringURL to the merchant’s store page
descriptionstringProduct description
pricestringDisplayed price
old_pricestringOriginal price before discount, if applicable
shopstringMerchant name
shippingstringShipping information
ratingnumberProduct rating
reviews_cntintegerNumber of reviews
trusted_storebooleanWhether the merchant is marked as a trusted store
compare_pricesstringLink or label for comparing prices
imagestringProduct image URL
referral_linkstringReferral tracking URL
global_rankintegerRank position of the item

​
news array

News results embedded in the search page.
FieldTypeDescription
titlestringHeadline of the article
linkstringURL of the article
sourcestringPublisher name
source_logostringPublisher logo URL
descriptionstringArticle snippet
datestringPublication date/time
imagestringThumbnail image URL
global_rankintegerRank position of the result

​
top_stories object

Google’s “Top Stories” news carousel.
FieldTypeDescription
itemsarrayList of top story items
items[].titlestringHeadline
items[].linkstringArticle URL
items[].sourcestringPublisher name
items[].source_logostringPublisher logo URL
items[].datestringPublication date/time
items[].imagestringThumbnail image URL
items[].global_rankintegerRank position

​
videos / short_videos arrays

Video results embedded in the search page.
FieldTypeDescription
titlestringVideo title
linkstringURL to the video
sourcestringPlatform or publisher name
datestringPublication date
durationstringVideo duration as displayed
duration_secintegerVideo duration in seconds
imagestringThumbnail image URL
key_momentsarrayList of key moment timestamps (see below)
global_rankintegerRank position

​
key_moments items

FieldTypeDescription
titlestringLabel for the key moment
linkstringURL to the specific timestamp
startstringStart time as displayed
start_secintegerStart time in seconds
imagestringPreview image URL

​
images array

Image results embedded in the search page.
FieldTypeDescription
titlestringImage title
linkstringURL of the source page
sourcestringSource site name
source_logostringSource site logo URL
original_imagestringURL of the full-resolution image
imagestringThumbnail image URL
global_rankintegerRank position
Featured snippet boxes appearing at the top of results.
FieldTypeDescription
typestringSnippet type, e.g. "paragraph", "list", "table"
titlestringSnippet title
descriptionstringSnippet text content
valuestringValue shown in the snippet, if applicable
linkstringSource URL
display_linkstringDisplayed source URL
sourcestringSource name
imagestringImage URL, if applicable
itemsarrayList items for list-type snippets (text, value)
global_rankintegerRank position

​
people_also_ask array

“People also ask” questions shown on the results page.
FieldTypeDescription
questionstringThe question text
answerstringThe answer snippet
linkstringSource URL for the answer
titlestringTitle of the source page
display_linkstringDisplayed source URL
global_rankintegerRank position

​
knowledge object

Google Knowledge Panel for an entity.
FieldTypeDescription
titlestringEntity name
subtitlestringEntity category or subtitle
typestringEntity type
descriptionstringDescription of the entity
description_sourcestringSource of the description
description_linkstringURL of the description source
kgmidstringGoogle Knowledge Graph ID
linkstringOfficial website URL
imagestringMain image URL
factsarrayList of fact items (predicate, title, value, link)
widgetsarrayAdditional knowledge widgets

​
ai_overview object

Google AI Overview summary shown at the top of some results pages.
FieldTypeDescription
textsarrayList of content blocks (type: title, paragraph, list, code)
texts[].typestringContent block type
texts[].snippetstringText content of the block
texts[].linksarrayInline links within the block (text, link)
texts[].reference_indexesarray of integersIndexes pointing to the references array
referencesarraySource references cited in the AI overview
references[].hrefstringURL of the reference
references[].titlestringTitle of the reference
references[].sourcestringSource name
references[].indexintegerReference index
global_rankintegerRank position

​
snack_pack array

Local business results shown in the map pack.
FieldTypeDescription
namestringBusiness name
linkstringURL to the business website
cidstringGoogle Customer ID of the business
ratingnumberAverage customer rating
reviews_cntintegerNumber of reviews
typestringBusiness category
pricestringPrice range indicator
phonestringPhone number
addressstringBusiness address
work_statusstringCurrent open/closed status
work_status_detailsstringDetailed status description
maps_linkstringURL to the business on Google Maps
sponsoredbooleanWhether the listing is a sponsored result
tagsarray of stringsAttribute tags for the business
global_rankintegerRank position

​
snack_pack_map object

The map image associated with the local pack results.
FieldTypeDescription
imagestringMap image URL
linkstringURL to Google Maps
latstringLatitude of the map center
lngstringLongitude of the map center

​
jobs object

Job listing results embedded in the search page.
FieldTypeDescription
titlestringWidget title
itemsarrayList of job items
items[].titlestringJob title
items[].companystringCompany name
items[].locationstringJob location
items[].sourcestringJob board or source
items[].descriptionstringJob description snippet
items[].linkstringURL to the job listing
items[].tagsarrayList of tags (name, value)

​
flights object

Flight results widget.
FieldTypeDescription
titlestringWidget title
fromstringDeparture location
tostringDestination
date_fromstringDeparture date
date_tostringReturn date
flight_classstringCabin class
ticket_typestringOne-way or round trip
itemsarrayList of flight options (logo, title, travel_time, stops, price, link)
date_price_itemsarrayAlternate date pricing (departure_date, return_date, price)

​
hotels_selection object

Hotel results widget.
FieldTypeDescription
titlestringWidget title
items[].namestringHotel name
items[].linkstringURL to the hotel listing
items[].pricestringDisplayed price
items[].ratingnumberHotel rating
items[].reviews_cntintegerNumber of reviews
items[].tagsarray of stringsAttribute labels
items[].imagestringHotel image URL

​
recipes object

Recipe results widget.
FieldTypeDescription
titlestringWidget title
items[].titlestringRecipe name
items[].linkstringURL to the recipe
items[].ratingnumberRecipe rating
items[].reviews_cntintegerNumber of reviews
items[].sourcestringSource site
items[].cook_timestringCooking time
items[].ingredientsarray of stringsList of ingredients
items[].imagestringRecipe image URL
Popular products widget embedded in results.
FieldTypeDescription
titlestringWidget title
items[].titlestringProduct name
items[].pricestringDisplayed price
items[].linkstringURL to the product
items[].ratingnumberProduct rating
items[].reviews_cntintegerNumber of reviews
items[].featuresarray of stringsProduct feature highlights
items[].imagestringProduct image URL

​
weather object

Weather widget shown for weather-related queries.
FieldTypeDescription
titlestringLocation name
temperaturestringCurrent temperature
imagestringWeather condition icon URL
daily_forecastarrayDay-by-day forecast (day, image, temperature.daytime, temperature.nighttime)
hourly_forecastobjectHourly precipitation and wind data
additional_infoarrayExtra info items (type, text)

​
currency_exchange object

Currency conversion widget.
FieldTypeDescription
exchange_ratenumberCurrent exchange rate
datestringDate of the rate
exchangearrayConverted amounts (amount, currency)
historyarrayHistorical rates (exchange_rate, date)
“Related searches” shown at the bottom of the page.
FieldTypeDescription
textstringRelated search text
linkstringURL to the related search
expandedbooleanWhether this item has nested related items
itemsarrayNested related items, same structure

​
pagination object

Pagination data for the results page.
FieldTypeDescription
current_pageintegerCurrent page number
next_pageintegerNext page number
next_page_linkstringURL to the next page
pagesarrayList of available pages (page, start, link)

​
spelling object

Spell correction data, if Google corrected or suggested an alternative query.
FieldTypeDescription
original_textstringThe original query as submitted
original_linkstringURL to search with the original query
original_emptybooleanWhether the original query returned no results
auto_corrected_textstringQuery Google automatically corrected to
auto_corrected_linkstringURL for the auto-corrected query
suggested_textstringAlternative spelling suggestion
suggested_linkstringURL for the suggested spelling

​
forums object

Forum and discussion results embedded in the page.
FieldTypeDescription
items[].titlestringForum post or thread title
items[].sourcestringForum or platform name
items[].linkstringURL to the forum thread
items[].answersarrayList of answers (text, link, is_top_answer)

​
latest_posts object

Latest social or editorial posts widget.
FieldTypeDescription
titlestringWidget title
items[].titlestringPost title
items[].sourcestringPublisher or platform name
items[].channelstringChannel or account name
items[].datestringPublication date
items[].linkstringURL to the post
items[].imagestringPost image URL
items[].global_rankintegerRank position

​
perspectives array

Perspectives results from forums, social media, and editorial sources.
FieldTypeDescription
titlestringPerspective title
authorstringAuthor name
sourcestringSource platform
textstringExcerpt or summary
datestringPublication date
linkstringURL to the full post
imagestringImage URL
global_rankintegerRank position
Top navigation links shown on the results page (e.g. Images, News, Videos).
FieldTypeDescription
titlestringLabel of the navigation item
hrefstringURL of the navigation link

​
chips array

Refinement chip filters shown below the search bar.
FieldTypeDescription
labelstringChip label text
linkstringURL for applying the chip filter
image_urlstringIcon image URL, if applicable

​
Example Full JSON

Full JSON response example
{
  "general": {
    "results_cnt": 2340000000,
    "search_time": 0.52,
    "language": "en",
    "country": "United States",
    "country_code": "US",
    "search_type": "text",
    "is_mobile": false,
    "is_empty": false,
    "consent_type": "none"
  },
  "input": {
    "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
    "request_id": "hl_a1b2c3d4e5f6g7h8"
  },
  "navigation": [
    { "title": "Images", "href": "https://www.google.com/search?q=pizza&udm=2" },
    { "title": "News", "href": "https://www.google.com/search?q=pizza&tbm=nws" },
    { "title": "Videos", "href": "https://www.google.com/search?q=pizza&udm=7" },
    { "title": "Shopping", "href": "https://www.google.com/search?q=pizza&tbm=shop" }
  ],
  "navigation_tabs": [
    { "title": "All", "link": "https://www.google.com/search?q=pizza" },
    { "title": "Images", "link": "https://www.google.com/search?q=pizza&udm=2" }
  ],
  "navigation_filters": [
    {
      "title": "Any time",
      "is_active": true,
      "has_popup": true,
      "popup_items": [
        { "title": "Past hour", "is_active": false },
        { "title": "Past 24 hours", "is_active": false },
        { "title": "Past week", "is_active": false },
        { "title": "Past month", "is_active": false },
        { "title": "Past year", "is_active": false }
      ]
    }
  ],
  "chips": [
    { "label": "pizza dough", "link": "https://www.google.com/search?q=pizza+dough", "image_url": "https://example.com/chips/dough.jpg" },
    { "label": "pizza near me", "link": "https://www.google.com/search?q=pizza+near+me", "image_url": "https://example.com/chips/nearby.jpg" },
    { "label": "pizza recipes", "link": "https://www.google.com/search?q=pizza+recipes", "image_url": "https://example.com/chips/recipes.jpg" }
  ],
  "top_ads": [
    {
      "title": "Order Pizza Online — Fast Delivery Guaranteed",
      "link": "https://www.example-pizza-ad.com/order",
      "display_link": "www.example-pizza-ad.com",
      "referral_link": "https://www.example-pizza-ad.com/ref=google",
      "description": "Hot fresh pizza delivered to your door in 30 minutes or less. Order now.",
      "extensions": [
        { "type": "site_link", "text": "Order Now", "link": "https://www.example-pizza-ad.com/order", "extended": false },
        { "type": "site_link", "text": "Deals", "link": "https://www.example-pizza-ad.com/deals", "extended": false }
      ],
      "global_rank": 1
    }
  ],
  "featured_snippets": [
    {
      "type": "paragraph",
      "title": "What is pizza?",
      "description": "Pizza is a dish of Italian origin consisting of a usually round, flat base of leavened wheat-based dough topped with tomatoes, cheese, and often various other ingredients.",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "display_link": "en.wikipedia.org › wiki › Pizza",
      "source": "Wikipedia",
      "global_rank": 2
    }
  ],
  "ai_overview": {
    "texts": [
      {
        "type": "paragraph",
        "snippet": "Pizza is one of the world's most popular foods, originating in Naples, Italy. It typically consists of a leavened dough base topped with tomato sauce, mozzarella cheese, and a variety of toppings.",
        "links": [
          { "text": "History of pizza", "link": "https://en.wikipedia.org/wiki/History_of_pizza" }
        ],
        "reference_indexes": [0, 1]
      },
      {
        "type": "list",
        "snippet": "Common pizza styles include:",
        "list": [
          { "type": "paragraph", "snippet": "Neapolitan — thin, soft crust, simple toppings" },
          { "type": "paragraph", "snippet": "New York-style — large, foldable slices" },
          { "type": "paragraph", "snippet": "Chicago deep dish — thick crust, layered toppings" }
        ],
        "reference_indexes": [2]
      }
    ],
    "references": [
      { "index": 0, "href": "https://en.wikipedia.org/wiki/Pizza", "title": "Pizza - Wikipedia", "source": "Wikipedia" },
      { "index": 1, "href": "https://en.wikipedia.org/wiki/History_of_pizza", "title": "History of pizza", "source": "Wikipedia" },
      { "index": 2, "href": "https://www.example-food.com/pizza-styles", "title": "Pizza Styles Around the World", "source": "Example Food" }
    ],
    "global_rank": 3
  },
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "amp_link": "https://en.m.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "display_link": "en.wikipedia.org › wiki › Pizza",
      "source": "Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature.",
      "snippet_highlighted_words": ["Pizza", "Italian", "dough"],
      "icon": "https://en.wikipedia.org/favicon.ico",
      "extensions": [
        { "type": "site_link", "text": "Neapolitan pizza", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza", "extended": false, "inline": false },
        { "type": "site_link", "text": "Pizzeria", "link": "https://en.wikipedia.org/wiki/Pizzeria", "extended": false, "inline": false },
        { "type": "site_link", "text": "Pizza Margherita", "link": "https://en.wikipedia.org/wiki/Pizza_Margherita", "extended": false, "inline": false }
      ],
      "global_rank": 4
    },
    {
      "link": "https://www.pizzahut.com/",
      "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
      "display_link": "www.pizzahut.com",
      "source": "Pizza Hut",
      "description": "Order pizza online for fast delivery or carryout from a store near you. View our full menu, nutritional information, store locations, and more.",
      "snippet_highlighted_words": ["pizza"],
      "icon": "https://www.pizzahut.com/favicon.ico",
      "extensions": [
        { "type": "site_link", "text": "Menu", "link": "https://www.pizzahut.com/menu", "extended": false, "inline": false },
        { "type": "site_link", "text": "Locations", "link": "https://www.pizzahut.com/locations", "extended": false, "inline": false }
      ],
      "global_rank": 5
    },
    {
      "link": "https://www.dominos.com/",
      "title": "Domino's Pizza - Order Online for Delivery or Carryout",
      "display_link": "www.dominos.com",
      "source": "Domino's",
      "description": "Order Domino's pizza online for delivery or carryout. Find deals, coupons, and track your order in real time.",
      "snippet_highlighted_words": ["pizza"],
      "icon": "https://www.dominos.com/favicon.ico",
      "extensions": [],
      "global_rank": 6
    },
    {
      "link": "https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps",
      "title": "Pizza Margherita in 4 easy steps",
      "display_link": "www.bbcgoodfood.com › recipes",
      "source": "BBC Good Food",
      "description": "Even a novice cook can master the art of perfect pizza with our step-by-step guide to making a classic Margherita.",
      "snippet_highlighted_words": ["pizza", "Margherita"],
      "icon": "https://www.bbcgoodfood.com/favicon.ico",
      "extensions": [],
      "global_rank": 7
    }
  ],
  "videos": [
    {
      "title": "How to Make Perfect Homemade Pizza",
      "link": "https://www.youtube.com/watch?v=abc123",
      "source": "YouTube",
      "date": "2025-11-01",
      "duration": "12:34",
      "duration_sec": 754,
      "image": "https://i.ytimg.com/vi/abc123/hqdefault.jpg",
      "key_moments": [
        { "title": "Making the dough", "link": "https://www.youtube.com/watch?v=abc123&t=30", "start": "0:30", "start_sec": 30, "image": "https://i.ytimg.com/vi/abc123/moment1.jpg" },
        { "title": "Adding toppings", "link": "https://www.youtube.com/watch?v=abc123&t=480", "start": "8:00", "start_sec": 480, "image": "https://i.ytimg.com/vi/abc123/moment2.jpg" }
      ],
      "global_rank": 8
    },
    {
      "title": "Classic New York Pizza At Home",
      "link": "https://www.youtube.com/watch?v=def456",
      "source": "YouTube",
      "date": "2025-09-15",
      "duration": "9:45",
      "duration_sec": 585,
      "image": "https://i.ytimg.com/vi/def456/hqdefault.jpg",
      "key_moments": [],
      "global_rank": 9
    }
  ],
  "top_stories": {
    "items": [
      {
        "title": "NYC Pizza Festival Returns for Its Biggest Year Yet",
        "link": "https://www.example-news.com/nyc-pizza-festival-2026",
        "source": "Example News",
        "source_logo": "https://www.example-news.com/logo.png",
        "date": "2 hours ago",
        "image": "https://www.example-news.com/images/pizza-festival.jpg",
        "global_rank": 10
      },
      {
        "title": "The Science Behind the Perfect Pizza Crust",
        "link": "https://www.another-outlet.com/pizza-crust-science",
        "source": "Another Outlet",
        "source_logo": "https://www.another-outlet.com/logo.png",
        "date": "5 hours ago",
        "image": "https://www.another-outlet.com/images/pizza-crust.jpg",
        "global_rank": 11
      }
    ]
  },
  "images": [
    {
      "title": "Classic Margherita Pizza",
      "link": "https://www.example-recipe.com/margherita",
      "source": "Example Recipe",
      "source_logo": "https://www.example-recipe.com/logo.png",
      "original_image": "https://www.example-recipe.com/images/margherita-full.jpg",
      "image": "https://www.example-recipe.com/images/margherita-thumb.jpg",
      "global_rank": 12
    },
    {
      "title": "Neapolitan Pizza with Fresh Basil",
      "link": "https://www.example-food.com/neapolitan",
      "source": "Example Food",
      "source_logo": "https://www.example-food.com/logo.png",
      "original_image": "https://www.example-food.com/images/neapolitan-full.jpg",
      "image": "https://www.example-food.com/images/neapolitan-thumb.jpg",
      "global_rank": 13
    }
  ],
  "shopping": [
    {
      "title": "Ooni Koda 16 Gas Powered Pizza Oven",
      "link": "https://www.example-store.com/ooni-koda-16",
      "shop_link": "https://www.example-store.com",
      "description": "Gas-powered outdoor pizza oven. Reaches 950°F in 20 minutes.",
      "price": "$599.00",
      "old_price": "$699.00",
      "shop": "Example Store",
      "shipping": "Free shipping",
      "rating": 4.8,
      "reviews_cnt": 3120,
      "trusted_store": true,
      "image": "https://www.example-store.com/images/ooni-koda.jpg",
      "global_rank": 14
    },
    {
      "title": "Pizza Stone for Oven and Grill",
      "link": "https://www.another-store.com/pizza-stone",
      "shop_link": "https://www.another-store.com",
      "description": "14-inch cordierite pizza stone, evenly distributes heat for a crispy crust.",
      "price": "$34.99",
      "shop": "Another Store",
      "shipping": "$4.99 shipping",
      "rating": 4.6,
      "reviews_cnt": 8740,
      "trusted_store": false,
      "image": "https://www.another-store.com/images/pizza-stone.jpg",
      "global_rank": 15
    }
  ],
  "top_pla": [
    {
      "title": "Ooni Fyra 12 Wood Pellet Pizza Oven",
      "link": "https://www.example-shop.com/ooni-fyra",
      "referral_link": "https://www.example-shop.com/ref=gpla",
      "price": "$349.00",
      "old_price": "$399.00",
      "shop": "Example Shop",
      "shipping": "Free shipping",
      "rating": 4.7,
      "reviews_cnt": 2340,
      "image": "https://www.example-shop.com/images/ooni-fyra.jpg",
      "global_rank": 16
    }
  ],
  "knowledge": {
    "title": "Pizza",
    "subtitle": "Dish",
    "type": "Food",
    "description": "Pizza is a dish of Italian origin consisting of a usually round, flat base of leavened wheat-based dough topped with tomatoes, cheese, and often various other ingredients.",
    "description_source": "Wikipedia",
    "description_link": "https://en.wikipedia.org/wiki/Pizza",
    "kgmid": "/m/0663v",
    "link": "https://en.wikipedia.org/wiki/Pizza",
    "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/Eq_it-na_pizza-margherita_sep2005_sml.jpg/220px.jpg",
    "facts": [
      { "predicate": "Place of origin", "title": "Place of origin", "value": "Naples, Italy", "link": "https://en.wikipedia.org/wiki/Naples" },
      { "predicate": "Main ingredients", "title": "Main ingredients", "value": "Dough, tomato sauce, cheese, toppings", "link": "" },
      { "predicate": "Serving temperature", "title": "Serving temperature", "value": "Hot", "link": "" }
    ],
    "widgets": [
      {
        "type": "list",
        "key": "Variations",
        "predicate": "Variations",
        "title": "Popular variations",
        "items": [
          { "title": "Neapolitan pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza" },
          { "title": "New York-style pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/New_York-style_pizza" },
          { "title": "Chicago-style pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/Chicago-style_pizza" }
        ]
      }
    ]
  },
  "people_also_ask": [
    {
      "question": "What is the most popular pizza topping?",
      "answer": "Pepperoni is the most popular pizza topping in the United States, appearing on approximately 36% of all pizzas ordered.",
      "link": "https://www.example-food.com/popular-pizza-toppings",
      "title": "Most Popular Pizza Toppings in America",
      "display_link": "www.example-food.com",
      "global_rank": 17
    },
    {
      "question": "Where was pizza invented?",
      "answer": "Pizza was invented in Naples, Italy. The modern pizza with tomato sauce and mozzarella is believed to have originated there in the 18th or early 19th century.",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "display_link": "en.wikipedia.org",
      "global_rank": 18
    }
  ],
  "snack_pack_map": {
    "image": "https://maps.googleapis.com/maps/api/staticmap?center=40.7128,-74.0060&zoom=13",
    "link": "https://www.google.com/maps/search/pizza+near+me",
    "lat": "40.7128",
    "lng": "-74.0060"
  },
  "snack_pack": [
    {
      "name": "Joe's Pizza",
      "link": "https://www.joespizzanyc.com",
      "cid": "12345678901234567",
      "rating": 4.7,
      "reviews_cnt": 5230,
      "type": "Pizza restaurant",
      "price": "$",
      "phone": "+1 212-366-1182",
      "address": "7 Carmine St, New York, NY 10014",
      "work_status": "Open",
      "work_status_details": "Open until 4:00 AM",
      "maps_link": "https://www.google.com/maps/place/Joe%27s+Pizza",
      "sponsored": false,
      "tags": ["Dine-in", "Takeaway", "No delivery"],
      "global_rank": 19
    },
    {
      "name": "Grimaldi's Pizzeria",
      "link": "https://www.grimaldis-pizza.com",
      "cid": "98765432109876543",
      "rating": 4.5,
      "reviews_cnt": 8910,
      "type": "Pizza restaurant",
      "price": "$$",
      "phone": "+1 718-858-4300",
      "address": "1 Front St, Brooklyn, NY 11201",
      "work_status": "Open",
      "work_status_details": "Open until 10:00 PM",
      "maps_link": "https://www.google.com/maps/place/Grimaldi%27s+Pizzeria",
      "sponsored": false,
      "tags": ["Dine-in", "Takeaway"],
      "global_rank": 20
    }
  ],
  "recipes": {
    "title": "Pizza recipes",
    "items": [
      {
        "title": "Classic Margherita Pizza",
        "link": "https://www.bbcgoodfood.com/recipes/pizza-margherita",
        "rating": 4.8,
        "reviews_cnt": 1240,
        "source": "BBC Good Food",
        "cook_time": "25 mins",
        "ingredients": ["pizza dough", "tomato sauce", "mozzarella", "fresh basil", "olive oil"],
        "image": "https://www.bbcgoodfood.com/images/margherita.jpg"
      },
      {
        "title": "Easy Pepperoni Pizza",
        "link": "https://www.example-recipe.com/pepperoni-pizza",
        "rating": 4.6,
        "reviews_cnt": 890,
        "source": "Example Recipe",
        "cook_time": "30 mins",
        "ingredients": ["pizza dough", "tomato sauce", "mozzarella", "pepperoni", "oregano"],
        "image": "https://www.example-recipe.com/images/pepperoni.jpg"
      }
    ]
  },
  "popular_products": {
    "title": "Popular pizza-related products",
    "items": [
      {
        "title": "Ooni Koda 16 Pizza Oven",
        "price": "$599.00",
        "link": "https://www.example-store.com/ooni-koda-16",
        "rating": 4.8,
        "reviews_cnt": 3120,
        "features": ["Gas powered", "Reaches 950°F", "16-inch capacity"],
        "image": "https://www.example-store.com/images/ooni-koda.jpg"
      }
    ]
  },
  "perspectives": [
    {
      "title": "Why Neapolitan Pizza is the Gold Standard",
      "author": "John Smith",
      "source": "Reddit",
      "text": "After trying pizza across 12 countries, I keep coming back to true Neapolitan pizza. The simplicity of the ingredients and the high-heat cooking is unmatched.",
      "date": "2026-03-10",
      "link": "https://www.reddit.com/r/pizza/comments/example",
      "image": "https://www.reddit.com/images/pizza-post.jpg",
      "global_rank": 21
    }
  ],
  "forums": {
    "items": [
      {
        "title": "What makes a great pizza dough?",
        "source": "Reddit",
        "subtitles": ["r/pizza", "452 comments"],
        "link": "https://www.reddit.com/r/pizza/comments/dough-question",
        "answers": [
          { "text": "High protein flour, long cold fermentation, and proper hydration are the three keys.", "link": "https://www.reddit.com/r/pizza/comments/dough-question/answer1", "is_top_answer": true },
          { "text": "Don't overwork the dough and let it rest at room temperature before stretching.", "link": "https://www.reddit.com/r/pizza/comments/dough-question/answer2", "is_top_answer": false }
        ]
      }
    ]
  },
  "related": [
    { "text": "pizza dough recipe", "link": "https://www.google.com/search?q=pizza+dough+recipe", "expanded": false },
    { "text": "pizza near me", "link": "https://www.google.com/search?q=pizza+near+me", "expanded": false },
    { "text": "best pizza in New York", "link": "https://www.google.com/search?q=best+pizza+in+new+york", "expanded": false },
    { "text": "homemade pizza", "link": "https://www.google.com/search?q=homemade+pizza", "expanded": false }
  ],
  "spelling": {
    "original_text": "pizza",
    "original_link": "https://www.google.com/search?q=pizza",
    "original_empty": false,
    "auto_corrected_text": "",
    "auto_corrected_link": "",
    "suggested_text": "",
    "suggested_link": ""
  },
  "pagination": {
    "current_page": 1,
    "next_page": 2,
    "next_page_start": 10,
    "next_page_link": "https://www.google.com/search?q=pizza&start=10",
    "pages": [
      { "page": 1, "start": 0, "link": "https://www.google.com/search?q=pizza" },
      { "page": 2, "start": 10, "link": "https://www.google.com/search?q=pizza&start=10" },
      { "page": 3, "start": 20, "link": "https://www.google.com/search?q=pizza&start=20" }
    ]
  },
  "bottom_ads": [
    {
      "title": "Best Pizza Deals Online — Order Now",
      "link": "https://www.example-pizza-ad2.com/order",
      "display_link": "www.example-pizza-ad2.com",
      "referral_link": "https://www.example-pizza-ad2.com/ref=google",
      "description": "Find the best pizza deals in your area. Fast delivery, great prices.",
      "extensions": [],
      "global_rank": 22
    }
  ]
}