Skip to main content
Serper logo
  • 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

Slug: SERPER_BATCH_SEARCH_WEBRun 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_GET_SEARCH_SUGGESTIONSReturn 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

string
required
Partial search query to complete.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize suggestions.
string
Two-letter lowercase country code for suggestions.
string
Two-letter lowercase language code for suggestions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_LIST_LOCATIONSFind canonical Serper location names and country codes for localizing search requests; this lookup is free.

Input Parameters

integer
Maximum number of matching locations to return (1-100).
string
Case-insensitive location prefix or term; omit to list locations from the start of the catalog.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_LIST_PLACE_REVIEWSReturn 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

string
Google business CID for the place; use exactly one place selector on the first page.
string ("most_relevant" | "newest" | "highest_rating" | "lowest_rating")
Order in which reviews are returned.
string
Opaque continuation cursor returned by a prior call. It retains the place selector and filters; omit the other inputs when continuing.
string
Google Place ID for the place; use exactly one place selector on the first page.
string
Google-assigned topic ID used to restrict reviews to one topic.
string
Google feature ID for the place; use exactly one place selector on the first page.
string
Two-letter lowercase country code used to localize review results.
string
Two-letter lowercase language code for review results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SCRAPE_WEBPAGEAsk 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

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.
Whether to include links found on the page.
boolean
Whether to include images found on the page.
boolean
Whether to include videos found on the page.
boolean
Whether to include page content converted to Markdown.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_IMAGESSearch 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

string
Image search terms. Required for the first page; a continuation cursor retains the original query.
string
Opaque continuation cursor returned by a prior call. It retains the original search inputs, so the cursor may be supplied by itself.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize results.
boolean
Whether Google may autocorrect the query.
string ("hour" | "day" | "week" | "month" | "year")
Restrict images to the selected recent time window.
string
Two-letter lowercase country code for Google results, such as us or gb.
integer ("10" | "100")
Requested results per page. Choose 100 only when the larger response is needed; it costs 2 credits instead of 1.
string
Two-letter language code for result text, such as en or fr.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_LENSReverse-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

string
Canonical location from SERPER_LIST_LOCATIONS used to localize results.
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.
string ("hour" | "day" | "week" | "month" | "year")
Optionally restrict visual matches to the selected recent time window.
string
Two-letter lowercase country code for Google Lens results.
string
Two-letter language code for Google Lens result text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_MAPSSearch 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

string
Google business CID to resolve directly; provide exactly one first-page selector.
string
Place or business search terms; provide exactly one of query, place_id, or cid on the first page.
string
Opaque continuation cursor returned by a prior call. It retains the search selectors, language, next page, and required map viewport.
string
Google Place ID to resolve directly; provide exactly one first-page selector.
string
Optional map viewport in @latitude,longitude,zoomz format with zoom from 3z through 21z.
string
Two-letter language code for place details, such as en or fr.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_NEWSSearch 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

string
News search terms. Required for the first page; a continuation cursor retains the original query.
string
Opaque continuation cursor returned by a prior call. Omit for the first page; it retains the original search inputs.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize results.
boolean
Whether Google may autocorrect the query.
string ("hour" | "day" | "week" | "month" | "year")
Restrict coverage to the selected recent time window.
string
Two-letter lowercase country code for Google News results.
string
Two-letter language code for article results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_PATENTSSearch 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

string
Patent search terms. Required for the first page; a continuation cursor retains the original query.
string
Opaque continuation cursor returned by a prior call. Omit it for the first page; it retains all original search inputs.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize results.
boolean
Whether Google may autocorrect the patent query.
string ("hour" | "day" | "week" | "month" | "year")
Restrict patent results to the selected recent time window.
string
Two-letter lowercase country code for Google Patents results.
string
Two-letter language code for patent result text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_PLACESSearch 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

string
Place or business search terms. Required for the first page; a continuation cursor retains the original query.
string
Opaque continuation cursor returned by a prior call. It retains the original search inputs and provider page number.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize results.
boolean
Whether Google may autocorrect the query.
string ("hour" | "day" | "week" | "month" | "year")
Restrict place results to the selected recent time window.
string
Two-letter lowercase country code for Google Places results.
string
Two-letter language code for result text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_SCHOLARSearch 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

string
Academic search terms. Required for the first page; a continuation cursor retains the original query.
string
Opaque continuation cursor returned by a prior call. Omit for the first page; it retains the original search inputs.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize results.
boolean
Whether Google may autocorrect the query.
string
Two-letter lowercase country code for Google Scholar results.
string
Two-letter language code for publication results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_SHOPPINGSearch 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

string
Product search terms. Required for the first page; a continuation cursor retains the original query.
string
Opaque continuation cursor returned by a prior call. It retains the original search inputs, so the cursor may be supplied by itself.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize products and offers.
boolean
Whether Google may autocorrect the query.
string
Two-letter lowercase country code for Shopping results.
string
Two-letter language code for Shopping results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_VIDEOSSearch 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

string
Video search terms. Required for the first page; a continuation cursor retains the original query.
string
Opaque continuation cursor returned by a prior call. It retains the original search inputs, so the cursor may be supplied by itself.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize results.
boolean
Whether Google may autocorrect the query.
string ("hour" | "day" | "week" | "month" | "year")
Restrict videos to the selected recent time window.
string
Two-letter lowercase country code for Google Video results.
string
Two-letter language code for video result text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SERPER_SEARCH_WEBSearch 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 searchesDiscount: 70

Input Parameters

string
Search terms. Required on the first page; a continuation cursor retains them.
string
Opaque continuation cursor returned by a prior call. It retains the original search inputs.
string
Canonical location from SERPER_LIST_LOCATIONS used to localize results.
boolean
Whether Google may autocorrect the query.
string ("hour" | "day" | "week" | "month" | "year")
Restrict results to the selected recent time window.
string
Two-letter lowercase country code for Google results, such as us or gb.
integer
Requested number of results for this page (1-100); the provider may return a different count.
string
Two-letter language code for result text, such as en or fr.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not