Google SERP as JSON: organic, AI Overview, People Also Ask, AI Mode, news, shopping. No Cloud setup.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
HasData API key, created at app.hasdata.com. 1,000 free credits every month, no card.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Get AI Mode SERP Results Captures Gemini-powered AI Mode answers from Google Search. Returns the conversational response text, cited source links, subtopic breakdowns, and, when continuable is set, a subsequentRequestToken for multi-turn continuation. Use for next-gen search interfaces, AI-answer monitoring, citation tracking, content research agents, building question-answering pipelines grounded in live Google results, and person/company data enrichment — e.g. asking `Who is the CEO of HasData?`, `What is Roman Milyushkevich's LinkedIn?`, `HasData founder email`, `HasData Instagram handle` to get a synthesized answer plus source URLs in one call, ideal for lead enrichment, sales research, people search, and filling in contact/attribute gaps for CRM records.
Specify the search term for which you want to scrape the SERP.
The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
The encoded location parameter.
Google canonical location for the search.
Whether to continue an existing AI Mode conversation.
Token used to continue a previous AI Mode request.
Get AI Mode SERP Results Captures Gemini-powered AI Mode answers from Google Search. Returns the conversational response text, cited source links, subtopic breakdowns, and, when continuable is set, a subsequentRequestToken for multi-turn continuation. Use for next-gen search interfaces, AI-answer monitoring, citation tracking, content research agents, building question-answering pipelines grounded in live Google results, and person/company data enrichment — e.g. asking `Who is the CEO of HasData?`, `What is Roman Milyushkevich's LinkedIn?`, `HasData founder email`, `HasData Instagram handle` to get a synthesized answer plus source URLs in one call, ideal for lead enrichment, sales research, people search, and filling in contact/attribute gaps for CRM records.
| Argument | Type | Description |
|---|---|---|
| q* | string | Specify the search term for which you want to scrape the SERP. |
| gl | string | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. |
| hl | string | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. |
| uule | string | The encoded location parameter. |
| location | string | Google canonical location for the search. |
| continuable | boolean | Whether to continue an existing AI Mode conversation. |
| subsequentRequestToken | string | Token used to continue a previous AI Mode request. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Specify the search term for which you want to scrape the SERP."
},
"gl": {
"type": "string",
"description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
},
"hl": {
"type": "string",
"description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
},
"uule": {
"type": "string",
"description": "The encoded location parameter."
},
"location": {
"type": "string",
"description": "Google canonical location for the search."
},
"continuable": {
"type": "boolean",
"description": "Whether to continue an existing AI Mode conversation."
},
"subsequentRequestToken": {
"type": "string",
"description": "Token used to continue a previous AI Mode request."
}
},
"additionalProperties": false
}Get AI Overview Results Fetches the lazy-loaded Google AI Overview block via a pageToken returned by the Google SERP API (token valid for 1 minute). Returns the AI-generated answer text, referenced source URLs, and expanded subtopic sections. Use as a follow-up call to Google SERP for tracking AI citations in SEO, fact-checking answers against sources, and LLM retrieval pipelines grounded in live Google results.
| Argument | Type | Description |
|---|---|---|
| pageToken* | string | Token from `aiOverview` block in Google SERP API. Valid for 1 minute. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pageToken"
],
"properties": {
"pageToken": {
"type": "string",
"description": "Token from `aiOverview` block in Google SERP API. Valid for 1 minute."
}
},
"additionalProperties": false
}Get Google Event Details Looks up a single Google event by the `pageToken` returned in a `google/serp` response's `eventsResults` array (or the ready-to-call `hasdataLink` next to it). Returns the venue name/rating/reviews/website/phone, a map link, a description, ticket sources (with official/unofficial flags), and the primary ticket link — details the SERP events widget does not show inline. The `pageToken` expires a few minutes after it is minted, so fetch it and call this endpoint promptly. Use to enrich an events search result with full venue and ticketing information.
| Argument | Type | Description |
|---|---|---|
| pageToken* | string | Token identifying a single event, taken from the `pageToken` field of an `eventsResults` entry in a `google/serp` response. Expires a few minutes after it is minted. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pageToken"
],
"properties": {
"pageToken": {
"type": "string",
"description": "Token identifying a single event, taken from the `pageToken` field of an `eventsResults` entry in a `google/serp` response. Expires a few minutes after it is minted."
}
},
"additionalProperties": false
}Get Immersive Product Information Expands the Google Shopping Immersive Product pop-up given an immersiveProductPageToken from the Google Shopping API, with optional moreStores (up to ~13 merchants instead of 3–5) and nextPageToken for paginating stores. Returns multi-store offers (merchant, price, shipping, URL), product specs, images, ratings, and the storesNextPageToken. Use for price-comparison bots, merchant discovery, dropshipping research, and aggregating full offer lists per product.
| Argument | Type | Description |
|---|---|---|
| pageToken* | string | Token for displaying more product info in the Google immersive pop-up, available in the Google Shopping API response as the `immersiveProductPageToken` property. |
| moreStores | boolean | Fetch additional store results in a single search. By default it returns 3–5 stores, and when true it returns up to 13 or the maximum available for the product. |
| nextPageToken | string | Token used to retrieve the next page of store results. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pageToken"
],
"properties": {
"pageToken": {
"type": "string",
"description": "Token for displaying more product info in the Google immersive pop-up, available in the Google Shopping API response as the `immersiveProductPageToken` property."
},
"moreStores": {
"type": "boolean",
"description": "Fetch additional store results in a single search. By default it returns 3–5 stores, and when true it returns up to 13 or the maximum available for the product."
},
"nextPageToken": {
"type": "string",
"description": "Token used to retrieve the next page of store results."
}
},
"additionalProperties": false
}Get Google News Results Retrieves Google News results by free-text query, topicToken (World, Business, Technology, etc.), sectionToken, publicationToken (e.g. CNN, BBC), or storyToken (full-coverage cluster with sort by relevance/date). Returns article title, snippet, source publisher, published date, thumbnail, and URL, plus tokens for navigating topics, sub-sections, and story clusters. Use for news monitoring, brand/PR tracking, topical aggregators, publisher-specific feeds, and drilling into full story coverage.
| Argument | Type | Description |
|---|---|---|
| q | string | Free-text query as used on news.google.com. Not allowed with `topicToken`, `storyToken`, or `publicationToken`. |
| gl | string | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. |
| hl | string | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. |
| so | string | Sort order for articles in a story. Use only with storyToken. |
| storyToken | string | Token for a single news story cluster (the “Full coverage” page). |
| topicToken | string | Token for a Google News topic such as World, Business, or Technology. Not allowed with `q`, `storyToken`, or `publicationToken`. |
Get Product Information Pulls detailed product data from Google Shopping by productId with searchType (offers, specs, reviews) and rich filters (free shipping, used-condition, sort by price/total price/deals/seller rating, reviews count). Returns product title, images, price, ratings, specs, merchant offers (seller, shipping, condition, total price), and review text depending on searchType. Use for price intelligence, catalog enrichment, review mining, competitor spec comparison, and building shopping assistants that surface the cheapest or highest-rated offer.
| Argument | Type | Description |
|---|---|---|
| gl | string | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. |
| hl | string | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. |
| uule | string | The encoded location parameter. |
| start | number | This parameter specifies the number of search results to skip and is used for pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page. This parameter is applicable only when `searchType=offers` is specified. For reviews pagination use `filter` parameter. |
| domain | string | Google domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`. |
Get Google Search Results Full-featured Google Search scraper with location/uule, country (gl), language (hl, lr), domain, device type, safesearch, time/date filters via tbs (qdr, cdr), and tbm vertical selection (images, videos, news, shopping, local), plus offset/num pagination (num capped at 10 without tbm). Returns organic results (title, link, snippet, position), ads, knowledge graph, related searches, People Also Ask, local pack, featured snippets, AI Overview pageToken, and rich SERP features. Use for SEO rank tracking, keyword research, SERP-feature monitoring, competitor analysis, grounding LLMs with fresh location-aware search data, and especially for person/company data enrichment — e.g. finding a person's LinkedIn/Instagram/Twitter profile (`Roman Milyushkevich LinkedIn`, `HasData Instagram`), a company's CEO/founder/leadership (`HasData CEO`, `HasData founder`), contact emails (`Roman Milyushkevich HasData email`), phone numbers, GitHub profiles, press mentions, or any public attribute of a person or business by running a targeted query and parsing the top organic results.
| Argument | Type | Description |
|---|---|---|
| q* | string | Specify the search term for which you want to scrape the SERP. |
| gl | string | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. |
| hl | string | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. |
| lr | array |
Get Google Light Search Results Google Search scraper served from the lightweight no-JS layout, cheaper and faster than the full SERP API. Returns organic results (title, link, displayed link, snippet, sitelinks, extensions, date, rating and review count), AI Overview with its text blocks and source references, answer box (featured snippet, calculator, unit and currency conversion, local time), knowledge graph, related questions, related searches, inline images, local pack, search filters, pagination, spelling correction and the location Google actually applied. Shopping, top stories, news, videos and jobs blocks are not served in this layout. Supports location/uule, country (gl), language (hl/lr), domain, safesearch, and time/date filters via tbs (qdr, cdr) with offset/num pagination (num capped at 10). Use for high-volume keyword monitoring, bulk rank tracking, backlink discovery, and AI Overview presence tracking.
| Argument | Type | Description |
|---|---|---|
| q* | string | Specify the search term for which you want to scrape the SERP. |
| gl | string | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. |
| hl | string | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. |
| lr | array | The 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content. |
Get Shopping Search Results Scrapes Google Shopping listings for a query with location/uule, country/language/domain, time/date filters, device type, shoprs filter-helper IDs, and offset pagination. Returns product title, price, merchant/source, rating, reviews count, thumbnail, product link, productId, immersiveProductPageToken, and filter chips with hasdata_link for refining by brand/price/condition/promotions. Use for e-commerce price tracking, catalog building, promotion discovery, and feeding productIds into the Product API or tokens into the Immersive Product API for deeper data.
| Argument | Type | Description |
|---|---|---|
| q* | string | Specify the search term for which you want to scrape the SERP. |
| gl | string | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. |
| hl | string | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. |
| tbs | string | This parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters: - Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021` - Filter results to show only those within the defined date range. - Sort by Date: `sbd:1` - Results are sorted by date, from the most recent to the oldest. - Sort by Relevance: `sbd:0` - Results are sorted by relevance to the search query. - Sites with Images: `img:1` - Only show results from webpages that contain images. Quick Date Range (qdr): - `qdr:h` - Show results from the past hour. - `qdr:d` - Limit results to the past day. - `qdr:w` - Filter results from the week. - `qdr:m` - Display results from the past month. - `qdr:y` - Show results from the past year. - `qdr:h10`, `qdr:d10`, `qdr:w10`, `qdr:m10`, `qdr:y10` - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively. These filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria. |
Get Short Videos Search Results Scrapes the Google Short Videos carousel (TikTok, YouTube Shorts, Instagram Reels, etc.) for a query with location/uule, country (gl/cr), language (hl/lr), device type, and page-based pagination. Supports Google's advanced filters (tbs). Returns video title, thumbnail, duration, source platform, channel/creator, direct video URL, the platform's video ID and profile handle, and ready-to-call HasData API links (hasdataLinks) for the video's comments, transcript, profile, posts or channel. Use for short-form content discovery, viral-trend monitoring, influencer research, cross-platform video aggregation, and sourcing short clips to summarize or embed in LLM responses.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search query term for retrieving short videos results. |
| cr | string | The country code for the country you want to limit the search to. Provide one exact documented value (237 allowed), e.g. `countryAF`, `countryAL`. |
| gl | string | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. |
| hl | string | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. |
| lr | array | The 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content. |
| sectionToken | string | Token for a sub-section under a topic, for example Business → Economy. Use only when `topicToken` or `publicationToken` is present. |
| publicationToken | string | Token for a specific publisher such as CNN or BBC. Not allowed with `q`, `storyToken`, or `topicToken`. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"description": "Free-text query as used on news.google.com. Not allowed with `topicToken`, `storyToken`, or `publicationToken`."
},
"gl": {
"type": "string",
"description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
},
"hl": {
"type": "string",
"description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
},
"so": {
"enum": [
"0",
"1"
],
"type": "string",
"description": "Sort order for articles in a story. Use only with storyToken."
},
"storyToken": {
"type": "string",
"description": "Token for a single news story cluster (the “Full coverage” page)."
},
"topicToken": {
"type": "string",
"description": "Token for a Google News topic such as World, Business, or Technology. Not allowed with `q`, `storyToken`, or `publicationToken`."
},
"sectionToken": {
"type": "string",
"description": "Token for a sub-section under a topic, for example Business → Economy. Use only when `topicToken` or `publicationToken` is present."
},
"publicationToken": {
"type": "string",
"description": "Token for a specific publisher such as CNN or BBC. Not allowed with `q`, `storyToken`, or `topicToken`."
}
},
"additionalProperties": false
}| filter | string | Filter parameter for refining search results. Supports various filters for offers and reviews. Multiple filters can be passed using a comma. The available filters are: Offers filters: - `freeship:1`: Show only products with free shipping. - `ucond:1`: Show only used products. - `scoring:p`: Sort by base price. - `scoring:tp`: Sort by total price. - `scoring:cpd`: Sort by current promotion deals (special offers). - `scoring:mrd`: Sort by seller's rating. Reviews filters: - `rnum:{number}`: Number of results (100 is max). |
| location | string | Google canonical location for the search. |
| productId* | string | The product ID to get results for. |
| searchType | string | Parameter for fetching specific product information, such as 'offers', 'specs', or 'reviews'. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"productId"
],
"properties": {
"gl": {
"type": "string",
"description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
},
"hl": {
"type": "string",
"description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
},
"uule": {
"type": "string",
"description": "The encoded location parameter."
},
"start": {
"type": "number",
"description": "This parameter specifies the number of search results to skip and is used for pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page.\n\nThis parameter is applicable only when `searchType=offers` is specified. For reviews pagination use `filter` parameter.\n"
},
"domain": {
"type": "string",
"description": "Google domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`."
},
"filter": {
"type": "string",
"description": "Filter parameter for refining search results. Supports various filters for offers and reviews. Multiple filters can be passed using a comma. The available filters are:\n\nOffers filters:\n- `freeship:1`: Show only products with free shipping.\n- `ucond:1`: Show only used products.\n- `scoring:p`: Sort by base price.\n- `scoring:tp`: Sort by total price.\n- `scoring:cpd`: Sort by current promotion deals (special offers).\n- `scoring:mrd`: Sort by seller's rating.\n\nReviews filters:\n- `rnum:{number}`: Number of results (100 is max).\n"
},
"location": {
"type": "string",
"description": "Google canonical location for the search."
},
"productId": {
"type": "string",
"description": "The product ID to get results for."
},
"searchType": {
"enum": [
"offers",
"specs",
"reviews"
],
"type": "string",
"description": "Parameter for fetching specific product information, such as 'offers', 'specs', or 'reviews'."
}
},
"additionalProperties": false
}| The 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content. |
| si | string | Google Cached Search Parameters ID. |
| num | number | Number of results per page, ranging from 10 to 100. |
| tbm | string | Specify the type of search. |
| tbs | string | This parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters: - Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021` - Filter results to show only those within the defined date range. - Sort by Date: `sbd:1` - Results are sorted by date, from the most recent to the oldest. - Sort by Relevance: `sbd:0` - Results are sorted by relevance to the search query. - Sites with Images: `img:1` - Only show results from webpages that contain images. Quick Date Range (qdr): - `qdr:h` - Show results from the past hour. - `qdr:d` - Limit results to the past day. - `qdr:w` - Filter results from the week. - `qdr:m` - Display results from the past month. - `qdr:y` - Show results from the past year. - `qdr:h10`, `qdr:d10`, `qdr:w10`, `qdr:m10`, `qdr:y10` - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively. These filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria. |
| lsig | string | Additional Google Place ID. |
| nfpr | number | Controls if auto-corrected results are shown. 0 includes them (default), 1 shows only the original query. Google may still return auto-corrected results if no others are available. |
| safe | string | Adult Content Filtering option. |
| uule | string | The encoded location parameter. |
| kgmid | string | Google Knowledge Graph ID. |
| start | number | This parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page. For Google Local Results, the start value must be in multiples of 20, such as 20 for the second page, 40 for the third page, etc. |
| domain | string | Google domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`. |
| filter | number | Defines whether to enable or disable the filters for 'Similar Results' and 'Omitted Results'. Set to 1 (default) to enable these filters, or 0 to disable them. |
| ludocid | string | The Google Place ID for a specific location. |
| location | string | Google canonical location for the search. |
| deviceType | string | Specify the device type for the search. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Specify the search term for which you want to scrape the SERP."
},
"gl": {
"type": "string",
"description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
},
"hl": {
"type": "string",
"description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
},
"lr": {
"type": "array",
"items": {
"enum": [
"lang_ar",
"lang_hy",
"lang_bg",
"lang_ca",
"lang_cs",
"lang_da",
"lang_de",
"lang_el",
"lang_en",
"lang_es",
"lang_et",
"lang_tl",
"lang_fi",
"lang_fr",
"lang_hr",
"lang_hi",
"lang_hu",
"lang_id",
"lang_is",
"lang_it",
"lang_iw",
"lang_he",
"lang_ja",
"lang_ko",
"lang_lt",
"lang_lv",
"lang_nl",
"lang_no",
"lang_fa",
"lang_pl",
"lang_pt",
"lang_ro",
"lang_ru",
"lang_sk",
"lang_sl",
"lang_sr",
"lang_sv",
"lang_th",
"lang_tr",
"lang_uk",
"lang_vi",
"lang_zh-CN",
"lang_zh-TW"
],
"type": "string"
},
"description": "The 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content."
},
"si": {
"type": "string",
"description": "Google Cached Search Parameters ID."
},
"num": {
"type": "number",
"description": "Number of results per page, ranging from 10 to 100."
},
"tbm": {
"enum": [
"isch",
"vid",
"nws",
"shop",
"lcl"
],
"type": "string",
"description": "Specify the type of search."
},
"tbs": {
"type": "string",
"description": "This parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters:\n\n - Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021` - Filter results to show only those within the defined date range.\n - Sort by Date: `sbd:1` - Results are sorted by date, from the most recent to the oldest.\n - Sort by Relevance: `sbd:0` - Results are sorted by relevance to the search query.\n - Sites with Images: `img:1` - Only show results from webpages that contain images.\n\nQuick Date Range (qdr):\n - `qdr:h` - Show results from the past hour.\n - `qdr:d` - Limit results to the past day.\n - `qdr:w` - Filter results from the week.\n - `qdr:m` - Display results from the past month.\n - `qdr:y` - Show results from the past year.\n - `qdr:h10`, `qdr:d10`, `qdr:w10`, `qdr:m10`, `qdr:y10` - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively.\n\nThese filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria.\n"
},
"lsig": {
"type": "string",
"description": "Additional Google Place ID."
},
"nfpr": {
"type": "number",
"description": "Controls if auto-corrected results are shown. 0 includes them (default), 1 shows only the original query. Google may still return auto-corrected results if no others are available.\n"
},
"safe": {
"enum": [
"active",
"off"
],
"type": "string",
"description": "Adult Content Filtering option."
},
"uule": {
"type": "string",
"description": "The encoded location parameter."
},
"kgmid": {
"type": "string",
"description": "Google Knowledge Graph ID."
},
"start": {
"type": "number",
"description": "This parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page.\n\nFor Google Local Results, the start value must be in multiples of 20, such as 20 for the second page, 40 for the third page, etc.\n"
},
"domain": {
"type": "string",
"description": "Google domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`."
},
"filter": {
"type": "number",
"description": "Defines whether to enable or disable the filters for 'Similar Results' and 'Omitted Results'. Set to 1 (default) to enable these filters, or 0 to disable them.\n"
},
"ludocid": {
"type": "string",
"description": "The Google Place ID for a specific location."
},
"location": {
"type": "string",
"description": "Google canonical location for the search."
},
"deviceType": {
"enum": [
"desktop",
"mobile",
"tablet"
],
"type": "string",
"description": "Specify the device type for the search."
}
},
"additionalProperties": false
}| num | number | Number of results per page, ranging from 10 to 100. |
| tbs | string | This parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters: - Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021` - Filter results to show only those within the defined date range. - Sort by Date: `sbd:1` - Results are sorted by date, from the most recent to the oldest. - Sort by Relevance: `sbd:0` - Results are sorted by relevance to the search query. - Sites with Images: `img:1` - Only show results from webpages that contain images. Quick Date Range (qdr): - `qdr:h` - Show results from the past hour. - `qdr:d` - Limit results to the past day. - `qdr:w` - Filter results from the week. - `qdr:m` - Display results from the past month. - `qdr:y` - Show results from the past year. - `qdr:h10`, `qdr:d10`, `qdr:w10`, `qdr:m10`, `qdr:y10` - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively. These filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria. |
| safe | string | Adult Content Filtering option. |
| uule | string | The encoded location parameter. |
| start | number | This parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page. For Google Local Results, the start value must be in multiples of 20, such as 20 for the second page, 40 for the third page, etc. |
| domain | string | Google domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`. |
| filter | number | Defines whether to enable or disable the filters for 'Similar Results' and 'Omitted Results'. Set to 1 (default) to enable these filters, or 0 to disable them. |
| location | string | Google canonical location for the search. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Specify the search term for which you want to scrape the SERP."
},
"gl": {
"type": "string",
"description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
},
"hl": {
"type": "string",
"description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
},
"lr": {
"type": "array",
"items": {
"enum": [
"lang_ar",
"lang_hy",
"lang_bg",
"lang_ca",
"lang_cs",
"lang_da",
"lang_de",
"lang_el",
"lang_en",
"lang_es",
"lang_et",
"lang_tl",
"lang_fi",
"lang_fr",
"lang_hr",
"lang_hi",
"lang_hu",
"lang_id",
"lang_is",
"lang_it",
"lang_iw",
"lang_he",
"lang_ja",
"lang_ko",
"lang_lt",
"lang_lv",
"lang_nl",
"lang_no",
"lang_fa",
"lang_pl",
"lang_pt",
"lang_ro",
"lang_ru",
"lang_sk",
"lang_sl",
"lang_sr",
"lang_sv",
"lang_th",
"lang_tr",
"lang_uk",
"lang_vi",
"lang_zh-CN",
"lang_zh-TW"
],
"type": "string"
},
"description": "The 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content."
},
"num": {
"type": "number",
"description": "Number of results per page, ranging from 10 to 100."
},
"tbs": {
"type": "string",
"description": "This parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters:\n\n - Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021` - Filter results to show only those within the defined date range.\n - Sort by Date: `sbd:1` - Results are sorted by date, from the most recent to the oldest.\n - Sort by Relevance: `sbd:0` - Results are sorted by relevance to the search query.\n - Sites with Images: `img:1` - Only show results from webpages that contain images.\n\nQuick Date Range (qdr):\n - `qdr:h` - Show results from the past hour.\n - `qdr:d` - Limit results to the past day.\n - `qdr:w` - Filter results from the week.\n - `qdr:m` - Display results from the past month.\n - `qdr:y` - Show results from the past year.\n - `qdr:h10`, `qdr:d10`, `qdr:w10`, `qdr:m10`, `qdr:y10` - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively.\n\nThese filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria.\n"
},
"safe": {
"enum": [
"active",
"off"
],
"type": "string",
"description": "Adult Content Filtering option."
},
"uule": {
"type": "string",
"description": "The encoded location parameter."
},
"start": {
"type": "number",
"description": "This parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page.\n\nFor Google Local Results, the start value must be in multiples of 20, such as 20 for the second page, 40 for the third page, etc.\n"
},
"domain": {
"type": "string",
"description": "Google domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`."
},
"filter": {
"type": "number",
"description": "Defines whether to enable or disable the filters for 'Similar Results' and 'Omitted Results'. Set to 1 (default) to enable these filters, or 0 to disable them.\n"
},
"location": {
"type": "string",
"description": "Google canonical location for the search."
}
},
"additionalProperties": false
}| uule | string | The encoded location parameter. |
| start | number | This parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 40 refers to the second page, and 80 to the third page. |
| domain | string | Google domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`. |
| shoprs | string | Specifies the helper ID for applying search filters. Must be used with the updated `q` parameter, which includes the selected filter (e.g., Coffee sale). To apply filters, use the `hasdata_link` from `filters[index].options[index]` in the JSON. Apply multiple filters by following each `hasdata_link` one by one. To remove a filter, follow its specific `hasdata_link`. |
| location | string | Google canonical location for the search. |
| deviceType | string | Specify the device type for the search. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Specify the search term for which you want to scrape the SERP."
},
"gl": {
"type": "string",
"description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
},
"hl": {
"type": "string",
"description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
},
"tbs": {
"type": "string",
"description": "This parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters:\n\n - Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021` - Filter results to show only those within the defined date range.\n - Sort by Date: `sbd:1` - Results are sorted by date, from the most recent to the oldest.\n - Sort by Relevance: `sbd:0` - Results are sorted by relevance to the search query.\n - Sites with Images: `img:1` - Only show results from webpages that contain images.\n\nQuick Date Range (qdr):\n - `qdr:h` - Show results from the past hour.\n - `qdr:d` - Limit results to the past day.\n - `qdr:w` - Filter results from the week.\n - `qdr:m` - Display results from the past month.\n - `qdr:y` - Show results from the past year.\n - `qdr:h10`, `qdr:d10`, `qdr:w10`, `qdr:m10`, `qdr:y10` - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively.\n\nThese filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria.\n"
},
"uule": {
"type": "string",
"description": "The encoded location parameter."
},
"start": {
"type": "number",
"description": "This parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 40 refers to the second page, and 80 to the third page.\n"
},
"domain": {
"type": "string",
"description": "Google domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`."
},
"shoprs": {
"type": "string",
"description": "Specifies the helper ID for applying search filters. Must be used with the updated `q` parameter, which includes the selected filter (e.g., Coffee sale).\n\nTo apply filters, use the `hasdata_link` from `filters[index].options[index]` in the JSON. Apply multiple filters by following each `hasdata_link` one by one.\n\nTo remove a filter, follow its specific `hasdata_link`.\n"
},
"location": {
"type": "string",
"description": "Google canonical location for the search."
},
"deviceType": {
"enum": [
"desktop",
"mobile",
"tablet"
],
"type": "string",
"description": "Specify the device type for the search."
}
},
"additionalProperties": false
}| tbs | string | Google advanced search filters, combined with commas. For example: - `qdr:h`, `qdr:d`, `qdr:w`, `qdr:m`, `qdr:y` - Show videos from the past hour, day, week, month, or year. |
| page | number | Page number for paginated results, where 0 is the first page. |
| uule | string | The encoded location parameter. |
| location | string | Google canonical location for the search. |
| deviceType | string | Specify the device type for the search. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Search query term for retrieving short videos results."
},
"cr": {
"type": "string",
"description": "The country code for the country you want to limit the search to. Provide one exact documented value (237 allowed), e.g. `countryAF`, `countryAL`."
},
"gl": {
"type": "string",
"description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
},
"hl": {
"type": "string",
"description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
},
"lr": {
"type": "array",
"items": {
"enum": [
"lang_ar",
"lang_hy",
"lang_bg",
"lang_ca",
"lang_cs",
"lang_da",
"lang_de",
"lang_el",
"lang_en",
"lang_es",
"lang_et",
"lang_tl",
"lang_fi",
"lang_fr",
"lang_hr",
"lang_hi",
"lang_hu",
"lang_id",
"lang_is",
"lang_it",
"lang_iw",
"lang_he",
"lang_ja",
"lang_ko",
"lang_lt",
"lang_lv",
"lang_nl",
"lang_no",
"lang_fa",
"lang_pl",
"lang_pt",
"lang_ro",
"lang_ru",
"lang_sk",
"lang_sl",
"lang_sr",
"lang_sv",
"lang_th",
"lang_tr",
"lang_uk",
"lang_vi",
"lang_zh-CN",
"lang_zh-TW"
],
"type": "string"
},
"description": "The 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content."
},
"tbs": {
"type": "string",
"description": "Google advanced search filters, combined with commas. For example:\n\n - `qdr:h`, `qdr:d`, `qdr:w`, `qdr:m`, `qdr:y` - Show videos from the past hour, day, week, month, or year.\n"
},
"page": {
"type": "number",
"description": "Page number for paginated results, where 0 is the first page."
},
"uule": {
"type": "string",
"description": "The encoded location parameter."
},
"location": {
"type": "string",
"description": "Google canonical location for the search."
},
"deviceType": {
"enum": [
"desktop",
"mobile",
"tablet"
],
"type": "string",
"description": "Specify the device type for the search."
}
},
"additionalProperties": false
}