> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to SearchApi

The SearchApi connector lets your AI agent act in each user's SearchApi account. Each user connects their own SearchApi access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** Bearer Token
**Categories:** Search, Analytics
**Tools:** 60: 60 read, 0 write, 0 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=SEARCHAPI)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the SearchApi connection

   In **AgentKit > Connections**, create a SearchApi connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'searchapi'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize SearchApi:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'searchapi_account_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "searchapi"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize SearchApi:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="searchapi_account_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their SearchApi credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'searchapi_account_get',
  toolInput: {},
  connector: 'searchapi',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="searchapi_account_get",
    tool_input={},
    connection_name="searchapi",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `searchapi_account_get`

Get Account Usage · Read-only

Get your SearchApi account's usage for the month.
Returns current_month_usage, monthly_allowance, remaining_credits and remaining_searches.
Use this to check remaining searches before large jobs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `searchapi_amazon_product_get`

Get Amazon Product · Read-only

Get one Amazon product's details by ASIN.
Returns the product's title, brand, price, rating, reviews, features, specifications, variants, images and buybox.
Use this after searchapi_amazon_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `asin` (`string`, required): The asin parameter is used to specify the product you want to retrieve details for. It accepts an Amazon Standard Identification Number (ASIN), a unique identifier for products on Amazon. Example: B0CHX1W1XY.
- `amazon_domain` (`string`, optional): The default parameter amazon.com defines the Amazon domain of the search. Check the full list of supported Amazon domains. Example: amazon.com.
- `currency` (`string`, optional): The currency parameter is used to specify the currency of the prices displayed by Amazon (e.g. EUR). By default, it follows the domain or the delivery location specified. This parameter is not available for all domains, check the full list of domains and currencies. Example: USD.
- `delivery_country` (`string`, optional): A two-letter ISO 3166-1 alpha-2 country code that defines the country of the delivery address. By default, it is set to the country code of the selected Amazon domain (e.g. de for amazon.de), you can also explicitly set it to a different country. Check the full list of supported Amazon delivery countries. Example: us.
- `language` (`string`, optional): The language parameter is used to specify the display language of Amazon page. Check the full list of supported Amazon display languages. Example: en_US.
- `postal_code` (`string`, optional): Postal code for the delivery location. Use this for postal-code countries (e.g. 10001 for US, SW1A 0AA for UK, M5V 2T6 for CA). Check the list of supported Amazon postal codes by domain and format. The response reports the outcome in search_metadata.delivery_location: applied, not_applied, or unverified. Example: 10001.
- `variant_prices` (`boolean`, optional): Set this parameter to true to include the price of each product variant. Enabling it may increase the response time. Some products include variant prices by default, even without this parameter. Example: false.

Example input: `{"asin":"<asin>"}`

### `searchapi_amazon_search`

Amazon Search · Read-only

Search Amazon products on any Amazon domain, with price, category and sort options.
Returns products with title, ASIN, price, rating, reviews, Prime and delivery details.
Use this to find products. Use searchapi_amazon_product_get with an ASIN for one product.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Amazon. Example: wireless earbuds.
- `amazon_domain` (`string`, optional): The default parameter amazon.com defines the Amazon domain of the search. Check the full list of supported Amazon domains. Example: amazon.com.
- `category_id` (`string`, optional): An Amazon browse node ID that limits results to a specific category. Use the Amazon Categories API to discover valid category IDs for any domain. Example: 172282.
- `currency` (`string`, optional): The currency parameter is used to specify the currency of the prices displayed by Amazon (e.g. EUR). By default, it follows the domain or the delivery location specified. This parameter is not available for all domains, check the full list of domains and currencies. Example: USD.
- `delivery_country` (`string`, optional): A two-letter ISO 3166-1 alpha-2 country code that defines the country of the delivery address. By default, it is set to the country code of the selected Amazon domain (e.g. de for amazon.de), you can also explicitly set it to a different country. Check the full list of supported Amazon delivery countries. Example: us.
- `language` (`string`, optional): The language parameter is used to specify the display language of Amazon page. Check the full list of supported Amazon display languages. Example: en_US.
- `page` (`integer`, optional): The parameter determines the results page number. It defaults to 1. Example: 1.
- `postal_code` (`string`, optional): Postal code for the delivery location. Use this for postal-code countries (e.g. 10001 for US, SW1A 0AA for UK, M5V 2T6 for CA). Check the list of supported Amazon postal codes by domain and format. The response reports the outcome in search_metadata.delivery_location: applied, not_applied, or unverified. Example: 10001.
- `price_max` (`string`, optional): This parameter controls the maximum price of the products returned. For instance - 20.5 value would return products with a maximum price of 20.5. The price is in the marketplace's own currency (e.g. EUR on amazon.de), even when currency is set. Example: 200.
- `price_min` (`string`, optional): This parameter controls the minimum price of the products returned. For instance - 10 value would return products with a minimum price of 10. The price is in the marketplace's own currency (e.g. EUR on amazon.de), even when currency is set. Example: 10.
- `sort_by` (`string`, optional): Parameter allows sorting search results by different criteria. Below is the list of available sorting options: featured - default sort order. price_low_to_high price_high_to_low average_review - sort by average customer reviews score. newest_arrivals bestsellers. Example: price_low_to_high.

Example input: `{"q":"<q>"}`

### `searchapi_apple_app_store_search`

Apple App Store Search · Read-only

Search the Apple App Store for apps.
Returns apps with name, app id, developer, price, rating, reviews, genres and description.
Use this for iOS app research. Use searchapi_google_play_store_search for Android.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `term` (`string`, required): Parameter defines the app query you want to search. Example: photo editor.
- `country` (`string`, optional): Two-letter country code (ISO 3166-1 alpha-2), defines the country of the store. The default parameter is us. Check the full list of supported Apple App Store countries. Example: us.
- `device` (`string`, optional): Filters apps based on the device they are available for in the App Store. The default is mobile. Other available options are: desktop for Mac apps tablet for iPad apps mobile for iPhone apps. Example: desktop.
- `include_explicit` (`boolean`, optional): A boolean indicating whether or not you want to include explicit content in your search results. The default is true. Example: true.
- `lang` (`string`, optional): Defines the language of the store. The default parameter is en-us. Check the full list of supported Apple App Store languages. Example: en-us.
- `num` (`integer`, optional): Specifies the number of results to return. By default, it is set to 10. The maximum number of results is 200. Example: 10.
- `property` (`string`, optional): When used, it shows only apps made by the developer specified in the term parameter. The only available option is developer. Example: developer.

Example input: `{"term":"<term>"}`

### `searchapi_baidu_search`

Baidu Search · Read-only

Search Baidu, the main Chinese search engine.
Returns organic results with title, link and snippet, plus related searches.
Use this for Chinese-language web results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Baidu. Queries can include operators and advanced filters like "machine learning models", site:, intitle:, or filetype:. Example: 人工智能.
- `ct` (`string`, optional): This parameter controls the language of search results. There are three options: 0 - Simplified and Traditional Chinese. (Default) 1 - Simplified Chinese. 2 - Traditional Chinese. Example: 1.
- `num` (`integer`, optional): This parameter specifies the number of results to display per page. Maximum number - 50. Use in combination with the page parameter to implement pagination functionality. Example: 10.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Use in combination with the num parameter to implement pagination. Example: 1.

Example input: `{"q":"<q>"}`

### `searchapi_bing_images_search`

Bing Images Search · Read-only

Search Bing Images with size, color, type, license and date filters.
Returns images with title, source page, original URL, size and thumbnail.
Use this for Bing image results. Use searchapi_google_images_search for Google.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Bing Images. Example: golden gate bridge.
- `aspect_ratio` (`string`, optional): This parameter filters images based on aspect ratio. Supported values are: square - width equals height. tall - height greater than width. wide - width greater than height. Example: wide.
- `color` (`string`, optional): This parameter controls the color of your search results. These options are available: black_and_white, color, red, orange, yellow, green, teal, blue, purple, pink, brown, black, gray, white. Example: blue.
- `country_code` (`string`, optional): Specifies the country for the search results if market_code is not specified. Defaults to US if unspecified or market_code is not used. Check the full list of supported Bing coutry_code countries. Note: the country_code parameter can't be used together with market_code parameter. Example: US.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `image_type` (`string`, optional): This parameter controls the type of your search results. There are only few options that are available: photo, gif, clipart, line_drawing, transparent, face and head_and_shoulders. Example: photo.
- `language` (`string`, optional): Sets the language for user interface text. Use 2-letter (ISO 639-1) or 4-letter codes (' - '). Defaults to en (English) if unspecified or unsupported. Check the full list of supported Bing language languages. Example: en.
- `market_code` (`string`, optional): Defines the country for search results. Format is language-country, like en-US. For a list of market values, check the full list of supported Bing market_code codes. Note: the market_code parameter can't be used together with country_code parameter. Example: en-US.
- `min_size` (`string`, optional): Use this parameter to filter images by minimum width and height. Enter the size in the format Width x Height (e.g., 800x600). Example: 800x600.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Example: 1.
- `safe_search` (`string`, optional): This parameter toggles the safe_search feature for the results. Default is Moderate. safe_search operates by filtering out adult content from your search results. Options are: off - returns results with adult text, images, and videos moderate - returns results with adult text. strict - don't return results with adult text, images, and videos Note: In some market_code parameters, strict is enforced regardless of this setting. Example: moderate.
- `size` (`string`, optional): This parameter controls the size of your search results. There are few options available: small, medium, large and extra_large. Example: large.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: last_day, last_week, last_month, last_year. Example: last_week.
- `usage_rights` (`string`, optional): This parameter controls the usage rights of your search results. Options that are available: public_domain, creative_commons_licenses, free_to_share_and_use, free_to_share_and_use_commercial, free_to_modify_share_and_use, free_to_modify_share_and_use_commercial. Example: creative_commons_licenses.

Example input: `{"q":"<q>"}`

### `searchapi_bing_news_search`

Bing News Search · Read-only

Search Bing News for articles.
Returns articles with title, link, source, date, snippet and thumbnail.
Use this for Bing's news index. Use searchapi_google_news_search for Google News.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Bing News. Queries can include operators and advanced filters like "climate change", site:, inurl:, or intitle:. Note: Optional when category parameter is used. If both are provided, category takes priority. Example: electric vehicles.
- `category` (`string`, optional): Parameter defines the category you want to search. You can find these categories in the Bing News URL as nvaug parameter value. For example: nvaug=%5bNewsVertical+Category%3d"rt_ CATEGORY "%5d. To retrieve Top Stories category, it is required to set category parameter to MaxClass. Most categories can be found in Bing News official documentation. Example: rt_Business.
- `country_code` (`string`, optional): Specifies the country for the search results if market_code is not specified. Check the full list of supported Bing coutry_code countries. Note: the country_code parameter can't be used together with market_code parameter. Example: US.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `language` (`string`, optional): Sets the language for user interface text. Use 2-letter (ISO 639-1) or 4-letter codes (' - '). Defaults to en (English) if unspecified or unsupported. Check the full list of supported Bing language languages. Example: en.
- `market_code` (`string`, optional): Defines the country for search results. Format is language-country, like en-US (Default value). For a list of market values, check the full list of supported Bing market_code codes. Note: the market_code parameter can't be used together with country_code parameter. Example: en-US.
- `num` (`integer`, optional): This parameter specifies the number of results to display per page. Maximum number - 50. Use in combination with the page parameter to implement pagination functionality. Example: 10.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Use in combination with the num parameter to implement pagination. Example: 1.
- `safe_search` (`string`, optional): This parameter toggles the safe_search feature for the results. Default is Moderate. safe_search operates by filtering out adult content from your search results. Options are: off - returns results with adult text, images, and videos moderate - returns results with adult text. strict - don't return results with adult text, images, and videos Note: In some market_code parameters, strict is enforced regardless of this setting. Example: moderate.
- `sort_by` (`string`, optional): By default, news results are sorted by relevance. To get the most recent articles, set it to most_recent. Example: most_recent.
- `time_period` (`string`, optional): This parameter filters the search results by time period. By default, it returns all articles without any time period. The time_period parameter can be set to: last_minute - Past minute last_5_minutes - Past 5 minutes last_15_minutes - Past 15 minutes last_30_minutes - Past 30 minutes last_hour - Past hour last_4_hours - Past 4 hours last_6_hours - Past 6 hours last_24_hours - Past 24 hours last_7_days - Past 7 days last_30_days - Past 30 days. Example: last_7_days.

