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

# SerpApi

> SerpApi provides a real-time API for structured search engine results, allowing developers to scrape, parse, and analyze SERP data for SEO and research

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

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

## Tools

> [accordion] Amazon Search
>
> **Slug:** `SERPAPI_AMAZON_SEARCH`
>
> Search Amazon by keyword or category for products, prices, and ratings. Successful non-cached requests count against the plan; exact-query cache hits within one hour, errors, and failed searches do not. Throughput is the account's hourly plan limit. Speed-mode multipliers are Best Effort 1x, Ludicrous 2x, and Ludicrous Max 4x.
>
> #### Input Parameters
>
> **page** `integer`
>
> One-based result page.
>
> **sort** `string ("relevanceblender" | "price-asc-rank" | "price-desc-rank" | "review-rank" | "date-desc-rank" | "exact-aware-popularity-rank")`
>
> Result ordering, such as price-asc-rank or review-rank.
>
> **async** `boolean`
>
> Set true to submit asynchronously and retrieve the result with the Search Archive action. Cannot be combined with no\_cache or Ludicrous Speed.
>
> **query** `string`
>
> Amazon search query. Provide query or category\_node, not both.
>
> **device** `string ("desktop" | "tablet" | "mobile")`
>
> Browser device profile.
>
> **language** `string`
>
> Marketplace locale, such as en\_US.
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **delivery\_zip** `string`
>
> Destination postal code.
>
> **amazon\_domain** `string`
>
> Amazon marketplace domain.
>
> **category\_node** `string`
>
> Amazon category node. Provide category\_node or query, not both.
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> **attribute\_filters** `string`
>
> Comma-separated Amazon key:value filters, for example p\_72:1248897011.
>
> **shipping\_location** `string`
>
> Destination country.
>
> **disable\_autocorrect** `boolean`
>
> Exclude results from an auto-corrected query.
>
> #### 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 Baidu with Query
>
> **Slug:** `SERPAPI_BAIDU_SEARCH`
>
> Search Baidu (Chinese search engine) and retrieve search results. Requires a search query string in the 'q' parameter. Returns organic search results, answer boxes, and pagination info in JSON format.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **f** `string`
>
> Defines the originating search type. (e.g., "8" is a normal search, "3" is from the suggestion list, and "1" is a related search.
>
> **q** `string` *required*
>
> Defines the search query, including all Baidu search operators (e.g., `inurl:`, `site:`, `intitle:`, etc.).
>
> **bs** `string`
>
> Defines the previous search query.
>
> **ct** `string`
>
> Defines which language to restrict results. Available options: "1" (All languages), "2" (Simplified Chinese), "3" (Traditional Chinese).
>
> **oq** `string`
>
> Defines the original search query when navigated from a related search.
>
> **pn** `integer`
>
> Defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.). Must be a non-negative integer.
>
> **q5** `string`
>
> Similar to using `inurl:` or `intitle:`. (e.g., "1" to search by page title, "2" to search by web address.).
>
> **q6** `string`
>
> Similar to using `site:`. (e.g., `q6=serpapi.com` to search for results only from the domain `serpapi.com`)
>
> **rn** `integer`
>
> Parameter defines the maximum number of results to return, limited to 50. (e.g., 10 (default) returns 10 results, 30 returns 30 results, and 50 returns 50 results). This parameter is only available for desktop and tablet searches. Must be between 1 and 50.
>
> **gpc** `string`
>
> Parameter defines the time period for results. (e.g., `stf=1749303572,1749908372&#124;stftype=1` only returns results from the past 7 days. First integer within the parameter, `1749303572` is Unix Timestamp for 7 days ago. Second integer, `1749908372` is Unix Timestamp for now.).
>
> **async** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi. It can be set to `false` (default) to open an HTTP connection and keep it open until you got your search results, or `true` to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no\_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
>
> **device** `string`
>
> Parameter defines the device to use to get the results. It can be set to "desktop" (default) to use a regular browser, "tablet" to use a tablet browser (currently using iPads), or "mobile" to use a mobile browser (currently using iPhones).
>
> **output** `string`
>
> Parameter defines the final output you want. It can be set to json (default) to get a structured `JSON` of the results, or `html` to get the raw html retrieved.
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Baidu results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to `false` (default) to allow results from the cache, or `true` to disallow results from the cache. no\_cache and async parameters should not be used together.
>
> #### 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] Bing Maps Search
>
> **Slug:** `SERPAPI_BING_MAPS`
>
> Search Bing Maps via SerpApi for local businesses and places, using a required query and an optional place ID. Results may include addresses, phone numbers, ratings, reviews, and other location details.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query for Bing Maps (e.g., 'coffee', 'restaurants', 'hotels near Times Square'). Use specific location queries for better results.
>
> **cp** `string`
>
> GPS coordinates formatted as 'latitude~~longitude' (e.g., '40.7455096~~-74.0083012'). Specifies the center point for the search area.
>
> **count** `integer`
>
> Number of results per page (maximum 30). Controls how many results are returned.
>
> **first** `integer`
>
> Result offset for pagination (defaults to 0). Used to retrieve subsequent pages of results.
>
> **setlang** `string`
>
> 2-character ISO 3166-1 language code for localization (e.g., 'us', 'de', 'gb'). Sets the language for results.
>
> **no\_cache** `boolean`
>
> Set to true to bypass cached results and force a fresh API call.
>
> **place\_id** `string`
>
> Unique reference identifier for a specific location. Can be used independently of the q parameter to retrieve details about a specific place.
>
> #### 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] Bing Search
>
> **Slug:** `SERPAPI_BING_SEARCH`
>
> Retrieve Bing Search Engine Results via SerpAPI. Throttle to \~1–2 calls/second and apply exponential backoff on HTTP 429. Supports query, location, language, and device parameters. Set `location`, `mkt`, or `cc` explicitly when local relevance matters — result ranking is highly sensitive to localization.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> The search query string.
>
> **cc** `string`
>
> Parameter defines the country to search from. It follows the 2-character ISO\_3166-1 format. Example: 'us' for United States, 'de' for Germany, 'gb' for United Kingdom.
>
> **mkt** `string`
>
> The market where the results come from (e.g., 'en-US'). Format: language code-country code (case insensitive). Example: 'en-US' for English in United States, 'de-DE' for German in Germany, 'fr-FR' for French in France.
>
> **first** `integer`
>
> Controls pagination offset. Defaults to 1.
>
> **device** `string`
>
> Defines the device to use to get the results. Can be 'desktop' (default), 'tablet', or 'mobile'.
>
> **filters** `string`
>
> Enables complex filtering such as filtering by date range. Exact values can be constructed by using Bing search and copying the filters query parameter.
>
> **location** `string`
>
> Defines the location to use for the search. It can be a city, a state, a country, or a zip code. Uses a canonicalized name for the location. Example: "Austin, Texas, United States".
>
> **safeSearch** `string`
>
> Filtering levels for adult content. Can be 'Off', 'Moderate', or 'Strict'.
>
> #### 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] DuckDuckGo Light Search
>
> **Slug:** `SERPAPI_DUCK_DUCK_GO_LIGHT_SEARCH`
>
> Tool to access the world's fastest DuckDuckGo Search API via SerpApi. Scrapes DuckDuckGo search results in JSON format with critical data for faster response times, without extra-rich results. Use when you need quick DuckDuckGo search results with essential information. Supports location-based searches, date filtering, and pagination (15 results per page).
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query for DuckDuckGo. Maximum 500 characters. Supports DuckDuckGo search syntax including inurl:, site:, intitle:, etc.
>
> **df** `string`
>
> Date-based result filtering. Use 'd' (day), 'w' (week), 'm' (month), 'y' (year), or custom range format 'YYYY-MM-DD..YYYY-MM-DD'.
>
> **kl** `string`
>
> Region code in country-language format (e.g., 'us-en', NOT 'en-us'). Format: \[country-code]-\[language-code]. Examples: 'us-en' (US English), 'uk-en' (UK English), 'fr-fr' (France French), 'ca-en' (Canada English), 'ca-fr' (Canada French).
>
> **async** `boolean`
>
> Submit search asynchronously. Default: false. Incompatible with Ludicrous Speed tier. Should not be used with no\_cache parameter.
>
> **output** `string`
>
> Response format: 'json' (default) or 'html'.
>
> **no\_cache** `boolean`
>
> Force fresh results, bypassing cache. Default: false. Cache duration is 1 hour. Should not be used with async parameter.
>
> **zero\_trace** `boolean`
>
> Enterprise feature to skip storing search data. Default: false. Requires enterprise account.
>
> **next\_page\_token** `string`
>
> Pagination token for retrieving subsequent pages. Returns 15 results per page. Obtain from previous response's serpapi\_pagination object.
>
> #### 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] DuckDuckGo Maps search
>
> **Slug:** `SERPAPI_DUCK_DUCK_GO_MAPS`
>
> Scrapes DuckDuckGo Maps results via SerpApi. Use when searching for location-based information like businesses, restaurants, or services in a specific geographic area. Returns structured data including ratings, reviews, addresses, operating hours, and contact information.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query for DuckDuckGo Maps (e.g., 'Coffee', 'Italian restaurants', 'Hotels').
>
> **lat** `number`
>
> GPS latitude coordinate for the search center point. Must be used together with lon parameter. Cannot be used together with bbox parameter.
>
> **lon** `number`
>
> GPS longitude coordinate for the search center point. Must be used together with lat parameter. Cannot be used together with bbox parameter.
>
> **bbox** `string`
>
> Bounding box coordinates formatted as 'latitude\_tl,longitude\_tl,latitude\_br,longitude\_br' where tl=top-left and br=bottom-right. Cannot be used together with lat/lon parameters. Use this to constrain search results to a specific geographic area.
>
> **strict\_bbox** `integer`
>
> Controls strict bounding box adherence. Set to 1 (default/strict) to limit results strictly within the bbox, or 0 (off) to allow results outside the bbox boundaries. Only relevant when bbox parameter is used.
>
> #### 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] DuckDuckGo search
>
> **Slug:** `SERPAPI_DUCK_DUCK_GO_SEARCH`
>
> Performs a DuckDuckGo search via SerpApi to retrieve SERP data, including organic results, ads, and structured information. Results may be localized by region by default.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Search term or phrase for the DuckDuckGo 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] eBay Search
>
> **Slug:** `SERPAPI_EBAY_SEARCH`
>
> Search eBay product listings via SerpApi using keywords and optional location and marketplace settings. Results include at most three organic listings and three related searches; a page number can be specified to search other pages. Listing prices and fees may be incomplete or inconsistent, so verify the total cost on the source page.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **gl** `string`
>
> Country code for the search results.
>
> **hl** `string`
>
> Language for the search results.
>
> **nkw** `string` *required*
>
> The search query (keywords). This is a required parameter.
>
> **num** `integer`
>
> Number of results per page. Valid options: 25, 50 (default), 100, 200.
>
> **page** `integer`
>
> Page number for pagination. Starts at 1.
>
> **device** `string`
>
> Device type to simulate (e.g., desktop, mobile, tablet).
>
> **location** `string`
>
> The location for the search. Defines the location from where the search is performed.
>
> **ebay\_domain** `string`
>
> The specific eBay domain to search (e.g., ebay.com, ebay.co.uk).
>
> **ebay\_buyer\_country** `string`
>
> The country for which the results should be tailored.
>
> **ebay\_marketplace\_id** `string`
>
> The eBay marketplace ID (e.g., EBAY-US, EBAY-GB, EBAY-DE).
>
> #### 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 Google Events
>
> **Slug:** `SERPAPI_EVENT_SEARCH`
>
> Searches for events in Google Search's structured event results.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Search query for events, specifying the topic, type, or name.
>
> **start** `integer`
>
> Only 0 is supported. Google Search does not paginate event listings with this offset.
>
> #### 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 finance
>
> **Slug:** `SERPAPI_FINANCE_SEARCH`
>
> Retrieves structured financial information (e.g., company data, stock details, market trends, news) from Google Finance via SERP API based on a query. Empty results for delisted, illiquid, or newly listed assets are valid 'no data' responses. High query volumes may trigger HTTP 429 rate limits; apply backoff on retries.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **query** `string` *required*
>
> The financial search query. This can be a company name, stock ticker symbol (e.g., 'AAPL', 'GOOG'), or a broader financial topic (e.g., 'US stock market trends', 'latest fintech news'). Prefer exchange-prefixed ticker symbols (e.g., 'NASDAQ:AAPL') over company names alone — name-only queries may return empty or generic results, and common names can match multiple entities, leading to misattributed data.
>
> #### 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 SerpApi Account
>
> **Slug:** `SERPAPI_GET_ACCOUNT`
>
> Return plan, usage, remaining searches, renewal, throughput, and extra credits. This endpoint is free and does not consume search quota. Search requests count only when successful and not cached. Speed modes price at 1x, 2x, or 4x for Best Effort, Ludicrous, or Ludicrous Max; the returned hourly limit is the account rate limit.
>
> #### 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] Amazon Product
>
> **Slug:** `SERPAPI_GET_AMAZON_PRODUCT`
>
> Retrieve Amazon product details, variants, sellers, and related items by ASIN. Successful non-cached requests count against the plan; exact-query cache hits within one hour, errors, and failed searches do not. Throughput is the account's hourly plan limit. Speed-mode multipliers are Best Effort 1x, Ludicrous 2x, and Ludicrous Max 4x.
>
> #### Input Parameters
>
> **asin** `string` *required*
>
> Amazon Standard Identification Number.
>
> **async** `boolean`
>
> Set true to submit asynchronously and retrieve the result with the Search Archive action. Cannot be combined with no\_cache or Ludicrous Speed.
>
> **device** `string ("desktop" | "tablet" | "mobile")`
>
> Browser device profile.
>
> **language** `string`
>
> Marketplace locale, such as en\_US.
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **delivery\_zip** `string`
>
> Destination postal code.
>
> **amazon\_domain** `string`
>
> Amazon marketplace domain.
>
> **other\_sellers** `boolean`
>
> Include offers from other sellers.
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> **shipping\_location** `string`
>
> Destination country.
>
> **all\_related\_products** `boolean`
>
> Retrieve all related-product sections; this may be slower.
>
> #### 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 Location Options
>
> **Slug:** `SERPAPI_GET_AVAILABLE_LOCATION_OPTIONS_FOR_GOOGLE_SEARCHES`
>
> Tool to get available location options for Google searches. Returns location names, codes, and identifiers that can be used in the location parameter. Use when you need to find valid location values for search queries.
>
> #### Input Parameters
>
> **q** `string`
>
> Restricts your search to locations that contain the supplied string. For example, 'Austin' will find 'Austin, TX', 'The University of Texas at Austin', etc. If not provided, returns general location options.
>
> **limit** `integer`
>
> Limits the number of locations returned. Must be between 1 and 10. If not specified, returns all matching locations up to the maximum of 10.
>
> #### 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 Facebook profile information
>
> **Slug:** `SERPAPI_GET_FACEBOOK_PROFILE`
>
> Tool to retrieve public information from a Facebook profile or page using SerpAPI. Use when you need to fetch profile details, bio, photos, followers, ratings, or contact information.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **no\_cache** `boolean`
>
> Force SerpAPI to fetch fresh results instead of returning cached data. Set to true to bypass cache and get the most up-to-date information.
>
> **profile\_id** `string` *required*
>
> Facebook Profile ID or username to retrieve information for. Can be a numeric ID (e.g., '100080376596424') or a username (e.g., 'Meta'). This is the unique identifier for the Facebook profile or page.
>
> #### 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 Google About This Result
>
> **Slug:** `SERPAPI_GET_GOOGLE_ABOUT_THIS_RESULT`
>
> Tool to get Google 'About this result' information for a website. Use when you need detailed information about a specific URL including company details, social profiles, web citations, and reviews.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> URL of the website to get information about, formatted as 'About \<URL>' (e.g., 'About [https://www.starbucks.com/](https://www.starbucks.com/)')
>
> **async** `boolean`
>
> Submit search asynchronously (true) or wait for results (false, default). Defaults to false.
>
> **engine** `string`
>
> Must be set to 'google\_about\_this\_result' to use this engine.
>
> **output** `string`
>
> Output format: json (default) or html. When html is used, raw\_html\_content will be populated instead of structured results.
>
> **no\_cache** `boolean`
>
> Force SerpApi to fetch fresh results even if a cached version is already present.
>
> **google\_domain** `string`
>
> Google domain to use for the search. Defaults to google.com.
>
> #### 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 AI Overview
>
> **Slug:** `SERPAPI_GET_GOOGLE_AI_OVERVIEW`
>
> Retrieve the full AI Overview referenced by a fresh Google Search page token. Successful non-cached requests count against the plan; exact-query cache hits within one hour, errors, and failed searches do not. Throughput is the account's hourly plan limit. Speed-mode multipliers are Best Effort 1x, Ludicrous 2x, and Ludicrous Max 4x.
>
> #### Input Parameters
>
> **async** `boolean`
>
> Set true to submit asynchronously and retrieve the result with the Search Archive action. Cannot be combined with no\_cache or Ludicrous Speed.
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **page\_token** `string` *required*
>
> Fresh page token from the ai\_overview field of a Google Search response. Use it within one minute, before it expires.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> #### 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 Google Hotels Autocomplete
>
> **Slug:** `SERPAPI_GET_GOOGLE_HOTELS_AUTOCOMPLETE_SUGGESTIONS`
>
> Tool to get autocomplete suggestions for Google Hotels destination searches. Use when users need to search for hotel destinations, properties, or locations before performing a full hotel search.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query for destination autocomplete (e.g., 'New York', 'Paris hotels', 'Bali resorts'). The API returns matching hotel destinations, properties, and location suggestions.
>
> **gl** `string`
>
> Country code to use for the autocomplete search. It's a two-letter country code (e.g., 'us' for United States, 'uk' for United Kingdom, 'fr' for France). Default is 'us'.
>
> **hl** `string`
>
> Language code for the autocomplete results. It's a two-letter language code (e.g., 'en' for English, 'es' for Spanish, 'fr' for French). Default is 'en'.
>
> **async** `boolean`
>
> Submit search asynchronously and retrieve results later via Searches Archive API. Set to true for async mode.
>
> **currency** `string`
>
> Currency code for pricing information (e.g., 'USD', 'EUR', 'GBP'). Default is 'USD'.
>
> **no\_cache** `boolean`
>
> Forces SerpAPI to fetch fresh results even if a cached version exists. Set to true to bypass cache.
>
> #### 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 Google Images Related Content
>
> **Slug:** `SERPAPI_GET_GOOGLE_IMAGES_RELATED_CONTENT`
>
> Get related content for a specific Google Images result. Requires a related\_content\_id obtained from a Google Images search. Use when you need to find similar images or related visual content for a particular image.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string`
>
> Search query that matches the original Google Images search. Recommended to provide for better results.
>
> **gl** `string`
>
> Country code for the search results. Uses two-letter country codes.
>
> **hl** `string`
>
> Language code for the search results. Uses two-letter language codes.
>
> **async** `boolean`
>
> Submit the search asynchronously and retrieve results later via Search Archive API. Set to true for async mode, false for synchronous (default).
>
> **output** `string`
>
> Response format: 'json' (default) for structured JSON results, or 'html' for raw HTML content.
>
> **no\_cache** `boolean`
>
> Force fresh results by bypassing the SerpApi cache. Set to true to always fetch new results.
>
> **related\_content\_id** `string` *required*
>
> Unique ID for retrieving the Related Content of an image. This ID is obtained from the Google Images API response (from the 'related\_content\_id' field of an image result).
>
> #### 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 Jobs Listing
>
> **Slug:** `SERPAPI_GET_GOOGLE_JOB_EMPLOYER_RATINGS`
>
> Retrieve employer ratings for a job ID returned by Google Jobs Search. Successful non-cached requests count against the plan; one-hour exact-query cache hits, errors, and failures do not, and throughput is the hourly plan limit with speed-mode multipliers of 1x, 2x, and 4x.
>
> #### Input Parameters
>
> **async** `boolean`
>
> Set true to submit asynchronously and retrieve the result with the Search Archive action. Cannot be combined with no\_cache or Ludicrous Speed.
>
> **job\_id** `string` *required*
>
> Encoded job\_id from a Google Jobs Search result.
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> #### 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 Google Patent Details
>
> **Slug:** `SERPAPI_GET_GOOGLE_PATENT_DETAILS`
>
> Tool to retrieve detailed information about a specific patent or scholar document from Google Patents via SerpApi. Use when you need patent details, claims, citations, inventors, assignees, legal events, or scholar publication information.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **async** `boolean`
>
> Submit search asynchronously and retrieve results later via Search Archive API. Defaults to false.
>
> **output** `string`
>
> Output format. Only 'json' is supported.
>
> **no\_cache** `boolean`
>
> Force SerpApi to fetch fresh results even if cached version exists. Cache expires after 1 hour. Defaults to false.
>
> **patent\_id** `string` *required*
>
> The ID of the patent or scholar document to retrieve. Use format 'patent/\<publication\_number>/\<country\_code>' for patents (country code optional, e.g., 'patent/US11734097B1/en' or 'patent/US11734097B1') or 'scholar/\<scholar\_id>' for scholar documents.
>
> #### 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 Archive
>
> **Slug:** `SERPAPI_GET_SEARCH_ARCHIVE`
>
> Retrieve an archived search by its search ID, including status and modeled result fields when available. Searches can be retrieved up to 31 days after completion.
>
> #### Input Parameters
>
> **search\_id** `string` *required*
>
> The ID of the search to retrieve. This is returned from a previous async search (when async=true parameter was used). The search\_id can be found in the search\_metadata.id field of the async search response.
>
> #### 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] YouTube Video
>
> **Slug:** `SERPAPI_GET_YOUTUBE_VIDEO`
>
> Retrieve YouTube video metadata, chapters, comments, and related videos. Successful non-cached requests count against the plan; exact-query cache hits within one hour, errors, and failed searches do not. Throughput is the account's hourly plan limit. Speed-mode multipliers are Best Effort 1x, Ludicrous 2x, and Ludicrous Max 4x.
>
> #### Input Parameters
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **video\_id** `string` *required*
>
> YouTube video ID.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **country\_code** `string`
>
> Two-letter country code.
>
> **async\_request** `boolean`
>
> Submit asynchronously and retrieve the result from Search Archive.
>
> **language\_code** `string`
>
> YouTube interface language code.
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> **next\_page\_token** `string`
>
> Token for the next related-video, comment, or reply page.
>
> #### 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] YouTube Video Transcript
>
> **Slug:** `SERPAPI_GET_YOUTUBE_VIDEO_TRANSCRIPT`
>
> Retrieve timestamped transcript content for a YouTube video. Successful non-cached requests count against the plan; exact-query cache hits within one hour, errors, and failed searches do not. Throughput is the account's hourly plan limit. Speed-mode multipliers are Best Effort 1x, Ludicrous 2x, and Ludicrous Max 4x.
>
> #### Input Parameters
>
> **async** `boolean`
>
> Set true to submit asynchronously and retrieve the result with the Search Archive action. Cannot be combined with no\_cache or Ludicrous Speed.
>
> **title** `string`
>
> Exact transcript title when multiple tracks share a language.
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **video\_id** `string` *required*
>
> YouTube video ID.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **language\_code** `string`
>
> Requested transcript language code, such as en.
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> **transcript\_type** `string`
>
> Set to asr to select an auto-generated transcript.
>
> #### 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 Domains List
>
> **Slug:** `SERPAPI_GOOGLE_DOMAINS_LIST`
>
> Retrieve the list of supported Google domains for 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] Google Forums Search
>
> **Slug:** `SERPAPI_GOOGLE_FORUMS_SEARCH`
>
> Tool to scrape forum results from Google's Forums Platform using SerpApi. Use when you need to search forum discussions, get forum titles, dates, links, answers with voting data, and related searches.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Parameter defines the query you want to search in Google Forums.
>
> **gl** `string`
>
> Parameter defines the country to use for the Google Forums search. It's a two-letter country code.
>
> **hl** `string`
>
> Parameter defines the language to use for the Google Forums search interface. It's a two-letter language code.
>
> **nfpr** `integer`
>
> Parameter defines whether to exclude results from an auto-corrected query that is spelled wrong. Set to 0 to exclude auto-corrected results, 1 to include them.
>
> **uule** `string`
>
> Parameter is the Google encoded location you want to use for the search. uule and location parameters can't be used together.
>
> **start** `integer`
>
> Parameter defines the result offset for pagination. It skips the given number of results. It's used for pagination.
>
> **device** `string`
>
> Parameter defines the device type to use for the search. Options are: desktop (default), tablet, or mobile.
>
> **engine** `string`
>
> Set parameter to google\_forums to use the Google Forums API engine.
>
> **filter** `integer`
>
> Parameter defines whether to enable or disable the similar/omitted results filter. Set to 0 to disable, 1 to enable.
>
> **output** `string`
>
> Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.
>
> **location** `string`
>
> Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Cannot be used with uule parameter.
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Google Forums results even if a cached version is already present. Defaults to false.
>
> **async\_req** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi. Set to true for asynchronous submission. Defaults to false.
>
> **zero\_trace** `boolean`
>
> Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true.
>
> **json\_restrictor** `string`
>
> Parameter allows you to restrict specific output fields in the JSON response.
>
> #### 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 Jobs Search
>
> **Slug:** `SERPAPI_GOOGLE_JOBS_SEARCH`
>
> Retrieve Google Jobs search results via SerpApi, with pagination, location and remote-job filtering. The response retains at most two jobs per page; attributes such as salary and posting date may be absent from each job's detected extensions, and results may include stale postings.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Parameter defines the query you want to search.
>
> **gl** `string`
>
> Parameter defines the country to use for the Google search. It's a two-letter country code.
>
> **hl** `string`
>
> Parameter defines the language to use for the Google Jobs search. It's a two-letter language code.
>
> **uds** `string`
>
> Parameter enables to filter search. It's a string provided by Google as a filter.
>
> **lrad** `integer`
>
> Defines search radius in kilometers. Does not strictly limit the radius.
>
> **uule** `string`
>
> Parameter is the Google encoded location you want to use for the search. uule and location parameters can't be used together. Note: the resolved `location_used` in the response may differ from `location_requested`.
>
> **chips** `string`
>
> Parameter defines additional query conditions. Top of a job search page contains elements called chips, its values are extracted in order to be passed to chips parameter.
>
> **ltype** `integer`
>
> Parameter will filter the results by work from home. Set to 1 for work from home jobs.
>
> **engine** `string`
>
> Set parameter to google\_jobs to use the Google Jobs API engine.
>
> **output** `string`
>
> Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.
>
> **location** `string`
>
> Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. It is recommended to specify location at the city level in order to simulate a real user’s search.
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Google Jobs results even if a cached version is already present.
>
> **async\_req** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi.
>
> **zero\_trace** `boolean`
>
> Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true.
>
> **google\_domain** `string`
>
> Parameter defines the Google domain to use. It defaults to google.com.
>
> **next\_page\_token** `string`
>
> Parameter defines the next page token. It is used for retrieving the next page of results. Up to 10 results are returned per page.
>
> #### 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 Lens search
>
> **Slug:** `SERPAPI_GOOGLE_LENS_SEARCH`
>
> Performs reverse image search using Google Lens to find visually similar images, products, and related content. Use when you need to identify objects, find similar products, or get information about images. Requires a publicly accessible image URL.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string`
>
> Optional search query to refine results. Works with 'all', 'visual\_matches', or 'products' types.
>
> **hl** `string`
>
> Two-letter language code for localized results (e.g., 'en', 'es', 'fr', 'de').
>
> **url** `string` *required*
>
> The URL of an image to perform Google Lens visual search. Must be a publicly accessible image URL.
>
> **type** `string ("all" | "products" | "exact_matches" | "visual_matches")`
>
> Search type to filter results. Options: 'all' (default), 'products' (shopping results), 'exact\_matches' (identical images), 'visual\_matches' (similar images).
>
> **country** `string`
>
> Two-letter country code for localized results (e.g., 'us', 'uk', 'ca').
>
> #### 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 Light Search
>
> **Slug:** `SERPAPI_GOOGLE_LIGHT_SEARCH`
>
> Retrieve Google Light Search Results via SerpApi. Supports q, location, gl, hl, and other SERP parameters. Returns lightweight JSON SERP data; results are in organic\_results (handle missing/empty gracefully). Snippets are shallow — follow citation URLs with BROWSER\_TOOL\_FETCH\_WEBPAGE for full content. Rate limit: HTTP 429 under heavy use; keep to \~1–2 requests/sec with exponential backoff on retry.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Parameter defines the query you want to search. You can use anything that you would use in a regular Google search.
>
> **gl** `string`
>
> Parameter defines the country to use for the Google search. It's a two-letter country code. Example: "us" for United States.
>
> **hl** `string`
>
> Parameter defines the language to use for the Google search. It's a two-letter language code. Example: "en" for English.
>
> **lr** `string`
>
> Parameter defines one or multiple languages to limit the search to. Example: "lang\_fr|lang\_de" for French or German.
>
> **num** `integer`
>
> Parameter defines the maximum number of results to return. (e.g., `10` (default) returns 10 results, `40` returns 40 results, and `100` returns 100 results). Maximum value is `100`.
>
> **nfpr** `string`
>
> Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to `1` to exclude results or `0` to include them. Defaults to `0`.
>
> **safe** `string`
>
> Parameter defines the level of filtering for adult content. It can be set to `active` or `off`. `active` is the highest level of filtering. `off` turns off filtering. Defaults to `off`.
>
> **uule** `string`
>
> Parameter is the Google encoded location you want to use for the search. Example: "w+CAIQICIHVG9yb250bw==" for Toronto.
>
> **start** `integer`
>
> Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., `0` (default) is the first page of results, `10` is the 2nd page of results, `20` is the 3rd page of results, etc.).
>
> **device** `string`
>
> Parameter defines the device to use to get the results. It can be set to `desktop`, `tablet`, or `mobile`. Defaults to `desktop`.
>
> **engine** `string`
>
> Set parameter to `google_light` to use the Google Light API engine.
>
> **filter** `string`
>
> Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to `0` to turn off filtering or `1` to turn on filtering. Defaults to `1`.
>
> **output** `string`
>
> Parameter defines the final output format. It can be set to 'json' (default) to get structured JSON results, or 'html' to get raw HTML retrieved from Google. When 'html' is used, the response will contain raw\_html\_content instead of structured search results.
>
> **location** `string`
>
> Parameter defines from where you want the search to originate. Example: "Austin, Texas, United States".
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Google Light results even if a cached version is already present.
>
> **zero\_trace** `boolean`
>
> Enterprise only. Parameter enables ZeroTrace mode. It can be set to `true` to enable ZeroTrace or `false` to disable it. Defaults to `false`.
>
> **async\_param** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi. It can be set to `true` to run the search asynchronously or `false` to run it synchronously. Defaults to `false`.
>
> **google\_domain** `string`
>
> Parameter defines the Google domain to use. It defaults to `google.com`.
>
> #### 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 Maps Posts
>
> **Slug:** `SERPAPI_GOOGLE_MAPS_POSTS`
>
> Scrapes Google Maps Posts for a business location via SerpApi. Extracts local posts published by business owners including titles, descriptions, links, images, and publication dates. Returns 10 posts per page with pagination support.
>
> #### Input Parameters
>
> **data\_id** `string` *required*
>
> The Google Maps data ID for the business location. This is required to identify which business's posts to retrieve. Format: '0x89c258e28c304997:0xfcafe4e7ce35ee8c'
>
> **no\_cache** `boolean`
>
> Force fresh results by bypassing cached data. Default is false. Note: Cached results don't consume monthly search quotas.
>
> **next\_page\_token** `string`
>
> Token for pagination to retrieve subsequent result pages. Each page contains 10 posts. Use the token from serpapi\_pagination in the previous response.
>
> #### 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 maps search
>
> **Slug:** `SERPAPI_GOOGLE_MAPS_SEARCH`
>
> Performs a Google Maps search via SERP API. Takes a query, optionally using specific GPS coordinates and pagination, returning structured location data.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query for Google Maps (e.g., 'coffee shops', 'restaurants near Central Park').
>
> **ll** `string`
>
> GPS coordinates for the search, formatted as '@latitude,longitude,zoom\_level'. Required when using pagination (start parameter). If unspecified and start is not provided, search may be less geographically specific or use a default location. Results are strictly viewport-bound to the area defined by the coordinates and zoom level; adjust coordinates and paginate via `start` to cover adjacent areas.
>
> **start** `integer`
>
> Starting result index for pagination, used to get subsequent pages of results. When start is provided, ll parameter becomes required. For the first page, omit start (or use start=0 only if ll is also provided).
>
> #### 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 Play Product Search
>
> **Slug:** `SERPAPI_GOOGLE_PLAY_PRODUCT`
>
> Tool to retrieve detailed Google Play product information using SerpApi. Supports apps, movies, TV shows, audiobooks, and books. Use when you need product details, ratings, reviews, or media for Google Play Store items.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **gl** `string`
>
> Two-letter country code for localization. Defaults to 'us'.
>
> **hl** `string`
>
> Two-letter language code for localization. Defaults to 'en'.
>
> **num** `integer`
>
> Maximum number of reviews per search. Max 199, default 40.
>
> **async** `boolean`
>
> Submit search asynchronously. Defaults to false.
>
> **store** `string ("apps" | "movies" | "tv" | "books" | "audiobooks")` *required*
>
> Store type: 'apps', 'movies', 'tv', 'books', or 'audiobooks'.
>
> **engine** `string`
>
> Set parameter to `google_play_product` to use the Google Play Product API engine.
>
> **output** `string ("json" | "html")`
>
> Response format: 'json' (default) or 'html'.
>
> **rating** `integer ("1" | "2" | "3" | "4" | "5")`
>
> Filter reviews by star rating (1-5).
>
> **sort\_by** `integer ("1" | "2" | "3")`
>
> Sort reviews: 1 (relevant), 2 (newest), 3 (rating).
>
> **no\_cache** `boolean`
>
> Bypass cache and force fresh results. Defaults to false.
>
> **platform** `string ("phone" | "tablet" | "watch" | "chromebook" | "tv")`
>
> Filter reviews by device type: 'phone', 'tablet', 'watch', 'chromebook', or 'tv'.
>
> **season\_id** `string`
>
> Season ID when store is 'tv'. Only applicable for TV store.
>
> **product\_id** `string` *required*
>
> Product ID to query (e.g., 'com.google.android.youtube' for apps).
>
> **all\_reviews** `boolean`
>
> Retrieve all reviews (true/false). Set to true to fetch all available reviews.
>
> **next\_page\_token** `string`
>
> Pagination token for retrieving additional 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] Google Scholar Author Profile
>
> **Slug:** `SERPAPI_GOOGLE_SCHOLAR_AUTHOR`
>
> Scrapes full Google Scholar Author page including articles, citations, metrics, and co-authors. Use when you need detailed information about a specific researcher's publications and academic profile.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **hl** `string`
>
> Two-letter language code for the interface language (e.g., 'en' for English, 'es' for Spanish).
>
> **num** `integer`
>
> Number of results per page. Maximum 100, defaults to 20.
>
> **sort** `string`
>
> Sort articles by 'title' or 'pubdate'. Default is by citation count.
>
> **start** `integer`
>
> Result offset for pagination. Defaults to 0.
>
> **view\_op** `string`
>
> View specific sections. Use 'view\_citation' to view a specific citation or 'list\_colleagues' to list colleagues.
>
> **no\_cache** `boolean`
>
> Force fresh results, ignoring cached data. Set to true to bypass cache.
>
> **author\_id** `string` *required*
>
> Unique identifier of the author from Google Scholar. Required to fetch the author's profile.
>
> **citation\_id** `string`
>
> Required when view\_op='view\_citation'. Unique identifier for the specific citation to view.
>
> #### 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 Scholar Cite
>
> **Slug:** `SERPAPI_GOOGLE_SCHOLAR_CITE`
>
> Scrapes full Google Scholar Citations with multiple citation formats. Retrieves MLA, APA, Chicago, Harvard, and Vancouver style citations along with download links for BibTeX, EndNote, RefMan, and RefWorks. Use when you need formatted citations for a specific research paper identified by its Google Scholar ID.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> The ID of an individual Google Scholar organic search result. This is required to fetch citation information for a specific paper.
>
> **hl** `string`
>
> Two-letter language code for localization (e.g., 'en' for English, 'es' for Spanish, 'fr' for French).
>
> **no\_cache** `boolean`
>
> Force fresh results, ignoring cached data. Set to true to bypass cache (cache expires after 1 hour).
>
> #### 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 Videos Light Search
>
> **Slug:** `SERPAPI_GOOGLE_VIDEOS_LIGHT`
>
> Tool to scrape Google Videos results using SerpApi's ultra-fast Google Videos Light API. Use when you need video titles, links, thumbnails, snippets, upload dates, and durations from Google Videos search. This lighter version excludes rich results for faster response times.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query for Google Videos. Supports advanced operators like inurl:, site:, intitle:.
>
> **gl** `string`
>
> Two-letter country code to define the country for the search.
>
> **hl** `string`
>
> Two-letter language code to define the language for the search interface.
>
> **lr** `string`
>
> Language restrictions using lang\_\{code} format, delimited by pipe |.
>
> **tbs** `string`
>
> Advanced search parameters for filtering by video duration, upload date, quality, or source.
>
> **nfpr** `integer`
>
> Exclude auto-corrected results. Set to 1 to exclude, 0 to include. Defaults to 0.
>
> **safe** `string`
>
> Adult content filter. Set to 'active' to filter adult content or 'off' to disable.
>
> **uule** `string`
>
> Google-encoded location parameter. Cannot be used with location parameter.
>
> **start** `integer`
>
> Result offset for pagination. Use 0 for page 1, 10 for page 2, etc.
>
> **device** `string`
>
> Device type for the search. Options: desktop (default), tablet, mobile.
>
> **engine** `string`
>
> Set parameter to google\_videos\_light to use the Google Videos Light API engine.
>
> **filter** `integer`
>
> Control Similar Results filter. Set to 1 to enable (default), 0 to disable.
>
> **output** `string`
>
> Output format. Set to json (default) for structured JSON or html for raw HTML.
>
> **location** `string`
>
> Geographic location for the search origin. Recommended to specify at city level. Cannot be used with uule parameter.
>
> **no\_cache** `boolean`
>
> Force fresh results even if cached version exists. Defaults to false.
>
> **async\_req** `boolean`
>
> Enable asynchronous submission mode. Defaults to false (maintains connection).
>
> **zero\_trace** `boolean`
>
> Enterprise only. Enable ZeroTrace mode. Defaults to false.
>
> **google\_domain** `string`
>
> Google domain to use for the search. Defaults to google.com.
>
> **json\_restrictor** `string`
>
> Restrict specific output fields in the JSON response for smaller payload size.
>
> #### 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] Hotel Search
>
> **Slug:** `SERPAPI_HOTEL_SEARCH`
>
> Search Google Hotels via SerpApi using a query and check-in and check-out dates, or retrieve property details with a property token. Search results contain at most three properties, each reduced to its name and property token; property details contain selected fields.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Parameter defines the search query. You can use anything that you would use in a regular Google Hotels search.
>
> **gl** `string`
>
> Parameter defines the country to use for the Google Hotels search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France)
>
> **hl** `string`
>
> Parameter defines the language to use for the Google Hotels search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French).
>
> **async** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi.
>
> **adults** `integer`
>
> Parameter defines the number of adults. Default to 2.
>
> **output** `string`
>
> Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.
>
> **rating** `integer`
>
> Parameter is used for filtering the results to certain rating.
>
> **sort\_by** `string`
>
> Parameter is used for sorting the results. Default is sort by Relevance.
>
> **bedrooms** `integer`
>
> Parameter defines the minimum number of bedrooms. Default to 0.
>
> **children** `integer`
>
> Parameter defines the number of children. Default to 0.
>
> **currency** `string`
>
> Parameter defines the currency of the returned prices. Default to USD.
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Google Hotels results even if a cached version is already present.
>
> **amenities** `string`
>
> Parameter defines to include only results that offer specified amenities.
>
> **bathrooms** `integer`
>
> Parameter defines the minimum number of bathrooms. Default to 0.
>
> **max\_price** `integer`
>
> Parameter defines the upper bound of price range.
>
> **min\_price** `integer`
>
> Parameter defines the lower bound of price range.
>
> **zero\_trace** `boolean`
>
> Enterprise only. Parameter enables ZeroTrace mode.
>
> **check\_in\_date** `string` *required*
>
> Parameter defines the check-in date. The format is YYYY-MM-DD.
>
> **children\_ages** `string`
>
> Parameter defines the ages of children. The age range is from 1 to 17, with children who haven't reached 1 year old being considered as 1.
>
> **eco\_certified** `boolean`
>
> Parameter defines to show results that are eco certified.
>
> **check\_out\_date** `string` *required*
>
> Parameter defines the check-out date. The format is YYYY-MM-DD.
>
> **property\_token** `string`
>
> Parameter is used to get property details which consists of name, address, phone, prices, nearby places, and etc.
>
> **property\_types** `string`
>
> Parameter defines to include only certain type of property in the results.
>
> **special\_offers** `boolean`
>
> Parameter defines to show results that have special offers.
>
> **next\_page\_token** `string`
>
> Parameter defines the next page token. It is used for retrieving the next page results.
>
> **vacation\_rentals** `boolean`
>
> Parameter defines to search for Vacation Rentals results. Default search is for Hotels.
>
> **free\_cancellation** `boolean`
>
> Parameter defines to show results that offer free cancellation.
>
> #### 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] Image search
>
> **Slug:** `SERPAPI_IMAGE_SEARCH`
>
> Searches Google Images via SERP API for a given query, returning structured image results. The number of results can be controlled using the 'num' parameter (1-100). If not specified, it defaults to 20 results.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **num** `integer`
>
> Number of image results to return. Defaults to 20 if not specified. Google typically returns up to 100 results.
>
> **query** `string` *required*
>
> Query to find images; be specific about the topic or subject. Avoid single-word or vague queries; combine subject, style, context, and audience details for precise 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] Google Maps Reviews
>
> **Slug:** `SERPAPI_LIST_GOOGLE_MAPS_REVIEWS`
>
> Retrieve Google Maps place reviews, topics, place data, and pagination. Successful non-cached requests count against the plan; exact-query cache hits within one hour, errors, and failed searches do not. Throughput is the account's hourly plan limit. Speed-mode multipliers are Best Effort 1x, Ludicrous 2x, and Ludicrous Max 4x.
>
> #### Input Parameters
>
> **async** `boolean`
>
> Set true to submit asynchronously and retrieve the result with the Search Archive action. Cannot be combined with no\_cache or Ludicrous Speed.
>
> **query** `string`
>
> Text used to filter reviews; incompatible with topic\_id.
>
> **data\_id** `string`
>
> Google Maps data ID. Provide data\_id or place\_id.
>
> **sort\_by** `string ("qualityScore" | "newestFirst" | "ratingHigh" | "ratingLow")`
>
> Review ordering.
>
> **language** `string`
>
> Two-letter review language code.
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **place\_id** `string`
>
> Google Maps place ID. Provide place\_id or data\_id.
>
> **topic\_id** `string`
>
> Topic ID used to filter reviews; incompatible with query.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **review\_count** `integer`
>
> Maximum reviews on eligible filtered or subsequent pages (1-20).
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> **next\_page\_token** `string`
>
> Token from serpapi\_pagination.next\_page\_token.
>
> #### 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] Naver Search
>
> **Slug:** `SERPAPI_NAVER_SEARCH`
>
> Search Naver for Korean web content, news, videos, and shopping results. Supports search categories and filters including time periods and sorting.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **num** `integer`
>
> Maximum results per page (1-100, default 50). Only available for Images API. Use when limiting image search results.
>
> **page** `integer`
>
> Page number (starts at 1). Automatically calculates the start parameter. Use for easier pagination instead of manually calculating start offset.
>
> **async** `boolean`
>
> Submit search asynchronously when true. Retrieve results later via Search Archive API. Cannot be used with no\_cache or on accounts with Ludicrous Speed enabled.
>
> **query** `string` *required*
>
> Search query string supporting operators like NOT, OR, site:, filetype:, near:, ip:, loc:, feed:. Use when searching Naver for Korean web results and content.
>
> **start** `integer`
>
> Results offset for pagination. Defaults to 1. Formula: (page \* 10) - 9 for most searches; (page \* 15) - 29 for web results. Use when fetching subsequent pages.
>
> **where** `string`
>
> Search category to use. Options: 'nexearch' (integrated search, default), 'web', 'video', 'news', 'image'. Use 'nexearch' for comprehensive results or specify category for targeted searches.
>
> **device** `string`
>
> Device type to simulate. Options: 'desktop' (default), 'tablet', or 'mobile'. Use to get device-specific search results.
>
> **output** `string`
>
> Output format. Options: 'json' (default, structured data) or 'html' (raw HTML). Use json for programmatic access.
>
> **period** `string`
>
> Time period filter. Options: 'all' (default), '1h', '1d', '1w', '1m', '3m', '6m', '1y', or custom format 'fromYYYYMMDDtoYYYYMMDD'. Use when searching for recent content.
>
> **sort\_by** `string`
>
> Sort order for results. Options: 'r' (relevance, default) or 'dd' (latest/date descending). Use 'dd' when freshness matters.
>
> **no\_cache** `boolean`
>
> Force fresh results when true, bypassing 1-hour cache. Cached searches are free. Set to true only when latest data is critical. Cannot be used with async parameter.
>
> #### 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 for news articles
>
> **Slug:** `SERPAPI_NEWS_SEARCH`
>
> Search Google news results via SerpApi for articles matching a query. Results are returned in the results object, with pagination supported by offset and result count.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **num** `integer`
>
> Maximum number of results to return per page. Default is 10, maximum is 100.
>
> **query** `string` *required*
>
> Search query for finding relevant news articles. Overly long or overly specific queries may return empty results; simplify to key phrases and split multi-concept searches into separate queries.
>
> **start** `integer`
>
> Result offset for pagination. Use 0 for the first page (default), 10 for the second page, 20 for the third, etc.
>
> #### 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] OpenTable Reviews Search
>
> **Slug:** `SERPAPI_OPEN_TABLE_REVIEWS`
>
> Tool to scrape OpenTable restaurant reviews using SerpApi. Retrieves user reviews, ratings, restaurant responses, images, and AI-generated summaries. Use when you need detailed review data for OpenTable restaurants.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-based indexing).
>
> **async** `boolean`
>
> Submit search asynchronously. Defaults to false.
>
> **output** `string ("json" | "html")`
>
> Response format: 'json' (default) or 'html'.
>
> **no\_cache** `boolean`
>
> Force fresh results by bypassing cache. Defaults to false.
>
> **place\_id** `string` *required*
>
> OpenTable restaurant ID (e.g., 'central-park-boathouse-new-york-2'). Found in the OpenTable URL after /r/.
>
> **zero\_trace** `boolean`
>
> Enterprise feature to skip storing search data. Defaults to false.
>
> **json\_restrictor** `string`
>
> Restrict output fields for smaller responses (e.g., 'reviews').
>
> **open\_table\_domain** `string`
>
> OpenTable domain to use. Defaults to '[www.opentable.com](http://www.opentable.com)'.
>
> #### 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 Play Search
>
> **Slug:** `SERPAPI_PLAY_SEARCH`
>
> Retrieve Google Play Store search results in JSON, with query, country, language, category, chart, and pagination options.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string`
>
> Parameter defines the query you want to search in Google Play Apps Store.
>
> **hl** `string`
>
> Parameter defines the language to use for the Google Play search. It's a two-letter language code. (e.g., `en` (default) for English, `es` for Spanish, or `fr` for French).
>
> **age** `string`
>
> Parameter defines age subcategory. age works, and should only be used with apps\_category=FAMILY (Kids Apps)
>
> **chart** `string`
>
> Parameter is used for showing top charts. It can return up to `50` results.
>
> **store** `string`
>
> Parameter defines the country to use for the Google Play search. It's a two-letter country code. (e.g., `us` (default) for the United States, `uk` for United Kingdom, or `fr` for France).
>
> **engine** `string`
>
> Set parameter to `google_play` to use the Google Play API engine.
>
> **output** `string`
>
> Parameter defines the final output you want. It can be set to json (default) to get a structured `JSON` of the results, or `html` to get the raw html retrieved.
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Google Play results even if a cached version is already present.
>
> **async\_param** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi.
>
> **store\_device** `string`
>
> Parameter defines the device for sorting results. This parameter cannot be used with apps\_category or q parameters.
>
> **apps\_category** `string`
>
> Parameter defines the apps store category.
>
> **see\_more\_token** `string`
>
> Parameter defines the see more token used for retrieving the pagination results from individual sections.
>
> **next\_page\_token** `string`
>
> Parameter defines the next page token. It is used for retrieving the next page results.
>
> **section\_page\_token** `string`
>
> Parameter defines the section page token used for retrieving the pagination results from individual sections.
>
> #### 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 AI Mode
>
> **Slug:** `SERPAPI_QUERY_GOOGLE_AI_MODE`
>
> Query Google AI Mode for generated text, references, and follow-up data. Successful non-cached requests count against the plan; exact-query cache hits within one hour, errors, and failed searches do not. Throughput is the account's hourly plan limit. Speed-mode multipliers are Best Effort 1x, Ludicrous 2x, and Ludicrous Max 4x.
>
> #### Input Parameters
>
> **async** `boolean`
>
> Set true to submit asynchronously and retrieve the result with the Search Archive action. Cannot be combined with no\_cache or Ludicrous Speed.
>
> **query** `string` *required*
>
> Natural-language prompt or search query to send to Google AI Mode.
>
> **device** `string ("desktop" | "tablet" | "mobile")`
>
> Browser device profile.
>
> **location** `string`
>
> City-level search origin.
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **image\_url** `string`
>
> Image URL to add as prompt context.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **continuable** `boolean`
>
> Return a token that can continue this conversation.
>
> **country\_code** `string`
>
> Two-letter country code for the search results.
>
> **language\_code** `string`
>
> Google interface language code.
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> **encoded\_location** `string`
>
> Google-encoded search origin. Cannot be combined with location.
>
> **subsequent\_request\_token** `string`
>
> Token from a prior continuable response for a follow-up query.
>
> #### 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 Google Scholar
>
> **Slug:** `SERPAPI_SCHOLAR_SEARCH`
>
> Searches Google Scholar via SerpApi for academic literature, papers, articles, and citations based on a query. Response results may include `inline_links.cited_by` and `resources` (PDF links), but these fields are not guaranteed; check for their existence and type before accessing.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **num** `integer`
>
> Maximum number of results to return per page. Default is 10, maximum is 20.
>
> **query** `string` *required*
>
> The search query for Google Scholar. This can be an academic topic, paper title, author name, or specific keywords.
>
> **start** `integer`
>
> Result offset for pagination. Use 0 for the first page (default), 10 for the second page, 20 for the third, etc.
>
> #### 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] Serp API search
>
> **Slug:** `SERPAPI_SEARCH`
>
> Search Google via SerpApi and return up to five organic results nested under results.organic\_results, with position, title, and link for each.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **query** `string` *required*
>
> User's search query; should be a clear, concise question or keyword phrase.
>
> #### 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 Apple App Store
>
> **Slug:** `SERPAPI_SEARCH_APPLE_APP_STORE`
>
> Tool to search Apple App Store for iOS and Mac apps. Returns app details including ratings, reviews, descriptions, and developer information. Use when you need to find apps on the Apple App Store or get information about specific apps.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **num** `integer`
>
> Maximum number of results to return. Use to limit or paginate results.
>
> **term** `string` *required*
>
> Search query term for Apple App Store apps.
>
> **async** `boolean`
>
> Submit search asynchronously.
>
> **device** `string`
>
> Device type to filter results: 'desktop', 'tablet', or 'mobile'.
>
> **country** `string`
>
> Country code for the search (e.g., 'us', 'uk', 'fr').
>
> **language** `string`
>
> Language code for the search (e.g., 'en-us', 'fr-fr', 'es-es').
>
> **no\_cache** `boolean`
>
> Force fresh results, bypassing cache.
>
> **property** `string`
>
> Search property. Set to 'developer' to search by developer name.
>
> **category\_id** `string`
>
> Filter by category ID (e.g., '6014' for Games).
>
> #### 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 Images Light Search
>
> **Slug:** `SERPAPI_SEARCH_GOOGLE_IMAGES_LIGHT`
>
> Tool to scrape Google Images results using SerpApi's Google Images Light API. Use when you need fast image search with thumbnails, titles, sources, and original image URLs from Google Images. This lightweight version provides faster response times compared to the full Google Images API.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search query for Google Images. Supports Google search operators like inurl:, site:, intitle:.
>
> **gl** `string`
>
> Two-letter country code to define the country for the search.
>
> **hl** `string`
>
> Two-letter language code to define the language for the search interface.
>
> **imgar** `string`
>
> Aspect ratio filter. Options: s (square), t (tall), w (wide), xw (extra wide).
>
> **imgsz** `string`
>
> Image size filter. Options: l (large), m (medium), i (icon), etc.
>
> **start** `integer`
>
> Result offset for pagination. Must be between 0 and 999.
>
> **device** `string`
>
> Device type for the search. Options: desktop (default), tablet, mobile.
>
> **engine** `string`
>
> Set parameter to google\_images\_light to use the Google Images Light API engine.
>
> **end\_date** `string`
>
> End date for filtering images by upload date. Format: YYYYMMDD.
>
> **location** `string`
>
> Geographic location for the search origin. Specify at city level for best results.
>
> **start\_date** `string`
>
> Start date for filtering images by upload date. Format: YYYYMMDD.
>
> **image\_color** `string`
>
> Color filter for images. Options: bw (black and white), red, blue, green, yellow, orange, pink, white, gray, black, teal, brown.
>
> **period\_unit** `string`
>
> Time period unit for filtering by upload date. Options: s (second), n (minute), h (hour), d (day), w (week), m (month), y (year). Must be used with period\_value.
>
> **period\_value** `integer`
>
> Time period value to use with period\_unit. Specifies how many units back to search.
>
> **google\_domain** `string`
>
> Google domain to use for the search. Defaults to google.com.
>
> #### 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 Google Local Services
>
> **Slug:** `SERPAPI_SEARCH_GOOGLE_LOCAL_SERVICES`
>
> Search Google Local Services for providers such as electricians, plumbers and HVAC technicians. Returns up to three local ads, which may include business information and a Google Guaranteed badge.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Parameter defines the service you want to search for (e.g., 'electrician', 'plumber', 'hvac repair').
>
> **hl** `string`
>
> Parameter defines the language to use for the search. It's a two-letter language code (e.g., 'en' for English, 'es' for Spanish, 'fr' for French).
>
> **bid** `string`
>
> Unique business identifier. Used together with cid and pid parameters to identify a specific business.
>
> **cid** `string`
>
> Unique business place ID from API response. Used to get details for a specific business.
>
> **pid** `string`
>
> Unique place identifier. Used together with cid and bid parameters to identify a specific business.
>
> **async** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi. Set to true to submit the search asynchronously.
>
> **output** `string`
>
> Parameter defines the final output format. Can be set to 'json' (default) to get structured JSON results, or 'html' to get raw HTML.
>
> **data\_cid** `string` *required*
>
> Google customer identifier for location. This is a unique identifier that specifies the geographic area for the search.
>
> **job\_type** `string`
>
> Parameter defines the service subcategory or specific job type within the main service category (e.g., 'restore\_power' for electrician searches).
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Google Local Services results even if a cached version is already present. Set to true to get fresh results.
>
> **zero\_trace** `boolean`
>
> Enterprise only. Parameter enables ZeroTrace mode to skip storing search metadata. Set to true to enable.
>
> **json\_restrictor** `string`
>
> Parameter restricts the output fields to reduce response size. Specify field paths to include in the response.
>
> #### 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 Index
>
> **Slug:** `SERPAPI_SEARCH_INDEX`
>
> Search SerpApi's preview LLM-first web index for grounding results. Successful non-cached requests count against the plan; exact-query cache hits within one hour, errors, and failed searches do not. Throughput is the account's hourly plan limit. Speed-mode multipliers are Best Effort 1x, Ludicrous 2x, and Ludicrous Max 4x.
>
> #### Input Parameters
>
> **num** `integer`
>
> Number of results to return.
>
> **mode** `string`
>
> Use deep for expanded recall through parallel sub-query fan-out.
>
> **safe** `string ("active" | "off")`
>
> Adult-content filtering.
>
> **async** `boolean`
>
> Set true to submit asynchronously and retrieve the result with the Search Archive action. Cannot be combined with no\_cache or Ludicrous Speed.
>
> **query** `string` *required*
>
> Query for SerpApi's LLM-first web index.
>
> **start** `integer`
>
> Zero-based result offset.
>
> **no\_cache** `boolean`
>
> Set true to bypass SerpApi's one-hour exact-query cache. Cached searches are free and do not count toward the monthly quota. Cannot be combined with async=true.
>
> **zero\_trace** `boolean`
>
> Enterprise-only mode that prevents SerpApi from retaining the search.
>
> **json\_restrictor** `string`
>
> Comma-separated response fields to include, reducing response size.
>
> #### 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 public Google ads
>
> **Slug:** `SERPAPI_SEARCH_PUBLIC_GOOGLE_ADS`
>
> Find public Google advertisements by advertiser or domain. Returns one page of public creative records; does not access or modify a private ad account.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **num** `integer`
>
> Maximum advertisements per page.
>
> **text** `string`
>
> Advertiser name or domain to search.
>
> **region** `string`
>
> Google Ads Transparency region code.
>
> **platform** `string ("PLAY" | "MAPS" | "SEARCH" | "SHOPPING" | "YOUTUBE")`
>
> Google platform to filter; omit for all platforms.
>
> **advertiser\_id** `string`
>
> Public Google advertiser ID; use this or text.
>
> **creative\_format** `string ("text" | "image" | "video")`
>
> Advertisement format to filter.
>
> **next\_page\_token** `string`
>
> Token returned by the preceding public search page.
>
> #### 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 Yelp businesses
>
> **Slug:** `SERPAPI_SEARCH_YELP`
>
> Search Yelp for businesses and places using SerpApi. Returns business listings that can include ratings, review counts or snippets, contact information, and location details.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **attrs** `string`
>
> Attribute filters to refine search (e.g., 'HotAndNew' for new businesses, 'Deals' for businesses with offers). Can be comma-separated for multiple filters.
>
> **start** `integer`
>
> Result offset for pagination. Use to fetch additional results beyond the first page. Each page typically contains 10 results.
>
> **sortby** `string ("recommended" | "rating" | "review_count")`
>
> Sort order for results. 'recommended' shows Yelp's recommended matches, 'rating' shows highest-rated first, 'review\_count' shows most-reviewed first.
>
> **find\_loc** `string` *required*
>
> Location to search in (e.g., 'San Francisco, CA', 'New York, NY', '10001'). Can be a city, state, address, or ZIP code.
>
> **no\_cache** `boolean`
>
> Set to true to force fresh results from Yelp, bypassing SerpApi's cache. Useful when you need real-time data.
>
> **find\_desc** `string` *required*
>
> Search query describing what to find (e.g., 'pizza', 'coffee shop', 'italian restaurant'). This is the business type or service you're looking for.
>
> **yelp\_domain** `string`
>
> Yelp domain to search on (e.g., 'yelp.com' for US, 'yelp.ca' for Canada, 'yelp.co.uk' for UK). Defaults to yelp.com if not specified.
>
> #### 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] Shopping search
>
> **Slug:** `SERPAPI_SHOPPING_SEARCH`
>
> Searches Google Shopping via SerpAPI for a specific product, returning structured listings in results.shopping\_results. Response fields such as rating, review\_count, extracted\_price, and extracted\_old\_price may be absent; null-check before ranking or computing discounts. Discount percentages in listings may reflect aggregate promotional claims, not per-item pricing.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **num** `integer`
>
> Maximum number of results to return per page. Default is 10, maximum is 100.
>
> **query** `string` *required*
>
> Product or item to search for on Google Shopping.
>
> **start** `integer`
>
> Result offset for pagination. Use 0 for the first page (default), 10 for the second page, 20 for the third, etc.
>
> #### 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 search
>
> **Slug:** `SERPAPI_TRENDS_SEARCH`
>
> Fetches Google Trends data; returns relative 0–100 interest indices (not absolute volumes) meaningful only when comparing queries within the same request. The `query`'s format (single/multiple terms) must comply with the selected `data_type`.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Search query/queries for Google Trends (use comma for multiple). Format (single vs. multiple terms) is dictated by `data_type`.
>
> **data\_type** `string`
>
> Specifies Google Trends search type, dictating `query` format (single term or comma-separated multiple terms). Options: - `TIMESERIES`: Interest over time; single/multiple queries. - `GEO_MAP`: Regional comparison; multiple queries. - `GEO_MAP_0`: Regional interest; single query. - `RELATED_TOPICS`: Related topics; single query. - `RELATED_QUERIES`: Related queries; single query.
>
> #### 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] Walmart Product Reviews
>
> **Slug:** `SERPAPI_WALMART_PRODUCT_REVIEWS`
>
> Tool to scrape full Walmart product reviews using SerpApi's Walmart Product Reviews API. Retrieves ratings, review text, user information, and helpful votes for a specific product. Use when you need detailed customer feedback and sentiment analysis for Walmart products.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination. Starts at 1. Use this to retrieve additional pages of reviews.
>
> **sort** `string ("relevancy" | "helpful" | "submission-desc" | "submission-asc" | "rating-desc" | "rating-asc")`
>
> Sort order for reviews. Options: 'relevancy' (default), 'helpful' (most helpful first), 'submission-desc' (newest first), 'submission-asc' (oldest first), 'rating-desc' (highest rating first), 'rating-asc' (lowest rating first).
>
> **async** `boolean`
>
> Set to true for asynchronous search submission. When true, the search is queued and returns immediately with a search\_id for later retrieval. Defaults to false.
>
> **output** `string ("json" | "html")`
>
> Response format: 'json' (default, structured data) or 'html' (raw HTML response).
>
> **rating** `integer ("1" | "2" | "3" | "4" | "5")`
>
> Filter reviews by star rating. Must be an integer between 1 and 5.
>
> **no\_cache** `boolean`
>
> Set to true to bypass cached results and force fresh data. Defaults to false. Note: Using this may increase response time and count against your SerpApi quota.
>
> **product\_id** `string` *required*
>
> Unique Walmart product identifier (us\_item\_id) to retrieve reviews for. This is the unique identifier for a specific Walmart product.
>
> #### 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] Walmart Search
>
> **Slug:** `SERPAPI_WALMART_SEARCH`
>
> Retrieve Walmart search results by query, location, store ID, and other parameters. Returns up to three organic product results; filters and pagination information are cleared.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **q** `string` *required*
>
> The search query term or phrase.
>
> **page** `integer`
>
> Page number for pagination. Starts at 1.
>
> **sort** `string`
>
> Sorting option for results. Available options: best\_match, best\_seller, price\_low, price\_high, rating\_high, new.
>
> **type** `string`
>
> Defines the type of search. Can be 'search', 'deals', 'store', 'question'. Default is 'search'.
>
> **location** `string`
>
> Defines the location to use for the search. It can be a city, region, or country. Uses a canonicalized name from the SerpApi locations API.
>
> **store\_id** `string`
>
> Store ID to filter results. Can be found using the Walmart Store Finder API.
>
> **max\_price** `number`
>
> Maximum price filter.
>
> **min\_price** `number`
>
> Minimum price filter.
>
> **min\_rating** `number`
>
> Minimum rating filter (1-5).
>
> #### 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] Yahoo Search
>
> **Slug:** `SERPAPI_YAHOO_SEARCH`
>
> Retrieve Yahoo! Search Engine Results. Supports query, location, language, and device parameters.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **b** `integer`
>
> Parameter defines the result offset. It skips the given number of results. It's used for pagination.
>
> **d** `string`
>
> Parameter specifies the destination for related topics.
>
> **p** `string` *required*
>
> Parameter defines the search query. You can use anything that you would use in a regular Yahoo! search.
>
> **vc** `string`
>
> Parameter defines the country to use for the Yahoo! search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France)
>
> **vf** `string`
>
> `all formats` or specific file format like `pdf` or `txt`.
>
> **vl** `string`
>
> Parameter defines language to limit the search to. It uses `lang_{two-letter language code}` to specify languages.
>
> **vm** `string`
>
> Parameter defines the level of filtering for adult content. Strict: `r`, Moderate: `i`, Off: `p`
>
> **vs** `string`
>
> Filter results by top-level domains separated by ','. (e.g., `.com,.org`)
>
> **fr2** `string`
>
> Parameter is responsible for rendering positions and expansions for some elements.
>
> **device** `string`
>
> Parameter defines the device to use to get the results. It can be set to `desktop` (default) to use a regular browser, `tablet` to use a tablet browser, or `mobile` to use a mobile browser.
>
> **output** `string`
>
> Parameter defines the final output you want. It can be set to json (default) to get a structured `JSON` of the results, or `html` to get the raw html retrieved.
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Yahoo! results even if a cached version is already present.
>
> **yahoo\_domain** `string`
>
> Parameter defines the Yahoo! domain to use. It defaults to `search.yahoo.com`. If specified domain is allowed, it will be prepended to the domain (e.g., `fr.search.yahoo.com`).
>
> **async\_request** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi.
>
> #### 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] Yahoo Videos Search
>
> **Slug:** `SERPAPI_YAHOO_VIDEOS`
>
> Scrape Yahoo! Videos results with position, title, thumbnail, link, preview, source, duration, date and more. Use when you need to search for video content on Yahoo! Videos.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **b** `integer`
>
> Parameter defines the result offset for pagination. It skips the given number of results.
>
> **p** `string` *required*
>
> Parameter defines the search query. You can use anything that you would use in a regular Yahoo! Videos search.
>
> **durs** `string`
>
> Parameter filters results by video duration. Options: 'short' (under 5 minutes), 'medium' (5-20 minutes), 'long' (over 20 minutes).
>
> **vage** `string`
>
> Parameter filters results by upload date. Options: 'day' (past 24 hours), 'week' (past week), 'month' (past month), 'year' (past year).
>
> **vres** `string`
>
> Parameter filters results by video resolution. Options: '360p', '480p', '720p', '1080p'.
>
> **async** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi. It can be set to `false` (default) to open an HTTP connection and keep it open until you got your search results, or `true` to just submit your search to SerpApi and retrieve them later.
>
> **vsite** `string`
>
> Parameter filters results by video source platform. Options: 'youtube', 'dailymotion', 'vimeo', 'mtv', 'cbsnews', 'foxnews', 'cnn', 'msn'.
>
> **device** `string`
>
> Parameter defines the device to use to get the results. It can be set to `desktop` (default), `tablet`, or `mobile`.
>
> **output** `string`
>
> Parameter defines the final output you want. It can be set to json (default) to get a structured `JSON` of the results, or `html` to get the raw html retrieved.
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the Yahoo! Videos results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h.
>
> **zero\_trace** `boolean`
>
> Enterprise only. Parameter enables ZeroTrace mode. It can be set to `false` (default) or `true`. Enable this mode to skip storing search parameters, search files, and search metadata on our servers.
>
> **yahoo\_domain** `string`
>
> Parameter defines the Yahoo! domain to use. It defaults to `search.yahoo.com`.
>
> #### 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 Images Search
>
> **Slug:** `SERPAPI_YANDEX_IMAGES_SEARCH`
>
> Tool to search Yandex Images for image results with advanced filters. Use when searching for images on Yandex with filters like size, color, type, or performing reverse image search.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **p** `integer`
>
> Page number (starts at 0, returns up to 30 results per page).
>
> **tab** `string`
>
> Tab to use for reverse image search - about or similar.
>
> **url** `string`
>
> Image URL for reverse image search.
>
> **crop** `string`
>
> Crop coordinates for reverse search (format: left;top;right;bottom, values 0-1).
>
> **site** `string`
>
> Filter by source domain (e.g., [www.shutterstock.com](http://www.shutterstock.com)).
>
> **text** `string` *required*
>
> Search query - anything you would use in regular Yandex Images search.
>
> **async** `boolean`
>
> Set to true for asynchronous submission.
>
> **color** `string`
>
> Color filter - color, gray, red, orange, yellow, cyan, green, blue, violet, white, or black.
>
> **width** `integer`
>
> Image width in pixels; must be used with height parameter.
>
> **height** `integer`
>
> Image height in pixels; must be used with width parameter.
>
> **output** `string`
>
> Response format - json (default) or html.
>
> **recent** `boolean`
>
> Shows images from the last 7 days when set to true.
>
> **crop\_id** `string`
>
> Filter by specific image section (Yandex-hosted images only).
>
> **no\_cache** `boolean`
>
> Set to true to bypass cached results.
>
> **file\_type** `string`
>
> Image format - jpg, png, or gifan.
>
> **image\_type** `string`
>
> Image type - photo, clipart, lineart, demotivator, or face.
>
> **zero\_trace** `boolean`
>
> Enterprise feature for privacy mode.
>
> **orientation** `string`
>
> Image orientation - horizontal, vertical, or square.
>
> **yandex\_domain** `string`
>
> Yandex Images domain to use for the search (default: yandex.com).
>
> #### 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
>
> **Slug:** `SERPAPI_YANDEX_SEARCH`
>
> Retrieve Yandex Search Results. Supports parameters like text (query), location, etc. Returns SERP data in JSON format.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **p** `integer`
>
> Defines the page number for pagination. Starts from 0.
>
> **num** `integer`
>
> Defines the number of results to return per page. Maps to 'groups\_on\_page' in Yandex API. Default is 20.
>
> **lang** `string`
>
> Defines the language to use for the search. (e.g., 'ru' for Russian, 'en' for English).
>
> **text** `string` *required*
>
> The search query string.
>
> **location** `string`
>
> Defines the location to use for the search. It can be a city name, a region, or a country. SerpApi will convert this to the appropriate Yandex location code.
>
> **yandex\_domain** `string`
>
> Defines the Yandex domain to use. Defaults to yandex.com.
>
> #### 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] YouTube Search
>
> **Slug:** `SERPAPI_YOU_TUBE_SEARCH`
>
> Retrieve YouTube Search Results. Supports parameters like search\_query, location, etc. Returns video SERP data in JSON format.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.025 per successful search
>
> **Discount:** 63
>
> #### Input Parameters
>
> **gl** `string`
>
> Parameter defines the country to use for the Google search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France). Head to the Google countries page for a full list of supported Google countries.
>
> **hl** `string`
>
> Parameter defines the language to use for the Youtube search. It's a two-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French). Head to the Google languages page for a full list of supported Google languages.
>
> **sp** `string`
>
> Parameter can be used for pagination. Youtube uses continous pagination and the next page token can be found in the SerpApi JSON response serpapi\_pagination -> next\_page\_token and pagination -> next\_page\_token fields. Parameter can also be used to filter the search results by Upload date (CAI%3D), 4K (EgJwAQ%3D%3D), etc. It can also be used for forcing the exact search query spelling by setting the sp value to QgIIAQ%3D%3D. Pagination tokens can expire; limit pagination depth to 3–5 pages.
>
> **async** `boolean`
>
> Parameter defines the way you want to submit your search to SerpApi. It can be set to `false` (default) to open an HTTP connection and keep it open until you got your search results, or `true` to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no\_cache parameters should not be used together.
>
> **output** `string`
>
> Parameter defines the final output you want. It can be set to json (default) to get a structured `JSON` of the results, or `html` to get the raw html retrieved.
>
> **no\_cache** `boolean`
>
> Parameter will force SerpApi to fetch the YouTube results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to `false` (default) to allow results from the cache, or `true` to disallow results from the cache. no\_cache and async parameters should not be used together.
>
> **zero\_trace** `boolean`
>
> Enterprise only. Parameter enables ZeroTrace mode. It can be set to `false` (default) or `true`. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
>
> **search\_query** `string` *required*
>
> Parameter defines the search query. You can use anything that you would use in a regular 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
