Search Google, images, news, maps, shopping, YouTube, jobs, hotels, flights and trends with Zenserp.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
Send a prompt to an AI answer engine (ChatGPT, Perplexity, Gemini or Copilot) and get its answer_text with citations; with brand it also reports whether and where that brand was cited. SPENDS quota at Zenserp's premium per-answer rate (see Zenserp pricing), is slow (seconds to a minute), and must not be repeated needlessly. Plan gate: Medium unlocks ChatGPT, Large adds Perplexity, Premium adds Gemini, Enterprise adds Copilot. GET /v1/answer-engine.
The answer engine to ask.
The question or prompt. prompt and additional_prompt together may hold at most 4,096 characters.
A brand name to track: the reply then has a brand_visibility object.
Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same.
Two-letter country code to localise the answer, e.g. us.
An optional follow-up prompt sent with the main one (counts toward the 4,096-character limit shared with prompt).
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Send a prompt to an AI answer engine (ChatGPT, Perplexity, Gemini or Copilot) and get its answer_text with citations; with brand it also reports whether and where that brand was cited. SPENDS quota at Zenserp's premium per-answer rate (see Zenserp pricing), is slow (seconds to a minute), and must not be repeated needlessly. Plan gate: Medium unlocks ChatGPT, Large adds Perplexity, Premium adds Gemini, Enterprise adds Copilot. GET /v1/answer-engine.
| Argument | Type | Description |
|---|---|---|
| brand | string | A brand name to track: the reply then has a brand_visibility object. |
| engine* | string | The answer engine to ask. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| prompt* | string | The question or prompt. prompt and additional_prompt together may hold at most 4,096 characters. |
| country | string | Two-letter country code to localise the answer, e.g. us. |
| additional_prompt | string | An optional follow-up prompt sent with the main one (counts toward the 4,096-character limit shared with prompt). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"engine",
"prompt"
],
"properties": {
"brand": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A brand name to track: the reply then has a brand_visibility object."
},
"engine": {
"enum": [
"chatgpt",
"perplexity",
"gemini",
"copilot"
],
"type": "string",
"description": "The answer engine to ask."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"prompt": {
"type": "string",
"maxLength": 4096,
"minLength": 1,
"description": "The question or prompt. prompt and additional_prompt together may hold at most 4,096 characters."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country code to localise the answer, e.g. us."
},
"additional_prompt": {
"type": "string",
"maxLength": 4096,
"minLength": 1,
"description": "An optional follow-up prompt sent with the main one (counts toward the 4,096-character limit shared with prompt)."
}
}
}Google Flights options. Best: origin and destination as 3-letter airport codes plus departure_date (dates and curr are honoured only then). A free-text q or a tfs string from a Google Flights URL also works. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v1/flights.
| Argument | Type | Description |
|---|---|---|
| q | string | Free-text flight query, used when no airport codes are given (no dates, no curr). |
| tfs | string | Google Flights search string copied from a Google Flights URL (full filters). |
| curr | string | 3-letter currency code for the prices, e.g. USD. |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| origin | string | Departure airport code, e.g. JFK. Name one airport, not a city. |
| destination | string | Arrival airport code, e.g. LHR. |
The number of search requests left on this Zenserp key's plan (remaining_requests). Free: it spends no quota. GET /v2/status.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Google Hotels offers for a hotel or place. Send check_in and check_out together, or Google falls back to today's rates. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v1/hotels.
| Argument | Type | Description |
|---|---|---|
| q* | string | Hotel name or place, e.g. 'hilton midtown new york'. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| adults | integer | Number of adults. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| check_in | string | Check-in date, yyyy-mm-dd. Needs check_out. |
Google image results (thumbnails, source pages, sizes). SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. Each page holds 100 images. GET /v2/search (tbm=isch).
| Argument | Type | Description |
|---|---|---|
| q* | string | The query. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| lr | string | Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr. |
| ijn | integer | Image page number, 100 images per page; per the docs, images 101-200 = ijn 2. Omit for the first page. |
| tbs | string | Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week). |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| start |
Google Jobs listings for a query (jobs_results: title, company, location, source, apply url). Google returns one page; there is no paging. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (ibp=htl;jobs).
| Argument | Type | Description |
|---|---|---|
| q* | string | The job query, e.g. 'php developer'. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
The supported country codes (values for gl). GET /v2/gl.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}The supported interface language codes (values for hl). GET /v2/hl.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}The search engine hosts Zenserp supports (values for search_engine). GET /v2/search_engines. The docs do not say whether helper lists are charged; they are not searches.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Google local/maps results: shops, cafes and other businesses with address, rating, phone and coordinates. Set location for accurate results. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (tbm=lcl).
| Argument | Type | Description |
|---|---|---|
| q* | string | The query. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| lr | string | Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr. |
| tbs | string | Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week). |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| start | integer | Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query. |
Google News results for a query: title, source, date, snippet. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (tbm=nws).
| Argument | Type | Description |
|---|---|---|
| q* | string | The query. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| lr | string | Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr. |
| tbs | string | Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week). |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| start | integer | Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query. |
| device |
Pages and sources that contain a given image (Google reverse image search). SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (image_url).
| Argument | Type | Description |
|---|---|---|
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| image_url* | string | Public URL of the image. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"image_url": {
"type": "string",
"pattern": "^https?:\\/\\/",
"maxLength": 2000,
"description": "Public URL of the image."
}
}
}Live search-engine result page as JSON: organic results, ads (paid_results), featured snippets, related questions and searches, knowledge graph. Google by default; set search_engine for Bing, Yandex or DuckDuckGo. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. ai_overview=true also returns Google's AI Overview and costs 3 requests when one is returned (Small plan or higher). GET /v2/search.
| Argument | Type | Description |
|---|---|---|
| q* | string | The query; search operators such as site: and intitle: work. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| lr | string | Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr. |
| tbs | string | Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week). |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| start |
The supported geo locations (values for location), as Google's canonical names. The list is long: pass query to keep only entries that contain it, and limit to cap the count. GET /v2/locations.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most entries returned (default 50). |
| query | string | Keep only entries whose text contains this (case-insensitive), e.g. 'vienna'. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Most entries returned (default 50)."
},
"query": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "Keep only entries whose text contains this (case-insensitive), e.g. 'vienna'."
}
}
}Product page data from Google Shopping: description, merchant offers, variations. product_id comes from zenserp_shopping_search. With gpc_id (from the same result) it returns the whole product cluster across merchants. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v1/shopping.
| Argument | Type | Description |
|---|---|---|
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| gpc_id | string | The Google Product Cluster id from the same search result (only valid together with its product_id). |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
| product_id* | string | The product id (PID) from a Google Shopping search result. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"gpc_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The Google Product Cluster id from the same search result (only valid together with its product_id)."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
},
"product_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The product id (PID) from a Google Shopping search result."
}
}
}Google Shopping listings for a query: product, price, merchant, rating, and the product_id for zenserp_shopping_product. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (tbm=shop).
| Argument | Type | Description |
|---|---|---|
| q* | string | The query. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| lr | string | Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr. |
| tbs | string | Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week). |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| start | integer | Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query. |
Trending searches from Google Trends for a country, optionally narrowed to given keywords or a category. Trending data covers at most the past 7 days. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v1/trends.
| Argument | Type | Description |
|---|---|---|
| cat | integer | Google Trends category id, e.g. 16 News, 7 Finance, 18 Shopping, 20 Sports, 5 Computers & Electronics, 45 Health. |
| geo | string | Country code, e.g. US. |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| keyword | array | Only trends matching these terms (and their related queries). A term that is not trending returns no rows. |
| timeframe | string | Window; longer ones all return the same 7-day window for trending searches. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cat": {
"type": "integer",
"maximum": 2000,
"minimum": 0,
"description": "Google Trends category id, e.g. 16 News, 7 Finance, 18 Shopping, 20 Sports, 5 Computers & Electronics, 45 Health."
},
"geo": {
"type": "string",
"pattern": "^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?$",
"description": "Country code, e.g. US."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"keyword": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 20,
"minItems": 1,
"description": "Only trends matching these terms (and their related queries). A term that is not trending returns no rows."
},
"timeframe": {
"enum": [
"now 1-H",
"now 4-H",
"now 1-d",
"now 7-d",
"today 1-m",
"today 3-m",
"today 12-m",
"today 5-y"
],
"type": "string",
"description": "Window; longer ones all return the same 7-day window for trending searches."
}
}
}Google video results for a query (title, channel, length, link). SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (tbm=vid).
| Argument | Type | Description |
|---|---|---|
| q* | string | The query. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| lr | string | Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr. |
| tbs | string | Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week). |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| start | integer | Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query. |
| device |
YouTube search results (videos, channels, ads) for a query, optionally by location. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (search_engine=youtube.com).
| Argument | Type | Description |
|---|---|---|
| q* | string | The query. |
| gl | string | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. |
| hl | string | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. |
| sp | string | YouTube 'sp' filter or pagination token, as used on youtube.com. |
| cache | boolean | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
| return_date |
| string |
| Return date, yyyy-mm-dd. Omit for one-way. |
| departure_date | string | Departure date, yyyy-mm-dd. Needs origin and destination. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Free-text flight query, used when no airport codes are given (no dates, no curr)."
},
"tfs": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Google Flights search string copied from a Google Flights URL (full filters)."
},
"curr": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "3-letter currency code for the prices, e.g. USD."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"origin": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Departure airport code, e.g. JFK. Name one airport, not a city."
},
"destination": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Arrival airport code, e.g. LHR."
},
"return_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Return date, yyyy-mm-dd. Omit for one-way."
},
"departure_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Departure date, yyyy-mm-dd. Needs origin and destination."
}
}
}| children |
| string |
| Ages of the children, comma separated, e.g. 4,9 (Google prices by age). |
| currency | string | 3-letter currency code for the prices, e.g. EUR. |
| check_out | string | Check-out date, yyyy-mm-dd; later than check_in. |
| free_cancellation | boolean | true = only properties with free cancellation. |
| accommodation_type | string | Restrict to hotels or vacation rentals. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Hotel name or place, e.g. 'hilton midtown new york'."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"adults": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Number of adults."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"check_in": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Check-in date, yyyy-mm-dd. Needs check_out."
},
"children": {
"type": "string",
"pattern": "^\\d{1,2}(,\\d{1,2}){0,9}$",
"description": "Ages of the children, comma separated, e.g. 4,9 (Google prices by age)."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "3-letter currency code for the prices, e.g. EUR."
},
"check_out": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Check-out date, yyyy-mm-dd; later than check_in."
},
"free_cancellation": {
"type": "boolean",
"description": "true = only properties with free cancellation."
},
"accommodation_type": {
"enum": [
"hotels",
"vacation_rentals"
],
"type": "string",
"description": "Restrict to hotels or vacation rentals."
}
}
}| integer |
| Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query. |
| device | string | Device to emulate. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The query."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"lr": {
"type": "string",
"pattern": "^lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?(\\|lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?){0,9}$",
"description": "Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr."
},
"ijn": {
"type": "integer",
"maximum": 30,
"minimum": 0,
"description": "Image page number, 100 images per page; per the docs, images 101-200 = ijn 2. Omit for the first page."
},
"tbs": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week)."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"start": {
"type": "integer",
"maximum": 990,
"minimum": 0,
"description": "Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query."
},
"device": {
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Device to emulate."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The job query, e.g. 'php developer'."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
}
}
}| device | string | Device to emulate. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The query."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"lr": {
"type": "string",
"pattern": "^lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?(\\|lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?){0,9}$",
"description": "Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr."
},
"tbs": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week)."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"start": {
"type": "integer",
"maximum": 990,
"minimum": 0,
"description": "Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query."
},
"device": {
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Device to emulate."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
}
}
}| string |
| Device to emulate. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The query."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"lr": {
"type": "string",
"pattern": "^lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?(\\|lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?){0,9}$",
"description": "Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr."
},
"tbs": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week)."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"start": {
"type": "integer",
"maximum": 990,
"minimum": 0,
"description": "Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query."
},
"device": {
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Device to emulate."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
}
}
}| integer |
| Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query. |
| device | string | Device to emulate. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
| ai_overview | boolean | true = also extract Google's AI Overview (3 requests when returned, otherwise 1; slower; Google only; Small plan or higher). |
| search_engine | string | Search engine host, e.g. google.com (default), google.de, bing.com, yandex.com, duckduckgo.com. zenserp_list_search_engines lists them. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The query; search operators such as site: and intitle: work."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"lr": {
"type": "string",
"pattern": "^lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?(\\|lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?){0,9}$",
"description": "Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr."
},
"tbs": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week)."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"start": {
"type": "integer",
"maximum": 990,
"minimum": 0,
"description": "Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query."
},
"device": {
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Device to emulate."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
},
"ai_overview": {
"type": "boolean",
"description": "true = also extract Google's AI Overview (3 requests when returned, otherwise 1; slower; Google only; Small plan or higher)."
},
"search_engine": {
"type": "string",
"pattern": "^(?:[a-z0-9-]+\\.)+[a-z]{2,24}$",
"description": "Search engine host, e.g. google.com (default), google.de, bing.com, yandex.com, duckduckgo.com. zenserp_list_search_engines lists them."
}
}
}| device | string | Device to emulate. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The query."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"lr": {
"type": "string",
"pattern": "^lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?(\\|lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?){0,9}$",
"description": "Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr."
},
"tbs": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week)."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"start": {
"type": "integer",
"maximum": 990,
"minimum": 0,
"description": "Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query."
},
"device": {
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Device to emulate."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
}
}
}| string |
| Device to emulate. |
| fields | array | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. |
| location | string | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The query."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"lr": {
"type": "string",
"pattern": "^lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?(\\|lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?){0,9}$",
"description": "Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr."
},
"tbs": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week)."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"start": {
"type": "integer",
"maximum": 990,
"minimum": 0,
"description": "Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query."
},
"device": {
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Device to emulate."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The query."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"sp": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "YouTube 'sp' filter or pagination token, as used on youtube.com."
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 30,
"minItems": 1,
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
},
"location": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
}
}
}