Example input: `{"q":"<q>"}`

### `searchapi_bing_search`

Bing Search · Read-only

Search Bing and get the results page as structured JSON.
Returns organic results with title, link and snippet, plus ads, answer box, related searches and pagination.
Use this for Bing results. Use searchapi_google_search for Google.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Bing. Queries can include operators and advanced filters like "machine learning models", site:, feed:, AND, or OR. Example: best project management software.
- `country_code` (`string`, optional): Specifies the country for the search results if market_code is not specified. Defaults to US if unspecified or market_code is not used. Check the full list of supported Bing coutry_code countries. Note: the country_code parameter can't be used together with market_code parameter. Example: US.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `filters` (`string`, optional): This parameter allows to use various filters to restrict search results. It supports a wide range of filtering options, including date-based: ex1%3a"ez1" - data from the past 24 hours. ex1%3a"ez2" - data from the past week. ex1%3a"ez3" - data from the past month. For date filtering, prefer the time_period parameters above, which accept calendar dates directly. This parameter cannot be combined with them. Note: Exact values for complex filters can be constructed by performing a search on Bing and then copying the value of the filters parameter. Example: ex1:"ez2".
- `language` (`string`, optional): Sets the language for user interface text. Use 2-letter (ISO 639-1) or 4-letter codes (' - '). Defaults to en (English) if unspecified or unsupported. Check the full list of supported Bing language languages. Example: en.
- `lat` (`string`, optional): Parameter defines the latitude of the location you want to use for the search. Example: 40.7128.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. For example - location=New York would select New York,United States or location=London would select London TV Region,England,United Kingdom. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `lon` (`string`, optional): Parameter defines the longitude of the location you want to use for the search. Example: -74.0060.
- `market_code` (`string`, optional): Defines the country for search results. Format is language-country, like en-US. For a list of market values, check the full list of supported Bing market_code codes. Note: the market_code parameter can't be used together with country_code parameter. Example: en-US.
- `next_page_token` (`string`, optional): A token for fetching the next set of results. You can obtain this token from the pagination.next_page_token field in the previous response. The next page starts right after the last organic result of that response, while page=2 always starts at result 11. The token takes precedence over page. Use it with the same q as the search that returned it. Example: CBQQAA.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Bing's first page can hold fewer than 10 organic results, so page=2, which always starts at result 11, may skip some. Use next_page_token to continue right after the last result. Example: 1.
- `safe_search` (`string`, optional): This parameter toggles the safe_search feature for the results. Default is Moderate. safe_search operates by filtering out adult content from your search results. Options are: off - returns results with adult text, images, and videos moderate - returns results with adult text. strict - don't return results with adult text, images, and videos Note: In some market_code parameters, strict is enforced regardless of this setting. Example: moderate.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: last_day - data from the past 24 hours. last_week - data from the past week. last_month - data from the past month. last_year - data from the past year. Using time_period_min or time_period_max parameters, you can specify a custom time period. Example: last_week.

Example input: `{"q":"<q>"}`

### `searchapi_chatgpt_search`

ChatGPT Search · Read-only

Ask ChatGPT a question, optionally with live web search.
Returns the answer text, cited sources and entity cards.
Use this to see how ChatGPT answers a prompt. Use searchapi_perplexity_search for Perplexity.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The prompt to send to ChatGPT. Up to 4000 characters. Example: What are the main causes of inflation?.
- `country` (`string`, optional): Two-letter country code (ISO 3166-1 alpha-2), defines the country of the search. The default parameter is us. Check the full list of supported ChatGPT countries. Example: us.
- `expand_entities` (`boolean`, optional): Set to true to expand each knowledge-entity card in the answer into a rich detail card with a description, titled sections, related entities ("Key Areas" / "Nearby Landmarks"), inline images, and reference links, returned under each card's details. Adds latency since each entity triggers an extra fetch. Example: false.
- `web_search` (`boolean`, optional): Set to true to use ChatGPT with web search. ChatGPT runs a live web search and answers with cited sources, turning the request into a ChatGPT search API. The pages the answer cites are returned in reference_links, and the full ranked set of pages ChatGPT retrieved is returned in web_results. ChatGPT may also search on its own initiative, so these can appear without this parameter. response_metadata.is_web_search_performed always reports whether a search actually ran. Example: true.

Example input: `{"q":"<q>"}`

### `searchapi_duckduckgo_search`

DuckDuckGo Search · Read-only

Search DuckDuckGo and get the results as structured JSON.
Returns organic results with title, link and snippet, plus next_page_token.
Use this for privacy-focused web results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on DuckDuckGo. Queries can include operators and advanced filters like "machine learning models", site:, intitle:, or inurl:. Example: privacy focused browsers.
- `locale` (`string`, optional): Specifies the country and language for your search. The default parameter is us-en. Check the full list of supported DuckDuckGo locales. Example: us-en.
- `next_page_token` (`string`, optional): This parameter is used to retrieve the next page of results. It is returned in the response when there are more results to display. The next_page_token is a unique identifier for the next page of results. It is used to retrieve the next page of results. Example: CBQQAA.
- `safe` (`string`, optional): Specifies the filter level for adult content. Available values are: on Default moderate off. Example: moderate.
- `time_period` (`string`, optional): Filters results by date. Predefined values are: any_time Default past_year past_month past_week past_day Also possible to filter by a specific date range, use following format for that: YYYY-MM-DD..YYYY-MM-DD. Example: past_week.

Example input: `{"q":"<q>"}`

### `searchapi_ebay_search`

eBay Search · Read-only

Search eBay listings with price, condition, buying format and location filters.
Returns listings with title, item id, price, condition, shipping, seller and bids.
Use this for eBay prices and listings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter specifies your search query. It accepts any term or phrase you'd typically input in eBay search. This parameter is optional when the parameter category_id is present. The results will include only products containing all specified words, but you can refine your search by using: Commas and parentheses to get products that include any of the terms (e.g., (ring,earrings,necklace)). You can have multiple sets (e.g., (blue,red)(t-shirt,trousers), which would return products that include (blue or red) and (t-shirt or trousers). A minus sign to exclude terms (e.g., -wood). Example: vintage camera.
- `buying_format` (`string`, optional): This parameter allows you to filter search results by eBay's buying formats: auction, buy_it_now, best_offer. Example: buy_it_now.
- `category_id` (`string`, optional): This parameter that allows you to restrict your search to a specific eBay category. Categories are different for each eBay domain. Category ids can be retrieved using the API or by inspecting category links found in ebay_domain/n/all-categories. Each category link follows the pattern ebay_domain/b/category_name/category_id/. On ebay.com, top-level categories (such as Jewelry & Watches) return results only together with q or buying_format. Example: 625.
- `condition` (`string`, optional): This parameter allows you to filter items by their condition. Multiple conditions can be applied by separating them with commas (e.g., new,used_very_good). Available conditions include: new, new_opened, like_new, new_with_defects pre_owned_fair, pre_owned_excellent, used_very_good, used_good, used_acceptable excellent_refurbished, very_good_refurbished and good_refurbished certified_refurbished, seller_refurbished for_parts_or_not_working, not_specified. Example: new.
- `country` (`string`, optional): Since eBay does not have domains for all countries, country is a two-letter ISO 3166-1 alpha-2 country code that allows you to localize ebay.com and change the language and currency (if available). It defaults to the domain's country. Check the full list of supported eBay countries. Example: us.
- `delivery_country` (`string`, optional): A two-letter ISO 3166-1 alpha-2 country code that allows you to set the an specific delivery country for the search. The default will be country if it's set, otherwise it will be the domain's country. Check the full list of supported eBay delivery countries. Example: us.
- `distance_radius` (`integer`, optional): A numerical value to filter results based on their distance to a given postal code. This parameter is only applicable when the parameter postal_code is also included. Example: 50.
- `ebay_domain` (`string`, optional): The default parameter ebay.com defines the eBay domain of the search and it's used for multiple countries, but other country-specific domains are also supported. Check the full list of supported eBay domains. Example: ebay.com.
- `filters` (`string`, optional): This parameter allows you to filter search results by various criteria. Multiple filters can be applied by separating them with commas (e.g., sale_items,free_shipping). Available filters include: Listing filters: sale_items deals_and_savings listed_as_lots Item and seller filters: search_description authenticity_guarantee authorized_seller benefits_charity psa_vault Shipping, pickup and return filters: free_shipping local_pickup fast_arrival free_returns returns_accepted. Example: free_shipping.
- `include_related_results` (`boolean`, optional): When set to true, the API returns eBay's "Results matching fewer words" items under a separate related_results key, both after the exact matches and when there are none. Defaults to false, which leaves them out and returns an error when no exact matches are found. Example: false.
- `num` (`integer`, optional): This parameter determines the number of items per page. The possible values are: 60, 120 and 240. It defaults to 60. Example: 10.
- `page` (`integer`, optional): This parameter determines the results page number. It defaults to 1. Example: 1.
- `postal_code` (`string`, optional): This parameter allows you to set the shipping postal code along with delivery_country for the search. It is not available for all delivery countries, check the full list of delivery countries that support postal codes, if not provided in those countries, eBay might automatically set a postal code. Example: 10001.
- `price_max` (`string`, optional): This parameter controls the maximum price of the products returned. For instance - 20.5 value would return products with a maximum price of 20.5. Example: 200.
- `price_min` (`string`, optional): This parameter controls the minimum price of the products returned. For instance - 10 value would return products with a minimum price of 10. Example: 10.
- `sort_by` (`string`, optional): This parameter allows sorting search results by different criteria. Below is the list of available sorting options: best_match Default price_shipping_low_to_high, price_shipping_high_to_low time_newly_listed, time_ending_soonest distance_nearest price_low_to_high, price_high_to_low (Not available for ebay.com, ebay.co.uk, ebay.com.au, ebay.de) condition_new_first, condition_used_first (Not available for ebay.com, ebay.co.uk, ebay.com.au, ebay.de, ebay.ca, cafr.ebay.ca, ebay.nl, ebay.com.my, ebay.com.sg). Example: price_shipping_low_to_high.

Example input: `{"q":"<q>"}`

### `searchapi_google_ads_transparency_search`

Google Ads Transparency Center · Read-only

List the ads an advertiser ran, from the Google Ads Transparency Center, by advertiser ID or domain.
Returns ads with advertiser, format, first and last shown dates, preview links and next_page_token.
Use this for competitor ad research. Use searchapi_meta_ad_library_search for Facebook and Instagram ads.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_format` (`string`, optional): Filters results based on ad format. Accepted values are: text, image, or video. Example: video.
- `advertiser_id` (`string`, optional): Specifies the advertiser's unique ID. Multiple IDs can be provided, separated by commas. Required if domain is not provided. You can obtain the advertiser_id in two ways: Use our Advertiser Search API to search for advertisers or domain by keyword. Use our Google Ads Advertiser Info API to retrieve the advertiser ID directly from Google Search Page. Inspect the URL from the Google Ads Transparency Center website and locate the path segment that starts with AR. Example: AR13129532367502835713.
- `domain` (`string`, optional): Defines the advertiser's verified domain (e.g., tesla.com). Required if advertiser_id is not provided. Example: tesla.com.
- `next_page_token` (`string`, optional): A token for fetching the next set of results. You can obtain this token from the next_page_token field in the previous response. Example: CBQQAA.
- `num` (`integer`, optional): Specifies the number of results to return. Default is 40. The maximum is 100. Example: 40.
- `platform` (`string`, optional): Specifies the platform for which the ads are being retrieved. Accepted values include: google_play, google_maps, google_search, youtube, or google_shopping. Example: youtube.
- `region` (`string`, optional): Specifies the region for your search. The default parameter is anywhere. Check the full list of supported Google Ads Transparency Center regions. Example: US.
- `time_period` (`string`, optional): Limits the results to a specific time range. Accepted values are: today yesteday last_7_days last_30_days Alternatively, specify a custom range using YYYY-MM-DD..YYYY-MM-DD. Example: last_30_days.

Example input: `{}`

### `searchapi_google_ai_mode_search`

Google AI Mode · Read-only

Ask Google AI Mode a question, optionally about an image URL.
Returns the AI answer as text blocks with cited reference links.
Use this for an AI-written answer grounded in Google results. Use searchapi_google_search for the results list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google AI Mode. The AI Mode will respond in the same language as your query - for example, queries in German will receive answers in German, queries in Spanish will receive answers in Spanish. Note: not required if you use the url parameter. It can be used in combination with the url parameter as well. Example: How do heat pumps work in cold climates?.
- `gl` (`string`, optional): This parameter defines the country of the search. It defaults to the country of location or uule, and to us without either. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. For example - location=New York would select New York,United States or location=London would select London TV Region,England,United Kingdom. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `url` (`string`, optional): Parameter defines the image url. This is the direct link to the image you want Google AI Mode to analyze. Ensure the URL points to a valid image format (e.g.,.jpg,.png) and is accessible publicly. Example: https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg.

Example input: `{"q":"<q>"}`

### `searchapi_google_ai_overview_get`

Get Google AI Overview · Read-only

Get the full Google AI Overview for a search, using the page_token from a Google Search result.
Returns the AI Overview text blocks and reference links.
Use this after searchapi_google_search returns an ai_overview with a page_token.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page_token` (`string`, required): A token that contains the search parameters and query information needed to retrieve Google AI Overview data. This token is obtained from the Google Search API response. Important: Page tokens expire in less than 1 minute. Use the token immediately after retrieving it from the Google Search API for best results. Example: KIVu-nictZPdbqM4FMfv-xQoUqvtRZoA4atSdWK-ANshtgkhNyMHnJQkJYSQNumz7_Okk5k6.

