Skip to main content
DataForSEO logo
  • Category: seo & ai visibility
  • Auth: BASIC
  • Composio-managed OAuth available? N/A
  • Tools: 312
  • Triggers: 0
  • Slug: DATAFORSEO
  • Version: 20261101_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: DATAFORSEO_CREATE_APP_DATA_APPLE_APP_REVIEWS_TASKTool to create Apple App Store reviews retrieval tasks. Use when you need to fetch user reviews for a specific iOS app from the App Store. Returns task IDs for retrieving results later. Reviews can be sorted by most recent or most helpful.Instant: Supported on the latest version.Instant pricing: $0.003 per 100 Apple App Store reviews

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires app_id and either location/language code or name.

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: DATAFORSEO_CREATE_APP_DATA_APPLE_APP_SEARCHES_TASKTool to create Apple App Store search tasks via DataForSEO API. Use when you need to search for apps on the Apple App Store by keyword with specific location and language parameters. Returns task IDs for retrieving results later using the get task advanced endpoint. Supports up to 100 tasks per request.Instant: Supported on the latest version.Instant pricing: $0.001 per 100 Apple App Store search results

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires a keyword and either location/language code or name.

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: DATAFORSEO_CREATE_APP_DATA_GOOGLE_APP_LIST_TASKTool to create Google Play Store app list retrieval tasks. Use when you need to fetch lists of mobile apps from Google Play top charts (featured, topselling, topgrossing, etc.). Returns task IDs for retrieving results later.Instant: Supported on the latest version.Instant pricing: $0.001 per 100 Google Play app-list results

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires app_collection and either location/language code or name.

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: DATAFORSEO_CREATE_APP_DATA_GOOGLE_APP_REVIEWS_TASKTool to create Google Play app reviews retrieval tasks. Use when you need to fetch user reviews for a specific Android app from Google Play Store. Returns task IDs for retrieving results later. Reviews can be filtered by rating and sorted by newest or most relevant.Instant: Supported on the latest version.Instant pricing: $0.005 per 1,000 Google Play reviews

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires app_id and either location/language code or name.

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: DATAFORSEO_CREATE_BUSINESS_DATA_TRUSTPILOT_SEARCH_TASKTool to create Trustpilot search tasks for retrieving business profiles. Use when you need to search for businesses on Trustpilot by keyword. Returns task IDs for retrieving results later using the get task endpoint. The results provide business profiles with ratings, reviews count, and URLs.Instant: Supported on the latest version.Instant pricing: $0.007 per 100 Trustpilot search results

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires a keyword.

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: DATAFORSEO_CREATE_KW_BING_AUDIENCE_EST_TASKCreate a Bing Audience Estimation task in the DataForSEO sandbox for ad campaign planning. Targeting criteria include age, gender, location, industry, and job function.

Input Parameters

array
Target age groups for the ad campaign. Multiple age ranges can be specified to refine audience targeting
number
Cost per click (CPC) bid amount in USD. Affects estimated reach and budget calculations
array
Target gender(s) for the ad campaign. Can specify multiple genders for broader targeting
array
Industry targeting codes. Array of industry identifiers to target specific business sectors (e.g., 806303407 for Technology)
number
Daily advertising budget in USD. Used to estimate campaign reach and engagement metrics
array
Job function targeting codes. Array of job role identifiers to target specific professional functions (e.g., 806298607 for IT)
integer
Unique location identifier for geographic targeting. Use location_code, location_name, or location_coordinate (only one at a time)
string
Full name of target location (e.g., ‘United States’, ‘New York’). Use location_code, location_name, or location_coordinate (only one at a time)
string
GPS coordinates with radius for location targeting. Format: ‘latitude,longitude,radius_km’ (e.g., ‘29.6821525,-82.4098881,100’). Use location_code, location_name, or location_coordinate (only one at a time)

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: DATAFORSEO_CREATE_KW_GOOGLE_KW_FOR_KW_TASKTool to create Google Keywords For Keywords tasks for keyword research and analysis. Use when you need to get keyword suggestions, search volumes, CPC data, and competition metrics based on seed keywords. Returns task IDs for retrieving results later using the task_get endpoint.

Input Parameters

array
required
Array of task items to create. Each task will generate keyword suggestions and metrics based on the provided seed keywords. Maximum 100 tasks per 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: DATAFORSEO_CREATE_MERCHANT_AMAZON_SELLERS_TASKTool to create Merchant Amazon Sellers tasks. Use when you need to get a list of sellers for a specific product on Amazon, including seller details, pricing, condition, shipment information, and ratings. Returns task IDs for retrieving results later.Instant: Supported on the latest version.Instant pricing: $0.001 per Amazon sellers SERP

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires asin and either location/language code or name.

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: DATAFORSEO_CREATE_ON_PAGE_LIGHTHOUSE_TASK_POSTTool to create an On Page Lighthouse audit task for measuring web page quality based on Google’s Lighthouse. Use when you need to audit a web page for SEO, performance, accessibility, best practices, or PWA compliance. Results are retrieved asynchronously using the returned task ID.Instant: Supported on the latest version.Instant pricing: $0.005 per scanned Lighthouse page

Input Parameters

string
User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.
string
required
Target page URL with absolute path including protocol (http:// or https://). Example: ‘https://dataforseo.com’
array
Specific audits to run from the available audits list. Use the ‘Get On Page Lighthouse Audits’ action to retrieve the full list of available audits. If not specified, all relevant audits for the selected categories will be executed.
string
Lighthouse version number to use for the audit. Use the ‘List On Page Lighthouse Versions’ action to get available versions. If not specified, the latest version will be used.
array
Specific audit categories to run. Available options: ‘seo’, ‘pwa’, ‘performance’, ‘best_practices’, ‘accessibility’. If not specified, all categories will be audited.
boolean
Enable mobile device emulation for the audit. Set to true to test mobile version, false for desktop. Defaults to false if not specified.
string
URL for GET notification when task completes. Supports variables: $id (task ID) and $tag (user-defined tag). Example: ‘https://your-server.com/pingscript?id=\$id&tag=\$tag’
string
URL for POST notification with gzip-compressed results when task completes. Supports variables: $id (task ID) and $tag (user-defined tag). Example: ‘https://your-server.com/postback?id=\$id’
string
Language code for the audit. Defaults to ‘en’ if not specified. Use the ‘List On Page Lighthouse Languages’ action to get available language codes.
string
Language name for the audit. Defaults to ‘English’ if not specified. Use the ‘List On Page Lighthouse Languages’ action to get available languages.

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: DATAFORSEO_CREATE_ON_PAGE_TASK_POSTTool to create an On Page crawl task for analyzing websites. Use when you need to audit a website for SEO, check on-page parameters, find optimization opportunities, or analyze site structure. The crawl checks 60+ parameters including meta tags, duplicate content, images, response codes, and more.Instant: Supported on the latest version.Instant pricing: $0.001 per 10 crawled pages in basic mode

Input Parameters

string
User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.
string
required
Website domain or URL to crawl and analyze. Can be a domain (example.com) or full URL (https://example.com). This is the starting point for the website crawl.
string
Custom JavaScript code to execute on each page during crawling. Code should return a valid JavaScript object. Example: ‘meta = {}; meta.url = document.URL; meta;’
string
Specific URL to start crawling from. If not specified, crawling will start from the target domain’s homepage. Must be within the target domain.
boolean
Enable capturing of XMLHttpRequest (XHR) data during crawling. Useful for analyzing AJAX requests and dynamic content loading.
boolean
Enable spell checking on page content. When enabled, spelling errors will be detected and reported.
integer
Delay in milliseconds between requests to avoid overloading the target server. Minimum value is 0.
boolean
Switch to a different IP pool for requests. Can help avoid rate limiting or blocks from target websites.
string
URL for GET notification when task completes. Supports variables: $id (task ID) and $tag (user-defined tag). Example: ‘https://your-server.com/pingscript?id=\$id&tag=\$tag’
array
List of URLs to prioritize during crawling. These URLs will be crawled first before other discovered URLs.
string
Browser configuration preset for rendering. Available presets define viewport size, user agent, and other browser settings.
string
URL of a custom sitemap to use instead of auto-discovering the sitemap. Must be a valid sitemap URL.
boolean
Load external resources (CSS, JS, images) during crawling. Required for accurate page rendering and resource analysis.
boolean
Store raw HTML of crawled pages for later retrieval. Enabling this will increase storage costs but allows detailed page analysis.
string
Accept-Language header value for HTTP requests. Format: language codes with quality values (e.g., ‘en-US,en;q=0.9’).
integer
Maximum depth of crawling from the start URL. Depth 0 is the start URL itself, depth 1 includes all pages linked from the start URL, etc. Default is unlimited.
integer
Maximum number of pages to crawl on the website. Limits the scope of the crawl operation. If not specified, the default limit from your account settings will be used.
boolean
Whether to respect and use the website’s sitemap for crawling. If enabled, pages in the sitemap will be prioritized.
boolean
Enable cookie support during crawling. Useful for sites that require cookies for proper functionality.
boolean
Allow crawling of subdomains of the target domain. When enabled, links to subdomains will be followed.
object
Custom threshold values for various checks. Allows fine-tuning of what constitutes a warning or error for different metrics. Keys are check names, values are threshold integers.
string
Custom robots.txt content to use instead of fetching from the website. Useful for testing crawl behavior with different robots.txt rules.
string
Custom User-Agent string for HTTP requests. If not specified, DataForSEO’s default user agent will be used.
boolean
Enable JavaScript rendering during crawling. Required for crawling single-page applications and JavaScript-heavy sites.
array
Specific list of subdomains to allow during crawling. Only these subdomains will be crawled if encountered. Example: [‘blog.example.com’, ‘shop.example.com’]
boolean
Only crawl pages listed in the sitemap. When enabled, the crawler will not follow links outside the sitemap.
array
List of page-level checks to disable during crawling. Use to skip specific analysis metrics you don’t need.
integer
Browser viewport width in pixels for rendering. Default is typically 1920.
string
Language code for spell checking (e.g., ‘en’, ‘es’, ‘fr’). Required if check_spell is enabled.
Attempt to automatically dismiss cookie consent popups during crawling. Improves crawl accuracy by removing overlay elements.
boolean
Validate structured data and micromarkup (Schema.org, JSON-LD, etc.) on crawled pages. Checks for correct implementation of structured data.
integer
Browser viewport height in pixels for rendering. Default is typically 1080.
array
Specific list of subdomains to exclude from crawling. Links to these subdomains will be ignored.
boolean
Force execution of site-wide checks even if the crawl doesn’t complete all pages. Useful for getting partial results from large sites.
string
How to merge custom robots.txt with the site’s existing robots.txt. Options may include ‘replace’, ‘merge’, etc.
array
List of words to exclude from spell checking. Useful for brand names, technical terms, etc. that may be flagged as misspelled.
boolean
Enable parsing and extraction of page content (headings, paragraphs, images, etc.). Required for detailed content analysis.
boolean
Return partial results even if the crawl times out before completion. Useful for large sites where complete crawl may take too long.
array
List of site-wide checks to disable. Site-wide checks analyze patterns across all crawled pages.
boolean
Enable full browser rendering (headless browser) for crawling. Provides more accurate rendering of modern web pages but increases processing time.
boolean
Calculate keyword density metrics for crawled pages. Useful for SEO analysis to understand keyword usage patterns.
boolean
Check if www and non-www versions of the site redirect correctly. Important for SEO to avoid duplicate content issues.
number
Browser screen scale factor for high-DPI displays. Default is 1.0. Use 2.0 for retina displays.

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: DATAFORSEO_CREATE_SERP_GOOGLE_AUTOCOMPLETE_TASKTool to create Google Autocomplete SERP tasks. Use when you need to retrieve autocomplete suggestions that Google Search provides as users type their queries. Returns task IDs for retrieving results later.Instant: Supported on the latest version.Instant pricing: $0.006 per 10 Google Autocomplete requests

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires keyword and optionally location/language parameters.

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: DATAFORSEO_CREATE_SERP_GOOGLE_EVENTS_TASKTool to create Google Events SERP tasks via DataForSEO API. Use when you need to retrieve event listings from Google Search for specific keywords and locations. Note: Google Events SERP API works for English language only. Returns task IDs for retrieving results later using the get task advanced endpoint.

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires a keyword and either location_code, location_name, or location_coordinate.

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: DATAFORSEO_CREATE_SERP_GOOGLE_FINANCE_EXPLORE_TASKTool to create Google Finance Explore SERP tasks. Use when you need to retrieve real-time data from the ‘Explore’ tab of Google Finance, including market indexes, news, earnings calendars, trending instruments, and market trends. Returns task IDs for retrieving results later.Instant: Supported on the latest version.Instant pricing: Estimated $0.006 per 10 Google Finance Explore requests; $0.001 per request for some market views.

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires location and language parameters.

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: DATAFORSEO_CREATE_SERP_GOOGLE_LOCAL_FINDER_TASKTool to create Google Local Finder SERP tasks for retrieving local business search results. Use when you need to get location-based search results for businesses and services from Google’s Local Finder.Instant: Supported on the latest version.Instant pricing: $0.006 per 10 standard-queue Google Local Finder SERP (20 desktop or 10 mobile results)

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires keyword and either location_code, location_name, or location_coordinate.

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: DATAFORSEO_CREATE_SERP_GOOGLE_MAPS_TASKTool to create Google Maps SERP tasks. Use when you need to retrieve Google Maps search results for local businesses, places, or locations. Returns task IDs for retrieving results later.Instant: Supported on the latest version.Instant pricing: $0.006 per 10 standard-queue Google Maps SERP (up to 100 results)

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires keyword (or url) and optionally location/language parameters.

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: DATAFORSEO_CREATE_SERP_GOOGLE_ORGANIC_TASK_POSTTool to create Google Organic SERP tasks for retrieving top search engine results. Use when you need to get organic search results for specific keywords, analyze SERP features, track rankings, or research competitors. Results include organic listings, featured snippets, People Also Ask, and other SERP elements. Tasks are processed asynchronously - use the returned task ID to retrieve results later.Instant: Supported on the latest version.Instant pricing: $0.006 per 10 standard-queue Google Organic SERP (10 results)

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires either ‘keyword’ or ‘url’ parameter along with optional location and language settings.

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: DATAFORSEO_CREATE_SERP_SEZNAM_ORGANIC_TASKTool to create a SERP Seznam Organic search task. Use when you need to retrieve Seznam search engine results for a specific keyword and location in the Czech Republic. Results are retrieved asynchronously using the returned task ID.Instant: Supported on the latest version.Instant pricing: $0.006 per 10 standard-queue Seznam Organic SERP (10 results)

Input Parameters

string
Operating system for the search. Default depends on the device type selected.
string
User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.
string
Direct Seznam search URL with exact language/location parameters. Cannot be used with keyword parameter.
integer
Number of results to return in SERP. Default is 10, maximum is 700.
string
Device type for the search: ‘desktop’, ‘mobile’, or ‘tablet’. Default is ‘desktop’.
string
Search query keyword (up to 700 characters). Use %25 for ’%’ and %2B for ’+’ in the query string. Required if url parameter is not specified.
integer
Task execution priority: 1 for normal speed (default), 2 for high priority (higher charges apply). Higher priority tasks are processed faster.
string
Search engine domain to use for the search. Default is ‘search.seznam.cz’.
string
URL for GET notification when task completes. Supports variables: $id (task ID) and $tag (user-defined tag).
string
URL for POST notification with results when task completes. Supports variables: $id (task ID) and $tag (user-defined tag).
string
Additional Seznam-specific search parameters or query modifiers to customize the search.
string
Language code (e.g., ‘cs’). Required if language_name is not specified. Use ‘List SERP Seznam Languages’ action to get available language codes.
string
Full language name (e.g., ‘Czech’). Required if language_code is not specified. Use ‘List SERP Seznam Languages’ action to get available languages.
integer
Location identifier code. Required if location_name is not specified. Use ‘List SERP Seznam Locations’ action to get available location codes.
string
Full name of the search engine location. Required if location_code is not specified. Use ‘List SERP Seznam Locations’ action to get available locations.
string
Data type for postback results: ‘regular’, ‘advanced’, or ‘html’. Required if postback_url is specified.
integer
Maximum number of pages to crawl. Default is 1, maximum is 100.
array
Array of match criteria to stop crawling (maximum 10 objects). When any criterion is met, crawling stops immediately.
boolean
Enable calculation of pixel rectangles for SERP elements. Adds a small additional cost per task. Default is false.

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: DATAFORSEO_CREATE_SERP_YOUTUBE_VIDEO_COMMENTS_TASKTool to create YouTube Video Comments SERP tasks. Use when you need to retrieve comments data from a specific YouTube video, including author info, timestamps, likes, and reply counts. Returns task IDs for retrieving results later.Instant: Supported on the latest version.Instant pricing: $0.003 per 100 YouTube comments

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires video_id and optionally location/language parameters.

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: DATAFORSEO_CREATE_SERP_YOUTUBE_VIDEO_SUBTITLES_TASKTool to create YouTube video subtitles extraction tasks. Use when you need to retrieve subtitle data from YouTube videos including text, timing, and translations. Tasks are processed asynchronously - use the returned task ID to retrieve subtitle results later.Instant: Supported on the latest version.Instant pricing: $0.001 per YouTube video subtitles request

Input Parameters

array
required
Array of task items to be created. Maximum 100 tasks per request. Each task requires a ‘video_id’ parameter along with optional location and language settings.

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: DATAFORSEO_FORCE_ON_PAGE_CRAWLTool to force stop On Page crawl tasks. Use when you need to immediately terminate ongoing website crawl operations. Data collected before stopping remains available for retrieval.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

array
required
Array of task items to force stop. Each task requires the unique task ID of the crawl to terminate.

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: DATAFORSEO_GET_AI_KEYWORD_DATA_AVAILABLE_FILTERSTool to retrieve available filters for DataForSEO AI Keyword Data API endpoints. Use when you need to discover which fields can be filtered in AI keyword data queries and their data types (string or numeric).Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_AI_KEYWORD_DATA_LOCATIONS_AND_LANGUAGESTool to retrieve the full list of locations and languages supported in AI Keyword Data API. Use when you need to get available geographic locations and their supported languages for AI keyword optimization. This endpoint is free and incurs no cost.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_AI_OPT_CHAT_GPT_LLM_SCRAPER_HTML_BY_IDTool to retrieve AI Optimization Chat GPT LLM Scraper task results in HTML format. Use when you need to fetch the HTML content from a previously submitted LLM scraper task using its unique task ID. The task ID remains valid for 7 days after task creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier. Unique task identifier in our system in the UUID format. You will be able to use it within 7 days to request the results of the task at any time.

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: DATAFORSEO_GET_AI_OPT_CHAT_GPT_LLM_SCRAPER_TASK_ADV_BY_IDTool to retrieve advanced ChatGPT LLM scraper task results by task ID. Use when you need to fetch detailed scraper results including markdown content, search results, sources, brand entities, and various content types (text, tables, images, local businesses, products) for a previously submitted task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - a universally unique identifier (UUID). Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_AI_OPT_GEMINI_LLM_SCRAPER_TASK_ADVTool to retrieve advanced AI Optimization Gemini LLM scraper task results by task ID. Use when you need to fetch completed task data including LLM-generated content, sources, tables, and images. Results remain accessible for 30 days after task creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier (UUID) obtained from task_post or tasks_ready endpoint. Results accessible for 30 days after task creation.

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: DATAFORSEO_GET_AI_OPTIMIZATION_CHAT_GPT_LLM_RESPONSES_LIVETool to retrieve live structured responses from ChatGPT AI models via DataForSEO. Returns AI-generated content with optional web search augmentation, token usage statistics, and cost information. Use when you need immediate ChatGPT responses with control over model parameters, conversation context, and web search capabilities.Instant: Supported on the latest version.Instant pricing: $0.006 per 10 live LLM response requests plus model usage

Input Parameters

string
User-defined identifier for tracking or organizing this request
number
Nucleus sampling parameter. Alternative to temperature. Model considers tokens with top_p probability mass
string
Name of the ChatGPT model to use (e.g., ‘gpt-4o’, ‘gpt-4.1-mini’). If not specified, the default model will be used
Enable web search to augment the AI response with current information from the internet
number
Sampling temperature between 0 and 2. Higher values (e.g., 0.8) make output more random, lower values (e.g., 0.2) make it more focused and deterministic
string
required
The main prompt or question to send to the ChatGPT model
array
Prior conversation history to provide context for the current prompt
string
System-level instruction that sets the behavior or context for the AI model
string
City name to focus web search results for location-specific queries
Force web search even if the model determines it’s not necessary
integer
Maximum number of tokens to generate in the response. Controls response length
string
ISO country code (e.g., ‘FR’, ‘US’) to focus web search results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATAFORSEO_GET_AI_OPTIMIZATION_GEMINI_LLM_SCRAPER_HTML_BY_IDRetrieve HTML results for a completed Gemini LLM Scraper task by its unique ID. Use this action to fetch the scraped HTML content from a previously posted task. Results are available for 7 days after task posting.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format. Results are available for 7 days after task posting. The task must be created via task_post endpoint first.

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: DATAFORSEO_GET_AI_OPTIMIZATION_LLM_MENTIONS_TOP_DOMAINS_LIVETool to get live aggregated LLM mentions grouped by most frequently mentioned domains. Use when you need to identify which domains are most often cited or mentioned by LLMs (Google AI Overview or ChatGPT) for specific keywords, with metrics like total mentions and AI search volume per domain.Instant: Supported on the latest version.Instant pricing: $0.1 per LLM mention request plus $0.001 per result row

Input Parameters

string
User-defined tag for request tracking. Maximum 255 characters.
string
Specific domain to filter results by.
array
required
Array of target keywords to search for in LLM responses. Each target can specify search scope and match type. At least one target is required.
string
Alternative single keyword parameter (deprecated, use target array instead).
string ("google" | "chat_gpt")
required
LLM platform to search: ‘google’ for Google AI Overview, ‘chat_gpt’ for ChatGPT responses.
Scope of links to include: ‘sources’ for source citations only, ‘related_links’ for related links only, ‘all_links’ for both sources and related links.
string
Language code for the search (e.g., ‘en’ for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes.
string
Language name for the search (e.g., ‘English’). Use either language_name or language_code, not both.
integer
Geographic location code for the search context (e.g., 2840 for United States). Use either location_code or location_name, not both. See DataForSEO locations list for valid codes.
string
Geographic location name for the search context (e.g., ‘United States’). Use either location_name or location_code, not both.
string
Advanced search filter expression to apply to results. Uses DataForSEO filter syntax.
integer
Maximum number of top domains to return. Limits the total number of domains in the result.
boolean
Whether to include subdomains when filtering by domain.
integer
Maximum number of internal items to return per domain. Limits the detail level for each domain’s mentions.
array
Filters to apply to the initial dataset before aggregation. Each filter is an array with [field, operator, value]. Example: [['ai_search_volume', '>', 10]] filters for mentions with AI search volume greater than 10.

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: DATAFORSEO_GET_AI_OPTIMIZATION_LLM_SCRAPER_LIVE_ADVANCEDReturn immediate advanced ChatGPT or Gemini scraper results for a prompt.

Input Parameters

string
User-defined tracking tag.
string
required
Prompt to submit to the selected LLM platform, up to 2000 characters.
string ("chat_gpt" | "gemini")
required
LLM platform to query: ChatGPT or Gemini.
string
Language code for the response.
string
Language name alternative to language_code.
integer
DataForSEO geographic location code.
string
Location name alternative to location_code.
boolean
ChatGPT-only option that forces the model to search the web.
string
Gemini-only coordinates in latitude,longitude,radius format; radius must be 199-199999 mm.

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: DATAFORSEO_GET_APP_DATA_APPLE_APP_LIST_TASK_ADVANCEDTool to retrieve Apple App Store app list results for a previously created task. Returns detailed app data including titles, ratings, prices, reviews, and icons for apps in the specified collection (e.g., top charts). Use this after creating an app list task to get the results using the task ID.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_APP_DATA_APPLE_APP_SEARCHES_TASK_ADVANCEDTool to retrieve Apple App Searches task results from DataForSEO. Use when you need to get app search results for a previously created task. This is the second step in a two-step process: first create a task using task_post, then retrieve results using this action with the task ID.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task ID returned from POST /v3/app_data/apple/app_searches/task_post endpoint. This is a two-step API where you first create a task and then retrieve results using this ID.

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: DATAFORSEO_GET_APP_DATA_GOOGLE_APP_INFO_TASK_HTML_BY_IDRetrieve HTML content for a previously submitted Google Play app info task by task ID; results are available for 7 days after task posting. The tool defaults to the sandbox; select production to retrieve production task results.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format. Results are available for 7 days after task posting. The task must be created via task_post endpoint first.
boolean
Whether to use the DataForSEO sandbox environment (sandbox.dataforseo.com) instead of production (api.dataforseo.com). Defaults to True to avoid unintended production charges. Set to False to query live production data.

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: DATAFORSEO_GET_APP_DATA_GOOGLE_APP_LIST_TASK_ADVANCED_BY_IDTool to retrieve Google Play app list results for a previously created task. Returns detailed app data including titles, ratings, prices, reviews, and icons for apps in the specified collection (e.g., top charts).Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_APP_DATA_GOOGLE_APP_REVIEWS_TASK_HTMLTool to retrieve HTML content for Google Play app reviews by task ID. Use when you need to get the raw HTML page data of app reviews from Google Play Store for a previously submitted task. Results are available for 7 days after task posting.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format. Results are available for 7 days after task posting. The task must be created via task_post endpoint first.

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: DATAFORSEO_GET_APP_DATA_GOOGLE_APP_SEARCHES_TASK_HTML_BY_IDTool to retrieve raw HTML results for a Google Play app searches task by ID. Use when you need to get the unprocessed HTML content of Google Play Store app search results after creating an app searches task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 7 days to request the results of the task at any time.
boolean
Enable sandbox mode for testing without charges. When true, uses sandbox.dataforseo.com instead of api.dataforseo.com.

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: DATAFORSEO_GET_APPENDIX_ERRORSTool to retrieve the complete list of DataForSEO API error codes and HTTP status codes. Use when you need to understand possible API errors, their codes, and messages for error handling or debugging.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_APPENDIX_STATUSTool to get current operational status of all DataForSEO APIs and endpoints. Use when you need to check if specific APIs or endpoints are experiencing outages or performance issues.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_APPENDIX_USER_DATATool to retrieve current user account data including balance, rate limits, spending statistics, and pricing information. Use when you need to check account status, available balance, API usage limits, or subscription details.

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: DATAFORSEO_GET_APP_GOOGLE_APP_REVIEWS_TASK_GET_ADV_BY_IDTool to retrieve Google Play app review results for a previously created task. Returns feedback data including review ratings, content, reviewer profiles, publication dates, and developer responses for the specified app.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_APP_GOOGLE_APP_SEARCHES_TASK_ADV_BY_IDRetrieve advanced Google Play app search results for a previously created task by task ID. Results can include app titles, ratings, prices, review counts, and icons for the specified keyword.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system that you will receive from the POST request. You can use it within 30 days to request the results of the task at any time.
boolean
Enable sandbox mode for testing without charges. When true, uses sandbox.dataforseo.com instead of api.dataforseo.com.

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: DATAFORSEO_GET_APPLE_APP_INFO_TASK_ADVANCEDRetrieve advanced results for a previously created Apple App Info task by task ID. Results can include app ratings, review counts, pricing, categories, similar apps, and developer details.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format obtained from task_post response or tasks_ready endpoint. Accessible for 30 days.

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: DATAFORSEO_GET_BING_KW_PERFORMANCE_LOCATIONS_AND_LANGUAGESTool to retrieve the full list of locations and languages supported in Bing Keyword Performance API endpoints. Use when you need to get available geographic locations and their supported languages for Bing keyword performance data. This endpoint is free and incurs no cost.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_BIZ_BUSINESS_LISTINGS_AVAILABLE_FILTERSTool to retrieve available filters for Business Data Business Listings API endpoints. Use when you need to discover which fields can be filtered in business listings queries and their data types (string, numeric, boolean, array, or time).Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_BIZ_GOOGLE_HOTEL_INFO_TASK_GET_ADV_BY_IDTool to retrieve Google Hotel Info task results by task ID. Use when you need to get detailed hotel information including ratings, prices, amenities, location details, and reviews.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_BIZ_GOOGLE_HOTEL_SEARCHES_TASK_BY_IDTool to retrieve Google Hotel Searches task results by task ID. Use when you need to fetch hotel search results from a previously created task within 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_BIZ_GOOGLE_MY_BUSINESS_UPDATES_TASK_BY_IDTool to retrieve Google My Business updates and posts by task ID. Use when you need to fetch business updates, posts, and announcements from a Google My Business profile for a previously created task. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format. Retrieves results within 30 days of task creation.

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: DATAFORSEO_GET_BIZ_GOOGLE_QUESTIONS_AND_ANSWERS_TASKTool to retrieve Google Business questions and answers data by task ID. Use when you need to fetch Q&A information for a business including questions asked by users, answers provided, user profiles, and timestamps. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format, obtained from task_post or tasks_ready endpoint. Task ID is usable within 30 days of task creation.

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: DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_EXTENDED_REVIEWS_TASKTool to retrieve Google Business extended reviews data by task ID. Use when you need to fetch detailed review information for a business including review text, ratings, reviewer profiles, images, owner responses, and review highlights. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format, obtained from task_post or tasks_ready endpoint. Task ID is usable within 30 days of task creation.

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: DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_MY_BUSINESS_INFO_TASKTool to retrieve Google My Business information by task ID. Use when you need to fetch comprehensive business data including name, location, contact details, ratings, operating hours, photos, and popular times. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format, obtained from task_post or tasks_ready endpoint. Task ID is usable within 30 days of task creation.

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: DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_REVIEWS_TASKTool to retrieve Google Reviews task results by task ID. Use when you need to fetch review data for a specific business establishment including review text, ratings, reviewer information, business owner responses, and review metadata.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_BUSINESS_DATA_TRIPADVISOR_REVIEWS_TASK_BY_IDTool to retrieve TripAdvisor Reviews task results by task ID. Use when you need to fetch review data for a specific business establishment including review text, ratings, reviewer information, business owner responses, and review metadata from TripAdvisor. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier valid for 30 days after task creation.

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: DATAFORSEO_GET_BUSINESS_DATA_TRIPADVISOR_SEARCH_TASK_BY_IDTool to retrieve TripAdvisor Search task results by task ID. Use when you need to fetch business listings and ratings from TripAdvisor for a previously created search task within 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_BUSINESS_DATA_TRUSTPILOT_SEARCH_TASK_BY_IDTool to retrieve Trustpilot search task results by task ID. Use when you need to fetch business profiles from Trustpilot for a previously created search task. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format. You can use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_CHAT_GPT_LLM_SCRAPER_LOCATIONS_BY_COUNTRYTool to retrieve available ChatGPT LLM Scraper locations filtered by country ISO code. Use when you need to get the list of valid locations for setting up ChatGPT LLM scraper tasks in a specific country.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Country ISO code to filter the list of locations. Example: ‘us’ for United States, ‘gb’ for United Kingdom.

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: DATAFORSEO_GET_DATAFORSEO_LABS_AVAILABLE_FILTERSTool to retrieve available filters for DataForSEO Labs API endpoints. Use when you need to discover which fields can be filtered in DataForSEO Labs queries and their data types.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_DATAFORSEO_LABS_GOOGLE_AVAILABLE_HISTORYTool to retrieve available historical dates for DataForSEO Labs domain metrics. Use when you need to discover which dates are available for setting in the first_date and second_date fields of the Domain Metrics by Categories endpoint.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_DATAFORSEO_LABS_GOOGLE_TOP_SEARCHES_LIVETool to retrieve top Google search keywords with comprehensive metrics including search volume, competition, CPC, trends, and intent data. Use when you need to discover popular keywords, analyze search trends, or gather keyword research data for SEO and advertising campaigns.Instant: Supported on the latest version.Instant pricing: Estimated $0.012 per top-search request plus $0.001 per 10 results

Input Parameters

string
User-defined task identifier (max 255 characters) for matching tasks with results
integer
Maximum number of results to return. Maximum is 1000. Default: 1000
integer
Pagination offset. Recommended for results under 10,000. Default: 0
array
Filtering conditions (up to 8 filters). Each filter is an array with [field, operator, value] format. Operators: <, <=, >, >=, =, <>, in, not_in, regex, like, ilike. Example: [['keyword_info.search_volume', '>', 1000]]
array
Sorting rules (up to 3). Format: ‘field,direction’. Example: [‘keyword_info.search_volume,desc’]
string
Token for pagination beyond 10,000 results. Use instead of offset for large result sets to avoid timeouts
string
Language code for the search. Either language_name or language_code is required. Example: ‘en’
string
Full language name for the search. Either language_name or language_code is required. Example: ‘English’
integer
Location code for the search. Either location_name or location_code is required. Example: 2840 (United States)
string
Full location name for the search. Either location_name or location_code is required. Example: ‘United States’
boolean
Return only core keywords, excluding synonyms. Default: false
boolean
Include SERP data for each keyword. Default: false
boolean
Include clickstream metrics (gender/age distribution, search volume). Doubles the cost. Default: false

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: DATAFORSEO_GET_DATAFORSEO_LABS_STATUSTool to retrieve last update dates for DataForSEO Labs data sources (Google, Bing, and Amazon). Use when you need to check when Labs data was last refreshed for freshness validation.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_DOMAIN_ANALYTICS_TECH_TECHNOLOGY_STATS_LIVETool to retrieve historical technology adoption statistics across domains. Use when you need data on how many domains use a specific technology over time, with breakdowns by country, language, and domain rank. Returns daily statistics showing technology penetration and geographic distribution.Instant: Supported on the latest version.Instant pricing: Estimated $0.012–$0.018 per technology statistics request

Input Parameters

array
required
Array of task items to be processed. Each task requires a technology name and optional date range. Multiple tasks can be submitted in a single 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: DATAFORSEO_GET_GEMINI_LLM_RESPONSES_TASK_BY_IDTool to retrieve structured Gemini LLM responses from a specific task by ID. Use when you need to fetch the results of a previously created Gemini LLM optimization task. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - unique task identifier in our system in the UUID format. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_GOOGLE_HIST_BULK_TRAFFIC_EST_LIVETool to get historical monthly traffic volumes for up to 1000 domains, subdomains, or webpages on Google over a specified time range. Use when you need to analyze traffic trends from organic search, paid search, featured snippets, and local pack results. Historical data is available through October 2020, and if no date range is specified, data will be returned for the previous 12 months.Instant: Supported on the latest version.Instant pricing: $0.12 per historical traffic request plus $0.001 per domain

Input Parameters

string
User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.
string
Ending date for historical data in YYYY-MM-DD format. If not specified, data will be returned through the current month. Example: ‘2024-12-31’
array
required
Array of target domains, subdomains, or webpages to retrieve historical traffic estimations for. You can specify up to 1000 targets per request. Examples: [‘dataforseo.com’, ‘cnn.com’, ‘https://www.forbes.com/page’]
string
Starting date for historical data in YYYY-MM-DD format. If not specified, data will be returned for the previous 12 months. Example: ‘2024-01-01’
array
Filter results by type. Can include: organic, paid, featured_snippet, local_pack. Default: [‘organic’, ‘paid’]
string
Language code for the search results. Use language_code OR language_name. Example: ‘en’
string
Language name for the search results. Use language_name OR language_code. Example: ‘English’
integer
Geographic location code for the search. Use location_code OR location_name. Example: 2840 (United States)
string
Geographic location name for the search. Use location_name OR location_code. Example: ‘United States’
boolean
Excludes highly similar keywords from traffic estimation when set to true. Default: false

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: DATAFORSEO_GET_GOOGLE_HISTORICAL_SERPS_LIVEReturn Google SERPs collected during a requested date range for a keyword and locale.

Input Parameters

string
User-defined task identifier for matching this request with its result.
string
End date for historical SERPs, in YYYY-MM-DD format.
string
required
Search keyword to retrieve historical Google SERPs for.
string
Start date for historical SERPs, in YYYY-MM-DD format.
string
Language code. Use either language_code or language_name.
string
Full language name. Use either language_name or language_code.
integer
DataForSEO location code. Use either location_code or location_name.
string
Full location name. Use either location_name or location_code.

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: DATAFORSEO_GET_GOOGLE_KEYWORD_IDEAS_LIVEGenerate relevant Google keyword ideas and keyword metrics from seed terms.

Input Parameters

string
User-defined identifier returned in the task data.
integer
Maximum keyword ideas to return, from 1 to 1000. The provider defaults to 700.
integer
Number of keyword ideas to skip. Prefer offset_token when retrieving over 10,000 results.
array
Provider filter expression with up to eight conditions joined by ‘and’ or ‘or’.
array
Seed terms used to generate relevant keyword ideas. Required unless continuing with offset_token.
array
Up to three sorting rules formatted as ‘field,asc’ or ‘field,desc’.
string
Opaque token returned by the previous page. When supplied, the provider ignores fields other than limit.
string
Language code. Omit both language selectors to use the location’s default language.
string
Full language name. Omit both language selectors to use the location’s default language.
integer
Target location code. Provide exactly one location selector unless continuing with offset_token.
string
Full target location name. Provide exactly one location selector unless continuing with offset_token.
boolean
Exclude highly similar keywords and return only core keywords. The provider defaults to false.
boolean
Use phrase-match rather than broad-match keyword selection. The provider defaults to false.
boolean
Include SERP details for each keyword. The provider defaults to false.
boolean
Include clickstream and normalized metrics. This doubles the provider request cost.

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: DATAFORSEO_GET_KEYWORDS_DATA_BING_KEYWORDS_FOR_SITE_TASKTool to retrieve Bing Keywords For Site task results by task ID. Use when you need to fetch keyword data for a specified website including search volume, CPC, competition metrics, and monthly search trends for keywords associated with the site.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASK_BY_IDTool to retrieve Bing search volume task results by task ID. Use when you need to fetch keyword search volume data with historical monthly trends from a previously created task. Results include average search volume, CPC, competition level, and 12 months of historical data. Task results are available for 30 days after creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format. You can use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_KEYWORDS_DATA_GOOGLE_ADS_STATUSTool to get current status of Google Ads keyword data updates. Use when you need to check if Google has updated keyword data for the previous month or find the latest available search volume data.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_KEYWORDS_DATA_GOOGLE_SEARCH_VOLUME_TASK_BY_IDTool to retrieve Google Search Volume task results by task ID. Use when you need to fetch search volume metrics for specified keywords, including monthly average search volume, CPC, competition levels, and 12-month historical search trends.

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_KW_BING_AUDIENCE_EST_INDUSTRIESTool to retrieve the list of industries supported by Bing Ads Audience Estimation endpoint. Use when you need industry IDs for targeting Bing audience estimation campaigns. Returns 147 industries with their unique identifiers.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_KW_BING_KW_FOR_KW_TASK_BY_IDTool to retrieve Bing Keywords For Keywords task results by task ID. Use when you need to fetch keyword suggestions for specified terms, including search volume, CPC, competition metrics, and monthly search trends. Returns up to 3000 keyword suggestions.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_KW_BING_KW_SUGGESTIONS_FOR_URL_LIVETool to get Bing keyword suggestions based on a target URL with search volume, competition, and CPC metrics. Use when you need to discover relevant keywords associated with a specific webpage for SEO optimization or content strategy.Instant: Supported on the latest version.Instant pricing: Estimated $0.09 per live Bing keyword-suggestion request

Input Parameters

string
required
The webpage URL to analyze for keyword suggestions (max 2000 characters)
string
Language code (e.g., ‘en’). Either language_name or language_code is required
string
Full language name (e.g., ‘English’). Either language_name or language_code is required
boolean
Filters out brand-related keywords from results. Default: false

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: DATAFORSEO_GET_KW_BING_KW_SUGGESTIONS_FOR_URL_TASKTool to retrieve Bing keyword suggestions for a URL from a previously created task. Use when you need to fetch keyword recommendations based on URL content analysis. Results are sorted by confidence score from highest to lowest and are available for 30 days after task creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format returned from task_post endpoint. Results are available for 30 days after task creation.

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: DATAFORSEO_GET_KW_GOOGLE_ADS_AD_TRAFFIC_BY_KW_TASK_BY_IDTool to retrieve Google Ads Ad Traffic By Keywords task results by task ID. Use when you need to fetch ad traffic forecasts for keywords, including projected impressions, CTR, average CPC, cost, and clicks based on specified bids and match types.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_KW_LIVETool to retrieve Google Ads keyword suggestions for specified keywords with comprehensive metrics. Use when you need keyword ideas, search volumes, CPC data, competition levels, and bid estimates for advertising campaigns or keyword research.Instant: Supported on the latest version.Instant pricing: $0.09 per live Google Ads task (up to 1,000 keywords)

Input Parameters

string
User-defined task identifier (max 255 characters) for matching tasks with results
string
Ending date for historical data in ‘yyyy-mm-dd’ format. Cannot exceed yesterday’s date.
string
Sort results by: relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid. Default: relevance
array
required
Array of keywords to get suggestions for. Maximum 20 keywords, each up to 80 characters. Keywords will be converted to lowercase automatically.
string
Starting date for historical data in ‘yyyy-mm-dd’ format. Minimal value is 4 years prior to current date.
string
Search engine language code. Example: ‘en’ for English
string
Full search engine language name. Example: ‘English’
integer
Search engine location code. Example: 2840 for United States. You can get location codes from the locations endpoint.
string
Full search engine location name. Example: ‘London,England,United Kingdom’ or ‘United States’
boolean
Include Google search partners in results. Default: false
string
GPS coordinates in ‘latitude,longitude’ format. Example: ‘40.7128,-74.0060’ for New York City
boolean
Include adult content keywords in results. Default: false

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: DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_KW_TASK_BY_IDTool to retrieve Google Ads Keywords For Keywords task results by task ID. Use when you need to fetch keyword metrics for specified search terms from Google Ads API, including search volume, CPC, competition levels, bid estimates, and historical monthly search trends.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_SITE_TASKTool to retrieve Google Ads Keywords For Site task results by task ID. Use when you need to fetch keyword data including search volume, competition levels (LOW/MEDIUM/HIGH), bidding metrics, and semantic annotations for a domain from a previously created task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format returned from task_post endpoint. Results are available for 30 days after task creation.

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: DATAFORSEO_GET_KW_GOOGLE_ADS_SEARCH_VOL_TASK_BY_IDTool to retrieve Google Ads Search Volume task results by task ID. Use when you need to fetch Google Ads metrics for keywords including search volume, competition levels, CPC, top-of-page bid estimates, and 12-month historical trends. Based on Google Ads API (replacement for legacy AdWords API).Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_KW_GOOGLE_KW_FOR_CATEGORY_LIVETool to retrieve live Google keywords for a specific product/service category. Returns up to 700 keyword suggestions with search volume, CPC, competition level, and historical monthly trends. Use when analyzing keyword opportunities within a specific category from Google’s taxonomy.

Input Parameters

string
User-defined task identifier for tracking and matching results. Maximum 255 characters
string ("search_volume" | "relevance")
Sort results by ‘search_volume’ or ‘relevance’ in descending order. Default: ‘search_volume’
integer
required
Category ID from Google’s product/service taxonomy. Obtain via /v3/keywords_data/google/categories endpoint
string
Language code for search results (e.g., ‘en’). Alternative to language_name
string
Full language name for search results (e.g., ‘English’). Mutually exclusive with language_code
integer
Search engine location code for geographic targeting. Alternative to location_name
string
Full location name for geographic targeting (e.g., ‘United States’, ‘London,England,United Kingdom’). Mutually exclusive with location_code or location_coordinate
boolean
Include Google search partners data when true. Default: false
array
Up to 200 keywords to exclude from results. Terms are converted to lowercase automatically
string
GPS coordinates in ‘latitude,longitude’ format for country-level targeting. Mutually exclusive with location_name or location_code

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: DATAFORSEO_GET_KW_GOOGLE_KW_FOR_KW_TASK_BY_IDTool to retrieve Google Keywords For Keywords task results by task ID. Use when you need to fetch keyword metrics for specified search terms, including search volume, CPC, competition levels, and historical monthly search trends.

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_LLM_MENTIONS_AVAILABLE_FILTERSTool to fetch available filters for AI Optimization LLM Mentions API endpoints. Use when you need to discover which filter parameters are available for querying LLM mentions data.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_MERCHANT_AMAZON_ASIN_TASK_ADVANCED_BY_IDTool to retrieve Amazon product information by ASIN task ID. Use when you need to get detailed information about a product and all its modification ASINs listed on Amazon.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - unique task identifier in our system in the UUID format. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_MERCHANT_AMAZON_ASIN_TASK_HTMLTool to retrieve raw HTML results for an Amazon ASIN merchant task by ID. Use when you need to get the unprocessed HTML content of an Amazon product page after creating an ASIN task. Task results are available within 7 days of creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 7 days to request the results of the task at any time.

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: DATAFORSEO_GET_MERCHANT_AMAZON_PRODUCTS_TASK_ADVANCED_BY_IDTool to retrieve advanced Amazon Products task results by task ID. Use when you need to fetch detailed product search results including pricing, ratings, delivery info, and product metadata for a previously submitted Amazon merchant task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - a universally unique identifier (UUID). Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_MERCHANT_AMAZON_PRODUCTS_TASK_HTML_BY_IDTool to retrieve raw HTML results for a Merchant Amazon Products task by ID. Use when you need to get the unprocessed HTML content of Amazon product pages after creating a products task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 7 days to request the results of the task at any time.

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: DATAFORSEO_GET_MERCHANT_AMAZON_SELLERS_TASK_ADVANCEDTool to retrieve Amazon sellers task results from DataForSEO. Use when you need to get seller information for a previously created task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format obtained from task_post endpoint. Results accessible for 30 days after task creation.

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: DATAFORSEO_GET_MERCHANT_AMAZON_SELLERS_TASK_HTML_BY_IDTool to retrieve raw HTML results for a Merchant Amazon Sellers task by ID. Use when you need to get the unprocessed HTML content of an Amazon sellers page after creating a sellers task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 7 days to request the results of the task at any time.

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: DATAFORSEO_GET_MERCHANT_GOOGLE_PRODUCTS_TASK_ADVANCED_BY_IDTool to retrieve advanced Google Shopping Products task results by task ID. Use when you need to fetch detailed product search results including pricing, ratings, delivery info, seller details, and product metadata for a previously submitted Google merchant task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - a universally unique identifier (UUID). Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_MERCHANT_GOOGLE_PRODUCTS_TASK_HTMLTool to retrieve raw HTML results for a Merchant Google Products task by ID. Use when you need to get the unprocessed HTML content of Google Shopping product pages after creating a products task. Task results are available within 7 days of creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 7 days to request the results of the task at any time.

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: DATAFORSEO_GET_MERCHANT_GOOGLE_SELLERS_TASK_ADVANCED_BY_IDTool to retrieve advanced Google Sellers task results by task ID. Use when you need to fetch detailed seller listings for a product on Google Shopping, including pricing, ratings, availability, and seller information for a previously submitted merchant task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - a universally unique identifier (UUID). Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_MERCHANT_G_PRODUCT_INFO_TASK_ADV_BY_IDTool to retrieve advanced Google Product Info task results by task ID. Use when you need detailed product information from Google Shopping including title, description, images, ratings, specifications, seller details with pricing and delivery info, and product variations for a previously submitted merchant task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - unique task identifier in our system in the UUID format. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_ON_PAGE_CONTENT_PARSING_LIVEParse one page into structured content and optional Markdown.

Input Parameters

string
required
Absolute URL of the page whose content should be parsed.
boolean
Return the parsed page as Markdown in each item’s page_as_markdown field.
string ("desktop" | "mobile" | "tablet")
Browser screen preset. Use only when JavaScript or browser rendering is enabled.
boolean
Load page resources required for browser rendering.
string
Accept-Language header value the crawler should use to access the page.
boolean
Load and execute JavaScript on the page. Additional provider charges may apply.
boolean
Render the page in a browser. Requires enable_javascript and load_resources to be true and may incur additional provider charges.

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: DATAFORSEO_GET_ON_PAGE_DUPLICATE_CONTENTTool to retrieve duplicate content analysis for a specific page using the SimHash algorithm. Use when you need to identify pages with content similar to a target page, with similarity scores from 0-10 where higher scores indicate greater similarity.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format obtained from the On Page Task POST endpoint. This ID is used to retrieve results for a previously created crawl task
string
User-defined identifier for task tracking. Maximum 255 characters. This tag is returned in the response to help match requests with results
string
required
Initial page URL to analyze for duplicate content. Must be a valid URL that was crawled in the task
integer
Maximum number of pages to return in the results. Defaults to 100 if not specified. Maximum allowed value is 1000
integer
Offset for results pagination. Use this to skip the first N results. Defaults to 0
integer
Content similarity threshold on a scale of 0-10, where 0 means completely dissimilar and 10 means identical. Only pages with similarity at or above this threshold are returned. Defaults to 6 if not specified

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: DATAFORSEO_GET_ON_PAGE_DUPLICATE_TAGSTool to retrieve pages with duplicate title or description tags from On Page crawl tasks. Use when you need to identify SEO issues related to duplicate metadata across pages. Returns lists of pages sharing the same title or description tags along with page performance metrics.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

array
required
Array of task items for retrieving duplicate tags. Each task requires an On Page task ID and duplicate type. Maximum 100 tasks per 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: DATAFORSEO_GET_ON_PAGE_INSTANT_PAGESAudit one to twenty pages immediately for SEO and performance issues.

Input Parameters

array
required
One to twenty typed page audit requests.

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: DATAFORSEO_GET_ON_PAGE_KEYWORD_DENSITYTool to get keyword density and keyword frequency data from an On Page task. Use when you need to analyze keyword usage patterns on a specific website or web page, filter keywords by frequency or density, or understand which keywords appear most often on a page.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier from a previous On Page task in UUID format. You must have a completed On Page task to use this endpoint.
string
Custom identifier for matching results with your tasks. Maximum 255 characters. Useful for tracking and organizing requests.
string
Specific page URL to analyze for keyword density. Omit this parameter to analyze the entire website from the original On Page task.
integer
Maximum number of keywords to return in results. Default is 100, maximum is 1000. Use to control response size.
array
Array of filters to apply to results. Format: [[field, operator, value], ...]. Operators include: =, <>, <, <=, >, >=, like, not_like, in, not_in, regex, not_regex. Example: [['frequency', '>', 5]] to get keywords with frequency greater than 5.
array
Array of sorting rules for results. Format: [‘field,direction’] where direction is ‘asc’ or ‘desc’. Supports up to 3 rules. Example: [‘frequency,desc’] to sort by frequency in descending order.
integer
required
Number of words per keyword to analyze. Must be 1, 2, 3, 4, or 5. For example, use 1 for single words, 2 for two-word phrases, etc.

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: DATAFORSEO_GET_ON_PAGE_LIGHTHOUSE_AUDITSTool to retrieve the complete list of available Lighthouse audits for the OnPage API. Use when you need to understand which Lighthouse audit titles are available for quality analysis of web pages.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_GET_ON_PAGE_LIGHTHOUSE_TASK_GET_JSONTool to retrieve On Page Lighthouse task results in JSON format. Use when you need to fetch Google Lighthouse audit data for a previously submitted task, including performance metrics, accessibility scores, SEO analysis, and detailed audit findings.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_ON_PAGE_NON_INDEXABLETool to retrieve non-indexable pages from an On-Page crawl task by task ID. Use when you need to identify pages blocked from search engine indexing via robots.txt, meta tags, or HTTP headers. Supports filtering and pagination.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

array
required
Array of task items to retrieve non-indexable pages. Each task requires a task ID obtained from a previous On-Page crawl.

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: DATAFORSEO_GET_ON_PAGE_PAGESTool to retrieve crawled pages with on-page metrics and optimization data. Use when you need detailed page-level information including SEO scores, performance metrics, content analysis, and technical checks for pages in a crawl task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format obtained from the On Page Task POST endpoint. This ID is used to retrieve results for a previously created crawl task within 30 days
string
User-defined identifier for task tracking. Maximum 255 characters. This tag is returned in the response to help match requests with results
integer
Maximum number of pages to return in the results. Defaults to 100 if not specified. Maximum allowed value is 1000
integer
Offset for results pagination. Use this to skip the first N results. Defaults to 0
array
Array of filter conditions to narrow down results. Maximum 8 filters allowed. Supports operators like =, <, >, !=, regex, like, not_like, in, not_in. Example: [[‘resource_type’, ’=’, ‘html’], ‘and’, [‘meta.scripts_count’, ’>’, 40]]
array
Array of sorting rules. Maximum 3 rules allowed. Format: [‘field,asc’] or [‘field,desc’]. Example: [‘meta.content.plain_text_word_count,desc’]
string
Pagination token for fetching results beyond 20,000. Use the token returned from previous response to get the next batch of results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATAFORSEO_GET_ON_PAGE_PAGES_BY_RESOURCETool to retrieve pages that use a specific resource from a completed OnPage crawl task. Use when you need to find all pages utilizing a particular JavaScript file, CSS file, image, or other resource. Returns on-page metrics, SEO audit data, and Core Web Vitals for each page.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

array
required
Array of task items to retrieve pages by resource. Each task requires an id and url.

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: DATAFORSEO_GET_ON_PAGE_RAW_HTMLReturn stored HTML for a page from an On Page or Instant Pages task.

Input Parameters

string
required
On Page or Instant Pages task ID created with raw HTML storage enabled.
string
Page URL whose stored HTML should be returned. Omit for an Instant Pages task.

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: DATAFORSEO_GET_ON_PAGE_SUMMARY_BY_IDTool to retrieve On Page Summary information for a scanned website by task ID. Use when you need to get overall website statistics and drill down into on-page SEO issues such as broken links, duplicate content, crawl errors, and page status codes. Task ID must be from an On-Page task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier obtained from a previously created On-Page task. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_BAIDU_LOCATIONS_BY_COUNTRYTool to retrieve supported Baidu SERP locations by country. Use when you need to get the list of valid Baidu SERP locations for setting up SERP tasks in a specific country.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Country ISO code to filter the list of Baidu SERP locations. Example: ‘us’ for United States, ‘cn’ for China.

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: DATAFORSEO_GET_SERP_BAIDU_ORGANIC_TASK_ADVANCED_BY_IDTool to retrieve advanced Baidu Organic SERP task results by task ID. Use when you need to fetch detailed search engine results page data from Baidu including organic results, rankings, and metadata for a previously submitted task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_BING_ORGANIC_LIVE_ADVANCEDReturn current advanced Bing Organic SERP results synchronously.

Input Parameters

string ("windows" | "macos" | "android" | "ios")
Operating system compatible with the selected device.
string
User-defined task identifier returned in the response data.
string
Direct Bing search URL containing the exact language and location.
integer
Number of results to retrieve, from 1 to 200. The provider default is 10.
string ("desktop" | "mobile")
Device type. The provider defaults to desktop.
string
Domain, subdomain, webpage, or wildcard URL pattern used to filter results.
string
required
Search keyword to retrieve current Bing Organic results for.
string
Additional Bing search query parameters.
string
Search engine language code. Use exactly one language selector.
string
Full search engine language name. Use exactly one language selector.
integer
DataForSEO location code. Use exactly one location selector.
string
Full search engine location name. Use exactly one location selector.
integer
Maximum number of search result pages to crawl, from 1 to 100.
string
Location as latitude,longitude with up to seven decimal places. Use exactly one location selector.
array
One to ten target rules that stop crawling after a match is included.
integer
Browser screen width in pixels; requires calculate_rectangles=true.
boolean
Calculate pixel positions for SERP elements; the provider charges extra when enabled.
integer
Browser screen height in pixels; requires calculate_rectangles=true.
number
Browser screen pixel ratio from 0.5 to 3; requires calculate_rectangles=true.

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: DATAFORSEO_GET_SERP_BING_ORGANIC_TASK_REGULAR_BY_IDTool to retrieve Bing Organic SERP task results by task ID. Use when you need to fetch search engine results page data from a previously created Bing organic search task, including organic rankings, paid results, and related searches.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_G_DATASET_SEARCH_TASK_ADV_BY_IDTool to retrieve Google Dataset Search task results by task ID. Use when you need to fetch dataset search results including dataset names, descriptions, providers, formats, authors, licenses, and citation information.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_G_FINANCE_EXPLORE_TASK_ADV_BY_IDTool to retrieve Google Finance Explore task results by task ID. Use when you need to fetch real-time Google Finance data including market indexes, news, earnings calendars, trending instruments, and market trends for a previously created task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - unique task identifier in our system in the UUID format. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_G_FINANCE_TICKER_SEARCH_TASK_ADV_BY_IDTool to retrieve Google Finance Ticker Search task results by task ID. Use when you need to fetch financial data for stocks, indices, or asset pairs from a previously submitted Google Finance ticker search task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_G_LOCAL_FINDER_TASK_GET_ADV_BY_IDTool to retrieve Google Local Finder SERP task results by task ID. Use when you need to fetch local business search results from a previously submitted Google Local Finder task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_LIVE_ADVANCEDTool to get live Google Ads Advertisers results via DataForSEO API. Use when you need to retrieve real-time advertiser information from Google Ads Transparency Center, including advertiser names, locations, verification status, and approximate ad counts for specific keywords.Instant: Supported on the latest version.Instant pricing: $0.002 per live Google Ads Advertisers request

Input Parameters

array
required
Array of task items to be executed. Each task searches for advertisers running ads for the specified keyword. Maximum 100 tasks per 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: DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_TASK_ADVANCEDTool to retrieve Google Ads advertiser transparency data for a previously created task. Returns advertiser accounts, domains, and ad counts from Google’s ads transparency database for the specified search query.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_ADS_SEARCH_LIVE_ADVANCEDTool to get live Google Ads Search advanced results. Use when you need to retrieve advertisement data from Google Ads Transparency Center for a specific advertiser domain or advertiser IDs, including ad creatives, formats, verification status, and time ranges.Instant: Supported on the latest version.Instant pricing: $0.002 per live Google Ads Search SERP (40 results)

Input Parameters

string
User-defined task identifier (max 255 characters). This tag will be returned in the response for tracking purposes
integer
Number of results to return (default: 40, max: 120). Billing applies per 40 results
string ("all" | "text" | "image" | "video")
Advertisement format types for filtering.
string
Domain name associated with an advertiser account. Either target or advertiser_ids must be specified
string
Ending date of the time range in yyyy-mm-dd format. Required if date_from is specified
string ("all" | "google_play" | "google_maps" | "google_search" | "google_shopping" | "youtube")
Advertising platform types for filtering results.
string ("normal" | "high")
Task priority levels.
string
Starting date of the time range in yyyy-mm-dd format (minimum: 2018-05-31). Required if date_to is specified
integer
Search engine location code. Use location_code, location_name, or location_coordinate (only one at a time)
string
Full name of search engine location (e.g., ‘United States’). Use location_code, location_name, or location_coordinate (only one at a time)
array
Array of advertiser identifiers (max 25). Either advertiser_ids or target must be specified
string
GPS coordinates of a location. Format: ‘latitude,longitude’. Use location_code, location_name, or location_coordinate (only one at a time)

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: DATAFORSEO_GET_SERP_GOOGLE_AI_MODE_LIVE_ADVANCEDReturn a current Google AI Mode answer and its structured references.

Input Parameters

string ("windows" | "macos" | "android" | "ios")
Operating system compatible with the selected device.
string
User-defined identifier returned in the task data.
string ("desktop" | "mobile")
Device type. The provider defaults to desktop.
string
required
Query to submit to Google AI Mode.
string
Search engine language code. Use exactly one language selector.
string
Full search engine language name. Use exactly one language selector.
integer
DataForSEO location code. Use exactly one location selector.
string
Full search engine location name. Use exactly one location selector.
string
Location as latitude,longitude with optional 4z-18z zoom. Use exactly one location selector.
integer
Browser screen width in pixels; requires calculate_rectangles=true.
boolean
Calculate pixel positions for SERP elements. Enabling this doubles the provider charge.
integer
Browser screen height in pixels; requires calculate_rectangles=true.
number
Browser screen pixel ratio from 0.5 to 3; requires calculate_rectangles=true.

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: DATAFORSEO_GET_SERP_GOOGLE_AI_MODE_TASK_ADVANCED_BY_IDTool to retrieve Google AI Mode SERP task results by task ID. Use when you need to fetch AI-generated overview results from Google search, including markdown content, references, nested elements like text, links, images, videos, tables, and shopping results.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - universally unique identifier (UUID). Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_AUTOCOMPLETE_LIVE_ADVANCEDReturn current Google autocomplete suggestions synchronously.

Input Parameters

string
User-defined task identifier returned in the response data.
string ("chrome" | "chrome-omni" | "gws-wiz" | "gws-wiz-serp" | "safari" | "firefox" | "psy-ab" | "toolbar" | "youtube" | "gws-wiz-local" | "img" | "products-cc")
Google autocomplete client whose suggestion behavior should be reproduced.
string
required
Partial search query to retrieve current Google autocomplete suggestions for.
string
Search engine language code. Use exactly one language selector.
string
Full search engine language name. Use exactly one language selector.
integer
Search engine location code. Use exactly one location selector.
string
Full search engine location name. Use exactly one location selector.
integer
Zero-based cursor position within the keyword; defaults to its final character position.

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: DATAFORSEO_GET_SERP_GOOGLE_AUTOCOMPLETE_TASK_ADVANCED_BY_IDTool to retrieve Google Autocomplete task results by task ID. Use when you need to fetch autocomplete suggestions from a previously submitted Google Autocomplete task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_DATASET_INFO_TASK_ADVANCEDTool to retrieve Google Dataset Info task results by task ID. Use when you need to fetch dataset search results including dataset titles, providers, formats, authors, licenses, citations, and descriptions for a previously submitted dataset search task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_FINANCE_MARKETS_TASK_HTML_BY_IDTool to retrieve raw HTML results for a Google Finance Markets SERP task by ID. Use when you need to get the unprocessed HTML content of a Google Finance Markets page after creating a finance markets task. Task results are available within 7 days of creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 7 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_FINANCE_QUOTE_TASK_ADVANCED_BY_IDRetrieve advanced Google Finance Quote task results by task ID. Returned result items contain type and ranking information for the previously created task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_FINANCE_QUOTE_TASK_HTML_BY_IDTool to retrieve raw HTML results for a Google Finance Quote task by ID. Use when you need to fetch the unprocessed HTML content from a previously created finance quote task. Results remain valid for 7 days after task creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format, obtained from task_post endpoint. Valid for 7 days after task creation.

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: DATAFORSEO_GET_SERP_GOOGLE_IMAGES_TASK_GET_ADVANCED_BY_IDTool to retrieve Google Images SERP task results by task ID. Use when you need to fetch image search results from a previously submitted Google Images task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_IMAGES_TASK_HTML_BY_IDTool to retrieve raw HTML results for a Google Images SERP task by ID. Use when you need to get the unprocessed HTML content of a Google Images search results page after creating an images task. Task results are available within 7 days of creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 7 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_JOBS_TASK_ADVANCEDTool to retrieve Google Jobs SERP task results by task ID. Use when you need to fetch job listing data from a previously submitted Google Jobs search task, including employer information, location, salary, contract type, and posting details. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_MAPS_LIVE_ADVANCEDReturn current advanced Google Maps business search results synchronously.

Input Parameters

string ("windows" | "macos" | "android" | "ios")
Device operating system: windows or macos for desktop; android or ios for mobile.
string
User-defined task identifier returned in the response data.
string
Direct Google Maps search URL containing the exact location and language.
integer
Number of results to parse, from 1 to 700. The provider default is 100.
string ("desktop" | "mobile")
Device type. The provider default is desktop.
string
required
Google Maps search keyword, up to 700 characters.
string
Google search domain override.
string
Search engine language code. Use this or language_name.
string
Full search engine language name. Use this or language_code.
integer
Search engine location code. Use only one location field.
string
Full search engine location name. Use only one location field.
boolean
Whether to enable search-places mode. The provider default is true.
integer
Maximum result pages to crawl, from 1 to 100.
boolean
Whether to show results only from the displayed map area. The provider default is true.
string
Location as latitude,longitude,zoom (zoom is 3z-21z and defaults to 17z). Use only one location field.

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: DATAFORSEO_GET_SERP_GOOGLE_MAPS_TASK_GET_ADVANCED_BY_IDTool to retrieve Google Maps SERP task results by task ID. Use when you need to fetch location-based business search results from a previously submitted Google Maps task, including business details, ratings, addresses, operating hours, and contact information.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. A universally unique identifier (UUID) unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_NEWS_TASK_GET_ADVANCEDTool to retrieve Google News SERP task results by task ID. Use when you need to fetch news article data from a previously submitted Google News search task, including headlines, sources, publication dates, and top stories. The task ID must be from a task created within the last 30 days.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_LIVEReturn current Google Organic SERP results in regular or advanced format.

Input Parameters

string ("windows" | "macos" | "android" | "ios")
Operating system compatible with the selected device.
string
User-defined task identifier returned in the response data.
integer
Number of results to retrieve, from 1 to 200.
string ("desktop" | "mobile")
Device type. The provider defaults to desktop.
string
required
Search keyword to retrieve current Google Organic results for.
string
Search engine language code. Required for regular results; advanced results may omit a language selector.
string
Full search engine language name. Required for regular results; advanced results may omit a language selector.
integer
DataForSEO location code. Use exactly one location selector.
string
Full location name. Use exactly one location selector.
string ("regular" | "advanced")
Response representation: regular core listings or advanced full SERP features.
string
Location as latitude,longitude,radius, with radius from 199 to 199999 millimeters. Use exactly one location selector.

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: DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_ADVANCED_BY_IDTool to retrieve advanced Google Organic SERP task results by task ID. Use when you need to fetch detailed search engine results page data from Google including organic results, rankings, and metadata for a previously submitted task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_HTML_BY_IDTool to retrieve raw HTML results for a Google Organic SERP task by ID. Use when you need to get the unprocessed HTML content of a Google search results page after creating an organic SERP task. Results are available for 7 days after task completion.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format to retrieve HTML results from a completed SERP task. Task ID is usable within 7 days of task completion.

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: DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_REGULAR_BY_IDTool to retrieve Google Organic SERP task results by task ID. Use when you need to fetch search engine results page data from a previously created Google organic search task, including organic rankings, paid results, and featured snippets.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_GOOGLE_SEARCH_BY_IMAGE_HTML_BY_IDTool to retrieve raw HTML results for a Google Search By Image task by ID. Use when you need to get the unprocessed HTML content of Google Search By Image results after creating a search by image task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in the DataForSEO system. You can use it within 7 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_GET_ADVANCEDTool to retrieve advanced Naver Organic SERP task results by task ID. Use when you need to fetch detailed search engine results page data from Naver including organic results, rankings, and metadata for a previously submitted task. Results are available for 30 days after task creation at no additional cost.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system that can be used within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_REGULAR_BY_IDTool to retrieve Naver Organic SERP task results by task ID. Use when you need to fetch search engine results page data from a previously created Naver organic search task, including organic rankings, paid results, and related searches.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_SEZNAM_ORGANIC_TASK_GET_ADVANCED_BY_IDTool to retrieve Seznam Organic SERP task results by task ID. Use when you need to fetch organic search results from a previously submitted Seznam search task, including rankings, titles, URLs, descriptions, and other SERP features like related searches, videos, and images.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_SEZNAM_ORGANIC_TASK_GET_REGULAR_BY_IDTool to retrieve Seznam Organic SERP task results by task ID. Use when you need to fetch completed Seznam search results including organic listings, rankings, and metadata. Results remain accessible for 30 days after task creation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Unique task identifier in UUID format. Results are accessible for 30 days after task creation.

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: DATAFORSEO_GET_SERP_YAHOO_ORGANIC_TASK_GET_ADVANCED_BY_IDTool to retrieve Yahoo Organic SERP task results by task ID. Use when you need to fetch organic search results from a previously submitted Yahoo search task, including rankings, titles, URLs, descriptions, ratings, and other SERP features like related searches, videos, and images.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_YAHOO_ORGANIC_TASK_REGULAR_BY_IDTool to retrieve Yahoo Organic SERP task results by task ID. Use when you need to fetch search engine results page data from a previously created Yahoo organic search task, including organic rankings, paid results, and related searches.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier in UUID format. Unique task identifier in our system. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_YT_VIDEO_COMMENTS_TASK_ADV_BY_IDTool to retrieve advanced YouTube Video Comments SERP task results by task ID. Use when you need to fetch detailed comment data including author info, timestamps, likes, and reply counts for a previously submitted YouTube video comments task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - a universally unique identifier (UUID). Unique task identifier in our system in the UUID format. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_GET_SERP_YT_VIDEO_SUBTITLES_TASK_ADV_BY_IDTool to retrieve YouTube video subtitles from a specific task by ID. Use when you need to fetch subtitle data for a YouTube video including text, timing information, and translations from a previously submitted task.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Task identifier - unique task identifier in our system in the UUID format. You will be able to use it within 30 days to request the results of the task at any time.

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: DATAFORSEO_LIST_AI_OPT_CHAT_GPT_LLM_RESPONSES_MODELSRetrieve the list of available Chat GPT AI models from DataForSEO. Returns comprehensive information about each model including reasoning capabilities, web search support, and POST-GET retrieval compatibility. Use this action to discover which AI models are available for use with the DataForSEO AI Optimization API.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_AI_OPT_CHAT_GPT_LLM_RESPONSES_TASKS_READYList completed DataForSEO ChatGPT LLM response tasks ready for result collection. Use to retrieve task IDs for uncollected Standard-method tasks submitted without a postback URL.

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: DATAFORSEO_LIST_AI_OPT_CHAT_GPT_LLM_SCRAPER_LANGUAGESTool to list available languages for DataForSEO ChatGPT LLM Scraper. Use when you need to see which languages are supported for AI optimization scraping tasks.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_AI_OPT_CHAT_GPT_LLM_SCRAPER_LOCATIONSTool to retrieve the list of available locations for DataForSEO ChatGPT LLM Scraper. Use when you need to filter locations by country when setting up a task.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_AI_OPT_CLAUDE_LLM_RESPONSES_TASKS_READYTool to list completed AI Optimization Claude LLM response tasks that are ready for collection. Use when working with DataForSEO AI optimization endpoints to retrieve task IDs of completed jobs that haven’t been collected yet.

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: DATAFORSEO_LIST_AI_OPT_GEMINI_LLM_SCRAPER_TASKS_READYTool to retrieve completed Gemini LLM Scraper tasks that haven’t been collected yet. Use when checking for ready tasks to process results (up to 1,000 tasks from last 3 days). Rate limit: 20 calls per minute.

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: DATAFORSEO_LIST_AI_OPTIMIZATION_GEMINI_LLM_SCRAPER_LANGUAGESTool to retrieve the list of available languages for DataForSEO AI Optimization Gemini LLM Scraper API. Use when you need to check which languages are supported for Gemini-powered LLM scraping operations.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_AI_OPTIMIZATION_GEMINI_LLM_SCRAPER_LOCATIONSList available locations for the DataForSEO Gemini LLM Scraper, optionally filtered by country. Results are paginated, with 500 locations returned by default and a next offset when more are available.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

integer
Maximum locations to return per call (1-1000).
integer
Zero-based offset within matching locations.
string
Country ISO code to filter the returned locations locally. Example: ‘US’, ‘GB’, ‘CA’.

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: DATAFORSEO_LIST_AI_OPT_LLM_MENTIONS_LOCATIONS_AND_LANGUAGESTool to retrieve the full list of locations and languages supported in DataForSEO AI Optimization LLM Mentions API. Use this to discover which geographic locations and languages are available for LLM mention tracking across platforms like Google and ChatGPT. Note: ChatGPT data is only available for the United States and English language.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_AI_OPT_PERPLEXITY_LLM_RESPONSES_MODELSTool to list available Perplexity AI models for LLM responses with their capabilities. Use when you need to see which Perplexity models are available and their supported features (reasoning, web search, POST-GET data retrieval).Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_APP_DATA_APPLE_APP_LIST_TASKS_READYTool to retrieve completed Apple App List tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_APP_DATA_APPLE_CATEGORIESTool to retrieve the complete list of app categories available on Apple App Store. Use when you need to see which app categories are supported for App Data API requests.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_APP_DATA_APPLE_LANGUAGESTool to list available languages for DataForSEO Apple App Data API. Use when you need to see which languages are supported for Apple app data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_APP_DATA_APPLE_LOCATIONSTool to retrieve the list of Apple App Store locations supported in DataForSEO App Data API. Use when you need to get available location codes and names for Apple App Store data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_APP_DATA_ERRORSTool to retrieve information about App Data API tasks that returned errors within the past 7 days. Use when you need to debug failed tasks, monitor error rates, or investigate specific function failures. Supports filtering by function name and datetime range.

Input Parameters

integer
Maximum number of returned tasks that responded with an error. Default: 1000, Maximum: 1000.
integer
Offset in the results array of returned tasks. Use for pagination. Default: 0.
string
End datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-20 23:59:59 +00:00’
string
Start datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-15 12:00:00 +00:00’
string
Filter results by specific function name (e.g., ‘app_data/task_get/advanced’, ‘postback_url’, ‘pingback_url’). If not specified, returns errors for all functions.

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: DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_INFO_TASKS_READYTool to retrieve completed Google App Info tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_LISTINGS_CATEGORIESTool to list all available Google Play app categories with their listing counts. Use when you need to see the complete list of app categories available on Google Play Store.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_LIST_TASKS_READYTool to retrieve completed Google App List tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_REVIEWS_TASKS_READYTool to retrieve completed Google App Reviews tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_SEARCHES_TASKS_READYTool to retrieve completed Google App Searches tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_APP_DATA_GOOGLE_CATEGORIESTool to list available Google Play app categories. Use when you need to retrieve the complete list of app category identifiers available on Google Play for filtering or classification purposes.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_APP_DATA_GOOGLE_LANGUAGESTool to list available languages for DataForSEO Google App Data API. Use when you need to see which languages are supported for Google app data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_APP_DATA_ID_LISTTool to retrieve a list of App Data task IDs within a specified time period. Use when you need to get task IDs and metadata for all App Data tasks (both successful and uncompleted) created between two dates. Limited to 1000 task IDs per call with 10 API calls per minute.

Input Parameters

string ("asc" | "desc")
Sort order by task execution time. Allowed values: ‘asc’ (ascending) or ‘desc’ (descending). Default: ‘asc’.
integer
Maximum number of task IDs to return. Default: 1000, Maximum: 1000.
integer
Offset for the results array. Use for pagination. Default: 0.
string
required
End date and time for filtering tasks in UTC format (yyyy-mm-dd hh:mm:ss +00:00). Maximum: current datetime.
string
required
Start date and time for filtering tasks in UTC format (yyyy-mm-dd hh:mm:ss +00:00). Maximum: 1 month prior if include_metadata is true, 6 months prior if false.
boolean
Whether to include task metadata in the response. If true, only tasks from the last month can be retrieved. Default: false.

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: DATAFORSEO_LIST_APP_DATA_TASKS_READYTool to retrieve completed App Data tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_APPLE_APP_SEARCHES_TASKS_READYTool to retrieve list of completed Apple App Searches tasks that are ready for collection. Use when you need to get task IDs of completed searches from the previous three days that haven’t been collected yet.

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: DATAFORSEO_LIST_BING_SEARCH_VOLUME_HISTORY_LOCATIONSTool to retrieve the list of locations and languages supported by Bing Search Volume History endpoint. Use when you need to determine which geographic locations and languages are available for Bing search volume history queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_BIZ_GOOGLE_EXTENDED_REVIEWS_TASKS_READYTool to retrieve completed Google Extended Reviews tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BIZ_GOOGLE_HOTEL_SEARCHES_TASKS_READYTool to retrieve completed Business Data Google Hotel Searches tasks ready for collection. Use when you need to get task IDs for completed hotel search tasks that haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BIZ_GOOGLE_MY_BUSINESS_INFO_TASKS_READYTool to retrieve completed Google My Business Info tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_BIZ_GOOGLE_MY_BUSINESS_UPDATES_TASKS_READYTool to retrieve completed Google My Business Updates tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BIZ_GOOGLE_QUESTIONS_ANSWERS_TASKS_READYTool to retrieve completed Google Questions And Answers tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BIZ_TRIPADVISOR_REVIEWS_TASKS_READYTool to retrieve completed TripAdvisor Reviews tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BUSINESS_DATA_BUSINESS_LISTINGS_CATEGORIESTool to list Business Data Business Listings categories by business count. Use when you need to retrieve the available business categories for business listings data.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_BUSINESS_DATA_BUSINESS_LISTINGS_LOCATIONSTool to list available locations for Business Listings data. Use when you need to retrieve location codes and geographic information for business listing queries. Returns all supported countries with business count statistics.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_BUSINESS_DATA_ERRORSTool to retrieve information about Business Data API tasks that returned errors within the past 7 days. Use when you need to debug failed tasks, monitor error rates, or investigate specific function failures. Supports filtering by function name and datetime range.

Input Parameters

integer
Maximum number of returned tasks that responded with an error. Default: 1000, Maximum: 1000.
integer
Offset in the results array of returned tasks. Use for pagination. Default: 0.
string
End datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-20 23:59:59 +00:00’
string
Start datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-15 12:00:00 +00:00’
string
Filter results by specific function name (e.g., ‘business_data/task_get/advanced’, ‘postback_url’, ‘pingback_url’). If not specified, returns errors for all functions.

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: DATAFORSEO_LIST_BUSINESS_DATA_GOOGLE_HOTEL_INFO_TASKS_READYTool to retrieve completed Google Hotel Info tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_BUSINESS_DATA_GOOGLE_LANGUAGESTool to list available languages for DataForSEO Google Business Data API. Use when you need to see which languages are supported for Google business data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_BUSINESS_DATA_GOOGLE_REVIEWS_TASKS_READYTool to retrieve completed Google Reviews tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BUSINESS_DATA_TASKS_READYTool to retrieve completed Business Data tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BUSINESS_DATA_TRIPADVISOR_LANGUAGESTool to list available TripAdvisor languages supported in Business Data API. Use when you need to retrieve language codes for TripAdvisor Business Data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_BUSINESS_DATA_TRIPADVISOR_SEARCH_TASKS_READYTool to retrieve completed TripAdvisor Search tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BUSINESS_DATA_TRUSTPILOT_REVIEWS_TASKS_READYTool to retrieve completed Trustpilot Reviews tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_BUSINESS_DATA_TRUSTPILOT_SEARCH_TASKS_READYTool to retrieve completed Trustpilot Search tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_CLAUDE_LLM_RESPONSE_MODELSTool to list available Claude AI models for AI optimization and LLM responses. Use when you need to see which Claude models are available and their capabilities (reasoning, web search, task post support).Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_CONTENT_ANALYSIS_AVAILABLE_FILTERSTool to retrieve available filters for DataForSEO Content Analysis API. Use when you need to discover which fields can be filtered in content analysis queries and their data types (string, numeric, boolean, array, or timestamp).Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_CONTENT_ANALYSIS_CATEGORIESTool to list all available Content Analysis categories based on Google product and service categories. Use when you need to retrieve the complete hierarchical list of approximately 3,180 category codes and names for content classification purposes.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_CONTENT_ANALYSIS_LANGUAGESTool to list available languages supported in Content Analysis API. Use when you need to retrieve language codes for content analysis queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_CONTENT_ANALYSIS_LOCATIONSTool to list available locations supported in Content Analysis API. Use when you need to retrieve location codes and geographic information for content analysis queries. This is a free endpoint that returns all supported locations.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_DATAFORSEO_LABS_CATEGORIESTool to retrieve the complete hierarchical list of Google categories used by DataForSEO Labs. Use when you need to obtain category codes and names for filtering search results or understanding domain categorization.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_DATAFORSEO_LABS_ERRORSTool to retrieve information about DataForSEO Labs API tasks that returned errors within the past 7 days. Use when you need to debug failed Labs tasks, monitor error rates, or investigate specific function failures.

Input Parameters

integer
Maximum number of returned tasks that responded with an error. Default: 1000, Maximum: 1000.
integer
Offset in the results array of returned tasks. Use for pagination. Default: 0.
string
End datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-20 23:59:59 +00:00’
string
Start datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-15 12:00:00 +00:00’
string
Filter results by specific function name (e.g., ‘dataforseo_labs/google/ranked_keywords/live’, ‘postback_url’, ‘pingback_url’). If not specified, returns errors for all functions.

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: DATAFORSEO_LIST_DATAFORSEO_LABS_LOCATIONS_AND_LANGUAGESTool to list available locations and languages supported in DataForSEO Labs API. Use when you need to retrieve location codes and language codes for DataForSEO Labs queries across Google, Bing, and Amazon data sources.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_DOMAIN_ANALYTICS_ERRORSTool to retrieve information about Domain Analytics API tasks that returned errors within the past 7 days. Use when you need to debug failed tasks, monitor error rates, or investigate specific function failures. Supports filtering by function name and datetime range.

Input Parameters

integer
Maximum number of returned tasks that responded with an error. Default: 1000, Maximum: 1000.
integer
Offset in the results array of returned tasks. Use for pagination. Default: 0.
string
End datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-20 23:59:59 +00:00’
string
Start datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-15 12:00:00 +00:00’
string
Filter results by specific function name (e.g., ‘domain_analytics/technologies/domain_technologies’, ‘postback_url’, ‘pingback_url’). If not specified, returns errors for all functions.

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: DATAFORSEO_LIST_DOMAIN_ANALYTICS_ID_LISTTool to retrieve a list of Domain Analytics task IDs within a specified time period. Use when you need to get task IDs and metadata for all Domain Analytics tasks (both successful and uncompleted) created between two dates. Limited to 1000 task IDs per call with 10 API calls per minute.

Input Parameters

string ("asc" | "desc")
Sort order by task execution time. Allowed values: ‘asc’ (ascending) or ‘desc’ (descending). Default: ‘asc’.
integer
Maximum number of task IDs to return. Default: 1000, Maximum: 1000.
integer
Offset for the results array. Use for pagination. Default: 0.
string
required
End date and time for filtering tasks in UTC format (yyyy-mm-dd hh:mm:ss +00:00). Maximum: current datetime.
string
required
Start date and time for filtering tasks in UTC format (yyyy-mm-dd hh:mm:ss +00:00). Maximum: 6 months prior if include_metadata is false, 1 month prior if true.
boolean
Whether to include task metadata in the response. If true, only tasks from the last month can be retrieved. Default: false.

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: DATAFORSEO_LIST_DOMAIN_ANALYTICS_TECHNOLOGIESTool to retrieve the complete list of available technologies in DataForSEO Domain Analytics API, organized by groups and categories. Use when you need to discover which technologies can be tracked or analyzed (e.g., ecommerce platforms, analytics tools, marketing services).Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_DOMAIN_ANALYTICS_TECHNOLOGIES_FILTERSTool to retrieve available filters for DataForSEO Domain Analytics Technologies API endpoints. Use when you need to discover which fields can be filtered in domain analytics technology queries and their data types (string, numeric, or timestamp).Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_DOMAIN_ANALYTICS_TECHNOLOGIES_LANGUAGESTool to list available languages for Domain Analytics Technologies API. Use when you need to retrieve language codes for domain analytics technology queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_DOMAIN_ANALYTICS_TECHNOLOGIES_LOCATIONSList available locations for the Domain Analytics Technologies API, including location names and country ISO codes for technology stack analysis queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_DOMAIN_ANALYTICS_WHOIS_FILTERSTool to retrieve available filters for DataForSEO Domain Analytics Whois API endpoint. Use when you need to discover which fields can be filtered in whois queries and their data types (string, numeric, boolean, array, or timestamp).Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_GEMINI_LLM_MODELSTool to list available Gemini LLM response models with their capabilities. Use when you need to see which Gemini AI models are available for optimization tasks, including their reasoning and web search support.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_GEMINI_LLM_RESPONSES_TASKS_READYTool to retrieve a list of completed Gemini LLM response tasks that haven’t been collected yet. Use when working with DataForSEO’s Standard method without postback_url to get task IDs for result collection via Task GET endpoint. Returns up to 1000 completed tasks from the previous three days. Rate limit: 20 calls per minute.

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: DATAFORSEO_LIST_KEYWORDS_DATA_BING_LANGUAGESTool to list available languages for DataForSEO Bing Keywords Data API. Use when you need to see which languages are supported for Bing keyword data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASKS_READYTool to retrieve completed Keywords Data Bing Search Volume tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_KEYWORDS_DATA_ENDPOINTSTool to retrieve all available Keywords Data API endpoints. Use when you need to discover available Keywords Data endpoints for Bing, Google, Google Ads, Google Trends, Clickstream Data, and DataForSEO Trends.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_KEYWORDS_DATA_ERRORSTool to retrieve Keywords Data API tasks that returned errors within the past 7 days. Use when you need to monitor or debug failed Keywords Data API requests, investigate error patterns, or troubleshoot API integration issues.

Input Parameters

integer
Maximum number of error records to return. Default: 100
integer
Pagination offset for results. Default: 0
string
End date/time for filtering errors in UTC format (e.g., ‘2024-01-31 23:59:59’). Filters errors up to this timestamp
string
Start date/time for filtering errors in UTC format (e.g., ‘2024-01-01 00:00:00’). Filters errors from this timestamp onwards
string
Filter errors by specific API function name (e.g., ‘keywords_for_keywords’, ‘search_volume’). Returns only errors from this function

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: DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_ADS_LANGUAGESTool to list available languages for DataForSEO Keywords Data Google Ads API. Use when you need to see which languages are supported for Google Ads keyword data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_CATEGORIESTool to list available Google AdWords product/service categories. Use when you need to retrieve the hierarchical list of ~94,933 Google advertising categories for keyword research or ad targeting purposes.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_LANGUAGESTool to list available languages for DataForSEO Google Keywords Data API. Use when you need to see which languages are supported for Google keywords data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_KW_BING_AUDIENCE_EST_JOB_FUNCTIONSTool to retrieve the list of job functions with job_function_id supported by Bing Ads Audience Estimation endpoint. Use when you need to see which job functions are available for audience estimation in Bing Ads.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_KW_BING_AUDIENCE_EST_TASKS_READYTool to retrieve completed Keywords Data Bing Audience Estimation tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_KW_BING_KW_FOR_KW_TASKS_READYTool to retrieve completed Bing Keywords For Keywords tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_KW_BING_KW_FOR_SITE_TASKS_READYTool to retrieve completed Bing Keywords For Site tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_KW_BING_KW_PERFORMANCE_TASKS_READYTool to retrieve completed Bing Keyword Performance tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_KW_BING_KW_SUGGESTIONS_FOR_URL_LANGUAGESTool to list available languages for DataForSEO Bing Keyword Suggestions API. Use when you need to see which languages are supported for Bing keyword suggestions queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_KW_BING_KW_SUGGESTIONS_FOR_URL_TASKS_READYTool to retrieve completed Bing Keyword Suggestions For URL tasks that haven’t been collected yet. Use when working with DataForSEO’s Standard method without postback_url to get task IDs for result collection. Results are maintained for 3 days after task completion.

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: DATAFORSEO_LIST_KW_BING_SEARCH_VOL_HISTORY_TASKS_READYTool to retrieve completed Bing Search Volume History tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_KW_CLICKSTREAM_LOCATIONS_AND_LANGUAGESTool to retrieve the full list of locations and languages supported in DataForSEO Clickstream Data API. Use when you need to get available geographic locations and their supported languages for clickstream keyword data. This endpoint is free and incurs no cost.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_KW_GOOGLE_ADS_AD_TRAFFIC_BY_KW_TASKS_READYTool to retrieve completed Google Ads Ad Traffic by Keywords tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_KW_GOOGLE_ADS_KW_FOR_KW_TASKS_READYTool to retrieve completed Google Ads Keywords For Keywords tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_KW_GOOGLE_ADS_KW_FOR_SITE_TASKS_READYTool to retrieve completed Google Ads Keywords For Site tasks that haven’t been collected yet. Use when working with DataForSEO’s Standard method without postback_url to get task IDs for result collection.

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: DATAFORSEO_LIST_KW_GOOGLE_ADS_SEARCH_VOL_TASKS_READYTool to retrieve completed Google Ads Search Volume tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_KW_GOOGLE_KW_FOR_KW_TASKS_READYTool to retrieve completed Google Keywords For Keywords tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_KW_GOOGLE_KW_FOR_SITE_TASKS_READYTool to retrieve completed Google Keywords For Site tasks that haven’t been collected yet. Use when working with DataForSEO’s Standard method without postback_url to get task IDs for result collection. Tasks are kept for 3 days after completion.

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: DATAFORSEO_LIST_KW_GOOGLE_SEARCH_VOL_TASKS_READYTool to retrieve completed Google Search Volume tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_LABS_GOOGLE_CATEGORIES_FOR_KW_LANGUAGESTool to list available languages for DataForSEO Labs Google Categories for Keywords API. Use when you need to see which languages are supported for Google Categories for Keywords queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_MERCHANT_AMAZON_ASIN_TASKS_READYTool to retrieve completed Merchant Amazon Asin tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_MERCHANT_AMAZON_LANGUAGESTool to list available languages for DataForSEO Amazon Merchant Data API. Use when you need to see which languages are supported for Amazon merchant data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_MERCHANT_AMAZON_PRODUCTS_TASKS_READYTool to retrieve completed Merchant Amazon Products tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_MERCHANT_AMAZON_SELLERS_TASKS_READYTool to retrieve completed Merchant Amazon Sellers tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_MERCHANT_ERRORSTool to retrieve information about Merchant API tasks that returned errors within the past 7 days. Use when you need to debug failed merchant tasks, monitor error rates, or investigate specific function failures. Supports filtering by function name and datetime range.

Input Parameters

integer
Maximum number of returned tasks that responded with an error. Default: 1000, Maximum: 1000.
integer
Offset in the results array of returned tasks. Use for pagination. Default: 0.
string
End datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-20 23:59:59 +00:00’
string
Start datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-15 12:00:00 +00:00’
string
Filter results by specific function name (e.g., ‘sellers/ad_url’, ‘postback_url’, ‘pingback_url’). If not specified, returns errors for all functions.

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: DATAFORSEO_LIST_MERCHANT_GOOGLE_LANGUAGESTool to list available languages for DataForSEO Merchant Google API. Use when you need to see which languages are supported for Google Shopping data queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_MERCHANT_GOOGLE_PRODUCT_INFO_TASKS_READYTool to retrieve completed Merchant Google Product Info tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_MERCHANT_GOOGLE_PRODUCTS_TASKS_READYTool to retrieve completed Merchant Google Products tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_MERCHANT_GOOGLE_REVIEWS_TASKS_READYTool to retrieve completed Merchant Google Reviews tasks that are ready for collection. Use when you need to get task IDs for completed tasks that haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_MERCHANT_GOOGLE_SELLERS_TASKS_READYTool to retrieve completed Merchant Google Sellers tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_MERCHANT_TASKS_READYTool to retrieve completed Merchant tasks that are ready for collection. Use when you need to get a list of task IDs for Google Shopping Products tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_ON_PAGE_AVAILABLE_FILTERSTool to retrieve available filters for DataForSEO OnPage API endpoints. Use when you need to discover which fields can be filtered in OnPage queries (resources, pages, non_indexable, links, pages_by_resource, redirect_chains, keyword_density) and their data types.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_ON_PAGE_ERRORSTool to retrieve information about OnPage API tasks that returned errors within the past 7 days. Use when you need to debug failed OnPage tasks, monitor error rates, or investigate specific function failures. Supports filtering by function name and datetime range.

Input Parameters

integer
Maximum number of returned tasks that responded with an error. Default: 1000, Maximum: 1000.
integer
Offset in the results array of returned tasks. Use for pagination. Default: 0.
string
End datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-20 23:59:59 +00:00’
string
Start datetime for filtering errors in UTC format ‘yyyy-mm-dd hh:mm:ss +00:00’. Filters errors within the last 7 days. Example: ‘2024-01-15 12:00:00 +00:00’
string
Filter results by specific function name (e.g., ‘on_page/task_post’, ‘postback_url’, ‘pingback_url’). If not specified, returns errors for all functions.

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: DATAFORSEO_LIST_ON_PAGE_LIGHTHOUSE_LANGUAGESTool to list available languages for DataForSEO On Page Lighthouse API. Use when you need to see which languages are supported for Lighthouse page quality audits.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_ON_PAGE_LIGHTHOUSE_TASKS_READYTool to retrieve the list of completed On Page Lighthouse tasks that haven’t been collected yet. Use when you need to get task IDs for completed Lighthouse audits before fetching their results. Tasks remain available for three days after completion.

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: DATAFORSEO_LIST_ON_PAGE_LIGHTHOUSE_VERSIONSTool to list available Lighthouse versions for OnPage API audits. Use when you need to check which Lighthouse versions are supported or identify the default version used for page quality analysis.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_ON_PAGE_RESOURCESTool to retrieve resources from a completed OnPage crawl task. Use when you need a detailed list of images, scripts, stylesheets, and broken elements found during the crawl. Returns resource metadata, sizes, loading times, and validation checks.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

array
required
Array of task items to retrieve resources. Each task requires an id.

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: DATAFORSEO_LIST_ON_PAGE_TASKS_READYTool to retrieve completed On Page tasks that haven’t been collected yet. Use when checking for ready tasks to process results (up to 1,000 tasks from last 3 days). Rate limit: 20 calls per minute.

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: DATAFORSEO_LIST_SERP_BAIDU_LANGUAGESTool to list available languages for DataForSEO Baidu SERP API. Use when you need to see which languages are supported for Baidu search engine results page queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_BAIDU_ORGANIC_TASKS_FIXEDTool to retrieve re-parsed Baidu organic SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_BAIDU_ORGANIC_TASKS_READYTool to retrieve completed SERP Baidu Organic tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_BING_LANGUAGESTool to list available languages for DataForSEO Bing SERP API. Use when you need to see which languages are supported for Bing search engine results page queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_BING_ORGANIC_TASKS_FIXEDTool to retrieve list of re-parsed Bing Organic SERP tasks that haven’t been collected yet. Use when you need to get task IDs for re-parsed results using the Standard method without postback_url, then collect the fixed results using Task GET endpoints.

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: DATAFORSEO_LIST_SERP_BING_ORGANIC_TASKS_READYTool to retrieve completed SERP Bing Organic tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_ENDPOINTSTool to retrieve the complete list of available SERP API endpoints for task setup. Use when you need to discover which SERP endpoints are available for specific search engines or operations.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_ERRORSTool to retrieve SERP API tasks that returned errors within the past 7 days. Use when you need to investigate or debug SERP API failures, monitor error patterns, or troubleshoot specific task issues.

Input Parameters

integer
Maximum number of error records to return
integer
Number of records to skip before returning results (for pagination)
string
End date and time for filtering errors in UTC format (e.g., ‘2024-01-31 23:59:59’). Must be within the past 7 days.
string
Start date and time for filtering errors in UTC format (e.g., ‘2024-01-01 00:00:00’). Must be within the past 7 days.
string
Filter errors by specific SERP API function name (e.g., ‘google/organic/live/advanced’, ‘pingback_url’)

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: DATAFORSEO_LIST_SERP_G_FINANCE_TICKER_SEARCH_TASKS_READYTool to retrieve completed SERP Google Finance Ticker Search tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_ADS_ADVERTISERS_LOCATIONSTool to list available Google Ads advertiser locations for SERP API queries. Use when you need to retrieve location codes and geographic information for Google Ads advertiser targeting. Note: locations in Russia and Belarus are no longer supported.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_GOOGLE_ADS_ADVERTISERS_TASKS_READYTool to retrieve completed SERP Google Ads Advertisers tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_ADS_SEARCH_LOCATIONSTool to list available Google Ads Search locations for SERP API. Use when you need location codes for geographic targeting in Google Ads Search queries. Returns all supported locations with their codes and geographic hierarchy. Note: locations in Russia and Belarus are not supported.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_GOOGLE_ADS_SEARCH_TASKS_READYTool to retrieve completed SERP Google Ads Search tasks that are ready for collection. Use when you need to get a list of task IDs for Google Ads Search tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_AI_MODE_LANGUAGESTool to list available languages for DataForSEO Google AI Mode SERP API. Use when you need to see which languages are supported for Google AI Mode search engine results page queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_GOOGLE_AI_MODE_TASKS_FIXEDTool to retrieve re-parsed SERP Google AI Mode tasks that haven’t been collected yet. Use when you need to get a list of task IDs for tasks that have been automatically re-parsed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1,000 re-parsed tasks from the last 24 hours. Rate limit: 20 calls per minute.

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: DATAFORSEO_LIST_SERP_GOOGLE_AI_MODE_TASKS_READYTool to retrieve completed SERP Google AI Mode tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_AUTOCOMPLETE_TASKS_FIXEDTool to retrieve re-parsed Google autocomplete SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_AUTOCOMPLETE_TASKS_READYTool to retrieve completed SERP Google Autocomplete tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_DATASET_INFO_TASKS_FIXEDTool to retrieve re-parsed Google Dataset Info tasks that haven’t been collected yet. Use when you need to get a list of task IDs for re-parsed tasks completed using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_DATASET_INFO_TASKS_READYTool to retrieve completed SERP Google Dataset Info tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_DATASET_SEARCH_TASKS_FIXEDTool to retrieve re-parsed Google Dataset Search SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_DATASET_SEARCH_TASKS_READYTool to retrieve completed SERP Google Dataset Search tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_EVENTS_TASKS_FIXEDTool to retrieve re-parsed Google Events SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_EVENTS_TASKS_READYTool to retrieve completed SERP Google Events tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_SERP_GOOGLE_FINANCE_EXPLORE_TASKS_READYTool to retrieve completed SERP Google Finance Explore tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_FINANCE_MARKETS_TASKS_READYTool to retrieve completed SERP Google Finance Markets tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_FINANCE_QUOTE_TASKS_READYTool to retrieve completed SERP Google Finance Quote tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_IMAGES_TASKS_FIXEDTool to retrieve re-parsed Google Images SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_IMAGES_TASKS_READYTool to retrieve completed SERP Google Images tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_SERP_GOOGLE_JOBS_TASKS_FIXEDTool to retrieve re-parsed Google Jobs SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_JOBS_TASKS_READYTool to retrieve completed SERP Google Jobs tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_LANGUAGESTool to list available languages for DataForSEO Google SERP API. Use when you need to see which languages are supported for Google SERP queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_GOOGLE_LOCAL_FINDER_TASKS_FIXEDTool to retrieve re-parsed Google Local Finder SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_LOCAL_FINDER_TASKS_READYTool to retrieve completed SERP Google Local Finder tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_MAPS_TASKS_FIXEDTool to retrieve re-parsed Google Maps SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_MAPS_TASKS_READYTool to retrieve completed SERP Google Maps tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_NEWS_TASKS_FIXEDTool to retrieve re-parsed Google News SERP tasks that haven’t been collected yet. Use when you need to get a list of task IDs for re-parsed tasks completed using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_NEWS_TASKS_READYTool to retrieve completed SERP Google News tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_GOOGLE_ORGANIC_TASKS_FIXEDTool to retrieve re-parsed Google Organic SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_ORGANIC_TASKS_READYTool to retrieve completed SERP Google Organic tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_SERP_GOOGLE_SEARCH_BY_IMAGE_TASKS_FIXEDTool to retrieve re-parsed Google Search by Image SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_GOOGLE_SEARCH_BY_IMAGE_TASKS_READYTool to retrieve completed SERP Google Search By Image tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_ID_LISTTool to retrieve a list of SERP task IDs within a specified time period. Use when you need to get task IDs and metadata for all SERP tasks (both successful and uncompleted) created between two dates. Limited to 1000 task IDs per call.

Input Parameters

string ("asc" | "desc")
Sort order by task execution time. Allowed values: ‘asc’ (ascending) or ‘desc’ (descending). Default: ‘asc’.
integer
Maximum number of task IDs to return. Default: 1000, Maximum: 1000.
integer
Offset for pagination. Use for retrieving results beyond the limit. Default: 0.
string
required
End date and time for filtering tasks in UTC format (yyyy-mm-dd hh:mm:ss +00:00). Must be greater than datetime_from.
string
required
Start date and time for filtering tasks in UTC format (yyyy-mm-dd hh:mm:ss +00:00). Minimum: 6 months ago (without metadata) or 1 month ago (with metadata).
boolean
Whether to include task metadata in the response. If true, only tasks from the last month can be retrieved. Default: false.

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: DATAFORSEO_LIST_SERP_NAVER_ORGANIC_TASKS_FIXEDTool to retrieve re-parsed Naver organic SERP tasks that haven’t been collected yet. Use when you need to get a list of task IDs for re-parsed tasks completed using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_NAVER_ORGANIC_TASKS_READYTool to retrieve completed SERP Naver Organic tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_SEZNAM_LANGUAGESTool to list available languages for DataForSEO Seznam SERP API. Use when you need to see which languages are supported for Seznam search engine results page queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_SEZNAM_ORGANIC_TASKS_FIXEDTool to retrieve re-parsed Seznam organic SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_SEZNAM_ORGANIC_TASKS_READYTool to retrieve completed Seznam Organic SERP tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_TASKS_READYTool to retrieve completed SERP tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_SERP_YAHOO_LANGUAGESTool to list available languages for DataForSEO Yahoo SERP API. Use when you need to see which languages are supported for Yahoo SERP queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_YAHOO_ORGANIC_TASKS_FIXEDTool to retrieve re-parsed Yahoo organic SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_YAHOO_ORGANIC_TASKS_READYTool to retrieve completed Yahoo Organic SERP tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_YOUTUBE_LANGUAGESTool to list available languages for DataForSEO YouTube SERP API. Use when you need to see which languages are supported for YouTube SERP queries.Instant: Supported on the latest version.Instant pricing: $0 per 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: DATAFORSEO_LIST_SERP_YOUTUBE_ORGANIC_TASKS_READYTool to retrieve completed YouTube Organic SERP tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_COMMENTS_TASKS_FIXEDTool to retrieve re-parsed YouTube Video Comments SERP tasks that haven’t been collected yet. Use when you need to get a list of task IDs for re-parsed tasks completed using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_COMMENTS_TASKS_READYTool to retrieve completed YouTube video comments SERP tasks that are ready for collection. Use when you need to get task IDs for YouTube video comments tasks that have completed but haven’t been collected yet using the Standard method without postback_url. Returns up to 1000 completed tasks from the previous three days.

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: DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_INFO_TASKS_FIXEDTool to retrieve re-parsed YouTube Video Info SERP tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_INFO_TASKS_READYTool to retrieve completed SERP YouTube Video Info tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_SUBTITLES_TASKS_FIXEDTool to retrieve re-parsed SERP YouTube Video Subtitles tasks that haven’t been collected yet. Use when you need to get task IDs for completed re-parsed tasks using the Standard method without postback_url, then collect the fixed results using the Task GET endpoint.

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: DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_SUBTITLES_TASKS_READYTool to retrieve completed SERP YouTube Video Subtitles tasks that are ready for collection. Use when you need to get a list of task IDs for tasks that have completed but haven’t been collected yet using the Standard method without postback_url.

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: DATAFORSEO_POST_DATAFORSEO_LABS_BULK_KEYWORD_DIFFICULTY_LIVETool to retrieve bulk keyword difficulty scores from DataForSEO Labs. Returns difficulty scores (0-100) for up to 1000 keywords based on top-10 SERP link profile analysis. Use when you need to assess keyword competitiveness at scale for SEO planning.Instant: Supported on the latest version.Instant pricing: Estimated $0.012 per keyword-difficulty request plus $0.001 per 10 keywords

Input Parameters

string
User-defined task identifier for tracking purposes. Maximum 255 characters
array
required
Array of keywords to get difficulty scores for. Maximum 1000 keywords allowed. Each keyword must be at least 3 characters long and will be converted to lowercase
string
Language code. Required if language_name is not provided
string
Full name of the language. Required if language_code is not provided
integer
Location code for search analysis. Required if location_name is not provided
string
Full name of the location for search analysis. Required if location_code is not provided

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: DATAFORSEO_POST_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASKCreate a Bing Search Volume task for keyword analysis. The returned task ID can be used to retrieve search volume, historical trends, cost-per-click, and competition data after the task completes.Instant: Supported on the latest version.Instant pricing: $0.06 per Bing search-volume request, for up to 200 keywords

Input Parameters

string
User-defined task identifier for tracking purposes. Maximum 255 characters
string ("all" | "mobile" | "desktop" | "tablet")
Device type for search volume data.
string
End date for search volume trend data in yyyy-mm-dd format. Maximum is 1 month ahead of current date
string ("search_volume" | "cpc" | "competition" | "relevance")
Sort order for keyword results.
array
required
Array of keywords to analyze for search volume data. Maximum 1000 keywords, each with max 100 characters
string
Start date for search volume trend data in yyyy-mm-dd format. Minimum is 24 months back from current date
string
GET endpoint URL to receive completion notification. DataForSEO will send a GET request to this URL when the task is complete
string
POST endpoint URL to receive completed task results. DataForSEO will POST the results to this URL when the task is complete
string
Language code for the search (e.g., ‘en’, ‘fr’, ‘de’). Use language_code OR language_name
string
Full name of the language for the search (e.g., ‘English’, ‘French’, ‘German’). Use language_name OR language_code
integer
Location code for the search (e.g., 2840 for United States). Use location_code OR location_name OR location_coordinate
string
Full name of the location for the search (e.g., ‘United States’). Use location_name OR location_code OR location_coordinate
boolean
Include Bing partner networks in search volume data. Default: false
string
GPS coordinates in ‘latitude,longitude’ format (e.g., ‘40.7128,-74.0060’ for New York). Use location_coordinate OR location_name OR location_code

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: DATAFORSEO_POST_KEYWORDS_DATA_GOOGLE_SEARCH_VOLUME_TASKTool to submit a Google search volume task for specified keywords. Use when you need to get search volume data for keywords. Returns a task ID that can be used to retrieve results asynchronously.

Input Parameters

string
Custom identifier for tracking this task. Maximum 255 characters.
array
required
Array of keywords to get search volume data for. Maximum 700 keywords, each up to 80 characters with maximum 10 words per keyword phrase.
string
Notification URL to receive a GET request when task completes. Supports $id and $tag variables.
string
Callback URL for automatic POST delivery of results when task completes. Supports $id and $tag variables.
string
Language code in ISO format (e.g., ‘en’, ‘es’). Use this OR language_name.
string
Full language name (e.g., ‘English’). Use this OR language_code.
integer
Location identifier code. Use this OR location_name OR location_coordinate. Example: 2840 for United States.
string
Full location name for search engine targeting (e.g., ‘United States’, ‘London,England,United Kingdom’). Use this OR location_code OR location_coordinate.
boolean
Include Google search partners in results. Default is false.
string
GPS coordinates in ‘latitude,longitude’ format for precise location targeting. Use this OR location_name OR location_code.

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: DATAFORSEO_POST_KW_GOOGLE_KW_FOR_CATEGORY_TASKTool to create a Google Keywords For Category task to retrieve keyword suggestions for a specific product/service category. Returns a task ID which can be used to fetch up to 700 keywords with search volume, CPC, competition metrics, and historical trends. Use when you need category-based keyword research for SEO or PPC planning.

Input Parameters

string
User-defined task identifier for tracking purposes. Maximum 255 characters
string
Sort order for results. Accepted values: ‘search_volume’ (default) or ‘relevance’
string
URL to receive GET ping notification when task completes. Use for lightweight completion notifications
string
URL to receive POST callback with task results when completed. Use for webhook delivery of results
integer
required
Product or service category identifier from Google Ads. Required to specify which category to retrieve keyword suggestions for
string
Language code for keyword targeting (e.g., ‘en’, ‘es’). Use language_code or language_name (only one at a time)
string
Full name of the target language (e.g., ‘English’, ‘Spanish’). Use language_code or language_name (only one at a time)
integer
Geographic location identifier for targeting. Use location_code, location_name, or location_coordinate (only one at a time)
string
Full name of target location (e.g., ‘United States’, ‘New York’). Use location_code, location_name, or location_coordinate (only one at a time)
boolean
Whether to include data from Google search partner network sites in addition to Google.com. Default is false
array
Array of negative keywords to exclude from results. Maximum 200 terms allowed. Keywords containing these terms will be filtered out
string
GPS coordinates with radius for location targeting. Format: ‘latitude,longitude,radius_km’ (e.g., ‘29.6821525,-82.4098881,100’). Use location_code, location_name, or location_coordinate (only one at a time)

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: DATAFORSEO_POST_ON_PAGE_SUMMARYTool to retrieve On Page Summary information for multiple scanned websites via POST request. Use when you need to get overall website statistics and drill down into on-page SEO issues for one or more task IDs in a single request.

Input Parameters

array
required
Array of task items to retrieve On Page Summary results. Each task requires an id.

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: DATAFORSEO_RESEND_APPENDIX_WEBHOOKSTool to resend webhooks (pingbacks and postbacks) for completed tasks. Use when you need to re-trigger webhook notifications for up to 100 tasks. Your account will not be double-charged for resending webhooks.

Input Parameters

array
required
Array of task identifiers to resend webhooks for. Maximum 100 tasks per request. Your account will not be double-charged for resending webhooks.

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: DATAFORSEO_SEARCH_BUSINESS_LISTINGS_LIVESearch DataForSEO’s Google Maps business listings index synchronously.

Input Parameters

string
User-defined task identifier, up to 255 characters.
integer
Maximum number of businesses to return, from 1 to 1000. The provider default is 100.
string
Business name to match, up to 200 characters.
integer
Number of matching businesses to omit before returning results.
array
Up to 8 listing filters, with ‘and’ or ‘or’ between conditions. A condition uses [field, operator, value].
array
Up to 3 sorting rules in field,asc or field,desc format.
array
Business category identifiers to search for, up to 10 categories.
boolean
Filter by whether the Google Maps listing is verified by its owner.
string
Business description text to match, up to 200 characters.
string
Opaque token from a previous response for retrieving the next result segment.
string
Search center and radius in latitude,longitude,radius format, with radius in kilometres from 1 to 100000.

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