Skip to main content
Search api logo
  • Category: web search & research
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 5
  • Triggers: 0
  • Slug: SEARCH_API
  • Version: 20261014_00

Tools

Slug: SEARCH_API_GET_ACCOUNT_INFOTool to retrieve account usage statistics including monthly usage, remaining credits, hourly limits, and subscription period information. Use when you need to check current account status or usage limits.

Input Parameters

boolean
Enterprise-only feature. When set to true, disables all logging and persistent storage for this request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH_API_GET_CACHED_SEARCH_BY_IDTool to retrieve cached search results by search ID in JSON format. Use when you need to access previously executed search results without re-running the query. The search ID is found in the search_metadata.id or search_metadata.json_url field from initial search responses. Cached results are available for 90 days.

Input Parameters

string
required
The unique identifier for a previously executed search, formatted as ‘search_[alphanumeric]’. This ID is found in the ‘id’ or ‘json_url’ field of the search_metadata from initial search responses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH_API_GET_CACHED_SEARCH_HTML_BY_IDTool to retrieve cached search results by search ID in HTML format. Use when you need to access the raw HTML snapshot of a previous search execution. The search ID is available in the search_metadata.id or search_metadata.html_url field from initial search responses.

Input Parameters

string
required
The unique identifier for a previously executed search. This ID is found in the ‘id’ or ‘html_url’ field of the search_metadata from initial search responses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH_API_GET_LOCATIONSTool to get available locations for geo-localized search queries. Use when you need to find location identifiers for targeting Google searches to specific geographic areas. Returns location metadata including identifiers, names, coordinates, and population reach.

Input Parameters

string
required
Search query for location lookup. The location name you want to search for (e.g., ‘new york’, ‘london’, ‘tokyo’).
integer
Maximum number of results to return. Default is 10, maximum allowed is 100.
boolean
Enterprise feature only. When set to true, disables logging of the request. Only available for enterprise accounts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH_API_SEARCHTool to perform unified search across 40+ search engines including Google, Bing, Yahoo, DuckDuckGo, YouTube, Amazon, and more. Use when you need to retrieve search results with rich structured data including organic results, ads, knowledge graphs, local listings, images, videos, and related searches. Supports advanced filtering by location, language, date, device type, and SafeSearch settings.

Input Parameters

string
required
Search query terms with support for operators and advanced filters.
string
Restricts results by country via TLD or IP geolocation.
string
Country code for results (default: us). Two-letter country code.
string
Interface language code (default: en). Two-letter language code.
string
Restricts results by document language (format: lang_xx).
integer
Number of results per page. Note: Google now returns a constant 10 results regardless of this parameter.
integer
Set to 1 to exclude auto-corrected results.
integer
Results page number for pagination (default: 1).
string
SafeSearch setting: ‘active’ to filter explicit content or ‘off’ to disable (default: off).
string
Google-encoded location parameter. Cannot be used together with location parameter.
string
Knowledge Graph identifier for entity-specific searches.
string
Device type for search results: desktop, mobile, or tablet (default: desktop).
string
required
Specifies the search engine to use. Supported engines include: google, bing, yahoo, duckduckgo, youtube, google_maps, google_shopping, google_jobs, google_hotels, amazon_search, ebay_search, walmart_search, apple_app_store, baidu, yandex, naver, and many more.
integer
Enable (1) or disable (0) duplicate content filters (default: 1).
string
Canonical search location for geo-targeted results (e.g., ‘United States’, ‘London,England,United Kingdom’).
string
Filter results by date: last_hour, last_day, last_week, last_month, or last_year.
string
Google domain to search (default: google.com).
boolean
Enterprise-only feature. When set to true, disables all logging and persistent storage for this request.
string
Custom date range end in MM/DD/YYYY format.
string
Custom date range start in MM/DD/YYYY format.
string
Search optimization strategy: ‘performance’ or ‘ads’ (default: performance).

Output

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