Example input: `{"page_token":"<page_token>"}`

### `searchapi_google_autocomplete`

Google Autocomplete · Read-only

Get Google's autocomplete suggestions for a partial query.
Returns the list of suggested queries.
Use this for keyword ideas or to complete a query.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Search query that would produce autocomplete suggestions. Example: how to learn.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.

Example input: `{"q":"<q>"}`

### `searchapi_google_books_search`

Google Books Search · Read-only

Search Google Books for books, magazines and newspapers.
Returns results with title, link, authors, publication date, snippet and preview availability.
Use this to find books.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google Books search. e.g. intitle:, inauthor:, inpublisher:, subject:, issn:, or isbn:. To exclude results, use the - character. For example: Harry -Potter. Example: machine learning.
- `document` (`string`, optional): This parameter filters results based on the type of document. Supported values are: books - Books magazines - Magazines newspapers - Newspapers. Example: books.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Example: 1.
- `safe` (`string`, optional): This parameter toggles the SafeSearch feature for the results. SafeSearch operates by filtering out adult content from your search results. Google's filters use proprietary technology to check keywords, phrases and URLs. While no filters are 100 percent accurate, SafeSearch will remove the overwhelming majority of adult content from your search results. Supported values are active to enable strict SafeSearch, blur to blur explicit images, and off to disable SafeSearch. By default, the value is blur. Example: active.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: 21century - data from 2000 till 2099. 20century - data form 1900 till 1999. 19century - data form 1800 till 1899. Using time_period_min or time_period_max parameters, you can specify a custom time period. Note: the time_period_min and time_period_max parameters could be used separately as well. Example: 21century.
- `view` (`string`, optional): This parameter filters results based on the view of the document. Supported values are: any_view - Any View preview_and_full_view - Preview and full view full_view - Full view. Example: full_view.

Example input: `{"q":"<q>"}`

### `searchapi_google_events_search`

Google Events Search · Read-only

Search Google Events for concerts, conferences and other events.
Returns events with title, date, venue, address, description, ticket links and thumbnail.
Use this to find events in a place.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search for events. Queries can include terms like "concerts tonight", "festivals in New York" or just "Events". Example: concerts in Austin.
- `gl` (`string`, optional): This parameter defines the country of the search and returns events from across it. Check the full list of supported Google Events gl countries. It cannot be combined with location or uule. When omitted, SearchApi applies its default localization. Example: us.
- `hl` (`string`, optional): This parameter defines the language of the results. Google Events only serves English, so en is the only accepted value. Example: en.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. When the query itself names a place, Google resolves the geography from the query and this parameter has no effect. Google only serves events in supported countries. Example: New York.

Example input: `{"q":"<q>"}`

### `searchapi_google_finance_quote_get`

Get Google Finance Quote · Read-only

Get a stock, index, currency or crypto quote from Google Finance.
Returns the price, change, key stats, price graph for the chosen window, news and financials.
Use this for market data on one ticker, such as GOOGL:NASDAQ.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The parameter defines the query you want to search. The query can be one of the following types: Stock. For example - NVDA:NASDAQ. Index. For example -.DJI:INDEXDJX. Mutual Fund. For example - VTSAX:MUTF. Currency. For example - BTC-USD. Futures. For example - GCW00:COMEX. Note: currencies and cryptocurrencies use a hyphen - instead of a colon: to separate the symbol from the exchange. Example: GOOGL:NASDAQ.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `window` (`string`, optional): Specifies the time period for which graph results will be returned. Available options include: 1D (Default) - past 1 day. 5D - past 5 days. 1M - past 1 month. 6M - past 6 months. YTD - current year to date. 1Y - past 1 year. 5Y - past 5 years. MAX - maximum available graph data. Example: 1M.

Example input: `{"q":"<q>"}`

### `searchapi_google_flights_search`

Google Flights Search · Read-only

Search Google Flights for one-way or round-trip flights with class, stops, airline, price and bag filters.
Returns best and other flights with legs, airlines, times, duration, layovers, price, emissions, plus departure and booking tokens and a price insight.
Use this to find flights. Pass departure_token to see return flights or booking_token for booking options.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `arrival_id` (`string`, required): This parameter specifies the code for the arrival airport or a location identifier. It must include at least one location that is not in departure_id. Airport Code: A 3-letter uppercase code representing the arrival airport (e.g., MAD for Madrid-Barajas Airport or JFK for John F. Kennedy International Airport). You can find these codes using resources like Google Flights or IATA. Location Identifier (kgmid): A string that begins with /m/, used to represent a specific location. You can find this identifier on Wikidata by looking for the "Freebase ID" while searching for location. Example: LHR.
- `departure_id` (`string`, required): This parameter specifies the code for the departure airport or a location identifier. Airport Code: A 3-letter uppercase code representing the departure airport (e.g., MAD for Madrid-Barajas Airport or JFK for John F. Kennedy International Airport). You can find these codes using resources like Google Flights or IATA. Location Identifier (kgmid): A string that begins with /m/, used to represent a specific location. You can find this identifier on Wikidata by looking for the "Freebase ID" while searching for location. For example, /m/02_286 is the identifier for New York,United States. Example: JFK.
- `adults` (`integer`, optional): Defines the number of adults. Default is 1. Note: Maximum number of passengers is 9. Example: 2.
- `booking_token` (`string`, optional): Used to retrieve booking options for selected flights. This token is found in the flight results. Example: WyJDalJJWVZad1ExcGhkMEZ3V0d0QlFVSk5SV2RDUnkwdExTMHRMUzB0.
- `carry_on_bags` (`integer`, optional): Defines the number of carry-on bags. Default is 0. Note: number can't be higher than amount of passengers. Example: 1.
- `checked_bags` (`integer`, optional): Defines the number of checked bags. Default is 0. Note: number can't be higher than amount of passengers. Example: 1.
- `children` (`integer`, optional): Defines the number of children. Default is 0. Example: 0.
- `currency` (`string`, optional): Defines the currency of the returned prices. Default is USD. Check the full list of supported Google Travel currency values. Example: USD.
- `departure_token` (`string`, optional): Used to select a flight and view return flights (for round trips) or flights for the next leg (for multi-city trips). This token is found in the flight results. Example: W1siSkZLIiwiMjAyNi0xMi0xMCIsIkxIUiIsbnVsbCwiQkEiLCIxMTIiXV0.
- `exclude_basic_economy` (`boolean`, optional): Set to true to exclude Basic Economy fares. Supported only when travel_class is economy. Google Flights offers this filter for flights within the United States, its territories and Canada. Other routes return the same results as without it. Booking options still list every fare the airline sells, including Basic Economy. Example: false.
- `excluded_airlines` (`string`, optional): Defines the airline or alliance codes to be excluded from available airlines. An airline ID is an uppercase code (e.g., AC for Air Canada airline or ONEWORLD for oneworld alliance). Airline codes can be found on IATA. Multiple airlines can be combined by joining them with a comma. For example: AC,ONEWORLD. Note: if included_airlines and excluded_airlines are used together, included_airlines takes priority. Example: UA.
- `expanded_search` (`boolean`, optional): Set to true together with show_hidden_flights and/or show_cheapest_flights to retrieve more results, which may result in longer request processing times. It has no effect on its own. Example: false.
- `flight_type` (`string`, optional): Defines the type of the flights. Available options: round_trip Default one_way multi_city. Example: round_trip.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google Travel gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google Travel hl languages. Example: en.
- `included_airlines` (`string`, optional): Defines the airline or alliance codes to be selected. An airline or alliance ID is an uppercase code (e.g., AC for Air Canada airline or ONEWORLD for oneworld alliance). Airline codes can be found on IATA. Multiple airlines can be combined by joining them with a comma. For example: AC,ONEWORLD. Example: BA,AA.
- `max_flight_duration` (`integer`, optional): Defines the maximum flight duration in minutes (e.g., 240 for 4 hours). Example: 600.
- `max_price` (`integer`, optional): Defines the maximum ticket price. Default is unlimited. Example: 900.
- `outbound_date` (`string`, optional): Defines the outbound date. The date format is YYYY-MM-DD. Note: Not required if flight_type set to multi_city. Example: 2026-12-10.
- `return_date` (`string`, optional): Defines the return date. The date format is YYYY-MM-DD. Note: Not required if flight_type set to one_way or multi_city. Example: 2026-12-17.
- `show_cheapest_flights` (`boolean`, optional): Set to true to show the cheapest flights. By default, best flights are shown. Example: true.
- `show_hidden_flights` (`boolean`, optional): Set to true to show hidden flights. Example: false.
- `sort_by` (`string`, optional): Defines the sorting order of the flights. Available options: top_flights Default price departure_time arrival_time duration emissions. Example: price.
- `stops` (`string`, optional): Defines the number of stops during the flight. Available options: any - Any number of stops. Default nonstop - Nonstop only. one_stop_or_fewer - 1 stop or fewer. two_stops_or_fewer - 2 stops or fewer. Example: nonstop.
- `travel_class` (`string`, optional): Defines the travel class. Available options: economy Default premium_economy business first_class. Example: economy.

Example input: `{"arrival_id":"<arrival_id>","departure_id":"<departure_id>"}`

### `searchapi_google_forums_search`

Google Forums Search · Read-only

Search Google's Forums results (Reddit, Quora, Stack Exchange and other discussions).
Returns discussions with title, link, source, date, snippet and answer counts.
Use this for community opinions. Use searchapi_reddit_search for Reddit only.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google Forums. Queries can include operators and advanced filters like "machine learning models", site:, inurl:, intitle:, AND, or OR. Example: best mechanical keyboard for programming.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. For example - location=New York would select New York,United States or location=London would select London TV Region,England,United Kingdom. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Use in combination with the num parameter to implement pagination. Example: 1.
- `safe` (`string`, optional): This parameter toggles the SafeSearch feature for the results. SafeSearch operates by filtering out adult content from your search results. Google's filters use proprietary technology to check keywords, phrases and URLs. While no filters are 100 percent accurate, SafeSearch will remove the overwhelming majority of adult content from your search results. Supported values are active to enable strict SafeSearch, blur to blur explicit images, and off to disable SafeSearch. By default, the value is blur. Example: active.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: last_hour - data from the past hour. last_day - data from the past 24 hours. last_week - data from the past week. last_month - data from the past month. last_year - data from the past year. Using time_period_min or time_period_max parameters, you can specify a custom time period. Note, that the time_period_min and time_period_max parameters could be used separately as well. Example: last_week.
- `verbatim` (`boolean`, optional): The verbatim parameter controls whether the search results are returned in the exact order of the query. By default, the value is false. To return the results in the exact order of the query, set the value to true. Ignored when time_period, time_period_min, time_period_max or sort_by is set. Example: false.

Example input: `{"q":"<q>"}`

### `searchapi_google_hotels_property_get`

