Search api
search_apiYour real-time SERP API solution. Mastering proxy management, CAPTCHAs, and JSON parsing for seamless web data extraction.
Acciones disponibles (5)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Get Account InfoSEARCH_API_GET_ACCOUNT_INFOAcciónTool 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.
SEARCH_API_GET_ACCOUNT_INFOAcciónTool 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.
Parámetros de entrada
zero_retentionbooleanEnterprise-only feature. When set to true, disables all logging and persistent storage for this request.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Cached Search by IDSEARCH_API_GET_CACHED_SEARCH_BY_IDAcciónTool 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.
SEARCH_API_GET_CACHED_SEARCH_BY_IDAcciónTool 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.
Parámetros de entrada
search_idstringObligatorioThe 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.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Cached Search HTML by IDSEARCH_API_GET_CACHED_SEARCH_HTML_BY_IDAcciónTool 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.
SEARCH_API_GET_CACHED_SEARCH_HTML_BY_IDAcciónTool 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.
Parámetros de entrada
search_idstringObligatorioThe 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.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get LocationsSEARCH_API_GET_LOCATIONSAcciónTool 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.
SEARCH_API_GET_LOCATIONSAcciónTool 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.
Parámetros de entrada
qstringObligatorioSearch query for location lookup. The location name you want to search for (e.g., 'new york', 'london', 'tokyo').
limitintegerMaximum number of results to return. Default is 10, maximum allowed is 100.
zero_retentionbooleanEnterprise feature only. When set to true, disables logging of the request. Only available for enterprise accounts.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
SearchSEARCH_API_SEARCHAcciónTool 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.
SEARCH_API_SEARCHAcciónTool 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.
Parámetros de entrada
qstringObligatorioSearch query terms with support for operators and advanced filters.
crstringRestricts results by country via TLD or IP geolocation.
glstringCountry code for results (default: us). Two-letter country code.
hlstringInterface language code (default: en). Two-letter language code.
lrstringRestricts results by document language (format: lang_xx).
numintegerNumber of results per page. Note: Google now returns a constant 10 results regardless of this parameter.
nfprintegerSet to 1 to exclude auto-corrected results.
pageintegerResults page number for pagination (default: 1).
safestringSafeSearch setting: 'active' to filter explicit content or 'off' to disable (default: off).
uulestringGoogle-encoded location parameter. Cannot be used together with location parameter.
kgmidstringKnowledge Graph identifier for entity-specific searches.
devicestringDevice type for search results: desktop, mobile, or tablet (default: desktop).
enginestringObligatorioSpecifies 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.
filterintegerEnable (1) or disable (0) duplicate content filters (default: 1).
locationstringCanonical search location for geo-targeted results (e.g., 'United States', 'London,England,United Kingdom').
time_periodstringFilter results by date: last_hour, last_day, last_week, last_month, or last_year.
google_domainstringGoogle domain to search (default: google.com).
zero_retentionbooleanEnterprise-only feature. When set to true, disables all logging and persistent storage for this request.
time_period_maxstringCustom date range end in MM/DD/YYYY format.
time_period_minstringCustom date range start in MM/DD/YYYY format.
optimization_strategystringSearch optimization strategy: 'performance' or 'ads' (default: performance).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not