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

# Serper

> Serper provides real-time Google search results, place data, autocomplete suggestions, and webpage extraction through a structured API.

![Serper logo](https://mintcdn.com/composio-preview/B09iGux45A5cYDuO/images/toolkits/serper.svg?fit=max\&auto=format\&n=B09iGux45A5cYDuO\&q=85\&s=c8a00addd4c250d8433714dade8d31c8)

* **Category:** web search & research
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 15
* **Triggers:** 0
* **Slug:** `SERPER`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Batch Search the Web
>
> **Slug:** `SERPER_BATCH_SEARCH_WEB`
>
> Run 1-10 independent first-page Google web searches in one native Serper request. Each query costs 1 credit for 1-10 results or 2 credits for 11-100 results. Result envelopes preserve input order. Use SERPER\_SEARCH\_WEB separately when page continuation is needed.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.001 per credit (1 credit/query for 1-10 results; 2 credits/query for 11-100; 1-10 queries/batch)
>
> **Discount:** 70
>
> #### Input Parameters
>
> **queries** `array` *required*
>
> Independent first-page web searches to run in one native batch (1-10). Each item costs 1 credit for 1-10 results or 2 credits for 11-100 results.
>
> #### 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 Search Suggestions
>
> **Slug:** `SERPER_GET_SEARCH_SUGGESTIONS`
>
> Return Google autocomplete suggestions for a partial search query without running a full search.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** From \$0.001 per request.
>
> **Discount:** 70
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Partial search query to complete.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize suggestions.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for suggestions.
>
> **language\_code** `string`
>
> Two-letter lowercase language code for suggestions.
>
> #### 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:** `SERPER_LIST_LOCATIONS`
>
> Find canonical Serper location names and country codes for localizing search requests; this lookup is free.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of matching locations to return (1-100).
>
> **query** `string`
>
> Case-insensitive location prefix or term; omit to list locations from the start of the catalog.
>
> #### 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 Place Reviews
>
> **Slug:** `SERPER_LIST_PLACE_REVIEWS`
>
> Return paginated Google reviews for one place identified by Place ID, feature ID, or CID, with optional sorting and topic filtering.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** From \$0.001 per page of reviews.
>
> **Discount:** 70
>
> #### Input Parameters
>
> **cid** `string`
>
> Google business CID for the place; use exactly one place selector on the first page.
>
> **sort** `string ("most_relevant" | "newest" | "highest_rating" | "lowest_rating")`
>
> Order in which reviews are returned.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. It retains the place selector and filters; omit the other inputs when continuing.
>
> **place\_id** `string`
>
> Google Place ID for the place; use exactly one place selector on the first page.
>
> **topic\_id** `string`
>
> Google-assigned topic ID used to restrict reviews to one topic.
>
> **feature\_id** `string`
>
> Google feature ID for the place; use exactly one place selector on the first page.
>
> **country\_code** `string`
>
> Two-letter lowercase country code used to localize review results.
>
> **language\_code** `string`
>
> Two-letter lowercase language code for review results.
>
> #### 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] Scrape Webpage
>
> **Slug:** `SERPER_SCRAPE_WEBPAGE`
>
> Ask Serper to fetch one webpage and return extracted text, metadata, and optionally markdown, links, images, and videos. Costs 2 credits; difficult pages may cost 6 or 10 credits.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.001 per scrape credit (2, 6, or 10 per page)
>
> **Discount:** 70
>
> #### Input Parameters
>
> **url** `string` *required*
>
> HTTP or HTTPS webpage URL for Serper to fetch. Userinfo, localhost, and non-public literal IP hosts are rejected; DNS names are resolved by Serper.
>
> **include\_links** `boolean`
>
> Whether to include links found on the page.
>
> **include\_images** `boolean`
>
> Whether to include images found on the page.
>
> **include\_videos** `boolean`
>
> Whether to include videos found on the page.
>
> **include\_markdown** `boolean`
>
> Whether to include page content converted to Markdown.
>
> #### 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] Search Images
>
> **Slug:** `SERPER_SEARCH_IMAGES`
>
> Search Google Images and return one page of source pages, full image URLs, thumbnails, dimensions, and positions. Requesting 100 results costs 2 credits instead of 1.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.001 per image-search credits (100 results use 2 credits)
>
> **Discount:** 70
>
> #### Input Parameters
>
> **query** `string`
>
> Image search terms. Required for the first page; a continuation cursor retains the original query.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. It retains the original search inputs, so the cursor may be supplied by itself.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize results.
>
> **autocorrect** `boolean`
>
> Whether Google may autocorrect the query.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year")`
>
> Restrict images to the selected recent time window.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Google results, such as us or gb.
>
> **result\_count** `integer ("10" | "100")`
>
> Requested results per page. Choose 100 only when the larger response is needed; it costs 2 credits instead of 1.
>
> **language\_code** `string`
>
> Two-letter language code for result text, such as en or fr.
>
> #### 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] Search with Google Lens
>
> **Slug:** `SERPER_SEARCH_LENS`
>
> Reverse-search one public image URL with Google Lens and return visual matches. This action accepts no text query, result-count, or pagination input. Each request costs 3 credits and is subject to Serper's account-specific rate limit, advertised at up to 300 requests per second.
>
> #### Input Parameters
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize results.
>
> **image\_url** `string` *required*
>
> Public HTTP or HTTPS URL of the image to reverse-search. Userinfo, localhost-style names, and non-public literal IP hosts are rejected; other DNS names are resolved by Serper. This action accepts an image URL, not a text query.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year")`
>
> Optionally restrict visual matches to the selected recent time window.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Google Lens results.
>
> **language\_code** `string`
>
> Two-letter language code for Google Lens result text.
>
> #### 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] Search Maps
>
> **Slug:** `SERPER_SEARCH_MAPS`
>
> Search Google Maps by text, Place ID, or CID, optionally constrained to a viewport, and return one page of rich place identifiers and contact details. Charged per page.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.001 per map-search credits (3 per page)
>
> **Discount:** 70
>
> #### Input Parameters
>
> **cid** `string`
>
> Google business CID to resolve directly; provide exactly one first-page selector.
>
> **query** `string`
>
> Place or business search terms; provide exactly one of query, place\_id, or cid on the first page.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. It retains the search selectors, language, next page, and required map viewport.
>
> **place\_id** `string`
>
> Google Place ID to resolve directly; provide exactly one first-page selector.
>
> **map\_position** `string`
>
> Optional map viewport in @latitude,longitude,zoomz format with zoom from 3z through 21z.
>
> **language\_code** `string`
>
> Two-letter language code for place details, such as en or fr.
>
> #### 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] Search News
>
> **Slug:** `SERPER_SEARCH_NEWS`
>
> Search recent Google News coverage and return one page of article titles, links, sources, publication times, snippets, and images when available.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** From \$0.001 per news search.
>
> **Discount:** 70
>
> #### Input Parameters
>
> **query** `string`
>
> News search terms. Required for the first page; a continuation cursor retains the original query.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. Omit for the first page; it retains the original search inputs.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize results.
>
> **autocorrect** `boolean`
>
> Whether Google may autocorrect the query.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year")`
>
> Restrict coverage to the selected recent time window.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Google News results.
>
> **language\_code** `string`
>
> Two-letter language code for article results.
>
> #### 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] Search Patents
>
> **Slug:** `SERPER_SEARCH_PATENTS`
>
> Search Google Patents and return typed patent records and figures. Each page costs 1 credit and is subject to the connected Serper account's rate limit.
>
> #### Input Parameters
>
> **query** `string`
>
> Patent search terms. Required for the first page; a continuation cursor retains the original query.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. Omit it for the first page; it retains all original search inputs.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize results.
>
> **autocorrect** `boolean`
>
> Whether Google may autocorrect the patent query.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year")`
>
> Restrict patent results to the selected recent time window.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Google Patents results.
>
> **language\_code** `string`
>
> Two-letter language code for patent result text.
>
> #### 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] Search Places
>
> **Slug:** `SERPER_SEARCH_PLACES`
>
> Search Google Places and return one page of local businesses and places. Use this lower-priced text search for place discovery; use SERPER\_SEARCH\_MAPS for direct Place ID or CID lookup and map-viewport searches. Charged per request and subject to the account-specific rate limit, advertised at up to 300 requests per second.
>
> #### Input Parameters
>
> **query** `string`
>
> Place or business search terms. Required for the first page; a continuation cursor retains the original query.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. It retains the original search inputs and provider page number.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize results.
>
> **autocorrect** `boolean`
>
> Whether Google may autocorrect the query.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year")`
>
> Restrict place results to the selected recent time window.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Google Places results.
>
> **language\_code** `string`
>
> Two-letter language code for result text.
>
> #### 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] Search Scholar
>
> **Slug:** `SERPER_SEARCH_SCHOLAR`
>
> Search Google Scholar and return one page of academic publications with citation counts, publication metadata, snippets, and PDF links when available.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** From \$0.001 per scholar search.
>
> **Discount:** 70
>
> #### Input Parameters
>
> **query** `string`
>
> Academic search terms. Required for the first page; a continuation cursor retains the original query.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. Omit for the first page; it retains the original search inputs.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize results.
>
> **autocorrect** `boolean`
>
> Whether Google may autocorrect the query.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Google Scholar results.
>
> **language\_code** `string`
>
> Two-letter language code for publication results.
>
> #### 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] Search Shopping
>
> **Slug:** `SERPER_SEARCH_SHOPPING`
>
> Search Google Shopping and return one page of products, prices, merchants, offers, ratings, images, and product IDs. Each page costs 2 credits.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.001 per shopping-search credits (2 per page)
>
> **Discount:** 70
>
> #### Input Parameters
>
> **query** `string`
>
> Product search terms. Required for the first page; a continuation cursor retains the original query.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. It retains the original search inputs, so the cursor may be supplied by itself.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize products and offers.
>
> **autocorrect** `boolean`
>
> Whether Google may autocorrect the query.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Shopping results.
>
> **language\_code** `string`
>
> Two-letter language code for Shopping results.
>
> #### 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] Search Videos
>
> **Slug:** `SERPER_SEARCH_VIDEOS`
>
> Search Google Videos and return one page of titles, source links, thumbnail and video URLs, durations, channels, dates, and positions. Each request/page costs 1 credit and is subject to the account-specific rate limit advertised at up to 300 requests per second.
>
> #### Input Parameters
>
> **query** `string`
>
> Video search terms. Required for the first page; a continuation cursor retains the original query.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. It retains the original search inputs, so the cursor may be supplied by itself.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize results.
>
> **autocorrect** `boolean`
>
> Whether Google may autocorrect the query.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year")`
>
> Restrict videos to the selected recent time window.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Google Video results.
>
> **language\_code** `string`
>
> Two-letter language code for video result text.
>
> #### 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] Search the Web
>
> **Slug:** `SERPER_SEARCH_WEB`
>
> Search Google web results and return one page of organic links plus available answer, knowledge, question, related-search, and top-story sections.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.001 per credit used for web searches
>
> **Discount:** 70
>
> #### Input Parameters
>
> **query** `string`
>
> Search terms. Required on the first page; a continuation cursor retains them.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call. It retains the original search inputs.
>
> **location** `string`
>
> Canonical location from SERPER\_LIST\_LOCATIONS used to localize results.
>
> **autocorrect** `boolean`
>
> Whether Google may autocorrect the query.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year")`
>
> Restrict results to the selected recent time window.
>
> **country\_code** `string`
>
> Two-letter lowercase country code for Google results, such as us or gb.
>
> **result\_count** `integer`
>
> Requested number of results for this page (1-100); the provider may return a different count.
>
> **language\_code** `string`
>
> Two-letter language code for result text, such as en or fr.
>
> #### 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