Get Google Hotels Property · Read-only

Get one hotel or rental's details and booking offers for given dates.
Returns the property's description, address, rating, reviews, amenities and prices from booking sites.
Use this after searchapi_google_hotels_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `check_in_date` (`string`, required): Defines the check-in date for the hotel stay in the format YYYY-MM-DD. This date marks the beginning of the reservation. Example: 2026-12-10.
- `check_out_date` (`string`, required): The check-out date for the hotel stay in the format YYYY-MM-DD. This date marks the end of the reservation. Example: 2026-12-14.
- `property_token` (`string`, required): Parameter defines the property you want to search. You can find property_token values using Google Hotels API, Google Hotels Autocomplete API or Google Local API. Example: ChcIyo2C8tLr4oc8GgsvZy8xdGQ4NjJyZRAB.
- `adults` (`integer`, optional): The number of adults staying at the property. Default is 2. The total number of adults and children cannot exceed 10. Example: 2.
- `children_ages` (`string`, optional): Defines the ages of children as a comma-separated list, e.g., 2,5 for two children aged 2 and 5. Available age range is 1–17. Note: This parameter is only applicable for hotels and will be ignored for other property types. Example: 5,9.
- `currency` (`string`, optional): Defines the currency of the returned prices. Default is USD. Check the full list of supported Google Travel currency values. Example: USD.
- `expanded_search` (`boolean`, optional): Set to true to fetch per-OTA pricing for vacation rental properties. When a property is classified as vacation_rental, the default response only includes limited booking offers. With this parameter enabled, full OTA price comparison (e.g., Booking.com, Expedia, Hotels.com, Agoda, etc.) is returned in featured_offers and all_offers. Example: false.
- `free_cancellation` (`boolean`, optional): Defines a filter indicating whether to display only hotels that offer free cancellation on bookings. Set it to true to include only hotels with free cancellation. Example: true.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google Travel gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en-us defines the interface language of the search. Check the full list of supported Google Travel hl languages. Example: en.

Example input: `{"check_in_date":"<check_in_date>","check_out_date":"<check_out_date>","property_token":"<property_token>"}`

### `searchapi_google_hotels_search`

Google Hotels Search · Read-only

Search Google Hotels and vacation rentals for dates and guests, with price, rating, class and cancellation filters.
Returns properties with name, property_token, price per night, total price, rating, reviews, class, amenities and images.
Use this to find hotels. Use searchapi_google_hotels_property_get with a property_token for one property's offers.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `check_in_date` (`string`, required): Defines the check-in date for the hotel stay in the format YYYY-MM-DD. This date marks the beginning of the reservation. Example: 2026-12-10.
- `check_out_date` (`string`, required): The check-out date for the hotel stay in the format YYYY-MM-DD. This date marks the end of the reservation. Example: 2026-12-14.
- `adults` (`integer`, optional): The number of adults staying in the apartment. Default is 2. For property_type=hotel, the maximum number of guests is 6 (including children). For property_type=vacation_rental, the maximum number is 10. Example: 2.
- `children_ages` (`string`, optional): Defines the ages of children as a comma-separated list, e.g., 2,5 for two children aged 2 and 5. Available age range is 1–17. Note: This parameter is only applicable for property_type=hotel and will be ignored for other property types. Example: 5,9.
- `currency` (`string`, optional): Defines the currency of the returned prices. Default is USD. Check the full list of supported Google Travel currency values. Example: USD.
- `eco_certified` (`boolean`, optional): Defines to show hotels that are eco-certified. Set it to true to include only eco-certified hotels. Example: false.
- `free_cancellation` (`boolean`, optional): Defines a filter indicating whether to display only hotels that offer free cancellation on bookings. Set it to true to include only hotels with free cancellation. Example: true.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google Travel gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google Travel hl languages. Example: en.
- `hotel_class` (`string`, optional): Defines the rating of the hotel. Multiple ratings can be used with comma, for example: 4,5. Available options: 2 for 2 stars 3 for 3 stars 4 for 4 stars 5 for 5 stars. Example: 4,5.
- `next_page_token` (`string`, optional): This parameter is used to retrieve the next page of results. It is returned in the response when there are more results to display. Example: CBQQAA.
- `price_max` (`string`, optional): Defines the maximum price. Default is unlimited. Example: 200.
- `price_min` (`string`, optional): Defines the minimum price. Default is 0. Example: 10.
- `property_type` (`string`, optional): Defines property type that specifies the category of accommodation to search for. The hotel option also includes vacation rentals. Available options: hotel Default vacation_rental. Example: hotel.
- `q` (`string`, optional): This parameter is used for the terms you want to search for on Google Hotels. Example: hotels in Lisbon.
- `rating` (`string`, optional): Defines the minimum rating of results to return. Available options: 7 for 3.5+ stars 8 for 4.0+ stars 9 for 4.5+ stars. Example: 8.
- `sort_by` (`string`, optional): Defines the sorting order of the results. Available options: relevance Default lowest_price highest_rating most_reviewed. Example: lowest_price.
- `special_offers` (`boolean`, optional): Defines to show results that have special offers. Set it to true to include only hotels with special offers. Example: false.

Example input: `{"check_in_date":"<check_in_date>","check_out_date":"<check_out_date>"}`

### `searchapi_google_images_search`

Google Images Search · Read-only

Search Google Images, with size, color, type, usage rights and date filters.
Returns images with title, source page, original image URL, size and thumbnail.
Use this to find images by text. Use searchapi_google_lens_search to search by an image.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google Images. Queries can include operators and advanced filters like "cute cats", site:, inurl:, intitle:, as_dt, or as_eq. Example: aurora borealis.
- `aspect_ratio` (`string`, optional): This parameter filters images based on aspect ratio. Supported values are: square - width equals height. tall - height greater than width. wide - width greater than height. panoramic - width is at least twice the height. Example: wide.
- `color` (`string`, optional): This parameter controls the color of your search results. These options are available: black_and_white, color, transparent, red, orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown. Example: blue.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `image_type` (`string`, optional): This parameter controls the type of your search results. There are only few options that are available: clipart, line_drawing, gif, face, photo. Example: photo.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Example: 1.
- `safe` (`string`, optional): This parameter toggles the SafeSearch feature for the results. SafeSearch operates by filtering out adult content from your search results. Google's filters use proprietary technology to check keywords, phrases and URLs. While no filters are 100 percent accurate, SafeSearch will remove the overwhelming majority of adult content from your search results. Supported values are active to enable strict SafeSearch, blur to blur explicit images, and off to disable SafeSearch. By default, the value is blur. Example: active.
- `size` (`string`, optional): This parameter controls the size of your search results. There are few options available: large, medium, icon, larger_than_400x300, larger_than_640x480, larger_than_800x600, larger_than_1024x768, larger_than_2mp, larger_than_4mp, larger_than_6mp, larger_than_8mp, larger_than_12mp, larger_than_15mp, larger_than_20mp, larger_than_40mp, larger_than_70mp. Example: large.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: last_hour, last_day, last_week, last_month, last_year. Example: last_week.
- `usage_rights` (`string`, optional): This parameter controls the usage rights of your search results. Options that are available: creative_commons_licenses, commercial_or_other_licenses. Example: creative_commons_licenses.

Example input: `{"q":"<q>"}`

### `searchapi_google_jobs_listing_get`

Get Google Jobs Listing · Read-only

Get employer ratings and apply options for one Google Jobs result by job_id.
Returns the job's apply options and employer ratings from review sites.
Use this after searchapi_google_jobs_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): The ID of the job to get the employer ratings for. Use the job_id of a job returned by the Google Jobs API. A job_id stops working once Google Jobs no longer lists the job, so take it from a recent search. Example: eyJqb2JfdGl0bGUiOiJTb2Z0d2FyZSBFbmdpbmVlciIsImh0aWRvY2lkIjoiYWJjMTIzIn0=.
- `gl` (`string`, optional): This parameter defines the country of the search, which also changes the review sites Google shows ratings from. Check the full list of supported Google Jobs gl countries. Example: us.
- `hl` (`string`, optional): This parameter defines the interface language of the search, which can also change the review sites Google shows ratings from. The default follows the gl country, as listed with the Google Jobs gl countries. Some languages, such as English, round large review counts (16.6K comes back as 16600), while German (de) gives exact counts. Check the full list of supported Google hl languages. Example: en.

Example input: `{"job_id":"<job_id>"}`

### `searchapi_google_jobs_search`

Google Jobs Search · Read-only

Search job listings aggregated by Google Jobs.
Returns jobs with title, company, location, posted date, salary, job type, apply links, job_id and next_page_token.
Use this to find jobs across sites. Use searchapi_google_jobs_listing_get for one job's employer ratings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google Jobs. Queries can include terms like "software engineer" or "marketing manager in New York". Examples include: Search by location: software engineer jobs in San Francisco Search by major or field of study: biology major jobs Search from a specific website: jobs from LinkedIn Search by military occupational specialty (MOS) code: veteran jobs with MOS 11B Search remote jobs: remote customer service jobs. Example: data engineer.
- `gl` (`string`, optional): This parameter defines the country of the search. It defaults to the country of location, and to us without one. Check the full list of supported Google Jobs gl countries. When latitude and longitude are used, gl is inferred from the coordinates, and coordinates in a country this engine does not support are rejected. Example: us.
- `hl` (`string`, optional): This parameter defines the interface language of the search. The default follows the gl country, as listed with the Google Jobs gl countries. Check the full list of supported Google hl languages. Example: en.
- `latitude` (`string`, optional): Latitude of the search location, in decimal degrees (-90 to 90). Use with longitude. Cannot be combined with location or uule. Example: 40.7128.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `longitude` (`string`, optional): Longitude of the search location, in decimal degrees (-180 to 180). Use with latitude. Cannot be combined with location or uule. Example: -74.0060.
- `next_page_token` (`string`, optional): This parameter is used to retrieve the next page of results. It is returned in the response when there are more results to display. The next_page_token is a unique identifier for the next page of results. It is used to retrieve the next page of results. Example: CBQQAA.

Example input: `{"q":"<q>"}`

### `searchapi_google_lens_search`

Google Lens Search · Read-only

Search Google Lens with an image URL to find visual matches, exact matches and products.
Returns visual matches with title, link, source and thumbnail, plus related content.
Use this to identify or find an image. Use searchapi_google_reverse_image_search for classic reverse image search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `url` (`string`, required): Parameter defines the image url. This is the direct link to the image you want Google Lens to analyze. Ensure the URL points to a valid image format (e.g.,.jpg,.png) and is accessible publicly. Example: https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg.
- `country` (`string`, optional): Two-letter country code to tailor results to a specific location. Defaults to US. Check the full list of supported Google Lens country codes. Shopping results in Google Lens API are available in Austria, Australia, Belgium, Brazil, Canada, Chile, Colombia, Czech Republic, Denmark, France, Germany, India, Indonesia, Ireland, Italy, Japan, Malaysia, Mexico, Netherlands, New Zealand, Norway, Philippines, Poland, Portugal, Russia, Singapore, South Africa, South Korea, Spain, Sweden, Switzerland, Turkey, UAE, United Kingdom, and United States. Example: us.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. Google Lens is not available on tablets. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `q` (`string`, optional): Specifies the text query to be searched alongside the image. The q parameter is only applicable when search_type is set to all or visual_matches. Example: where to buy.
- `safe_search` (`string`, optional): Filters adult content in search results. Supported values are active to enable strict filtering, blur to blur explicit images, and off to disable filtering. Only works when search_type is set to exact_matches. Example: active.
- `search_type` (`string`, optional): The search_type parameter allows you to filter the search results. Supported values are all, visual_matches, and exact_matches. Example: all.

Example input: `{"url":"<url>"}`

### `searchapi_google_local_search`

Google Local Search · Read-only

Search Google's local business results (the Local Pack and Places list).
Returns local businesses with title, place_id, address, rating, reviews, type, hours and phone.
Use this for local business listings. Use searchapi_google_maps_search for map-based search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Parameter defines the query you want to search for local businesses. Examples include: Business type: pizza, coffee shops, dentist Business type + location: pizza in Austin, TX Specific business: Starbucks near me. Example: coffee shop.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google gl countries. When latitude and longitude are used, gl is inferred from the coordinates, and coordinates in a country this engine does not support are rejected. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `latitude` (`string`, optional): Latitude of the search location, in decimal degrees (-90 to 90). Use with longitude. Cannot be combined with location or uule. Example: 40.7128.
- `location` (`string`, optional): Parameter defines the geographic location for the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `longitude` (`string`, optional): Longitude of the search location, in decimal degrees (-180 to 180). Use with latitude. Cannot be combined with location or uule. Example: -74.0060.
- `page` (`integer`, optional): Parameter defines the page number of results. Each page returns up to 20 local results. Example: 1.

