# Zenserp

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

- **Category:** ai web scraping
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `ZENSERP`
- **Version:** 20260313_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Search query; supports Bing operators |
| `cc` | string | No | Two-letter country code (ISO 3166), e.g. 'US' |
| `lat` | string | No | Latitude for geolocation override, e.g. '40.7128' |
| `lon` | string | No | Longitude for geolocation override, e.g. '-74.0060' |
| `mkt` | string | No | Market code for the request (per Bing market codes) |
| `count` | integer | No | Number of results to return (1-50) |
| `first` | integer | No | Zero-based offset for pagination (skip this many results) |
| `location` | string | No | Canonical geolocation, e.g. 'New York,New York,United States' |
| `search_engine` | string | No | Must be 'bing.com' to target Bing search |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `gl` | string | No | Country code for search results (e.g., 'us', 'fr'). |
| `hl` | string | No | Web interface language code (e.g., 'en' for English, 'fr' for French). |
| `location` | string | No | Geolocation used in the query. Use Google's canonical names for accurate results. |
| `product_id` | string | Yes | The PID (product id) from Google Shopping Search. Use this to fetch detailed product page information. |
| `search_engine` | string | No | URL of the search engine to query. Override the default search engine domain. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `num` | integer | No | Number of results to return (1-100). |
| `start` | integer | No | Zero-based offset for pagination. |
| `image_url` | string | Yes | Public URL of the image to reverse search. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Search query; supports full Google search operators. |
| `gl` | string | No | Country code for geolocation (e.g., 'us', 'fr'). |
| `hl` | string | No | Google interface language code, e.g., 'en'. |
| `lr` | string | No | Language filter prefixed with 'lang_', e.g., 'lang_fr'. |
| `lat` | number | No | Latitude for geolocation query. |
| `lng` | number | No | Longitude for geolocation query. |
| `num` | integer | No | Number of search results to return (1-100). |
| `tbm` | string ("isch" | "nws" | "shop" | "lcl" | "vid") | No | Type of search: 'isch' for images, 'nws' for news, 'shop' for shopping, 'lcl' for maps, 'vid' for video. |
| `start` | integer | No | Zero-based offset for pagination (use with num for pages). |
| `device` | string ("desktop" | "mobile") | No | Device to emulate: 'desktop' or 'mobile'. |
| `output` | string ("html" | "csv") | No | Raw export format: 'html' or 'csv'. |
| `location` | string | No | 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") | No | Restrict results by timeframe: e.g., 'now 1-H', 'today 12-m'. |
| `search_engine` | string | No | Override search engine URL (e.g., 'google.com' for Google, 'youtube.com' for YouTube search). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Google Trends

**Slug:** `ZENSERP_GOOGLE_TRENDS`

Tool to retrieve Google Trends data. Use when comparing keyword popularity over time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hl` | string | No | Interface language code (optional), e.g., 'en'. |
| `cat` | string | No | Category filter code (optional). Use numeric codes defined by Google Trends. |
| `geo` | string | No | Geographic location code (optional), e.g., 'US'. |
| `type` | string ("images" | "news" | "youtube" | "shopping") | No | Property to compare (optional). |
| `keywords` | array | Yes | 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") | No | Timeframe for trends data (optional). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Search query string |
| `gl` | string | No | Geographic location code (ISO 3166-1 alpha-2), e.g., 'us', 'ru' |
| `hl` | string | No | Language code for results, e.g., 'en', 'ru' |
| `num` | integer | No | Number of results to return (1-100) |
| `tbm` | string | No | Type of search: 'isch' for images-only search |
| `device` | string ("desktop" | "mobile") | No | Device type to emulate: 'desktop' or 'mobile' |
| `location` | string | No | Search location, e.g., 'New York, USA' |
| `search_engine` | string | No | Must be 'yandex.com' to target Yandex search |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |