> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zenserp

> Zenserp is a real-time SERP API that extracts Google Search results in JSON format.

![Zenserp logo](https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/images/toolkits/zenserp.svg?fit=max\&auto=format\&n=11RkPhDhzt1wdr6a\&q=85\&s=dd46be8fc542e52409a12d26ac6962bd)

* **Category:** web search & research
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 12
* **Triggers:** 0
* **Slug:** `ZENSERP`
* **Version:** 20261014\_00

## Tools

> [accordion] Bing Search
>
> **Slug:** `ZENSERP_BING_SEARCH`
>
> Tool to obtain Bing search results. Use when you need real-time scraping of Bing SERPs from bing.com.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query; supports Bing operators
>
> **cc** `string`
>
> Two-letter country code (ISO 3166), e.g. 'US'
>
> **lat** `string`
>
> Latitude for geolocation override, e.g. '40.7128'
>
> **lon** `string`
>
> Longitude for geolocation override, e.g. '-74.0060'
>
> **mkt** `string`
>
> Market code for the request (per Bing market codes)
>
> **count** `integer`
>
> Number of results to return (1-50)
>
> **first** `integer`
>
> Zero-based offset for pagination (skip this many results)
>
> **location** `string`
>
> Canonical geolocation, e.g. 'New York,New York,United States'
>
> **search\_engine** `string`
>
> Must be 'bing.com' to target Bing search
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Shopping Product Details
>
> **Slug:** `ZENSERP_GET_SHOPPING_PRODUCT`
>
> Tool to retrieve detailed Google Shopping product page information by product\_id. Use when you need comprehensive product details including pricing, reviews, specifications, and seller information for a specific product.
>
> #### Input Parameters
>
> **gl** `string`
>
> Country code for search results (e.g., 'us', 'fr').
>
> **hl** `string`
>
> Web interface language code (e.g., 'en' for English, 'fr' for French).
>
> **location** `string`
>
> Geolocation used in the query. Use Google's canonical names for accurate results.
>
> **product\_id** `string` *required*
>
> The PID (product id) from Google Shopping Search. Use this to fetch detailed product page information.
>
> **search\_engine** `string`
>
> URL of the search engine to query. Override the default search engine domain.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get API Status
>
> **Slug:** `ZENSERP_GET_STATUS`
>
> Tool to check the remaining API requests for your API key. Use when you need to verify your Zenserp API quota.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Google Reverse Image Search
>
> **Slug:** `ZENSERP_GOOGLE_REVERSE_IMAGE_SEARCH`
>
> Tool to perform a reverse image search on Google. Use after obtaining a public image URL to find where the image appears online.
>
> #### Input Parameters
>
> **num** `integer`
>
> Number of results to return (1-100).
>
> **start** `integer`
>
> Zero-based offset for pagination.
>
> **image\_url** `string` *required*
>
> Public URL of the image to reverse search.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Zenserp Google Search
>
> **Slug:** `ZENSERP_GOOGLE_SEARCH`
>
> Tool to perform a standard Google search via Zenserp. Use when you need structured SERP data for a given query.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query; supports full Google search operators.
>
> **gl** `string`
>
> Country code for geolocation (e.g., 'us', 'fr').
>
> **hl** `string`
>
> Google interface language code, e.g., 'en'.
>
> **lr** `string`
>
> Language filter prefixed with 'lang\_', e.g., 'lang\_fr'.
>
> **lat** `number`
>
> Latitude for geolocation query.
>
> **lng** `number`
>
> Longitude for geolocation query.
>
> **num** `integer`
>
> Number of search results to return (1-100).
>
> **tbm** `string ("isch" | "nws" | "shop" | "lcl" | "vid")`
>
> Type of search: 'isch' for images, 'nws' for news, 'shop' for shopping, 'lcl' for maps, 'vid' for video.
>
> **start** `integer`
>
> Zero-based offset for pagination (use with num for pages).
>
> **device** `string ("desktop" | "mobile")`
>
> Device to emulate: 'desktop' or 'mobile'.
>
> **output** `string ("html" | "csv")`
>
> Raw export format: 'html' or 'csv'.
>
> **location** `string`
>
> Geolocation for the query (use canonical Google names or uule tokens).
>
> **timeframe** `string ("now 1-H" | "now 4-H" | "now 1-d" | "now 7-d" | "today 1-m" | "today 3-m" | "today 12-m" | "today 5-y")`
>
> Restrict results by timeframe: e.g., 'now 1-H', 'today 12-m'.
>
> **search\_engine** `string`
>
> Override search engine URL (e.g., 'google.com' for Google, 'youtube.com' for YouTube search).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Google Trends
>
> **Slug:** `ZENSERP_GOOGLE_TRENDS`
>
> Tool to retrieve Google Trends data. Use when comparing keyword popularity over time.
>
> #### Input Parameters
>
> **hl** `string`
>
> Interface language code (optional), e.g., 'en'.
>
> **cat** `string`
>
> Category filter code (optional). Use numeric codes defined by Google Trends.
>
> **geo** `string`
>
> Geographic location code (optional), e.g., 'US'.
>
> **type** `string ("images" | "news" | "youtube" | "shopping")`
>
> Property to compare (optional).
>
> **keywords** `array` *required*
>
> Keywords to compare in Google Trends. Provide as array 'keyword\[]'.
>
> **timeframe** `string ("now 1-H" | "now 4-H" | "now 1-d" | "now 7-d" | "today 1-m" | "today 3-m" | "today 12-m" | "today 5-y")`
>
> Timeframe for trends data (optional).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Batches
>
> **Slug:** `ZENSERP_LIST_BATCHES`
>
> Tool to list all submitted batches for your Zenserp API key. Use when you need to retrieve batch processing status or history.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Countries
>
> **Slug:** `ZENSERP_LIST_COUNTRIES`
>
> Tool to get the list of supported Google country (gl) parameters. Use when you need to know valid country codes for geolocation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Supported Languages
>
> **Slug:** `ZENSERP_LIST_LANGUAGES`
>
> Tool to get a list of supported Google interface language (hl) parameters. Use when you need to find valid language codes for Google search queries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Locations
>
> **Slug:** `ZENSERP_LIST_LOCATIONS`
>
> Tool to get a list of supported geo locations for search targeting. Use when you need to know which location parameters are available for geolocation queries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Search Engines
>
> **Slug:** `ZENSERP_LIST_SEARCH_ENGINES`
>
> Tool to get the list of supported search engines that can be queried via Zenserp. Use when you need to determine which search engine domains are available for searches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Yandex Search via Zenserp
>
> **Slug:** `ZENSERP_YANDEX_SEARCH`
>
> Tool to obtain Yandex search results via Zenserp API. Use when you need programmatic access to Yandex search data after constructing a query.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query string
>
> **gl** `string`
>
> Geographic location code (ISO 3166-1 alpha-2), e.g., 'us', 'ru'
>
> **hl** `string`
>
> Language code for results, e.g., 'en', 'ru'
>
> **num** `integer`
>
> Number of results to return (1-100)
>
> **tbm** `string`
>
> Type of search: 'isch' for images-only search
>
> **device** `string ("desktop" | "mobile")`
>
> Device type to emulate: 'desktop' or 'mobile'
>
> **location** `string`
>
> Search location, e.g., 'New York, USA'
>
> **search\_engine** `string`
>
> Must be 'yandex.com' to target Yandex search
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