Example input: `{"q":"<q>"}`

### `searchapi_google_maps_place_get`

Get Google Maps Place · Read-only

Get the details of one Google Maps place by place_id or data_id.
Returns the place's name, address, phone, website, hours, rating, reviews summary, photos and popular times.
Use this after searchapi_google_maps_search. Use searchapi_google_maps_reviews_list for its reviews.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `data_id` (`string`, optional): This parameter is a unique identifier for locations on Google Maps, including businesses, landmarks, and more. It can be obtained using the Google Maps API and is used to access detailed information about a place. For example, a data_id look like 0x89c25a21fb011c85:0x33df10e49762f8e4. Note: The data_id parameter is not required if place_id parameter is being used. Example: 0x89c25a21fb011c85:0x33df10e49762f8e4.
- `gl` (`string`, optional): Parameter defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `place_id` (`string`, optional): This parameter is a unique identifier for locations on Google Maps, including businesses, landmarks, and more. It can be obtained using the Google Maps API and is used to access detailed information about a place. For example, a place_id look like ChIJhRwB-yFawokR5Phil-QQ3zM. More details about place_id can be found in the Google Maps Place ID documentation. Note: The place_id parameter is not required if data_id parameter is being used. Example: ChIJhRwB-yFawokR5Phil-QQ3zM.

Example input: `{}`

### `searchapi_google_maps_reviews_list`

List Google Maps Reviews · Read-only

List the reviews of one Google Maps place by place_id or data_id.
Returns reviews with author, rating, date, text and owner response, plus topics and next_page_token.
Use this to read what customers say about a place.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `data_id` (`string`, optional): This parameter is a unique identifier for locations on Google Maps, including businesses, landmarks, and more. It can be obtained using the Google Maps API and is used to access detailed information about a place. For example, a data_id look like 0x89c25a21fb011c85:0x33df10e49762f8e4. Note: The data_id parameter is not required if place_id parameter is being used. Example: 0x89c25a21fb011c85:0x33df10e49762f8e4.
- `gl` (`string`, optional): Parameter defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `next_page_token` (`string`, optional): Parameter defines the next page token that is used to retrieve the next page of reviews. Next page token can be found in the JSON response under pagination key. Example: CBQQAA.
- `num` (`integer`, optional): Parameter defines the number of reviews to return. The default value is 10 and the maximum value is 20. Example: 10.
- `place_id` (`string`, optional): This parameter is a unique identifier for locations on Google Maps, including businesses, landmarks, and more. It can be obtained using the Google Maps API and is used to access detailed information about a place. For example, a place_id look like ChIJhRwB-yFawokR5Phil-QQ3zM. More details about place_id can be found in the Google Maps Place ID documentation. Note: The place_id parameter is not required if data_id parameter is being used. Example: ChIJhRwB-yFawokR5Phil-QQ3zM.
- `sort_by` (`string`, optional): This parameter sorts results based on the following values: most_relevant - default sort order. newest highest_rating lowest_rating. Example: newest.

Example input: `{}`

### `searchapi_google_maps_search`

Google Maps Search · Read-only

Search Google Maps for places around an optional GPS location.
Returns places with title, place_id, data_id, address, rating, reviews, type, hours, phone and coordinates.
Use this to find businesses or places. Use searchapi_google_maps_place_get for one place's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google Maps. Queries can include terms like "restaurants near me" or "Starbucks New York". Example: pizza.
- `gl` (`string`, optional): Parameter defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `ll` (`string`, optional): The parameter specifies the GPS coordinates for the location where the query (q) should be applied. It can be formatted in two ways: @latitude,longitude,zoom (e.g. @40.7009973,-73.994778,12z) @latitude,longitude,meters (e.g. @40.7009973,-73.994778,500m) The last value can end with z (zoom, from 3z to 21z) or m (meters for radius, from 62m to 18636559m). While the zoom parameter is optional, it is advisable to use it for greater accuracy. Example: @40.7009973,-73.994778,12z.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Example: 1.

Example input: `{"q":"<q>"}`

### `searchapi_google_news_search`

Google News Search · Read-only

Search Google News for recent articles.
Returns articles with title, link, source, date, snippet and thumbnail.
Use this for news. Use searchapi_bing_news_search for Bing's news index.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google News. Queries can include operators and advanced filters like "climate change", site:, inurl:, intitle:, as_dt, or as_eq. When the site: operator is used, Google redirects the search to Google Search and the response carries web results. Use the Google News Portal API for news results filtered by publication. Example: climate policy.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google News hl languages. Example: en.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Example: 1.
- `sort_by` (`string`, optional): By default, news results are sorted by relevance. To get the most recent articles, set it to most_recent. Example: most_recent.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: last_hour - data from the past hour. last_day - data from the past 24 hours. last_week - data from the past week. last_month - data from the past month. last_year - data from the past year. Using time_period_min or time_period_max parameters, you can specify a custom time period. Note, that the time_period_min and time_period_max parameters could be used separately as well. Example: last_week.

Example input: `{"q":"<q>"}`

### `searchapi_google_patents_details_get`

Get Google Patent Details · Read-only

