Advanced SERP API

Schemas

ErrorResponse

messagestring · required
Error description

SerpResponse

organicobject[]
Organic search results
adsobject[]
Advertisement results (if any)
imagesobject[]
Image results (if tbm=isch was used)
videosobject[]
Video results (if tbm=vid was used)
shoppingobject[]
Shopping results (if tbm=shop was used)
newsobject[]
News results (if tbm=nws was used)
placesobject[]
Map/places results (for Google Maps searches)
knowledge_panelobject
Knowledge panel info (if available)
answer_boxobject
Featured snippet/answer box (if available)
related_searchesstring[]
Related search queries
paginationobject
Pagination information

OrganicResult

linkstring · uri · required
URL of the result
Example: https://en.wikipedia.org/wiki/Hamburger
titlestring · required
Title of the result
Example: Hamburger

positioninteger
Position in search results
Example: 1
display_linkstring
Displayed URL in search results
Example: https://en.wikipedia.org › wiki › Hamburger
descriptionstring
Description snippet
Example: A hamburger, or simply a burger, is a dish consisting of fillings—usually a patty of ground meat, typically beef—placed inside a sliced bun or bread roll.
sitelinksobject[]
Additional links from the same site

AdResult

titlestring · required
Ad title
linkstring · uri · required
Advertised URL

positioninteger
Position in the ads section
displayed_linkstring
Displayed URL in the ad
descriptionstring
Ad description

ImageResult

image_urlstring · uri · required
Direct URL to the image

titlestring
Image title or alt text
linkstring · uri
URL to the page containing the image
thumbnailstring · uri
Thumbnail URL
sourcestring
Source site name

VideoResult

titlestring · required
Video title
linkstring · uri · required
URL to the video page

thumbnailstring · uri
Video thumbnail URL
sourcestring
Source site or channel
durationstring
Video duration
published_timestring
When the video was published

ShoppingResult

titlestring · required
Product title
linkstring · uri · required
URL to the product page

pricestring
Product price
currencystring
Currency of the price
sourcestring
Merchant or source
ratingnumber
Product rating (if available)
image_urlstring · uri
Product image URL

NewsResult

titlestring · required
News article title
linkstring · uri · required
URL to the news article
sourcestring · required
News source

published_timestring
When the article was published
thumbnailstring · uri
Article thumbnail URL
descriptionstring
Article snippet

PlaceResult

namestring · required
Place name

linkstring · uri
URL to the place details
addressstring
Physical address
ratingnumber
Rating (out of 5)
reviewsinteger
Number of reviews
categorystring
Business category
coordinatesobject
phonestring
Contact phone number
hoursobject
Operating hours

KnowledgePanel

titlestring
Main title
typestring
Entity type
descriptionstring
Short description
attributesobject
Various attributes of the entity
image_urlstring · uri
Main image URL

AnswerBox

titlestring
Answer title
answerstring
The answer text
sourcestring
Source of the answer
source_linkstring · uri
Link to the source

Pagination

current_pageinteger
Current page number
next_page_linkstring · uri
URL for the next page of results
prev_page_linkstring · uri
URL for the previous page of results
total_resultsinteger
Estimated total number of results