Extract structured data from Google Search including organic results, People Also Ask, related searches, and optional AI Overview
query (string): The search query to execute on Google (1-10,000 characters)country (string): ISO 3166-1 alpha-2 country code for localized results. Defaults to UScity (string): Canonical city name for hyperlocal search results. Use canonical city names from the Google Ads geotargets.device (string): Device type for search results. Options: desktop (default), mobile.pages (integer): Number of search results pages to scrape (1-20). Defaults to 1include.html (boolean): Include raw HTML response. Defaults to falseinclude.aioverview (object): Include Google AI Overview. Set markdown: true for markdown formatting. Defaults to false (not included)aioverview object under the include parameter:
markdown (boolean): Include AI Overview formatted as Markdown. Defaults to falseaioverview is not included in the request, no AI Overview data will be returned| Field | Type | Description |
|---|---|---|
result.organicResults | array | Organic search results from Google |
result.peopleAlsoAsk | array | ”People Also Ask” questions with answers |
result.relatedSearches | array | Related search suggestions |
result.html | string | Raw HTML response (if requested) |
| Field | Type | Description |
|---|---|---|
position | number | Position in search results (1-indexed) |
title | string | Title of the search result |
link | string | URL of the search result |
displayedLink | string | Formatted URL as displayed in search results |
snippet | string | Search result snippet |
page | number | Page number where result was found (for multi-page) |
| Field | Type | Description |
|---|---|---|
question | string | The question being asked |
type | string | Type of result (AIOVERVIEW or LINK) |
snippet | string | Answer snippet for LINK type questions |
title | string | Title for LINK type questions |
link | string | URL for LINK type questions |
| Field | Type | Description |
|---|---|---|
query | string | Related search query |
link | string | Google search URL for the related query |
| Field | Type | Description |
|---|---|---|
result.aioverview | object | Google AI Overview data (if requested) |
result.aioverview.text | string | AI Overview text content |
result.aioverview.markdown | string | AI Overview in markdown format (if requested) |
| Field | Type | Description |
|---|---|---|
position | number | Position of source in AI Overview |
label | string | Title of the source |
url | string | URL of the source |
description | string | Description of the source |
| Field | Type | Description |
|---|---|---|
url | string | Direct URL to the video |
title | string | Video title |
thumbnail | string | Thumbnail image URL |
source | string | Channel or source name |
platform | string | Video platform (e.g., YouTube) |
date | string | Upload date |
duration | string | Video duration |
city parameter to get hyperlocal search results for specific locations. The backend automatically converts canonical city names to Google’s location parameter.
City name formats supported:
peopleAlsoAsk results include a page field indicating which page each question appeared on.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Request parameters for monitoring Google search results
The search query to execute on Google
1 - 10000"best laptops for programming"
ISO 3166-1 alpha-2 country code for localized search results
"US"
Device type for search results
desktop, mobile "desktop"
Number of search results pages to scrape (1-20)
1 <= x <= 203
Optional flags for including additional response data