Get the details of one patent or scholar result from Google Patents.
Returns the patent's abstract, claims, description, inventors, assignees, dates, classifications, citations and PDF link.
Use this after searchapi_google_patents_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `patent_id` (`string`, required): Parameter defines the patent or scholar id. For example: patent/US20240003950A1/en or scholar/5943115021336935230. Ids can be found in the URL of the Google Patents (https://patents.google.com/ patent_id ?) or in the Google Patents API response. Example: patent/US20240003950A1/en.

Example input: `{"patent_id":"<patent_id>"}`

### `searchapi_google_patents_search`

Google Patents Search · Read-only

Search Google Patents with country, status, inventor, assignee and date filters.
Returns patents with title, patent_id, snippet, inventor, assignee, dates, PDF link and pagination.
Use this to find patents. Use searchapi_google_patents_details_get for one patent.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google Patents. Queries can include operators and advanced filters like "artificial intelligence", AND, or OR. For example (ChatGPT OR GPT-4). For multiple queries, split them with semicolon;. For example: ChatGPT;GPT-4. For more advanced syntax, refer to the official Google documentation on Google Patents search query syntax. Example: solid state battery.
- `after` (`string`, optional): Parameter restricts results to those published after a specific date. The date must be in the format YYYYMMDD. You can specify a type of date by prefixing it, e.g., publication:20220101. Supported date types include: priority, filing, publication. Example: priority:20200101.
- `assignee` (`string`, optional): Parameter filters results by assignee names. To specify multiple assignees, separate them with a comma,. For example: Apple Inc,Google LLC. Example: Google LLC.
- `before` (`string`, optional): Parameter restricts results to those published before a specific date. The date must be in the format YYYYMMDD. You can specify a type of date by prefixing it, e.g., publication:20220101. Supported date types include: priority, filing, publication. Example: publication:20251231.
- `countries` (`string`, optional): Parameter filters results by country. Use the ISO 3166-1 alpha-2 country code, e.g., US for the United States, DE for Germany. To use multiple countries, separate them with a comma,. For example: US,DE. Check the full list of supported Google Patents countries. Example: US,DE.
- `inventor` (`string`, optional): Parameter filters results by inventor names. To specify multiple inventors, separate them with a comma,. For example: John Doe,Jane Doe. Example: John Doe.
- `language` (`string`, optional): Parameter filters results by language. To specify multiple languages, separate them with a comma,. For example: SWEDISH,ITALIAN Supported languages include: ARABIC, CHINESE, DANISH, DUTCH, ENGLISH, FINNISH, FRENCH, GERMAN, ITALIAN, JAPANESE, KOREAN, NORWEGIAN, PORTUGUESE, RUSSIAN, SPANISH, SWEDISH. Example: ENGLISH.
- `litigation` (`string`, optional): Parameter filterss patent results by litigation status. Use YES to include results with related litigation, NO to exclude them. Example: YES.
- `num` (`integer`, optional): This parameter specifies the number of results to display per page. By default, it is set to 10. Use in combination with the page parameter to implement pagination functionality. Max num per page is 100, min - 10. Example: 10.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Use in combination with the num parameter to implement pagination. Example: 1.
- `patent_status` (`string`, optional): Parameter filters patent results by status. Use GRANT for granted patents and APPLICATION for patent applications. Example: GRANT.
- `patent_type` (`string`, optional): Parameter filters patent results by type. Use PATENT for patents, DESIGN for design patents. Example: PATENT.
- `patents` (`boolean`, optional): Parameter controls the inclusion of patent results. Set to false to exclude patents. Default value is true. Example: true.
- `scholar` (`boolean`, optional): Parameter controls the inclusion of scholarly results. Set to true to include scholarly results. Default value is false. Example: false.
- `sort` (`string`, optional): Parameter controls the sorting order. The default is relevance. Other options include: new - Sort by filing date for patents, and by publication date for scholarly results. old - Sort by filing date for patents, and by publication date for scholarly results, in ascending order. Example: new.

Example input: `{"q":"<q>"}`

### `searchapi_google_play_store_search`

Google Play Store Search · Read-only

Search or browse the Google Play Store for apps, games, movies or books, including top charts.
Returns items with title, product id, developer, rating, price, category and link.
Use this for Android app research. Use searchapi_apple_app_store_search for iOS.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `store` (`string`, required): Parameter defines the store you would like to retrieve. There are several options to pick: apps, games, movies, and books. Example: apps.
- `age` (`string`, optional): The parameter is utilized to filter content based on the age of the target audience. It offers three distinct options: age_range1 option targets content suitable for an audience up to 5 years old. age_range2 option targets content suitable for an audience aged between 6 and 8 years old. age_range3 option targets content suitable for an audience aged between 9 and 12 years old. Note that this parameter only takes effect when combined with store and specific category pairs. These are: store=apps and category=FAMILY. store=movies and category=FAMILY. store=books and category=coll_1689. Example: age_range1.
- `category` (`string`, optional): Parameter defines a category to narrow your search. Here are all available Google Play Store apps, movies, and books categories. games categories are included in the apps categories list and should be used with the apps store. Example: GAME_ACTION.
- `chart` (`string`, optional): Parameter defines the chart that is used to retrieve the top charts and up to 500 results. Chart parameters could be found in store parsers. For instance: topselling_free will retrieve the top free apps; topselling_paid will retrieve the top paid apps. Example: topselling_free.
- `gl` (`string`, optional): The default parameter US defines the country of the store. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the language of the store. Check the full list of supported Google hl languages. Example: en.
- `next_page_token` (`string`, optional): Parameter defines the next page token that is used to retrieve the next page of results. Example: CBQQAA.
- `price` (`string`, optional): Parameter defines the price filter that is used only together with q search parameter with apps and books stores. There are 2 options for a price filter: 1 will only display free items from given search query; 2 will only display paid items from given search query. Example: 1.
- `q` (`string`, optional): This parameter is used for the terms you want to search on Google Play Store. Queries can include operators and advanced filters like \"puzzle games\", pub:"SEGA", or other advanced syntax. Example: budget tracker.
- `store_device` (`string`, optional): Default parameter phone - defines the store device of the apps or games store. There is a list of available store devices: windows, phone, tablet, tv, chromebook, watch and car. Example: phone.

Example input: `{"store":"<store>"}`

### `searchapi_google_product_get`

Get Google Product · Read-only

Get one Google Shopping product by its product_token.
Returns the product's title, description, prices from sellers, ratings, reviews and specifications.
Use this after searchapi_google_shopping_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `product_token` (`string`, required): Identifies the product. Mint one via the Google Shopping API and reuse the product_token returned in any shopping_results entry. Example: eyJlaSI6Im5ZVmxaOXVVTDY3dGkt.
- `gl` (`string`, optional): The default parameter us defines the country of the search. See the full list of Google Product gl countries.. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.

Example input: `{"product_token":"<product_token>"}`

### `searchapi_google_related_questions_get`

Get Google Related Questions · Read-only

Expand Google's People Also Ask questions using the next_page_token from a Google Search result.
Returns more related questions with their answers, sources and tokens.
Use this after searchapi_google_search returns related_questions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `next_page_token` (`string`, required): The next_page_token is used to fetch expanded answers for "People Also Ask" questions. This token is returned in the related_questions array from Google Search API results. Each question returned by this API also includes its own next_page_token, allowing you to recursively explore related questions. Example: CBQQAA.

Example input: `{"next_page_token":"<next_page_token>"}`

### `searchapi_google_reverse_image_search`

Google Reverse Image Search · Read-only

Run a Google reverse image search for an image URL.
Returns pages that contain the image, with title, link, snippet and image details.
Use this to find where an image appears. Use searchapi_google_lens_search for visual matches.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `url` (`string`, required): Parameter defines the image url. This is the direct link to the image you want to search with. The image must be publicly accessible, point to a valid image format (e.g.,.jpg,.png), and the url must be at most 6000 characters long. Example: https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg.
- `country` (`string`, optional): Two-letter country code that defines the location the search is made from. Defaults to us. Check the full list of supported Google Reverse Image country codes. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.

Example input: `{"url":"<url>"}`

### `searchapi_google_scholar_author_get`

Get Google Scholar Author · Read-only

Get a Google Scholar author profile and articles by author_id.
Returns the author's name, affiliation, interests, citation metrics, co-authors and articles.
Use this to look up a researcher. Use searchapi_google_scholar_search to find articles.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `author_id` (`string`, required): The parameter specifies the author_id for your search. Locate these values in: The URL of a Google Scholar page: https://scholar.google.com/citations?user= author_id. Example: JicYPdAAAAAJ.
- `citation_id` (`string`, optional): The parameter is essential for retrieving individual article citation. It's required when either: view_op=view_citation view_op=view_mandate You can identify these values in the JSON responses from the current engine when: Using author_id without any view_op parameter. Using author_id with the view_op=list_mandates parameter. Furthermore, these values are also available in the URL of a Google Scholar page: https://scholar.google.com/citations?view_op=view_citation&citation_for_view= citation_id. Note: The parameter can also be used independently, without the author_id. Example: JicYPdAAAAAJ:u5HHmVD_uO8C.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `page` (`integer`, optional): Parameter indicates which page of results to return. By default, it is set to 1. Parameter is only used while view_op parameter is empty or is set to list_mandates. Example: 1.
- `sortby` (`string`, optional): Articles are sorted by the number of citations by default. If you wish to: Sort by date, use: sortby=pubdate. Sort by title, use: sortby=title. Example: pubdate.
- `view_op` (`string`, optional): The parameter specifies the search type. By default, it provides detailed information about an author. Here are the available options:: view_citation - Provides in-depth citation details. A citation_id is required. list_mandates - Displays a list of author mandates. view_mandate - Offers detailed information on a mandate. A citation_id is required. list_colleagues - Enumerates all co-authors. Example: view_citation.

Example input: `{"author_id":"<author_id>"}`

### `searchapi_google_scholar_cite_get`

Get Google Scholar Citation · Read-only

Get the citation formats for a Google Scholar article by its data_cid.
Returns citations in MLA, APA, Chicago, Harvard and Vancouver, plus BibTeX and other export links.
Use this after searchapi_google_scholar_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `data_cid` (`string`, required): Parameter defines the cite id of the selected article. This id can be found in Google Scholar search results under the data_cid key value. Example: FDc6HiktlqEJ.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.

Example input: `{"data_cid":"<data_cid>"}`

### `searchapi_google_scholar_search`

Google Scholar Search · Read-only

Search Google Scholar for academic articles, optionally by citing article or year range.
Returns articles with title, link, authors, publication, snippet, cited_by count, versions and data_cid.
Use this to find papers. Use searchapi_google_scholar_cite_get for citation formats.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search in Google Scholar. Queries can include operators and advanced filters like "quantum computing", author:, or source:. Parameter is not required if cites or cluster parameter is present. Example: transformer neural networks.
- `as_rr` (`string`, optional): Default value 0 returns all results. Use 1 to return results only with review articles. Example: 1.
- `as_yhi` (`integer`, optional): Parameter sets the start year to filter results. Pair with as_yhi for a specific end year. Input format: YYYY. E.g., as_yhi=2022 fetches results till 2022 backwards. Example: 2026.
- `as_ylo` (`integer`, optional): Parameter sets the start year to filter results. Pair with as_yhi for a specific end year. Input format: YYYY. E.g., as_ylo=2022 fetches results from 2022 onwards. Example: 2022.
- `cites` (`string`, optional): The cites parameter is used to specify a unique ID for an article. Utilizing this parameter will generate a list of documents in Google Scholar that cite the specified article. For instance, cites=13392090434137936466 could be used to find all documents that cite the article with this unique ID. Additionally, using both the cites and q parameters together will result in a search within the citing articles themselves. Example: 6382582187718744581.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `num` (`integer`, optional): This parameter specifies the number of results to display per page. By default, it is set to 10, maximum number - 20. Use in combination with the page parameter to implement pagination functionality. Example: 10.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Use in combination with the num parameter to implement pagination. Example: 1.
- `source` (`string`, optional): This parameter allows filtering of organic results based on a specific source. It is added to the q parameter and is not compatible with cites or cluster parameters. Example: Nature.

Example input: `{"q":"<q>"}`

### `searchapi_google_search`

Google Search · Read-only

Search Google and get the results page as structured JSON.
Returns organic results with title, link and snippet, plus ads, knowledge graph, answer box, related questions and searches, and pagination.
Use this for general web search. Use searchapi_google_news_search for news or searchapi_google_ai_mode_search for an AI answer.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google. Queries can include operators and advanced filters like "machine learning models", site:, inurl:, intitle:, AND, or OR. Example: best project management software.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google gl countries. When latitude and longitude are used, gl is inferred from the coordinates, and coordinates in a country this engine does not support are rejected. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `latitude` (`string`, optional): Latitude of the search location, in decimal degrees (-90 to 90). Use with longitude. Cannot be combined with location or uule. Example: 40.7128.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. For example - location=New York would select New York,United States or location=London would select London TV Region,England,United Kingdom. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `longitude` (`string`, optional): Longitude of the search location, in decimal degrees (-180 to 180). Use with latitude. Cannot be combined with location or uule. Example: -74.0060.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Example: 1.
- `safe` (`string`, optional): This parameter toggles the SafeSearch feature for the results. SafeSearch operates by filtering out adult content from your search results. Google's filters use proprietary technology to check keywords, phrases and URLs. While no filters are 100 percent accurate, SafeSearch will remove the overwhelming majority of adult content from your search results. Supported values are active to enable strict SafeSearch, blur to blur explicit images, and off to disable SafeSearch. By default, the value is blur. Example: active.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: last_1_minute - data from the past minute. last_5_minutes - data from the past 5 minutes. last_15_minutes - data from the past 15 minutes. last_30_minutes - data from the past 30 minutes. last_hour - data from the past hour. last_day - data from the past 24 hours. last_week - data from the past week. last_month - data from the past month. last_year - data from the past year. Using time_period_min or time_period_max parameters, you can specify a custom time period. Example: last_week.
- `verbatim` (`boolean`, optional): This parameter forces Google to use your exact keywords, bypassing automatic spelling corrections, synonyms, and personalized or stemmed variations. Set the value to true to enable. When combined with time_period, time_period_min or time_period_max, the time filter is ignored. Note: Verbatim mode is stricter than the nfpr parameter — it disables all query modifications, not just spelling corrections. If you only want to prevent spelling auto-correction while keeping other Google features, use nfpr=1 instead. Example: false.

Example input: `{"q":"<q>"}`

### `searchapi_google_shopping_search`

Google Shopping Search · Read-only

Search Google Shopping for products with price, condition and seller filters.
Returns products with title, price, seller, rating, reviews, delivery and product_token.
Use this to compare prices. Use searchapi_google_product_get with a product_token for one product's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Specifies the search query, similar to performing a regular Google search. Filters embedded in the q parameter act as hints rather than strict filters. If there are too few matching items, results outside the filters may appear. Examples of usage: Search by price: tshirt under $30, skinny fit kids jeans between $15 and $30, charizard over $300. Search by size: mens size 8.5 nike air. Search by color: Playstation white. Search nearby stores: Apparel nearby. Search by condition: iphone used, macbook new. Search by brand: prada dress, gucci shoes. Example: running shoes.
- `condition` (`string`, optional): Filters product condition. Options include: new for new products, and used for used items. Example: new.
- `gl` (`string`, optional): The default parameter us defines the country of the search. See the full list of Google Shopping gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `is_free_delivery` (`boolean`, optional): Filters results to show only products with free shipping available. Set to true to show only items that offer free shipping. Can be combined with is_on_sale, is_small_business, and sort_by for more refined searches. Note: If the shoprs parameter is provided, it takes priority and this parameter will be ignored. Example: true.
- `is_on_sale` (`boolean`, optional): Filters results to show only products that are currently on sale. Set to true to show only discounted items. Can be combined with is_small_business, is_free_delivery, and sort_by for more refined searches. Note: If the shoprs parameter is provided, it takes priority and this parameter will be ignored. Example: true.
- `is_small_business` (`boolean`, optional): Filters results to show only products sold by small businesses. Set to true to show only small business sellers. Can be combined with is_on_sale, is_free_delivery, and sort_by for more refined searches. Note: If the shoprs parameter is provided, it takes priority and this parameter will be ignored. Example: false.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `page` (`integer`, optional): Indicates which page of results to return. The default is 1. Example: 1.
- `price_max` (`string`, optional): Specifies the maximum price of the products returned. The amount is in the local currency of the selected gl. For example, 100 filters results to products priced at $100 or less. Note: If the shoprs parameter is provided, it takes priority and this parameter will be ignored. Example: 200.
- `price_min` (`string`, optional): Specifies the minimum price of the products returned. The amount is in the local currency of the selected gl. For example, 2.50 filters results to products priced at $2.50 or higher. Note: If the shoprs parameter is provided, it takes priority and this parameter will be ignored. Example: 10.
- `sort_by` (`string`, optional): Sorts the shopping results by the specified criteria. Available options: price_low_to_high - Sort products from lowest to highest price price_high_to_low - Sort products from highest to lowest price rating_high_to_low - Sort products by rating, highest first Can be combined with is_on_sale, is_small_business, and is_free_delivery filters. Note: If the shoprs parameter is provided, it takes priority and this parameter will be ignored. Example: price_low_to_high.

Example input: `{"q":"<q>"}`

### `searchapi_google_trends_get`

Get Google Trends Data · Read-only

Get Google Trends data for up to 5 queries: interest over time, by region, related queries or related topics.
Returns the trend data for the chosen data_type, such as timeline values or region values.
Use this to compare search interest. Use searchapi_google_trends_trending_now_list for what is trending now.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `data_type` (`string`, required): Parameter defines the data type you wish to search for. You have several options to choose from: TIMESERIES also known as Interest Over Time, used to return historical, indexed data for a given input. GEO_MAP also known as Interest Over Region, used for geographical data. RELATED_QUERIES corresponds to searches for queries that are related to the given input. RELATED_TOPICS represents searches related to specific topics. Example: TIMESERIES.
- `cat` (`integer`, optional): The parameter for category selection defaults to 0, representing All Categories. This parameter determines the category to be used for the specified search. Please refer to the complete list of supported Google Trends Categories for more details. Example: 0.
- `geo` (`string`, optional): The default value for the location parameter is set to Worldwide, which denotes a global scope for the search. This parameter specifies the geographical area for the query search. If it is not explicitly set, the search defaults to a worldwide range. Check the full list of supported Google Trends geo locations. Example: US.
- `q` (`string`, optional): Parameter defines the search query. It can be either required or optional based on the data_type parameter: data_type=TIMESERIES - search query is required only if cat=0 (default). It is limited to 5 search queries that should be seperated by,. For instance: Java,JavaScript,Python. data_type=GEO_MAP - search query is required. data_type=RELATED_QUERIES - search query is optional. data_type=RELATED_TOPICS - search query is optional. Example: Java,Python.
- `region` (`string`, optional): The parameter specifies the geographical region for your chosen search. It is usable only with GEO_MAP data_type. There are few options to consider: COUNTRY - selects data from country searches. Usable only with Worldwide geo value. REGION - selects data from a states or provinces. DMA - selects data from metros. CITY - selects data from cities. Example: REGION.
- `time` (`string`, optional): The parameter determines the time range for the data retrieval. There are a few options: now 1-H - data from the past hour. now 4-H - data from the past 4 hours. now 1-d - data from the past day. now 7-d - data from the past 7 days. today 1-m - data from the past 30 days. today 3-m - data from the past 90 days. today 12-m - data from the past 12 months. today 5-y - data from the past 5 years. all - All available data since 2004. To select a custom date range, use the format yyyy-mm-dd. For example, 2019-01-01 2019-12-31 will retrieve data for the entire year of 2019. Example: today 12-m.

Example input: `{"data_type":"<data_type>"}`

### `searchapi_google_trends_trending_now_list`

List Google Trends Trending Now · Read-only

List the searches trending now on Google Trends for a country.
Returns trending searches with query, search volume, growth, start time, categories and related queries.
Use this to find what people search for right now.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `geo` (`string`, optional): Specifies the geographical area for the search, with the default set to US. For a full list of supported locations, refer to the Google Trends Trending Now geo locations. Example: US.
- `time` (`string`, optional): Filters trending queries based on the specified time duration. Available options: past_4_hours past_24_hours Default past_48_hours past_7_days. Example: past_24_hours.

Example input: `{}`

### `searchapi_google_videos_search`

Google Videos Search · Read-only

Search Google Videos, with duration, quality and caption filters.
Returns videos with title, link, source, channel, duration, date and thumbnail.
Use this for videos across sites. Use searchapi_youtube_search for YouTube only.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Google Videos. Queries can include operators and advanced filters like "cooking tutorials", site:, inurl:, intitle:, as_dt, or as_eq. Example: sourdough bread recipe.
- `captioned` (`string`, optional): This parameter restricts results to URLs based on video captions. By default, all videos are returned. To retrieve only videos with closed caption, closed param should be used. Note: this parameter is not compatible with a custom tbs parameter. Example: closed.
- `device` (`string`, optional): The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `duration` (`string`, optional): This parameter restricts results to URLs based on video duration. Supported values are: short - short videos (0-4 min.). medium - medium videos (4-20 min.). long - long videos (20+ min.). Note: this parameter is not compatible with a custom tbs parameter. Example: medium.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported Google gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Example: en.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. Add the region or country after a comma to pick a specific place: location=Kansas City, Kansas selects Kansas City,Kansas,United States. Example: New York.
- `page` (`integer`, optional): This parameter indicates which page of results to return. By default, it is set to 1. Example: 1.
- `quality` (`string`, optional): This parameter restricts results to URLs based on video quality. By default, all videos are returned. To retrieve only videos with high quality, high param should be used. Note: this parameter is not compatible with a custom tbs parameter. Example: high.
- `safe` (`string`, optional): This parameter toggles the SafeSearch feature for the results. SafeSearch operates by filtering out adult content from your search results. Google's filters use proprietary technology to check keywords, phrases and URLs. While no filters are 100 percent accurate, SafeSearch will remove the overwhelming majority of adult content from your search results. Supported values are active to enable strict SafeSearch, blur to blur explicit images, and off to disable SafeSearch. By default, the value is blur. Example: active.
- `source` (`string`, optional): This parameter restricts results to URLs based on source. Supported values are: youtube, cncc, cnn, ted, cbsnews, twitter, tiktok, facebook, timesnownews, nbcnews, foxnews. Note: this parameter is not compatible with a custom tbs parameter. Example: Nature.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: last_hour - data from the past hour. last_day - data from the past 24 hours. last_week - data from the past week. last_month - data from the past month. last_year - data from the past year. Note: this parameter is not compatible with a custom tbs parameter. Example: last_week.

Example input: `{"q":"<q>"}`

### `searchapi_indeed_jobs_search`

Indeed Jobs Search · Read-only

Search Indeed job postings by keywords and location.
Returns jobs with title, company, location, salary, posted date and link.
Use this to find jobs on Indeed. Use searchapi_google_jobs_search for jobs from many sites.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Parameter defines the keywords to search for, such as a job title, a skill or a company name. Example: product manager.
- `gl` (`string`, optional): Parameter defines the country whose Indeed site to search, as an ISO 3166-1 alpha-2 code such as us, gb or de. It supports 45 countries and defaults to us. Example: us.
- `location` (`string`, optional): Parameter defines the city, region or ZIP code to search jobs in. Without it, jobs are searched across the country. Example: New York.

Example input: `{"q":"<q>"}`

### `searchapi_linkedin_jobs_search`

LinkedIn Jobs Search · Read-only

Search public LinkedIn job postings by keywords, location, company and recency.
Returns jobs with title, company, location, posted date, link and filters.
Use this to find jobs on LinkedIn. Use searchapi_indeed_jobs_search for Indeed.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`string`, optional): Parameter filters jobs by LinkedIn company ids, separated by commas, up to 50. Jobs from any of the companies are returned. The company filter in a response lists companies hiring for the search, each with its id as value. Example: 1441.
- `distance` (`integer`, optional): Parameter defines the search radius around a city in miles. It can be set to 10, 25, 50 or 100. LinkedIn uses 50 miles when it is not set, and ignores it for a country. It requires location or location_id. Example: 25.
- `has_under_10_applicants` (`boolean`, optional): Set this parameter to true to return only jobs with fewer than 10 applicants. Example: false.
- `is_easy_apply` (`boolean`, optional): Set this parameter to true to return only Easy Apply jobs, which candidates apply to on LinkedIn. Example: false.
- `location` (`string`, optional): Parameter defines the city, region or country to search jobs in, up to 200 characters. LinkedIn matches the text to one of its own locations, and search_parameters.location_used names the place it searched. It cannot be used together with location_id. Without either, jobs are searched worldwide. search_parameters.location_id_used is the id of the place LinkedIn searched, which works as location_id. Example: New York.
- `location_id` (`string`, optional): Parameter defines the LinkedIn location id to search jobs in. It is the geoId value in a LinkedIn job search URL, for example 103644278 for the United States. LinkedIn location ids are 8 or 9 digits. It cannot be used together with location. A search with an id LinkedIn does not know returns an error. Example: 103644278.
- `page` (`integer`, optional): Parameter defines the page of results, from 1 to 95. The first page returns up to 60 jobs and each later page up to 10. Later pages return jobs and pagination only. Example: 1.
- `q` (`string`, optional): Parameter defines the keywords to search for, such as a job title, a skill or a company name. It can be up to 500 characters long. Example: machine learning engineer.
- `time_period` (`string`, optional): Parameter filters jobs by how recently they were posted. It can be set to last_hour, last_day, last_week or last_month. Example: last_week.

Example input: `{}`

### `searchapi_locations_search`

Search Locations · Read-only

Find the exact location names SearchApi accepts for the location parameter.
Returns matching locations with canonical name, country code, target type and reach.
Use this to choose a location value before a Google search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The search query to use to search for locations. For example, new york and london. Example: Austin.
- `limit` (`integer`, optional): The maximum number of results to return. Defaults to 10. Maximum is 100. Example: 10.

Example input: `{"q":"<q>"}`

### `searchapi_meta_ad_library_search`

Meta Ad Library Search · Read-only

Search the Meta Ad Library for Facebook, Instagram, Messenger and Threads ads by keyword or page.
Returns ads with page, ad id, status, start and end dates, platforms, creative text and media, plus next_page_token.
Use this for competitor ad research on Meta platforms.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `active_status` (`string`, optional): Filters ads by their status. Default is active. Supported values include: active, inactive, all. Example: active.
- `ad_type` (`string`, optional): Specifies the type of ads to return. Default is all. Supported values include: all, political_and_issue_ads, housing_ads, employment_ads, credit_ads. Note: Availability may depend on the selected country. Check the full list of supported Meta Ad Library countries and their supported ad_type. Example: all.
- `content_languages` (`string`, optional): Comma-separated list of content languages to filter ads by. Check the full list of supported Meta Ad Library content languages. Example: en.
- `country` (`string`, optional): Specifies the country for your search. The default value is ALL. Check the full list of supported Meta Ad Library countries and their supported ad_type. Example: us.
- `end_date` (`string`, optional): The latest date to include ads from, in format YYYY-MM-DD. Cannot be in the future (relative to UTC). Example: 2026-10-31.
- `location_id` (`string`, optional): Filters ads based on a specific geographic location using Meta Ad Library's location targeting feature. This parameter must be used together with location_name and location_type to define the targeted area. All three values can be obtained using our Page Search API, which supports location search aligned with Meta Ad Library's internal targeting system. Example: 103644278.
- `media_type` (`string`, optional): Filters results based on media type. Default is all. Supported values are: all, video, image, meme, image_and_meme, none. Example: all.
- `next_page_token` (`string`, optional): A token for fetching the next set of results. You can obtain this token from the next_page_token field in the previous response. Note: Tokens can grow large (8KB+) after several pages. If you encounter 413 or 414 errors, use a POST request with the token in the JSON body instead of the URL query string. Example: CBQQAA.
- `page_id` (`string`, optional): Specifies the page's unique ID. You can obtain the page_id in two ways: Use our Page Search API to retrieve the page ID directly from Meta Ad Library. Inspect the URL from the Meta Ad Library website and locate the view_all_page_id parameter. When present, in the response there are additional fields ad_library_page_info and page blocks. Example: 20531316728.
- `platforms` (`string`, optional): Comma-separated list of platforms where the ads appear. Supported values include: facebook, instagram, audience_network, messenger, threads. Example: facebook,instagram.
- `q` (`string`, optional): Defines the keyword for your search. When present together with page_id or location_id, it will filter that page or location for the keyword. Enclosing the whole query in double quotes searches for an exact phrase, for example q="air jordan". You can pass several quoted phrases, such as q="air jordan" "just do it", and each one is matched as a phrase. Mixing quoted and unquoted terms, for example q="air jordan" nike, is matched as unordered keywords. Use search_type to control this explicitly. Example: running shoes.
- `search_type` (`string`, optional): Controls how q is matched. Supported values are keyword_unordered, which matches ads containing all your keywords in any order, and keyword_exact_phrase, which matches quoted phrases exactly, respecting word order. When omitted, the type is inferred from q: a query made up entirely of quoted phrases uses keyword_exact_phrase, and anything else uses keyword_unordered. This parameter is ignored when page_id or location_id is present, since those searches use their own type. Example: keyword_unordered.
- `sort_by` (`string`, optional): Specifies the sort order of results. Supported values are: most_recent, impressions_high_to_low. Default is impressions_high_to_low. Example: impressions_high_to_low.
- `start_date` (`string`, optional): The earliest date to include ads from, in format YYYY-MM-DD. Cannot be in the future (relative to UTC). Example: 2026-01-01.

Example input: `{}`

### `searchapi_perplexity_search`

Perplexity Search · Read-only

Ask Perplexity a question and get its answer with sources.
Returns the answer text and the cited sources.
Use this for an AI answer with citations. Use searchapi_chatgpt_search for ChatGPT.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to ask Perplexity. The answer is returned in the same language as your query - for example, queries in German will receive answers in German, queries in Spanish will receive answers in Spanish. Example: What is retrieval augmented generation?.
- `sources` (`string`, optional): Comma-separated list of source connectors Perplexity searches. Defaults to web. Supported values are: web - General web results. scholar - Academic papers and journals. Example: sources=web,scholar.

Example input: `{"q":"<q>"}`

### `searchapi_reddit_search`

Reddit Search · Read-only

Search Reddit posts, optionally in one subreddit.
Returns posts with title, subreddit, author, score, comment count, date and link, plus next_page_token.
Use this for Reddit discussions. Use searchapi_google_forums_search for many forums.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The terms you want to search for, up to 512 characters. Supports Reddit search operators such as site: and author:. Example: home espresso machine.
- `next_page_token` (`string`, optional): The token for the next page of results. Use the pagination.next_page_token value from the previous response. Each page holds up to 7 posts, as on Reddit. Reddit re-ranks relevance results between requests, so later pages of a relevance search across all of Reddit can repeat a post. Example: CBQQAA.
- `safe` (`string`, optional): Controls NSFW results. active (default) leaves them out, off includes them. Example: active.
- `sort_by` (`string`, optional): Sorts the results. Options are: relevance - most relevant first (default) hot - currently popular top - highest score new - newest first comment_count - most comments. Example: top.
- `subreddit` (`string`, optional): Restricts the search to one subreddit, given by its name, for example rails. Example: rails.
- `time_period` (`string`, optional): Limits the results to posts created in a time range. Options are: last_hour last_day last_week last_month last_year any_time (default). Example: last_month.

Example input: `{"q":"<q>"}`

### `searchapi_tripadvisor_search`

Tripadvisor Search · Read-only

Search Tripadvisor for places, hotels, restaurants and things to do.
Returns results with name, place id, type, location, rating, reviews and link.
Use this for travel reviews and places.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Parameter defines the query you want to search. This can be a destination, hotel name, restaurant, attraction, or any travel-related search term. Example: Rome.
- `category` (`string`, optional): This parameter filters results by category. Main options are places and forums. Default value is places. You can also filter by place category using: things_to_do, restaurants, destinations, hotels, airlines. Example: restaurants.
- `lat` (`string`, optional): Parameter defines the GPS latitude for the search origin. Must be between -90 and 90. Must be used together with lon. Example: 40.7128.
- `location` (`string`, optional): Parameter defines the location for the search. The location is resolved to GPS coordinates using the locations API. See the full list of supported locations. Example: New York.
- `lon` (`string`, optional): Parameter defines the GPS longitude for the search origin. Must be between -180 and 180. Must be used together with lat. Example: -74.0060.
- `num` (`integer`, optional): This parameter defines the number of results to return per page. Acceptable values are between 1 and 100. Example: 10.
- `page` (`integer`, optional): This parameter defines the page number for pagination. Must be 1 or greater. Example: 1.
- `tripadvisor_domain` (`string`, optional): This parameter defines the Tripadvisor domain to search on. Each domain corresponds to a specific country/region and language. Check the full list of supported Tripadvisor domains. Example: tripadvisor.com.

Example input: `{"q":"<q>"}`

### `searchapi_walmart_search`

Walmart Search · Read-only

Search Walmart.com products with price, category and sort filters.
Returns products with title, product id, price, rating, reviews, seller and fulfillment.
Use this for Walmart prices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The parameter specifies your search query. It accepts any term or phrase you'd typically input in a Walmart search. Example: air fryer.
- `category_id` (`string`, optional): This parameter filters search to a specific category id. To find a category id, search on Walmart and add a filter by department, for example: searching for "Bear" and selecting "Food" in Departments gives us https://www.walmart.com/search?q=bear&catId=976759 where 976759 is the category ID for "Food". Example: 976759.
- `filters` (`string`, optional): To narrow search results using filters, use the format name:value. For multiple filters, separate them with a double pipe (||). For example: brand:Ghirardelli||retailer_type:Walmart The full list of available filters appears in the response’s filters section. However, the quickest way to discover valid filters is to: Go to Walmart.com. Run a product search and apply the filters you want. Copy the value that appears in the URL after facet=. Example: brand:Ninja.
- `page` (`integer`, optional): The parameter determines the results page number. It defaults to 1. Walmart stops serving results after page 10, so requests beyond it come back empty even when the response's pagination.other_pages section advertises higher page numbers. Example: 1.
- `price_max` (`string`, optional): This parameter controls the maximum price of the products returned. For instance - 20.5 value would return products with a maximum price of $20.5. Example: 200.
- `price_min` (`string`, optional): This parameter controls the minimum price of the products returned. For instance - 10 value would return products with a minimum price of $10. Example: 10.
- `sort_by` (`string`, optional): Parameter allows sorting search results by different criteria. Below is the list of available sorting options: best_match - sort order based on relevance. Default price_low_to_high price_high_to_low best_seller Note: the response's filters section mirrors the sort options Walmart shows on its own site, which include entries such as rating_high and new. Only the four values listed above are accepted by this parameter. Example: price_low_to_high.

Example input: `{"q":"<q>"}`

### `searchapi_yandex_search`

Yandex Search · Read-only

Search Yandex, the main Russian search engine.
Returns organic results with title, link and snippet, plus pagination.
Use this for Russian-language web results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on Yandex. Queries can include operators and advanced filters like "machine learning models". Example: weather Moscow.
- `lang` (`string`, optional): Parameter defines the interface language of the search. Check the full list of supported Yandex lang languages. Example: en.
- `location` (`string`, optional): This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check the full list of supported Yandex locations. Example: Moscow.
- `page` (`integer`, optional): Specifies the page of results to return. The default value is 1. Example: 1.
- `time_period` (`string`, optional): This parameter restricts results to URLs based on date. Supported values are: last_day - data from the past 24 hours. last_two_weeks - data from the past 2 week. last_month - data from the past month. Example: last_month.
- `yandex_domain` (`string`, optional): The default parameter yandex.com defines the Yandex domain of the search. Check the full list of supported Yandex yandex_domain domains. Example: yandex.com.

Example input: `{"q":"<q>"}`

### `searchapi_yelp_search`

Yelp Search · Read-only

Search Yelp for local businesses in a location.
Returns businesses with name, Yelp id, rating, reviews, price, categories, address and phone.
Use this for Yelp business listings. Use searchapi_google_maps_search for Google Maps.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `location` (`string`, required): This parameter defines the geographic area to search around. It accepts a city and state (New York, NY), an address, or a ZIP code. Example: San Francisco, CA.
- `category` (`string`, optional): This parameter filters results by a Yelp category alias, e.g. restaurants or barbers. Category aliases are returned in the categories field of mobile results. Example: restaurants.
- `device` (`string`, optional): This parameter defines the device to search on. mobile (default) returns up to 80 organic results per page. desktop returns 10 per page and adds neighborhoods and is_service_area_business to results. Desktop results come without distance, and desktop organic results without phone. Desktop addresses give the street and city only, and desktop search_information.location has no gps_coordinates. Desktop categories carry no alias, and their titles can differ from mobile's. Desktop ads come without tracking_link. Example: desktop. One of: `desktop`, `mobile`, `tablet`.
- `filters` (`string`, optional): This parameter filters results by Yelp attribute tokens. Combine multiple tokens with commas, e.g. GoodForKids,RestaurantsDelivery. Yelp ignores tokens it does not recognize. Example: GoodForKids.
- `page` (`integer`, optional): This parameter defines the page of results to return. A mobile page holds up to 80 results (Yelp uses 60 or 10 for some searches), and a desktop page holds 10. Yelp lists at most 240 results in total for a search term and location, across all pages combined. Yelp can reorder results between requests, so a business may appear on more than one page. Use place_id to deduplicate results. Example: 1.
- `price` (`string`, optional): This parameter filters results by price level, from 1 ($) to 4 ($$$$). Combine multiple levels with commas, e.g. 1,2. Example: 2.
- `q` (`string`, optional): This parameter defines the search term, such as a business name (Starbucks) or a category keyword (dentist, coffee). It can be up to 128 characters. Example: sushi.
- `sort_by` (`string`, optional): This parameter defines how results are ordered. Supported values are recommended (default), rating, and review_count. review_count requires device=desktop. Example: rating.

Example input: `{"location":"<location>"}`

### `searchapi_youtube_channel_get`

Get YouTube Channel · Read-only

Get the details of a YouTube channel by ID or @handle.
Returns the channel's title, description, subscriber count, video count, links and recent videos.
Use this to look up a creator.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `channel_id` (`string`, required): Identifies the YouTube channel to query. Accepts a channel ID or an '@' handle from YouTube URLs. For channel IDs, use the format: https://www.youtube.com/channel/CHANNEL_ID. For '@' handles, use: https://www.youtube.com/@HANDLE. Examples: UCXZCJLdBC09xxGZ6gcdrc6A for channel IDs; @BostonDynamics for '@' handles. Example: @Google.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported YouTube gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported YouTube hl languages. Example: en.

Example input: `{"channel_id":"<channel_id>"}`

### `searchapi_youtube_comments_list`

List YouTube Comments · Read-only

List the comments on a YouTube video.
Returns comments with author, text, likes, reply count and date, plus next_page_token.
Use this to read viewer reactions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): The unique identifier for a YouTube video. Find it in the video's URL, e.g., https://www.youtube.com/watch?v= video_id, or through our YouTube Search API. Also accepts full YouTube URLs (https://www.youtube.com/watch?v=VIDEO_ID, shorts, embed and live) and share links (https://youtu.be/VIDEO_ID). Example: dQw4w9WgXcQ.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported YouTube gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported YouTube hl languages. Example: en.
- `next_page_token` (`string`, optional): This token is used to retrieve the next page of comments or replies. When using the YouTube Comments API, use the next_page_token or replies_next_page_token provided in the previous response to load subsequent pages. For users of the YouTube Video API, comments_sorting_token can also facilitate pagination by fetching additional comment pages. Ensure the appropriate token is used based on the data context and API being accessed. Example: CBQQAA.

Example input: `{"video_id":"<video_id>"}`

### `searchapi_youtube_search`

YouTube Search · Read-only

Search YouTube for videos, channels and playlists.
Returns videos with title, video id, channel, views, length, published date and thumbnail, plus channels and playlists.
Use this to find YouTube videos. Use searchapi_youtube_video_get for one video's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): This parameter is used for the terms you want to search on YouTube. Queries can include terms like "cooking tutorials" or "music videos". Example: python tutorial for beginners.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported YouTube gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported YouTube hl languages. Example: en.

Example input: `{"q":"<q>"}`

### `searchapi_youtube_transcript_get`

Get YouTube Transcript · Read-only

Get the transcript (captions) of a YouTube video in a chosen language.
Returns transcript segments with text, start time and duration, plus available languages.
Use this to read or summarize a video's speech.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): Parameter defines the video_id you want to search. You can find these values in JSON responses in YouTube engine or in YouTube page that appears in URL: https://www.youtube.com/watch?v= video_id. Also accepts full YouTube URLs (watch, shorts, embed and live) and share links (https://youtu.be/VIDEO_ID). Example: dQw4w9WgXcQ.
- `lang` (`string`, optional): The parameter en sets the default language for transcripts. While a variety of languages are supported, often only a few are available. Review the list of known supported YouTube Transcript languages. Example: en.
- `only_available` (`boolean`, optional): When set to true, enables fallback behavior. The API first attempts to find a transcript matching your lang or transcript_name parameter. If no match is found, it returns the first available transcript instead of an error. Transcripts can still be filtered by transcript_type. Example: true.
- `transcript_name` (`string`, optional): Defines the transcript name to retrieve. You can find the available transcript names in the response of the video in the available_languages field. You can use to select the desired transcript by name instead of lang. Example: English.
- `transcript_type` (`string`, optional): Defines the transcript preference when both auto-generated and manually uploaded transcripts are available. auto - Prioritizes YouTube's auto-generated transcript. It can be translated into any lang language, but retrieval may be slower compared to manual transcripts. manual - Prioritizes manually uploaded transcripts. Example: manual.

Example input: `{"video_id":"<video_id>"}`

### `searchapi_youtube_video_get`

Get YouTube Video · Read-only

Get the details of one YouTube video.
Returns the video's title, description, channel, views, likes, publish date, chapters and related videos.
Use this after searchapi_youtube_search. Use searchapi_youtube_transcript_get for what is said.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): Parameter defines the video_id you want to search. You can find these values in JSON responses in YouTube engine or in YouTube page that appears in URL: https://www.youtube.com/watch?v= video_id. Also accepts full YouTube URLs (watch, shorts, embed and live) and share links (https://youtu.be/VIDEO_ID). Example: dQw4w9WgXcQ.
- `gl` (`string`, optional): The default parameter us defines the country of the search. Check the full list of supported YouTube gl countries. Example: us.
- `hl` (`string`, optional): The default parameter en defines the interface language of the search. Check the full list of supported YouTube hl languages. Example: en.

Example input: `{"video_id":"<video_id>"}`

## Related

Other Search connectors ([all 89](/agentkit/connectors/?category=search)):

- [Supadata](/agentkit/connectors/supadata/): Scalekit connector, API key, 21 tools
- [Exa](/agentkit/connectors/exa/): Scalekit connector, API key, 21 tools
- [Brave Search](/agentkit/connectors/brave/): Scalekit connector, API key, 18 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
