tag"},"follow":{"type":"boolean","title":"Follow","description":"Whether page allows following links (true if follow, false if nofollow)"},"charset":{"type":"integer","title":"Charset","description":"Character encoding from meta charset"},"favicon":{"type":"string","title":"Favicon","description":"Favicon URL"},"canonical":{"type":"string","title":"Canonical","description":"Canonical URL from link rel=canonical tag"},"generator":{"type":"string","title":"Generator","description":"Content management system or generator from meta generator tag"},"description":{"type":"string","title":"Description","description":"Meta description content"},"images_size":{"type":"integer","title":"Images Size","description":"Total size of all images in bytes"},"images_count":{"type":"integer","title":"Images Count","description":"Number of images on the page"},"scripts_size":{"type":"integer","title":"Scripts Size","description":"Total size of all scripts in bytes"},"meta_keywords":{"type":"string","title":"Meta Keywords","description":"Meta keywords content"},"scripts_count":{"type":"integer","title":"Scripts Count","description":"Number of script tags on the page"},"stylesheets_size":{"type":"integer","title":"Stylesheets Size","description":"Total size of all stylesheets in bytes"},"stylesheets_count":{"type":"integer","title":"Stylesheets Count","description":"Number of stylesheet references"},"external_links_count":{"type":"integer","title":"External Links Count","description":"Number of external links on the page"},"internal_links_count":{"type":"integer","title":"Internal Links Count","description":"Number of internal links on the page"}},"description":"Page metadata information including title, description, and SEO properties.","additionalProperties":false},"size":{"type":"integer","title":"Size","description":"Uncompressed resource size in bytes"},"checks":{"type":"object","title":"Checks","properties":{"flash":{"type":"boolean","title":"Flash","description":"True if page contains Flash content"},"frame":{"type":"boolean","title":"Frame","description":"True if page contains frames or iframes"},"is_www":{"type":"boolean","title":"Is Www","description":"True if URL includes www subdomain"},"is_http":{"type":"boolean","title":"Is Http","description":"True if URL uses HTTP protocol"},"is_https":{"type":"boolean","title":"Is Https","description":"True if URL uses HTTPS protocol"},"canonical":{"type":"boolean","title":"Canonical","description":"True if page has canonical tag"},"is_broken":{"type":"boolean","title":"Is Broken","description":"True if page returns 4xx or 5xx status code"},"no_h1_tag":{"type":"boolean","title":"No H1 Tag","description":"True if page has no H1 heading tag"},"no_doctype":{"type":"boolean","title":"No Doctype","description":"True if HTML lacks DOCTYPE declaration"},"no_favicon":{"type":"boolean","title":"No Favicon","description":"True if page lacks favicon"},"is_redirect":{"type":"boolean","title":"Is Redirect","description":"True if page returns a redirect status code"},"broken_links":{"type":"boolean","title":"Broken Links","description":"True if page contains broken hyperlinks"},"has_misspelling":{"type":"boolean","title":"Has Misspelling","description":"True if page content contains spelling errors"},"large_page_size":{"type":"boolean","title":"Large Page Size","description":"True if page size exceeds recommended limit"},"broken_resources":{"type":"boolean","title":"Broken Resources","description":"True if page has broken resource links (images, scripts, styles)"},"seo_friendly_url":{"type":"boolean","title":"Seo Friendly Url","description":"True if URL is SEO-friendly (readable, descriptive)"},"high_loading_time":{"type":"boolean","title":"High Loading Time","description":"True if page loading time exceeds optimal threshold"},"high_waiting_time":{"type":"boolean","title":"High Waiting Time","description":"True if server response time (TTFB) is high"},"https_to_http_links":{"type":"boolean","title":"Https To Http Links","description":"True if HTTPS page contains HTTP links"},"no_content_encoding":{"type":"boolean","title":"No Content Encoding","description":"True if page lacks content encoding (gzip/compress)"},"no_encoding_meta_tag":{"type":"boolean","title":"No Encoding Meta Tag","description":"True if page lacks charset meta tag"}},"description":"On-page SEO audit checks with boolean indicators for various optimization factors.","additionalProperties":false},"content":{"type":"object","title":"Content","properties":{"plain_text_rate":{"type":"number","title":"Plain Text Rate","description":"Ratio of plain text to total HTML size"},"plain_text_size":{"type":"integer","title":"Plain Text Size","description":"Size of plain text content in characters"},"plain_text_word_count":{"type":"integer","title":"Plain Text Word Count","description":"Number of words in plain text content"},"smog_readability_index":{"type":"number","title":"Smog Readability Index","description":"SMOG readability index score"},"automated_readability_index":{"type":"number","title":"Automated Readability Index","description":"Automated Readability Index score"},"dale_chall_readability_index":{"type":"number","title":"Dale Chall Readability Index","description":"Dale-Chall readability score"},"title_to_content_consistency":{"type":"number","title":"Title To Content Consistency","description":"Consistency score between title and page content (0-1)"},"coleman_liau_readability_index":{"type":"number","title":"Coleman Liau Readability Index","description":"Coleman-Liau readability index score"},"flesch_kincaid_readability_index":{"type":"number","title":"Flesch Kincaid Readability Index","description":"Flesch-Kincaid readability score"},"description_to_content_consistency":{"type":"number","title":"Description To Content Consistency","description":"Consistency score between meta description and page content (0-1)"}},"description":"Content analysis metrics including readability and consistency.","additionalProperties":false},"location":{"type":"string","title":"Location","description":"Redirect location if applicable"},"page_timing":{"type":"object","title":"PageTiming","properties":{"speed_index":{"type":"integer","title":"Speed Index","description":"Speed Index metric in milliseconds"},"dom_complete":{"type":"integer","title":"Dom Complete","description":"DOM Complete time in milliseconds"},"download_time":{"type":"integer","title":"Download Time","description":"Total download time in milliseconds"},"first_input_delay":{"type":"integer","title":"First Input Delay","description":"First Input Delay (FID) in milliseconds - Core Web Vital"},"time_to_interactive":{"type":"integer","title":"Time To Interactive","description":"Time to Interactive (TTI) in milliseconds"},"first_contentful_paint":{"type":"integer","title":"First Contentful Paint","description":"First Contentful Paint (FCP) in milliseconds"},"cumulative_layout_shift":{"type":"number","title":"Cumulative Layout Shift","description":"Cumulative Layout Shift (CLS) score - Core Web Vital"},"largest_contentful_paint":{"type":"integer","title":"Largest Contentful Paint","description":"Largest Contentful Paint (LCP) in milliseconds - Core Web Vital"},"time_to_secure_connection":{"type":"integer","title":"Time To Secure Connection","description":"Time to establish secure connection in milliseconds"}},"description":"Page load timing metrics and Core Web Vitals.","additionalProperties":false},"status_code":{"type":"integer","title":"Status Code","description":"HTTP response status code"},"encoded_size":{"type":"integer","title":"Encoded Size","description":"Compressed resource size in bytes"},"onpage_score":{"type":"number","title":"Onpage Score","description":"On-page optimization score from 0 to 100"},"cache_control":{"type":"object","title":"CacheControl","properties":{"ttl":{"type":"integer","title":"Ttl","description":"Time to live in seconds for cached resource"},"cachable":{"type":"boolean","title":"Cachable","description":"Whether the resource is cacheable"}},"description":"Cache control directives and settings.","additionalProperties":false},"resource_type":{"type":"string","title":"Resource Type","description":"Type of resource (e.g., 'html')"},"total_dom_size":{"type":"integer","title":"Total Dom Size","description":"Total DOM size in bytes"},"duplicate_title":{"type":"boolean","title":"Duplicate Title","description":"True if page title is duplicated across multiple pages"},"duplicate_content":{"type":"boolean","title":"Duplicate Content","description":"True if page content is duplicated"},"total_transfer_size":{"type":"integer","title":"Total Transfer Size","description":"Total transfer size including headers in bytes"},"duplicate_description":{"type":"boolean","title":"Duplicate Description","description":"True if meta description is duplicated across multiple pages"}},"description":"Individual page result containing crawl data and on-page metrics."},"title":"Result","description":"Array of page results with crawl data and metrics"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success, 40000+ indicates error."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects containing pages that use the specified resource"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_SUMMARY_BY_ID","name":"Get On Page Summary","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"tag":{"type":"string","title":"Tag","description":"Custom tag associated with the task"},"target":{"type":"string","title":"Target","description":"Target website URL that was crawled"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum number of pages set for crawling"}},"description":"Echo of the original request parameters sent in the task creation request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"OnPageSummaryResult","properties":{"domain_info":{"type":"object","title":"DomainInfo","properties":{"ip":{"type":"string","title":"Ip","description":"Domain IP address"},"cms":{"type":"string","title":"Cms","description":"Identified CMS platform"},"name":{"type":"string","title":"Name","description":"Domain name"},"checks":{"type":"object","title":"DomainChecks","properties":{"ssl":{"type":"boolean","title":"Ssl","description":"Whether SSL certificate is present"},"http2":{"type":"boolean","title":"Http2","description":"Whether HTTP/2 protocol is supported"},"sitemap":{"type":"boolean","title":"Sitemap","description":"Whether sitemap is detected on the domain"},"robots_txt":{"type":"boolean","title":"Robots Txt","description":"Whether robots.txt file is present"},"test_www_redirect":{"type":"boolean","title":"Test Www Redirect","description":"Whether www redirect is implemented"},"test_https_redirect":{"type":"boolean","title":"Test Https Redirect","description":"Whether HTTP redirects to HTTPS"},"test_page_not_found":{"type":"boolean","title":"Test Page Not Found","description":"Whether 404 responses work correctly"},"start_page_deny_flag":{"type":"boolean","title":"Start Page Deny Flag","description":"Whether start page returns 403 forbidden status"},"test_canonicalization":{"type":"boolean","title":"Test Canonicalization","description":"Result of canonicalization test"},"test_directory_browsing":{"type":"boolean","title":"Test Directory Browsing","description":"Whether directory browsing is blocked"},"test_hidden_server_signature":{"type":"boolean","title":"Test Hidden Server Signature","description":"Whether server signature is hidden"}},"description":"Domain-level checks for common SEO and technical requirements.","additionalProperties":false},"server":{"type":"string","title":"Server","description":"Server version and type"},"ssl_info":{"type":"object","title":"SslInfo","properties":{"certificate_hash":{"type":"string","title":"Certificate Hash","description":"Hash algorithm version used"},"valid_certificate":{"type":"boolean","title":"Valid Certificate","description":"Whether the SSL certificate is valid"},"certificate_issuer":{"type":"string","title":"Certificate Issuer","description":"Certificate issuing authority"},"certificate_subject":{"type":"string","title":"Certificate Subject","description":"Certificate subject entity"},"certificate_version":{"type":"string","title":"Certificate Version","description":"X.509 certificate version"},"certificate_expiration_date":{"type":"string","title":"Certificate Expiration Date","description":"Certificate expiration timestamp in UTC format"}},"description":"SSL certificate information for the domain.","additionalProperties":false},"crawl_end":{"type":"string","title":"Crawl End","description":"Crawl completion timestamp in UTC format"},"crawl_start":{"type":"string","title":"Crawl Start","description":"Crawl initiation timestamp in UTC format"},"main_domain":{"type":"string","title":"Main Domain","description":"Root domain name"},"total_pages":{"type":"integer","title":"Total Pages","description":"Total number of pages crawled"},"extended_crawl_status":{"type":"string","title":"Extended Crawl Status","description":"Detailed crawl status or error information"},"www_redirect_status_code":{"type":"integer","title":"Www Redirect Status Code","description":"Status code for www redirect response"},"page_not_found_status_code":{"type":"integer","title":"Page Not Found Status Code","description":"HTTP status code for 404 pages"},"canonicalization_status_code":{"type":"integer","title":"Canonicalization Status Code","description":"Status code for canonical redirect"},"directory_browsing_status_code":{"type":"integer","title":"Directory Browsing Status Code","description":"Status code for directory browsing response"}},"description":"Domain-wide information and configuration.","additionalProperties":false},"crawl_status":{"type":"object","title":"CrawlStatus","properties":{"pages_crawled":{"type":"integer","title":"Pages Crawled","description":"Number of pages successfully crawled"},"pages_in_queue":{"type":"integer","title":"Pages In Queue","description":"Number of pages awaiting crawl"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum number of pages set for crawling"}},"description":"Crawl status information including queue and progress metrics.","additionalProperties":false},"page_metrics":{"type":"object","title":"PageMetrics","properties":{"checks":{"type":"object","title":"PageChecks","properties":{"frame":{"type":"integer","title":"Frame","description":"Pages with frame or iframe elements"},"is_www":{"type":"integer","title":"Is Www","description":"Pages on www subdomain"},"is_http":{"type":"integer","title":"Is Http","description":"Pages using HTTP protocol"},"is_https":{"type":"integer","title":"Is Https","description":"Pages using HTTPS protocol"},"no_title":{"type":"integer","title":"No Title","description":"Pages missing title tags"},"canonical":{"type":"integer","title":"Canonical","description":"Number of canonical pages"},"is_broken":{"type":"integer","title":"Is Broken","description":"Pages with status codes below 200 or above 400"},"no_h1_tag":{"type":"integer","title":"No H1 Tag","description":"Pages missing H1 tags"},"no_doctype":{"type":"integer","title":"No Doctype","description":"Pages missing DOCTYPE declaration"},"no_favicon":{"type":"integer","title":"No Favicon","description":"Pages where favicon is not detected"},"is_4xx_code":{"type":"integer","title":"Is 4Xx Code","description":"Pages with 4xx response codes"},"is_5xx_code":{"type":"integer","title":"Is 5Xx Code","description":"Pages with 5xx response codes"},"is_redirect":{"type":"integer","title":"Is Redirect","description":"Pages with 3XX redirect status codes"},"lorem_ipsum":{"type":"integer","title":"Lorem Ipsum","description":"Pages with lorem ipsum placeholder text detected"},"no_image_alt":{"type":"integer","title":"No Image Alt","description":"Pages with images missing alt attributes"},"is_orphan_page":{"type":"integer","title":"Is Orphan Page","description":"Pages unreachable via internal links"},"no_description":{"type":"integer","title":"No Description","description":"Pages missing meta description tags"},"no_image_title":{"type":"integer","title":"No Image Title","description":"Pages with images missing title attributes"},"redirect_chain":{"type":"integer","title":"Redirect Chain","description":"Pages with multiple redirect chains"},"title_too_long":{"type":"integer","title":"Title Too Long","description":"Pages with titles exceeding 65 characters"},"canonical_chain":{"type":"integer","title":"Canonical Chain","description":"Pages with canonical pointing to canonicalized page"},"has_misspelling":{"type":"integer","title":"Has Misspelling","description":"Pages with spelling mistakes found"},"large_page_size":{"type":"integer","title":"Large Page Size","description":"Pages exceeding 1 MB in size"},"small_page_size":{"type":"integer","title":"Small Page Size","description":"Pages under 1024 bytes in size"},"title_too_short":{"type":"integer","title":"Title Too Short","description":"Pages with titles under 30 characters"},"has_html_doctype":{"type":"integer","title":"Has Html Doctype","description":"Pages with valid DOCTYPE present"},"irrelevant_title":{"type":"integer","title":"Irrelevant Title","description":"Pages with title relevance threshold below 0.3"},"low_content_rate":{"type":"integer","title":"Low Content Rate","description":"Pages with low plaintext-to-size ratio"},"seo_friendly_url":{"type":"integer","title":"Seo Friendly Url","description":"Pages with SEO-compliant URLs"},"high_content_rate":{"type":"integer","title":"High Content Rate","description":"Pages with content rate exceeding 0.9"},"high_loading_time":{"type":"integer","title":"High Loading Time","description":"Pages with load time exceeding 3 seconds"},"high_waiting_time":{"type":"integer","title":"High Waiting Time","description":"Pages with TTFB exceeding 1.5 seconds"},"canonical_to_broken":{"type":"integer","title":"Canonical To Broken","description":"Pages with canonical pointing to 404s"},"duplicate_meta_tags":{"type":"integer","title":"Duplicate Meta Tags","description":"Pages with duplicate meta tags"},"https_to_http_links":{"type":"integer","title":"Https To Http Links","description":"HTTPS pages with mixed security links"},"low_character_count":{"type":"integer","title":"Low Character Count","description":"Pages with less than 1024 characters"},"no_content_encoding":{"type":"integer","title":"No Content Encoding","description":"Pages missing compression"},"recursive_canonical":{"type":"integer","title":"Recursive Canonical","description":"Pages with canonical loop detection"},"deprecated_html_tags":{"type":"integer","title":"Deprecated Html Tags","description":"Pages with deprecated HTML elements"},"high_character_count":{"type":"integer","title":"High Character Count","description":"Pages with over 256,000 characters"},"low_readability_rate":{"type":"integer","title":"Low Readability Rate","description":"Pages with Flesch-Kincaid score under 15"},"no_encoding_meta_tag":{"type":"integer","title":"No Encoding Meta Tag","description":"Pages missing charset encoding meta tag"},"canonical_to_redirect":{"type":"integer","title":"Canonical To Redirect","description":"Pages with canonical pointing to redirects"},"size_greater_than_3mb":{"type":"integer","title":"Size Greater Than 3Mb","description":"Pages over 3 MB in size"},"has_links_to_redirects":{"type":"integer","title":"Has Links To Redirects","description":"Pages linking to redirect URLs"},"irrelevant_description":{"type":"integer","title":"Irrelevant Description","description":"Pages with description relevance below 0.2"},"irrelevant_meta_keywords":{"type":"integer","title":"Irrelevant Meta Keywords","description":"Pages with meta keywords relevance below 0.6"},"meta_charset_consistency":{"type":"integer","title":"Meta Charset Consistency","description":"Pages with charset encoding mismatches"},"has_render_blocking_resources":{"type":"integer","title":"Has Render Blocking Resources","description":"Pages with render-blocking assets"},"seo_friendly_url_dynamic_check":{"type":"integer","title":"Seo Friendly Url Dynamic Check","description":"Pages with no dynamic parameters in URL"},"seo_friendly_url_keywords_check":{"type":"integer","title":"Seo Friendly Url Keywords Check","description":"Pages with URL-title keyword consistency"},"seo_friendly_url_characters_check":{"type":"integer","title":"Seo Friendly Url Characters Check","description":"Pages passing URL character validation"},"seo_friendly_url_relative_length_check":{"type":"integer","title":"Seo Friendly Url Relative Length Check","description":"Pages with URL length under 120 characters"}},"description":"Comprehensive page-level checks aggregate for on-page SEO issues.","additionalProperties":false},"broken_links":{"type":"integer","title":"Broken Links","description":"Total broken link count"},"onpage_score":{"type":"number","title":"Onpage Score","description":"Overall on-page SEO optimization score on 0-100 scale"},"non_indexable":{"type":"integer","title":"Non Indexable","description":"Number of pages blocked from indexing"},"redirect_loop":{"type":"integer","title":"Redirect Loop","description":"Number of redirect chains leading back to same URL"},"links_external":{"type":"integer","title":"Links External","description":"Total count of external links across all pages"},"links_internal":{"type":"integer","title":"Links Internal","description":"Total count of internal links across all pages"},"duplicate_title":{"type":"integer","title":"Duplicate Title","description":"Number of pages with duplicate title tags"},"broken_resources":{"type":"integer","title":"Broken Resources","description":"Total broken resource count (images, scripts, stylesheets)"},"duplicate_content":{"type":"integer","title":"Duplicate Content","description":"Number of pages with duplicate content"},"duplicate_description":{"type":"integer","title":"Duplicate Description","description":"Number of pages with duplicate meta descriptions"},"links_relation_conflict":{"type":"integer","title":"Links Relation Conflict","description":"Number of link relation conflicts"}},"description":"Aggregated page statistics and metrics.","additionalProperties":false},"crawl_progress":{"type":"string","title":"Crawl Progress","description":"Progress of the crawl operation (e.g., 'finished', 'in_progress')"},"crawl_stop_reason":{"type":"string","title":"Crawl Stop Reason","description":"Reason why crawling was halted"},"crawl_gateway_address":{"type":"string","title":"Crawl Gateway Address","description":"IP address of the crawler used"}},"description":"On Page Summary result containing overall website information and issues."},"title":"Result","description":"List of On Page Summary results containing overall website information and issues"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with On Page Summary results."},"title":"Tasks","description":"Array of task objects containing On Page Summary results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_BAIDU_LOCATIONS_BY_COUNTRY","name":"Get SERP Baidu Locations By Country","description":"Tool 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.","input_parameters":{"country":{"type":"string","description":"Country ISO code to filter the list of Baidu SERP locations. Example: 'us' for United States, 'cn' for China.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD."},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"BaiduLocationTaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique UUID task identifier."},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD."},"data":{"type":"object","title":"Data","description":"Request parameters used for this task.","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","title":"BaiduLocationResult","properties":{"location_code":{"type":"integer","title":"Location Code","description":"Unique location identifier code for Baidu SERP."},"location_name":{"type":"string","title":"Location Name","description":"Full name of the Baidu SERP location."},"location_type":{"type":"string","title":"Location Type","description":"Classification of the location (e.g., Country, State, City)."},"country_iso_code":{"type":"string","title":"Country Iso Code","description":"ISO country code for the Baidu SERP location."},"location_code_parent":{"type":"integer","title":"Location Code Parent","description":"Parent location code (null for top-level locations)."}},"description":"Represents a single Baidu SERP location entry."},"title":"Result","description":"Array of Baidu SERP location results."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code."},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned for this task."},"status_message":{"type":"string","title":"Status Message","description":"Task-specific status message."}},"description":"Represents a single task result in the DataForSEO response."},"title":"Tasks","description":"Array of task result objects containing Baidu SERP location data."},"version":{"type":"string","title":"Version","description":"Current API version."},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about request status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_BAIDU_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Baidu Organic Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"faq":{"type":"array","items":{"type":"object","title":"FaqItem","properties":{"type":{"type":"string","title":"Type","description":"FAQ element type"},"title":{"type":"string","title":"Title","description":"Question text"},"description":{"type":"string","title":"Description","description":"Answer text"}},"description":"FAQ item in search results."},"title":"Faq","description":"FAQ section items"},"url":{"type":"string","title":"Url","description":"Result URL"},"page":{"type":"integer","title":"Page","description":"SERP page number"},"type":{"type":"string","title":"Type","description":"Element type (e.g., organic, paid, video)"},"links":{"type":"array","items":{"type":"object","title":"LinkInfo","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link information for search result items."},"title":"Links","description":"Additional links within the result"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price value"},"regular":{"type":"number","title":"Regular","description":"Regular price without discounts"},"currency":{"type":"string","title":"Currency","description":"ISO currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in a range"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether price represents a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for products in search results.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Result title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"images":{"type":"array","items":{"type":"object","title":"ImageInfo","properties":{"alt":{"type":"string","title":"Alt","description":"Alt text for the image"},"url":{"type":"string","title":"Url","description":"Image source URL"},"type":{"type":"string","title":"Type","description":"Image element type"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Image information in search results."},"title":"Images","description":"Images within the result"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum value for this rating scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for search result items.","additionalProperties":false},"position":{"type":"string","title":"Position","description":"Element position on the page (left/right)"},"cache_url":{"type":"string","title":"Cache Url","description":"Cached page URL"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate"},"y":{"type":"number","title":"Y","description":"Y coordinate"},"width":{"type":"number","title":"Width","description":"Rectangle width"},"height":{"type":"number","title":"Height","description":"Rectangle height"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the result publication"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"description":{"type":"string","title":"Description","description":"Result description snippet"},"highlighted":{"type":"array","items":{"type":"string","properties":{}},"title":"Highlighted","description":"Highlighted keywords in the result"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"}},"description":"Organic search result item from Baidu SERP."},"title":"Items","description":"Array of search result items including organic results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query used (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Baidu domain used for search"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of SERP pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code used"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results found"}},"description":"Individual task result containing Baidu Organic SERP data."},"title":"Result","description":"Array of Baidu SERP result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to API docs for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_BING_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Bing Organic Task Regular By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"OrganicItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Full URL of the search result"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":null,"description":"Page number where this result appears"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of the SERP item (e.g., 'organic', 'paid')"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Title of the search result"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Domain of the result"},"breadcrumb":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Breadcrumb","default":null,"description":"Breadcrumb navigation path shown in the result"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within a group of elements with identical type values"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":null,"description":"Description or snippet from the search result"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank in the SERP (across all types)"}},"description":"Organic search result item from Bing SERP."},{"type":"object","title":"RelatedSearchesItem","properties":{"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":null,"description":"Page number where this section appears"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type identifier (e.g., 'related_searches')"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"RelatedSearchItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL for the related search"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of related search item"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Related search query text"}},"description":"Individual related search query suggestion."}},{"type":"null"}],"title":"Items","default":null,"description":"Array of related search suggestions"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within a group of elements with identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank in the SERP"}},"description":"Related searches section in SERP results."}],"properties":{}},"title":"Items","description":"Array of SERP result items including organic results, paid results, and related searches"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of spell correction applied"},"keyword":{"type":"string","title":"Keyword","description":"Corrected keyword suggestion from the search engine"}},"description":"Autocorrection information for the search query.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the search results on Bing"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of SERP items found (e.g., 'organic', 'paid', 'related_searches')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the items array"},"language_code":{"type":"string","title":"Language Code","description":"Language code parameter used in the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code parameter used in the request"},"refinement_chips":{"type":"object","title":"RefinementChips","properties":{"type":{"type":"string","title":"Type","description":"Type of refinement chips element"},"items":{"type":"array","items":{"type":"object","title":"RefinementChipsItem","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Type of refinement chip"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"}},"description":"Individual refinement chip suggestion."},"title":"Items","description":"Array of refinement chip items"}},"description":"Search refinement chip suggestions.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results reported by the search engine"}},"description":"Complete SERP result data for a Bing Organic search task."},"title":"Result","description":"Array of SERP results containing organic and paid search results, related searches, and other SERP features"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with SERP results."},"title":"Tasks","description":"Array of task objects containing SERP results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_ADS_ADVERTISERS_TASK_ADV_BY_ID","name":"Get SERP Google Ads Advertisers Task (Advanced)","description":"Tool to retrieve Google Ads Advertisers task results by task ID. Use when you need to fetch advertiser information from Google Ads Transparency Center, including advertiser names, locations, verification status, and approximate ad counts.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (ads_advertisers)"},"items":{"type":"array","items":{"type":"object","title":"AdsAdvertiserItem","properties":{"type":{"type":"string","title":"Type","description":"Element type (ads_advertiser, ads_multi_account_advertiser, ads_domain)"},"title":{"type":"string","title":"Title","description":"Advertiser name or title"},"xpath":{"type":"string","title":"Xpath","description":"DOM location identifier"},"domain":{"type":"string","title":"Domain","description":"Domain name (for ads_domain type)"},"location":{"type":"string","title":"Location","description":"Advertiser location"},"verified":{"type":"boolean","title":"Verified","description":"Whether the advertiser is verified"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"advertisers":{"type":"array","items":{"type":"object","title":"AdvertiserDetail","properties":{"location":{"type":"string","title":"Location","description":"Advertiser location"},"verified":{"type":"boolean","title":"Verified","description":"Whether the advertiser is verified"},"advertiser_id":{"type":"string","title":"Advertiser Id","description":"Unique advertiser identifier"},"approx_ads_count":{"type":"integer","title":"Approx Ads Count","description":"Approximate number of ads for this advertiser"}},"description":"Individual advertiser account details within a multi-account group."},"title":"Advertisers","description":"List of individual advertisers (for ads_multi_account_advertiser type)"},"advertiser_id":{"type":"string","title":"Advertiser Id","description":"Unique advertiser identifier (for ads_advertiser type)"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"},"approx_ads_count":{"type":"integer","title":"Approx Ads Count","description":"Approximate number of ads"}},"description":"Base class for advertiser-related items in search results."},"title":"Items","description":"Array of advertiser items with details"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search term used in the query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to view the search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (adstransparency.google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements found in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"array","items":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Refinement chip display text"},"domain":{"type":"string","title":"Domain","description":"Domain name for the refinement"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"Additional refinement options"}},"description":"Search refinement option for narrowing results."},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found"}},"description":"Search result data for Google Ads Advertisers task."},"title":"Result","description":"Array of search result objects containing advertiser data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Ads Advertisers results."},"title":"Tasks","description":"Array of task objects containing Google Ads Advertisers results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_DATASET_SEARCH_TASK_ADV_BY_ID","name":"Get SERP Google Dataset Search Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (dataset_search)"},"items":{"type":"array","items":{"type":"object","title":"DatasetItem","properties":{"type":{"type":"string","title":"Type","description":"Element type (typically 'dataset')"},"links":{"type":"array","items":{"type":"object","title":"LinkElement","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"domain":{"type":"string","title":"Domain","description":"Link domain"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link element within dataset results."},"title":"Links","description":"Array of sitelinks within the result"},"title":{"type":"string","title":"Title","description":"Dataset name/title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"authors":{"type":"array","items":{"type":"object","title":"AuthorInfo","properties":{"url":{"type":"string","title":"Url","description":"Author profile URL"},"name":{"type":"string","title":"Name","description":"Author name"},"type":{"type":"string","title":"Type","description":"Author element type"},"domain":{"type":"string","title":"Domain","description":"Author domain"}},"description":"Dataset author/creator information."},"title":"Authors","description":"Dataset creators/authors information"},"formats":{"type":"array","items":{"type":"object","title":"FormatInfo","properties":{"size":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Size","description":"File size information"},"type":{"type":"string","title":"Type","description":"Format type identifier"},"format":{"type":"string","title":"Format","description":"File format (e.g., CSV, JSON)"}},"description":"File format information for datasets."},"title":"Formats","description":"Available file formats with size information"},"licenses":{"type":"array","items":{"type":"object","title":"LicenseInfo","properties":{"url":{"type":"string","title":"Url","description":"License details URL"},"type":{"type":"string","title":"Type","description":"License element type"},"title":{"type":"string","title":"Title","description":"License name"},"domain":{"type":"string","title":"Domain","description":"License domain"}},"description":"Dataset license information."},"title":"Licenses","description":"Dataset licensing terms"},"position":{"type":"string","title":"Position","description":"Element alignment (left/right)"},"image_url":{"type":"string","title":"Image Url","description":"Associated image URL"},"dataset_id":{"type":"string","title":"Dataset Id","description":"Unique dataset identifier"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"area_covered":{"type":"array","items":{"type":"string","properties":{}},"title":"Area Covered","description":"Geographic areas covered by the dataset"},"updated_date":{"type":"string","title":"Updated Date","description":"Last update timestamp for the dataset"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"},"period_covered":{"type":"object","title":"PeriodCovered","properties":{"end_date":{"type":"string","title":"End Date","description":"End date of coverage"},"start_date":{"type":"string","title":"Start Date","description":"Start date of coverage"},"displayed_date":{"type":"string","title":"Displayed Date","description":"Display date text"}},"description":"Temporal coverage information for datasets.","additionalProperties":false},"related_article":{"type":"string","title":"Related Article","description":"URL to related publication"},"dataset_providers":{"type":"array","items":{"type":"object","title":"DatasetProviderInfo","properties":{"url":{"type":"string","title":"Url","description":"Provider URL"},"type":{"type":"string","title":"Type","description":"Provider element type"},"title":{"type":"string","title":"Title","description":"Provider name/title"},"domain":{"type":"string","title":"Domain","description":"Provider domain"}},"description":"Dataset provider information."},"title":"Dataset Providers","description":"List of dataset provider institutions"},"unique_identifier":{"type":"string","title":"Unique Identifier","description":"Digital object identifier (DOI) or similar"},"dataset_description":{"type":"object","title":"DatasetDescription","properties":{"text":{"type":"string","title":"Text","description":"Description text"},"links":{"type":"array","items":{"type":"object","title":"DatasetDescriptionLink","properties":{"url":{"type":"string","title":"Url","description":"Link URL"},"type":{"type":"string","title":"Type","description":"Link type identifier"},"title":{"type":"string","title":"Title","description":"Link text"}},"description":"Link embedded in dataset description."},"title":"Links","description":"Embedded links in description"}},"description":"Dataset description with embedded links.","additionalProperties":false},"scholarly_articles_url":{"type":"string","title":"Scholarly Articles Url","description":"URL to related scholarly articles"},"scholarly_citations_count":{"type":"integer","title":"Scholarly Citations Count","description":"Number of scholarly citations"}},"description":"Dataset search result item."},"title":"Items","description":"Array of dataset items with details"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search term used in the query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to view the search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements found in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"array","items":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Refinement chip display text"},"domain":{"type":"string","title":"Domain","description":"Domain name for the refinement"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"Additional refinement options"}},"description":"Search refinement option for narrowing results."},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found"}},"description":"Search result data for Google Dataset Search task."},"title":"Result","description":"Array of search result objects containing dataset data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Dataset Search results."},"title":"Tasks","description":"Array of task objects containing Google Dataset Search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_FINANCE_EXPLORE_TASK_ADV_BY_ID","name":"Get SERP Google Finance Explore Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (finance_explore)"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"GoogleFinanceHeroGroupsItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_hero_groups)"},"markets":{"anyOf":[{"type":"object","title":"GoogleFinanceHeroMarkets","properties":{"us":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."}},{"type":"null"}],"title":"Us","default":null,"description":"US market indexes"},"asia":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."}},{"type":"null"}],"title":"Asia","default":null,"description":"Asian market indexes"},"crypto":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceAssetPairElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance pair link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Exchange rate value"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Movement direction"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Pair identifier (e.g., EUR-USD)"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Base asset code"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price movement"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Quote asset code"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Formatted pair name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent change"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Full base asset name"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Full quote asset name"}},"description":"Asset pair (currency, crypto) financial data element."}},{"type":"null"}],"title":"Crypto","default":null,"description":"Cryptocurrency pairs"},"europe":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."}},{"type":"null"}],"title":"Europe","default":null,"description":"European market indexes"},"futures":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."}},{"type":"null"}],"title":"Futures","default":null,"description":"Futures indexes"},"currencies":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceAssetPairElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance pair link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Exchange rate value"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Movement direction"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Pair identifier (e.g., EUR-USD)"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Base asset code"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price movement"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Quote asset code"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Formatted pair name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent change"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Full base asset name"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Full quote asset name"}},"description":"Asset pair (currency, crypto) financial data element."}},{"type":"null"}],"title":"Currencies","default":null,"description":"Currency pairs"}},"description":"Markets data within hero groups section."},{"type":"null"}],"default":null,"description":"Market data organized by region and type"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Hero groups item containing market overview across regions."},{"type":"object","title":"GoogleFinanceInterestedItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_interested)"},"items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."},{"type":"object","title":"GoogleFinanceAssetPairElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance pair link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Exchange rate value"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Movement direction"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Pair identifier (e.g., EUR-USD)"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Base asset code"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price movement"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Quote asset code"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Formatted pair name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent change"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Full base asset name"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Full quote asset name"}},"description":"Asset pair (currency, crypto) financial data element."},{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}]}},{"type":"null"}],"title":"Items","default":null,"description":"List of financial instruments"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item showing recent searches and followed securities."},{"type":"object","title":"GoogleFinanceNewsItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_news)"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceNewsElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Article link"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Article headline"},"quotes":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceNewsQuote","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance URL"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Price trend direction"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument ticker symbol"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Display name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"}},"description":"Financial instrument quote mentioned in a news article."}},{"type":"null"}],"title":"Quotes","default":null,"description":"Financial instruments mentioned"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":null,"description":"Publishing website name"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"Featured image URL"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Publication time"}},"description":"News article element from Google Finance."}},{"type":"null"}],"title":"Items","default":null,"description":"List of news articles"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item containing news articles and quoted market indexes."},{"type":"object","title":"GoogleFinanceEarningsCalendarItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_earnings_calendar)"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceEarningsCalendarElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Calendar link"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Calendar event name"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Event date/time"}},"description":"Earnings calendar event element."}},{"type":"null"}],"title":"Items","default":null,"description":"List of earnings calendar events"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item containing upcoming earnings dates."},{"type":"object","title":"GoogleFinanceMostFollowedItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_most_followed)"},"items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."},{"type":"object","title":"GoogleFinanceAssetPairElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance pair link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Exchange rate value"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Movement direction"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Pair identifier (e.g., EUR-USD)"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Base asset code"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price movement"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Quote asset code"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Formatted pair name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent change"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Full base asset name"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Full quote asset name"}},"description":"Asset pair (currency, crypto) financial data element."},{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}]}},{"type":"null"}],"title":"Items","default":null,"description":"List of trending financial instruments"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item showing trending financial instruments and pairs."},{"type":"object","title":"GoogleFinanceMarketTrendsItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_market_trends)"},"trends":{"anyOf":[{"type":"object","title":"GoogleFinanceMarketTrendsCategory","properties":{"losers":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}},{"type":"null"}],"title":"Losers","default":null,"description":"Top losing instruments"},"gainers":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}},{"type":"null"}],"title":"Gainers","default":null,"description":"Top gaining instruments"},"most_active":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}},{"type":"null"}],"title":"Most Active","default":null,"description":"Most actively traded instruments"}},"description":"Market trends category (most active, gainers, losers)."},{"type":"null"}],"default":null,"description":"Market trends organized by category"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item containing market trends categorized by performance."},{"type":"object","title":"GoogleFinancePeopleAlsoSearchItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_people_also_search)"},"items":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Items","default":null,"description":"List of related search terms"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item containing related search suggestions."}],"properties":{}},"title":"Items","description":"Array of Google Finance SERP elements"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection information if search query was corrected.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search term used in the query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to view the search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements found in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"array","items":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Refinement chip display text"},"domain":{"type":"string","title":"Domain","description":"Domain name for the refinement"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"Additional refinement options"}},"description":"Search refinement option for narrowing results."},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found"}},"description":"Search result data for Google Finance Explore task."},"title":"Result","description":"Array of search result objects containing finance data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Finance Explore results."},"title":"Tasks","description":"Array of task objects containing Google Finance Explore results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_FINANCE_TICKER_SEARCH_TASK_ADV_BY_ID","name":"Get SERP Google Finance Ticker Search Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier. Value: 'finance_ticker_search'"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"GoogleFinanceMarketIndex","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL to the detailed market index page"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of the item. Value: 'google_finance_market_index'"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction (e.g., 'up', 'down')"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Ticker symbol of the market index"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location of the market"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Timestamp when the data was retrieved"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Unique identifier for the market index"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within the group of elements with identical type values"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current value of the market index"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank among all elements in the result"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Display name of the market index"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change in the index value"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Change in index value"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market identifier code"}},"description":"Market index item from Google Finance search results."},{"type":"object","title":"GoogleFinanceAssetPair","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL to the detailed asset pair page"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of the item. Value: 'google_finance_asset_pair'"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price of the asset pair"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction (e.g., 'up', 'down')"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location or market"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Timestamp when the data was retrieved"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Unique identifier for the asset pair"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within the group of elements with identical type values"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Symbol of the base currency/asset in the pair"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Change in price"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Symbol of the quote currency/asset in the pair"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank among all elements in the result"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Display name of the asset pair"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change in price"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Display name of the base currency/asset"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Display name of the quote currency/asset"}},"description":"Asset pair (currency/commodity) item from Google Finance search results."},{"type":"object","title":"GoogleFinanceMarketInstrument","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL to the detailed instrument page"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of the item. Value: 'google_finance_market_instrument'"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price of the instrument"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction (e.g., 'up', 'down')"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Ticker symbol of the instrument"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location or exchange"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Timestamp when the data was retrieved"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Unique identifier for the market instrument"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within the group of elements with identical type values"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Change in price"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank among all elements in the result"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Display name of the instrument"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code for the price (e.g., 'USD', 'EUR')"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change in price"}},"description":"Market instrument (stock/security) item from Google Finance search results."}],"properties":{}},"title":"Items","description":"Array of finance ticker search result items (market indices, asset pairs, or instruments)"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of spell correction"},"keyword":{"type":"string","title":"Keyword","description":"Autocorrected keyword"}},"description":"Spell check or autocorrection information.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword or ticker symbol used in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the search results on Google Finance"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results array"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"string","title":"Location Code","description":"Geographic location code used for the request"},"refinement_chips":{"type":"object","title":"RefinementChip","properties":{"type":{"type":"string","title":"Type","description":"Type of refinement chip"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"},"options":{"type":"array","items":{"type":"object","title":"RefinementChipOption","properties":{"url":{"type":"string","title":"Url","description":"URL for the refinement option"},"type":{"type":"string","title":"Type","description":"Type of refinement option"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"}},"description":"Individual refinement chip option."},"title":"Options","description":"Array of refinement options"}},"description":"Search refinement chip option.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found in the search engine"}},"description":"Result data containing Google Finance Ticker Search results."},"title":"Result","description":"Array of finance ticker search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Finance Ticker Search results."},"title":"Tasks","description":"Array of task objects containing Google Finance Ticker Search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_LOCAL_FINDER_TASK_GET_ADV_BY_ID","name":"Get SERP Google Local Finder Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Search type (e.g., local_finder)"},"items":{"type":"array","items":{"type":"object","title":"LocalPackItem","properties":{"cid":{"type":"string","title":"Cid","description":"Google client ID"},"url":{"type":"string","title":"Url","description":"Relevant URL for the business"},"type":{"type":"string","title":"Type","description":"Element type (e.g., local_pack)"},"phone":{"type":"string","title":"Phone","description":"Business phone number"},"title":{"type":"string","title":"Title","description":"Business name or title"},"xpath":{"type":"string","title":"Xpath","description":"DOM element XPath locator"},"domain":{"type":"string","title":"Domain","description":"Associated domain"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum possible rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Format type (e.g., Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of reviews or votes"}},"description":"Rating information for local business results.","additionalProperties":false},"is_paid":{"type":"boolean","title":"Is Paid","description":"Advertisement indicator"},"position":{"type":"string","title":"Position","description":"Alignment on page (left or right)"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate position"},"y":{"type":"number","title":"Y","description":"Y coordinate position"},"width":{"type":"number","title":"Width","description":"Rectangle width in pixels"},"height":{"type":"number","title":"Height","description":"Rectangle height in pixels"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"rank_group":{"type":"integer","title":"Rank Group","description":"Group position among identical types"},"description":{"type":"string","title":"Description","description":"Business description text"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in SERP"}},"description":"Individual local pack search result item."},"title":"Items","description":"Array of local pack search result items"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Correction type (e.g., did_you_mean, showing_results_for)"},"keyword":{"type":"string","title":"Keyword","description":"Autocorrected search term"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Result timestamp in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct SERP verification URL"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of search results present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Search refinement options","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of SERP results"}},"description":"Result data containing Google Local Finder search results."},"title":"Result","description":"Array of local finder search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task information with Google Local Finder search results."},"title":"Tasks","description":"Array of task objects containing Google Local Finder search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_ADVANCED","name":"Get SERP Google Ads Advertisers Advanced","description":"Tool to retrieve Google Ads Advertisers task results by task ID. Use when you need to fetch advertiser information from Google Ads Transparency Center, including advertiser names, locations, verification status, and approximate ad counts.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"AdsMultiAccountAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_multi_account_advertiser"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Advertiser location"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"advertisers":{"anyOf":[{"type":"array","items":{"type":"object","title":"Advertiser","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Country code"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Google Ads verification status"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of ads running"}},"description":"Individual advertiser account within a multi-account advertiser group."}},{"type":"null"}],"title":"Advertisers","default":null,"description":"Associated advertiser accounts"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate ads count across all platforms"}},"description":"Multi-account advertiser item with associated advertiser accounts."},{"type":"object","title":"AdsAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_advertiser"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser account name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Account location"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Verification status"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of active ads"}},"description":"Individual advertiser account item."},{"type":"object","title":"AdsDomainItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_domain"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Domain name"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"}},"description":"Domain-level advertiser item."}],"properties":{}},"title":"Items","description":"Array of advertiser result items"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp (yyyy-mm-dd hh:mm:ss +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct search engine results link"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (adstransparency.google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Result types: ads_multi_account_advertiser, ads_advertiser, ads_domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of returned items"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Search refinement options","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total SERP results count"}},"description":"Individual task result containing Google Ads Advertisers data."},"title":"Result","description":"Array of result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range, refer to error documentation)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_LIVE_ADVANCED","name":"Get SERP Google Ads Advertisers Live Advanced","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be executed. Each task searches for advertisers running ads for the specified keyword. Maximum 100 tasks per request.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"GetSerpGoogleAdsAdvertisersLiveAdvancedRequestItem","required":["keyword"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","test_query"],"maxLength":255,"description":"User-defined identifier for task tracking. Maximum 255 characters. Useful for matching tasks to results in your system."},"keyword":{"type":"string","title":"Keyword","examples":["insurance","credit cards","web hosting"],"maxLength":700,"description":"Search term for ads advertisers search. Maximum 700 characters. Special characters like '%' must be encoded as '%25' and '+' as '%2B'."},"priority":{"enum":[1,2],"type":"integer","title":"PriorityLevel","description":"Task execution priority levels."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826],"description":"Search engine location code (e.g., 2840 for United States). Mutually exclusive with location_name or location_coordinate. If no location is specified, advertisers will be searched across all available locations."},"location_name":{"type":"string","title":"Location Name","examples":["London,England,United Kingdom","New York,New York,United States"],"description":"Full location name (e.g., 'London,England,United Kingdom'). Mutually exclusive with location_code or location_coordinate. If no location is specified, advertisers will be searched across all available locations."},"location_coordinate":{"type":"string","title":"Location Coordinate","examples":["52.6178549,-155.352142","40.7127837,-74.0059413"],"description":"GPS coordinates in 'latitude,longitude' format (e.g., '52.6178549,-155.352142'). Mutually exclusive with location_name or location_code. If no location is specified, advertisers will be searched across all available locations."}},"description":"Individual task item for Google Ads Advertisers Live Advanced request.","requiredFields":"$17:props:tools:131:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"AdsMultiAccountAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_multi_account_advertiser"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Advertiser location"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"advertisers":{"anyOf":[{"type":"array","items":{"type":"object","title":"Advertiser","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Country code"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Google Ads verification status"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of ads running"}},"description":"Individual advertiser account within a multi-account advertiser group."}},{"type":"null"}],"title":"Advertisers","default":null,"description":"Associated advertiser accounts"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate ads count across all platforms"}},"description":"Multi-account advertiser item with associated advertiser accounts."},{"type":"object","title":"AdsAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_advertiser"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser account name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Account location"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Verification status"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of active ads"}},"description":"Individual advertiser account item."},{"type":"object","title":"AdsDomainItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_domain"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Domain name"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"}},"description":"Domain-level advertiser item."}],"properties":{}},"title":"Items","description":"Array of advertiser result items"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp (yyyy-mm-dd hh:mm:ss +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct search engine results link"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (adstransparency.google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Result types: ads_multi_account_advertiser, ads_advertiser, ads_domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of returned items"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Search refinement options","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total SERP results count"}},"description":"Individual task result containing Google Ads Advertisers data."},"title":"Result","description":"Array of result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range, refer to error documentation)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_TASK_ADVANCED","name":"Get SERP Google Ads Advertisers Task Advanced","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword from the original request"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Task priority level"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original task parameters from the POST request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"AdsMultiAccountAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element classification (ads_multi_account_advertiser)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser name or company name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location of the advertiser"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within elements of the same type"},"advertisers":{"anyOf":[{"type":"array","items":{"type":"object","title":"AdvertiserInfo","properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Advertiser account location"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Google verification status of the advertiser"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier for Google Ads Search API queries"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of active ads from this advertiser"}},"description":"Information about an individual advertiser account."}},{"type":"null"}],"title":"Advertisers","default":null,"description":"List of associated advertiser accounts with details"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in overall SERP results"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate total quantity of ads across all accounts"}},"description":"Multi-account advertiser result item from ads transparency database."},{"type":"object","title":"AdsAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element classification (ads_advertiser)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser account name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Advertiser account location"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Google verification status of the advertiser"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within elements of the same type"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier for Google Ads Search API queries"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in overall SERP results"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of active ads from this advertiser"}},"description":"Single advertiser account result item from ads transparency database."},{"type":"object","title":"AdsDomainItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element classification (ads_domain)"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Domain name (e.g., 'apple.com')"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within elements of the same type"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in overall SERP results"}},"description":"Domain result item from ads transparency database."}],"properties":{}},"title":"Items","description":"Array of search result elements (advertisers and domains)"},"spell":{"type":"object","title":"Spell","properties":{"type":{"type":"string","title":"Type","description":"Type of spell correction"},"keyword":{"type":"string","title":"Keyword","description":"Suggested corrected keyword"}},"description":"Autocorrection data for search query.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when the result was retrieved"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify SERP results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain from the POST request"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result items present (ads_multi_account_advertiser, ads_advertiser, ads_domain)"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language specification used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier used for the request"},"refinement_chips":{"type":"object","title":"RefinementChips","properties":{"type":{"type":"string","title":"Type","description":"Type of refinement chip"},"title":{"type":"string","title":"Title","description":"Refinement chip title"},"options":{"type":"array","items":{"type":"object","title":"RefinementOption","properties":{"url":{"type":"string","title":"Url","description":"URL for this refinement option"},"type":{"type":"string","title":"Type","description":"Type of refinement option"},"title":{"type":"string","title":"Title","description":"Option title or label"}},"description":"Individual refinement option."},"title":"Options","description":"Available refinement options"}},"description":"Search refinement options displayed in SERP.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found in SERP"}},"description":"Result data containing Google Ads advertiser information from transparency database."},"title":"Result","description":"Array of result objects containing Google Ads advertiser data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success, 40000+ indicates task in queue or processing."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects containing Google Ads advertiser results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_SEARCH_LIVE_ADVANCED","name":"Get SERP Google Ads Search Live Advanced","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier (max 255 characters). This tag will be returned in the response for tracking purposes","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"depth":{"type":"integer","description":"Number of results to return (default: 40, max: 120). Billing applies per 40 results","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"format":{"type":"string","description":"Advertisement format types for filtering.","default":"$undefined","example":"$undefined","enum":["all","text","image","video"],"required":false},"target":{"type":"string","description":"Domain name associated with an advertiser account. Either target or advertiser_ids must be specified","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"date_to":{"type":"string","description":"Ending date of the time range in yyyy-mm-dd format. Required if date_from is specified","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"platform":{"type":"string","description":"Advertising platform types for filtering results.","default":"$undefined","example":"$undefined","enum":["all","google_play","google_maps","google_search","google_shopping","youtube"],"required":false},"priority":{"type":"string","description":"Task priority levels.","default":"$undefined","example":"$undefined","enum":["normal","high"],"required":false},"date_from":{"type":"string","description":"Starting date of the time range in yyyy-mm-dd format (minimum: 2018-05-31). Required if date_to is specified","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"Search engine location code. Use location_code, location_name, or location_coordinate (only one at a time)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Full name of search engine location (e.g., 'United States'). Use location_code, location_name, or location_coordinate (only one at a time)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"advertiser_ids":{"type":"array","description":"Array of advertiser identifiers (max 25). Either advertiser_ids or target must be specified","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"location_coordinate":{"type":"string","description":"GPS coordinates of a location. Format: 'latitude,longitude'. Use location_code, location_name, or location_coordinate (only one at a time)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type: ads_search"},"items":{"type":"array","items":{"type":"object","title":"AdsSearchItem","properties":{"url":{"type":"string","title":"Url","description":"URL pointing to the advertisement on the Ads Transparency platform"},"type":{"type":"string","title":"Type","description":"Element type: ads_search"},"title":{"type":"string","title":"Title","description":"Advertiser name"},"format":{"type":"string","title":"Format","description":"Ad format: text, image, or video"},"verified":{"type":"boolean","title":"Verified","description":"True if advertiser account is verified by Google Ads"},"last_shown":{"type":"string","title":"Last Shown","description":"Date and time when the ad was shown the last time (UTC: yyyy-mm-dd hh:mm:ss +00:00)"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of elements with identical type values"},"creative_id":{"type":"string","title":"Creative Id","description":"Unique identifier of the advertisement"},"first_shown":{"type":"string","title":"First Shown","description":"Date and time when the ad was shown for the first time (UTC: yyyy-mm-dd hh:mm:ss +00:00)"},"advertiser_id":{"type":"string","title":"Advertiser Id","description":"Unique identifier of the advertiser account"},"preview_image":{"type":"object","title":"PreviewImage","properties":{"url":{"type":"string","title":"Url","description":"Image URL"},"width":{"type":"integer","title":"Width","description":"Image width in pixels"},"height":{"type":"integer","title":"Height","description":"Image height in pixels"}},"description":"Preview image data for an advertisement.","additionalProperties":false},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position among all the elements in SERP"}},"description":"Individual advertisement search result item."},"title":"Items","description":"Array of advertisement items"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received (UTC: yyyy-mm-dd hh:mm:ss +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain: adstransparency.google.com"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of search results returned"},"items_count":{"type":"integer","title":"Items Count","description":"Number of returned items"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total SERP results count"}},"description":"Individual task result containing Google Ads Search data."},"title":"Result","description":"Array of result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range, refer to error documentation)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_AI_MODE_TASK_ADVANCED_BY_ID","name":"Get SERP Google AI Mode Task Advanced Results","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Keyword used for the task"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"type":"object","title":"SerpItem","properties":{"page":{"type":"integer","title":"Page","description":"Page number in search results"},"type":{"type":"string","title":"Type","description":"Item type (e.g., 'ai_overview')"},"items":{"type":"array","items":{"type":"object","title":"AiOverviewItem","properties":{"url":{"type":"string","title":"Url","description":"URL to the item source"},"date":{"type":"string","title":"Date","description":"Publication date for video items"},"text":{"type":"string","title":"Text","description":"Text content for text/video/expanded elements"},"type":{"type":"string","title":"Type","description":"Item type (e.g., 'ai_overview_element', 'ai_overview_video_element', 'ai_overview_table_element', 'ai_overview_expanded_element', 'ai_overview_shopping')"},"links":{"type":"array","items":{"type":"object","title":"LinkElement","properties":{"url":{"type":"string","title":"Url","description":"Link URL"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'link_element')"},"title":{"type":"string","title":"Title","description":"Link title or anchor text"},"domain":{"type":"string","title":"Domain","description":"Domain of the linked URL"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link element within AI overview content."},"title":"Links","description":"List of links within the item"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price"},"regular":{"type":"number","title":"Regular","description":"Regular price before discount"},"currency":{"type":"string","title":"Currency","description":"Currency code (e.g., 'USD', 'EUR')"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in price range"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Indicates if price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for shopping items.","additionalProperties":false},"table":{"type":"object","title":"TableInfo","properties":{"table_header":{"type":"array","items":{"type":"string","properties":{}},"title":"Table Header","description":"List of column headers"},"table_content":{"type":"array","items":{"type":"array","items":{"type":"string"},"properties":{}},"title":"Table Content","description":"2D array of table cell values"}},"description":"Table structure within AI overview content.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Item title"},"domain":{"type":"string","title":"Domain","description":"Domain of the item URL"},"images":{"type":"array","items":{"type":"object","title":"ImageElement","properties":{"alt":{"type":"string","title":"Alt","description":"Image alt text attribute"},"url":{"type":"string","title":"Url","description":"URL to the page containing the image"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'images_element')"},"image_url":{"type":"string","title":"Image Url","description":"Direct URL to the image file"}},"description":"Image element within AI overview content."},"title":"Images","description":"List of images within the item"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value for the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"}},"description":"Rating information for products or services.","additionalProperties":false},"seller":{"type":"string","title":"Seller","description":"Seller name for shopping items"},"source":{"type":"string","title":"Source","description":"Source name for video items"},"snippet":{"type":"string","title":"Snippet","description":"Video snippet or description"},"markdown":{"type":"string","title":"Markdown","description":"Content in markdown format for element/table/expanded types"},"position":{"type":"string","title":"Position","description":"Position in SERP (e.g., 'left', 'right')"},"image_url":{"type":"string","title":"Image Url","description":"Image URL for video or shopping items"},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp for video items"},"components":{"type":"array","items":{"type":"object","title":"AiOverviewExpandedComponent","properties":{"text":{"type":"string","title":"Text","description":"Component text content"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'ai_overview_expanded_component')"},"links":{"type":"array","items":{"type":"object","title":"LinkElement","properties":{"url":{"type":"string","title":"Url","description":"Link URL"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'link_element')"},"title":{"type":"string","title":"Title","description":"Link title or anchor text"},"domain":{"type":"string","title":"Domain","description":"Domain of the linked URL"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link element within AI overview content."},"title":"Links","description":"List of links in this component"},"title":{"type":"string","title":"Title","description":"Component title"},"images":{"type":"array","items":{"type":"object","title":"ImageElement","properties":{"alt":{"type":"string","title":"Alt","description":"Image alt text attribute"},"url":{"type":"string","title":"Url","description":"URL to the page containing the image"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'images_element')"},"image_url":{"type":"string","title":"Image Url","description":"Direct URL to the image file"}},"description":"Image element within AI overview content."},"title":"Images","description":"List of images in this component"},"markdown":{"type":"string","title":"Markdown","description":"Component content in markdown format"},"references":{"type":"array","items":{"type":"object","title":"AiOverviewReference","properties":{"url":{"type":"string","title":"Url","description":"URL of the source page"},"text":{"type":"string","title":"Text","description":"Excerpt or snippet from the source"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'ai_overview_reference')"},"title":{"type":"string","title":"Title","description":"Title of the source page"},"domain":{"type":"string","title":"Domain","description":"Domain of the source"},"source":{"type":"string","title":"Source","description":"Source name or publisher"}},"description":"Reference to source webpage used to generate AI overview."},"title":"References","description":"List of source references in this component"}},"description":"Component within expanded AI overview elements."},"title":"Components","description":"List of components for expanded elements"},"product_id":{"type":"string","title":"Product Id","description":"Product identifier for shopping items"},"references":{"type":"array","items":{"type":"object","title":"AiOverviewReference","properties":{"url":{"type":"string","title":"Url","description":"URL of the source page"},"text":{"type":"string","title":"Text","description":"Excerpt or snippet from the source"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'ai_overview_reference')"},"title":{"type":"string","title":"Title","description":"Title of the source page"},"domain":{"type":"string","title":"Domain","description":"Domain of the source"},"source":{"type":"string","title":"Source","description":"Source name or publisher"}},"description":"Reference to source webpage used to generate AI overview."},"title":"References","description":"List of source references for the item"},"marketplace":{"type":"string","title":"Marketplace","description":"Marketplace name for shopping items"},"marketplace_url":{"type":"string","title":"Marketplace Url","description":"Marketplace URL for shopping items"}},"description":"Individual item within AI overview results."},"title":"Items","description":"List of nested elements within the AI overview"},"xpath":{"type":"string","title":"Xpath","description":"XPath to the element in the page"},"markdown":{"type":"string","title":"Markdown","description":"Complete AI overview content in markdown format"},"position":{"type":"string","title":"Position","description":"Position in SERP (e.g., 'left', 'right')"},"rectangle":{"type":"object","title":"Rectangle","properties":{"x":{"type":"integer","title":"X","description":"X coordinate of the element"},"y":{"type":"integer","title":"Y","description":"Y coordinate of the element"},"width":{"type":"integer","title":"Width","description":"Width of the element in pixels"},"height":{"type":"integer","title":"Height","description":"Height of the element in pixels"}},"description":"Pixel coordinates of the element on the page.","additionalProperties":false},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within identical type group"},"references":{"type":"array","items":{"type":"object","title":"AiOverviewReference","properties":{"url":{"type":"string","title":"Url","description":"URL of the source page"},"text":{"type":"string","title":"Text","description":"Excerpt or snippet from the source"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'ai_overview_reference')"},"title":{"type":"string","title":"Title","description":"Title of the source page"},"domain":{"type":"string","title":"Domain","description":"Domain of the source"},"source":{"type":"string","title":"Source","description":"Source name or publisher"}},"description":"Reference to source webpage used to generate AI overview."},"title":"References","description":"List of webpage references used to generate the overview"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall position among all results"},"asynchronous_ai_overview":{"type":"boolean","title":"Asynchronous Ai Overview","description":"Indicates if AI overview is loaded asynchronously"}},"description":"Search engine result page item (AI overview)."},"title":"Items","description":"List of SERP items containing AI overview results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type"},"keyword":{"type":"string","title":"Keyword","description":"Original keyword"}},"description":"Spell check or autocorrection information.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword or query"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify results in SERP"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the task"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Array of result types returned (e.g., ['ai_overview'])"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location identifier used for the request"},"refinement_chips":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"Chip URL"},"type":{"type":"string","title":"Type","description":"Refinement chip type"},"title":{"type":"string","title":"Title","description":"Chip title"}},"description":"Refinement chip for search results.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results"}},"description":"Result data containing SERP results with AI overview."},"title":"Result","description":"List of task results containing SERP data with AI overview"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with results."},"title":"Tasks","description":"Array of task objects containing SERP results with AI overview"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_AUTOCOMPLETE_TASK_ADVANCED_BY_ID","name":"Get SERP Google Autocomplete Task (Advanced)","description":"Tool to retrieve Google Autocomplete task results by task ID. Use when you need to fetch autocomplete suggestions from a previously submitted Google Autocomplete task.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (autocomplete)"},"items":{"type":"array","items":{"type":"object","title":"AutocompleteItem","properties":{"url":{"type":"string","title":"Url","description":"URL for the suggested search query"},"type":{"type":"string","title":"Type","description":"Type of the autocomplete item"},"title":{"type":"string","title":"Title","description":"Autocomplete suggestion text"}},"description":"Individual autocomplete suggestion item."},"title":"Items","description":"Array of autocomplete suggestion items"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword or prefix used for autocomplete"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the autocomplete results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier used for the request"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of autocomplete suggestions returned"}},"description":"Result data containing Google Autocomplete suggestions."},"title":"Result","description":"Array of autocomplete result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Autocomplete results."},"title":"Tasks","description":"Array of task objects containing Google Autocomplete results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_DATASET_INFO_TASK_ADVANCED","name":"Get SERP Google Dataset Info Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"items":{"type":"array","items":{"type":"object","title":"DatasetItem","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (typically 'dataset')"},"links":{"type":"array","items":{"type":"object","title":"SitelinkItem","properties":{"url":{"type":"string","title":"Url","description":"Sitelink URL"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Sitelink title"},"domain":{"type":"string","title":"Domain","description":"Domain of the sitelink"},"description":{"type":"string","title":"Description","description":"Sitelink description/snippet"}},"description":"Individual sitelink within dataset results."},"title":"Links","description":"Related sitelinks for the dataset"},"title":{"type":"string","title":"Title","description":"Dataset title"},"xpath":{"type":"string","title":"Xpath","description":"XPath location in DOM"},"authors":{"type":"array","items":{"type":"object","title":"Author","properties":{"url":{"type":"string","title":"Url","description":"Author URL"},"name":{"type":"string","title":"Name","description":"Author name"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"domain":{"type":"string","title":"Domain","description":"Author domain"}},"description":"Dataset author information."},"title":"Authors","description":"Dataset authors or creators"},"formats":{"type":"array","items":{"type":"object","title":"Format","properties":{"size":{"type":"integer","title":"Size","description":"File size in bytes or as integer"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"format":{"type":"string","title":"Format","description":"Format type (e.g., CSV, JSON)"}},"description":"File format information."},"title":"Formats","description":"Available file formats (e.g., csv, html, zip, pdf)"},"licenses":{"type":"array","items":{"type":"object","title":"License","properties":{"url":{"type":"string","title":"Url","description":"License URL"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"License title"},"domain":{"type":"string","title":"Domain","description":"License domain"}},"description":"Dataset license information."},"title":"Licenses","description":"Dataset licenses (e.g., CC BY 4.0)"},"position":{"type":"string","title":"Position","description":"Display position alignment (e.g., 'left', 'right')"},"image_url":{"type":"string","title":"Image Url","description":"Dataset preview image URL"},"dataset_id":{"type":"string","title":"Dataset Id","description":"Unique dataset identifier used for searches"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type result group"},"area_covered":{"type":"array","items":{"type":"string","properties":{}},"title":"Area Covered","description":"Geographic areas covered by the dataset"},"updated_date":{"type":"string","title":"Updated Date","description":"Last update timestamp for the dataset"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute SERP position"},"period_covered":{"type":"object","title":"PeriodCovered","properties":{"end_date":{"type":"string","title":"End Date","description":"End date of dataset coverage"},"start_date":{"type":"string","title":"Start Date","description":"Start date of dataset coverage"},"displayed_date":{"type":"string","title":"Displayed Date","description":"Human-readable date range display"}},"description":"Time period covered by the dataset.","additionalProperties":false},"related_article":{"type":"string","title":"Related Article","description":"Related article reference"},"dataset_providers":{"type":"array","items":{"type":"object","title":"DatasetProvider","properties":{"url":{"type":"string","title":"Url","description":"Provider URL"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Provider name"},"domain":{"type":"string","title":"Domain","description":"Provider domain"}},"description":"Dataset provider with details."},"title":"Dataset Providers","description":"Organizations or institutions providing the dataset"},"unique_identifier":{"type":"string","title":"Unique Identifier","description":"Unique identifier for the dataset"},"dataset_description":{"type":"object","title":"DatasetDescription","properties":{"text":{"type":"string","title":"Text","description":"Description text"},"links":{"type":"array","items":{"type":"object","title":"DescriptionLink","properties":{"url":{"type":"string","title":"Url","description":"Link URL"},"type":{"type":"string","title":"Type","description":"Link type identifier"},"title":{"type":"string","title":"Title","description":"Link text"},"domain":{"type":"string","title":"Domain","description":"Link domain"},"description":{"type":"string","title":"Description","description":"Link description/snippet"}},"description":"Embedded link within dataset description."},"title":"Links","description":"Embedded links in the description"}},"description":"Dataset description with embedded links.","additionalProperties":false},"scholarly_articles_url":{"type":"string","title":"Scholarly Articles Url","description":"URL to scholarly articles citing this dataset"},"scholarly_citations_count":{"type":"integer","title":"Scholarly Citations Count","description":"Number of scholarly citations for this dataset"}},"description":"Individual dataset item from search results."},"title":"Items","description":"Array of dataset items with details"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of spell suggestion (e.g., 'did_you_mean')"},"keyword":{"type":"string","title":"Keyword","description":"Suggested keyword"}},"description":"Spell check information for the query.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword used in the query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to view the search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (e.g., google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Array of item types present in the results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of dataset items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found in the SERP"}},"description":"Search result data for Google Dataset Info task."},"title":"Result","description":"Array of search result objects containing dataset data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Dataset Info results."},"title":"Tasks","description":"Array of task objects containing Google Dataset Info results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_MARKETS_TASK_HTML_BY_ID","name":"Get SERP Google Finance Markets Task HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"SerpTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of SERP result (e.g., 'finance_markets')"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Finance Markets SERP page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or query specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the SERP HTML task containing the HTML content."},"title":"Result","description":"Array of SERP task results containing the Google Finance Markets HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Finance Markets SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_QUOTE_TASK_ADVANCED_BY_ID","name":"Get SERP Google Finance Quote Task (Advanced)","description":"Tool to retrieve Google Finance Quote task results by task ID. Use when you need real-time financial data from Google Finance Quote tab for a specific ticker symbol, including current price, market data, news, and financial metrics.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (finance_quote)"},"items":{"type":"array","items":{"type":"object","title":"GoogleFinanceItem","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"}},"description":"Base item type for Google Finance elements - can be any of the specific finance element types."},"title":"Items","description":"Array of Google Finance elements with various types (quote, news, financials, details, etc.)"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search term used in the query (ticker symbol)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to view the search results on Google Finance"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements found in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"array","items":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Refinement chip display text"},"domain":{"type":"string","title":"Domain","description":"Domain name for the refinement"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"Additional refinement options"}},"description":"Search refinement option for narrowing results."},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found"}},"description":"Search result data for Google Finance Quote task."},"title":"Result","description":"Array of search result objects containing Google Finance Quote data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Finance Quote results."},"title":"Tasks","description":"Array of task objects containing Google Finance Quote results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_QUOTE_TASK_HTML_BY_ID","name":"Get SERP Google Finance Quote HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format, obtained from task_post endpoint. Valid for 7 days after task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in DataForSEO credits"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or stock ticker used for the task"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Task data containing the original request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"FinanceQuoteHtmlResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Finance quote page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"Individual HTML result item containing raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Stock ticker or keyword specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the Google Finance Quote HTML task."},"title":"Result","description":"Array of HTML results containing Google Finance quote page content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Individual task information with HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Finance quote pages"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_IMAGES_TASK_GET_ADVANCED_BY_ID","name":"Get SERP Google Images Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (images)"},"items":{"type":"array","items":{"type":"object","title":"ImageItem","properties":{"url":{"type":"string","title":"Url","description":"URL to the source page containing the image"},"type":{"type":"string","title":"Type","description":"Type of the image item"},"title":{"type":"string","title":"Title","description":"Image title or alt text"},"xpath":{"type":"string","title":"Xpath","description":"XPath to the element on the page"},"subtitle":{"type":"string","title":"Subtitle","description":"Image subtitle or description"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"source_url":{"type":"string","title":"Source Url","description":"Direct URL to the image file"},"encoded_url":{"type":"string","title":"Encoded Url","description":"Encoded image URL"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"}},"description":"Individual image search result item."},"title":"Items","description":"Array of image search result items"},"spell":{"type":"object","title":"Spell","description":"Autocorrection details if the query was corrected","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword used for the images query"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the image search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier used for the request"},"refinement_chips":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of image results returned by the search engine"}},"description":"Result data containing Google Images search results."},"title":"Result","description":"Array of image search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Images search results."},"title":"Tasks","description":"Array of task objects containing Google Images search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_IMAGES_TASK_HTML_BY_ID","name":"Get SERP Google Images Task HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"SerpTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of SERP result (e.g., 'images')"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Images SERP page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or query specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the SERP HTML task containing the HTML content."},"title":"Result","description":"Array of SERP task results containing the Google Images HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Images SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_JOBS_TASK_ADVANCED","name":"Get SERP Google Jobs Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters (keyword, language_code, location_code, etc.)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Search result type identifier (e.g., 'jobs')"},"items":{"type":"array","items":{"type":"object","title":"JobItem","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (e.g., 'google_jobs_item')"},"title":{"type":"string","title":"Title","description":"Job position title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator to the element on the page"},"job_id":{"type":"string","title":"Job Id","description":"Unique Google Jobs identifier for the job listing"},"salary":{"type":"string","title":"Salary","description":"Compensation details if available (null if not specified)"},"location":{"type":"string","title":"Location","description":"Geographic location of the job posting"},"position":{"type":"string","title":"Position","description":"Alignment position on the page (e.g., 'left' or 'right')"},"time_ago":{"type":"string","title":"Time Ago","description":"Relative time since posting (e.g., '2 days ago')"},"rectangle":{"type":"object","title":"Rectangle","description":"Pixel coordinates of the element (null for jobs)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}},"timestamp":{"type":"string","title":"Timestamp","description":"Publication timestamp in UTC format"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"source_url":{"type":"string","title":"Source Url","description":"Direct URL to the original job posting"},"source_name":{"type":"string","title":"Source Name","description":"Name of the original source platform (e.g., LinkedIn, Indeed)"},"employer_url":{"type":"string","title":"Employer Url","description":"URL to the employer's website"},"contract_type":{"type":"string","title":"Contract Type","description":"Employment classification (e.g., Full-time, Part-time, Contract)"},"employer_name":{"type":"string","title":"Employer Name","description":"Name of the employer organization"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all SERP results"},"employer_image_url":{"type":"string","title":"Employer Image Url","description":"URL to the employer's logo image"}},"description":"Individual job listing result item."},"title":"Items","description":"Array of job listing result items with employer, location, and employment details"},"spell":{"type":"object","title":"Spell","description":"Autocorrection details if the search query was corrected (null if none)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword used for the jobs query (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the job search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results (e.g., ['google_jobs_item'])"},"items_count":{"type":"integer","title":"Items Count","description":"Number of job listing items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Available search refinement options","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of job results returned by the search engine"}},"description":"Result data containing Google Jobs search results."},"title":"Result","description":"Array of job search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Jobs search results."},"title":"Tasks","description":"Array of task objects containing Google Jobs search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_MAPS_TASK_GET_ADVANCED_BY_ID","name":"Get SERP Google Maps Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Search type (e.g., 'maps')"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"MapsSearchItem","properties":{"cid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cid","default":null,"description":"Google client ID for the business"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to business website"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (e.g., 'maps_search')"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","default":null,"description":"Business contact phone number"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Business name displayed in search results"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Associated website domain"},"rating":{"anyOf":[{"type":"object","title":"RatingInfo","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","default":null,"description":"Average rating score value"},"rating_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating Max","default":null,"description":"Maximum rating value for the scale"},"rating_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rating Type","default":null,"description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes Count","default":null,"description":"Total number of reviews or votes"}},"description":"Rating information for business results."},{"type":"null"}],"default":null,"description":"Aggregated business rating information"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null,"description":"Full business address as a single string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","default":null,"description":"Primary business category"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","default":null,"description":"Geographic latitude coordinate"},"place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Id","default":null,"description":"Unique Google Places identifier"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","default":null,"description":"Geographic longitude coordinate"},"is_claimed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Claimed","default":null,"description":"Indicates if business ownership is verified on Google"},"main_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Main Image","default":null,"description":"URL to the main business profile image"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within identical type group"},"work_hours":{"anyOf":[{"type":"object","title":"WorkHours","properties":{"timetable":{"anyOf":[{"type":"object","title":"WorkHoursTimetable","properties":{"friday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Friday","default":null,"description":"Operating hours for Friday"},"monday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Monday","default":null,"description":"Operating hours for Monday"},"sunday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Sunday","default":null,"description":"Operating hours for Sunday"},"tuesday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Tuesday","default":null,"description":"Operating hours for Tuesday"},"saturday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Saturday","default":null,"description":"Operating hours for Saturday"},"thursday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Thursday","default":null,"description":"Operating hours for Thursday"},"wednesday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Wednesday","default":null,"description":"Operating hours for Wednesday"}},"description":"Weekly timetable for business operating hours."},{"type":"null"}],"default":null,"description":"Weekly schedule with open/close times"},"current_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Status","default":null,"description":"Current operational status (e.g., 'open', 'close')"}},"description":"Business operating hours with timetable and current status."},{"type":"null"}],"default":null,"description":"Business operating hours and current status"},"price_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Level","default":null,"description":"Price range indicator (e.g., 'inexpensive' to 'very_expensive')"},"address_info":{"anyOf":[{"type":"object","title":"AddressInfo","properties":{"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip","default":null,"description":"Postal code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","default":null,"description":"City name"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region","default":null,"description":"State or province"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null,"description":"Street address"},"borough":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Borough","default":null,"description":"Borough or district name"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","default":null,"description":"ISO country code"}},"description":"Detailed address information for a business location."},{"type":"null"}],"default":null,"description":"Structured address information with granular components"},"hotel_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hotel Rating","default":null,"description":"Hotel star rating from 1 to 5 (only for hotels)"},"total_photos":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Photos","default":null,"description":"Total number of photos available for the business"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall position in SERP results"},"original_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Title","default":null,"description":"Original business name (untranslated)"},"rating_distribution":{"anyOf":[{"type":"object","title":"RatingDistribution","properties":{"1":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"1","default":null,"description":"Count of 1-star ratings"},"2":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"2","default":null,"description":"Count of 2-star ratings"},"3":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"3","default":null,"description":"Count of 3-star ratings"},"4":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"4","default":null,"description":"Count of 4-star ratings"},"5":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"5","default":null,"description":"Count of 5-star ratings"}},"description":"Breakdown of star ratings for a business."},{"type":"null"}],"default":null,"description":"Distribution of star ratings"},"additional_categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Additional Categories","default":null,"description":"Additional business classifications"}},"description":"Google Maps search result item for a business location."},{"type":"object","title":"MapsPaidItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to business website"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (e.g., 'maps_paid_item')"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","default":null,"description":"Business contact phone number"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Business name displayed in sponsored listing"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Associated website domain"},"rating":{"anyOf":[{"type":"object","title":"RatingInfo","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","default":null,"description":"Average rating score value"},"rating_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating Max","default":null,"description":"Maximum rating value for the scale"},"rating_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rating Type","default":null,"description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes Count","default":null,"description":"Total number of reviews or votes"}},"description":"Rating information for business results."},{"type":"null"}],"default":null,"description":"Business rating information"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","default":null,"description":"Geographic latitude coordinate"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","default":null,"description":"Geographic longitude coordinate"},"main_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Main Image","default":null,"description":"URL to the main business profile image"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within identical type group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall position in SERP results"}},"description":"Sponsored Google Maps listing item."}],"properties":{}},"title":"Items","description":"Array of Google Maps search result items including both organic and sponsored listings"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Correction type (e.g., did_you_mean, showing_results_for)"},"keyword":{"type":"string","title":"Keyword","description":"Autocorrected search term"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Result retrieval timestamp in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify results in SERP"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of search results present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code identifier"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Search refinement options available","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results available from search engine"}},"description":"Result data containing Google Maps search results."},"title":"Result","description":"Array of Google Maps search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task information with Google Maps search results."},"title":"Tasks","description":"Array of task objects containing Google Maps search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_NEWS_TASK_GET_ADVANCED","name":"Get SERP Google News Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters (keyword, language_code, location_code, etc.)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Search result type identifier (e.g., 'news')"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"NewsSearchItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Direct URL to the news article"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type identifier (e.g., 'news_search')"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"News article headline or title"},"xpath":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xpath","default":null,"description":"XPath locator to the element on the page"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Source domain of the news article"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null,"description":"Preview text or excerpt from the article"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"URL to the associated image for the news article"},"rectangle":{"anyOf":[{"type":"object","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"}]}},{"type":"null"}],"title":"Rectangle","default":null,"description":"Pixel coordinates of the element on SERP (x, y, width, height)"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Publication date and time of the article"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within results of the same type"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in all SERP results"}},"description":"Individual news search result item."},{"type":"object","title":"TopStoriesItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type identifier (e.g., 'top_stories')"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"TopStoriesElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Direct link to the article"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","default":null,"description":"Relative publication time (e.g., '2 hours ago')"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Article headline"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"News site domain"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":null,"description":"News outlet or source name"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"Article image URL"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"ISO format publication datetime"},"amp_version":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Amp Version","default":null,"description":"Whether AMP version is available"}},"description":"Individual story within top stories section."}},{"type":"null"}],"title":"Items","default":null,"description":"Array of nested story elements within top stories section"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Section heading for top stories"},"xpath":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xpath","default":null,"description":"XPath locator to the element on the page"},"position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position","default":null,"description":"Alignment position on the page (e.g., 'left')"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within results of the same type"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in all SERP results"}},"description":"Top stories carousel/section result item."}],"properties":{}},"title":"Items","description":"Array of news search result items including news articles and top stories sections"},"spell":{"type":"object","title":"Spell","description":"Autocorrection details if the search query was corrected (null if none)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword used for the news query (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the news search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results (e.g., ['news_search', 'top_stories'])"},"items_count":{"type":"integer","title":"Items Count","description":"Number of news items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"},"refinement_chips":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of news results returned by the search engine"}},"description":"Result data containing Google News search results."},"title":"Result","description":"Array of news search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google News search results."},"title":"Tasks","description":"Array of task objects containing Google News search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Google Organic Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"faq":{"type":"array","items":{"type":"object","title":"FaqItem","properties":{"type":{"type":"string","title":"Type","description":"FAQ element type"},"title":{"type":"string","title":"Title","description":"Question text"},"description":{"type":"string","title":"Description","description":"Answer text"}},"description":"FAQ item in search results."},"title":"Faq","description":"FAQ section items"},"url":{"type":"string","title":"Url","description":"Result URL"},"page":{"type":"integer","title":"Page","description":"SERP page number"},"type":{"type":"string","title":"Type","description":"Element type (e.g., organic, paid, video)"},"links":{"type":"array","items":{"type":"object","title":"LinkInfo","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link information for search result items."},"title":"Links","description":"Additional links within the result"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price value"},"regular":{"type":"number","title":"Regular","description":"Regular price without discounts"},"currency":{"type":"string","title":"Currency","description":"ISO currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in a range"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether price represents a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for products in search results.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Result title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"images":{"type":"array","items":{"type":"object","title":"ImageInfo","properties":{"alt":{"type":"string","title":"Alt","description":"Alt text for the image"},"url":{"type":"string","title":"Url","description":"Image source URL"},"type":{"type":"string","title":"Type","description":"Image element type"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Image information in search results."},"title":"Images","description":"Images within the result"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum value for this rating scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for search result items.","additionalProperties":false},"is_image":{"type":"boolean","title":"Is Image","description":"Whether result contains an image"},"is_video":{"type":"boolean","title":"Is Video","description":"Whether result contains a video"},"position":{"type":"string","title":"Position","description":"Element position on the page (left/right)"},"cache_url":{"type":"string","title":"Cache Url","description":"Cached page URL"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate"},"y":{"type":"number","title":"Y","description":"Y coordinate"},"width":{"type":"number","title":"Width","description":"Rectangle width"},"height":{"type":"number","title":"Height","description":"Rectangle height"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the result publication"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"amp_version":{"type":"boolean","title":"Amp Version","description":"Whether result has an AMP version"},"description":{"type":"string","title":"Description","description":"Result description snippet"},"highlighted":{"type":"array","items":{"type":"string","properties":{}},"title":"Highlighted","description":"Highlighted keywords in the result"},"pre_snippet":{"type":"string","title":"Pre Snippet","description":"Information displayed before description"},"is_malicious":{"type":"boolean","title":"Is Malicious","description":"Whether result is marked as malicious"},"is_web_story":{"type":"boolean","title":"Is Web Story","description":"Whether result is a web story"},"website_name":{"type":"string","title":"Website Name","description":"Website name"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"},"extended_snippet":{"type":"string","title":"Extended Snippet","description":"Information displayed after description"},"about_this_result":{"type":"object","title":"AboutThisResultInfo","properties":{"url":{"type":"string","title":"Url","description":"Source information URL"},"type":{"type":"string","title":"Type","description":"Element type"},"source":{"type":"string","title":"Source","description":"Source name"},"language":{"type":"string","title":"Language","description":"Content language"},"location":{"type":"string","title":"Location","description":"Geographic location"},"source_url":{"type":"string","title":"Source Url","description":"Source URL"},"source_info":{"type":"string","title":"Source Info","description":"Additional source details"},"search_terms":{"type":"array","items":{"type":"string","properties":{}},"title":"Search Terms","description":"Search terms used"},"related_terms":{"type":"array","items":{"type":"string","properties":{}},"title":"Related Terms","description":"Related terms"}},"description":"About this result context information.","additionalProperties":false},"related_search_url":{"type":"string","title":"Related Search Url","description":"URL for related searches"},"is_featured_snippet":{"type":"boolean","title":"Is Featured Snippet","description":"Whether result is a featured snippet"}},"description":"Organic search result item from Google SERP."},"title":"Items","description":"Array of search result items including organic results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query used (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Google domain used for search"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of SERP pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code used"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"object","title":"RefinementChips","properties":{"type":{"type":"string","title":"Type","description":"Refinement chips type"},"items":{"type":"array","items":{"type":"object","title":"RefinementChipElement","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Type of refinement chip element"},"title":{"type":"string","title":"Title","description":"Refinement chip title text"},"domain":{"type":"string","title":"Domain","description":"Domain of the refinement chip"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"List of refinement options"}},"description":"Individual refinement chip for search refinement."},"title":"Items","description":"Array of refinement chip elements"}},"description":"Search refinement chip options.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results found"}},"description":"Individual task result containing Google Organic SERP data."},"title":"Result","description":"Array of Google SERP result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to API docs for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_GET_HTML_BY_ID","name":"Get SERP Google Organic Task HTML By ID","description":"Tool 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 Organic search results page after creating an organic task. Task results are available within 7 days of creation.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"SerpTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of SERP result (e.g., 'organic')"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Organic SERP page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or query specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the SERP HTML task containing the HTML content."},"title":"Result","description":"Array of SERP task results containing the Google Organic HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Organic SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_HTML_BY_ID","name":"Get SERP Google Organic Task HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"HtmlTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"HtmlTaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google search results page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword specified in the original request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the HTML task containing the HTML content."},"title":"Result","description":"Array of HTML task results containing the Google SERP HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Organic SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Google Organic Task Regular By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"os":{"type":"string","title":"Os","description":"Operating system used for the search"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"tag":{"type":"string","title":"Tag","description":"Custom tag for task identification"},"device":{"type":"string","title":"Device","description":"Device type used for the search (e.g., 'desktop', 'mobile')"},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"priority":{"type":"integer","title":"Priority","description":"Priority level of the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"url":{"type":"string","title":"Url","description":"Full URL of the search result"},"page":{"type":"integer","title":"Page","description":"Page number where this result appears"},"type":{"type":"string","title":"Type","description":"Type of the SERP item (e.g., 'organic', 'paid', 'featured_snippet')"},"title":{"type":"string","title":"Title","description":"Title of the search result"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path shown in the result"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of elements with identical type values"},"description":{"type":"string","title":"Description","description":"Description or snippet from the search result"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute rank in the SERP (across all types)"}},"description":"Organic search result item from Google SERP."},"title":"Items","description":"Array of SERP result items including organic results, paid results, and featured snippets"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of spell correction applied (e.g., 'did_you_mean', 'showing_results_for', 'no_results_found_for', 'including_results_for')"},"keyword":{"type":"string","title":"Keyword","description":"Corrected keyword suggestion from the search engine"}},"description":"Autocorrection information for the search query.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of SERP items found (e.g., 'organic', 'paid', 'featured_snippet')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the items array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code parameter used in the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code parameter used in the request"},"refinement_chips":{"type":"object","title":"RefinementChips","properties":{"type":{"type":"string","title":"Type","description":"Type of refinement chips element"},"items":{"type":"array","items":{"type":"object","title":"RefinementChipsItem","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Type of refinement chip"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"},"domain":{"type":"string","title":"Domain","description":"Domain of the refinement URL"},"options":{"type":"array","items":{"type":"object","title":"RefinementChipOption","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Type of refinement chip option"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"},"domain":{"type":"string","title":"Domain","description":"Domain of the refinement URL"}},"description":"Individual refinement chip option."},"title":"Options","description":"Array of refinement chip options"}},"description":"Individual refinement chip suggestion."},"title":"Items","description":"Array of refinement chip items"},"xpath":{"type":"string","title":"Xpath","description":"XPath location of the element on the page"}},"description":"Search refinement chip suggestions.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results reported by the search engine"}},"description":"Complete SERP result data for a Google Organic search task."},"title":"Result","description":"Array of SERP results containing organic and paid search results, featured snippets, and other SERP features"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with SERP results."},"title":"Tasks","description":"Array of task objects containing SERP results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_SEARCH_BY_IMAGE_HTML","name":"Get SERP Google Search By Image HTML","description":"Tool to retrieve raw HTML results for a Google Search By Image SERP task by ID. Use when you need to get the unprocessed HTML content of a Google reverse image search results page after creating a search by image task. Task results are available within 7 days of creation.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"SerpTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of SERP result (e.g., 'search_by_image')"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Search By Image SERP page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or query specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the SERP HTML task containing the HTML content."},"title":"Result","description":"Array of SERP task results containing the Google Search By Image HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Search By Image SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_SEARCH_BY_IMAGE_HTML_BY_ID","name":"Get SERP Google Search By Image HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"HtmlTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":true},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"HtmlSearchByImageResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type (search_by_image)"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Full HTML document content of the search results page from Google Search By Image"},"page":{"type":"integer","title":"Page","description":"Serial page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Decoded keyword from the original request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request (e.g., google.com)"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request (e.g., en)"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the HTML task containing search by image results and HTML content."},"title":"Result","description":"Array of HTML search by image results containing the HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Search By Image queries"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Naver Organic Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"cid":{"type":"string","title":"Cid","description":"Client ID for local results"},"faq":{"type":"array","items":{"type":"object","title":"FaqItem","properties":{"type":{"type":"string","title":"Type","description":"FAQ element type"},"title":{"type":"string","title":"Title","description":"Question text"},"description":{"type":"string","title":"Description","description":"Answer text"}},"description":"FAQ item in search results."},"title":"Faq","description":"FAQ section items"},"url":{"type":"string","title":"Url","description":"Result URL"},"page":{"type":"integer","title":"Page","description":"SERP page number"},"type":{"type":"string","title":"Type","description":"Element type (e.g., organic, paid, video, map, local_pack, related_searches, images)"},"extra":{"type":"object","title":"Extra","description":"Additional metadata (e.g., ad_aclk for paid results)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"VideoElementInfo","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Video URL"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Video element type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Video title"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":null,"description":"Video source platform"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Video duration or timestamp"}},"description":"Video element information in search results."},{"type":"object","title":"ImageInfo","properties":{"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt","default":null,"description":"Alt text for the image"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Image source URL"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Image element type"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"Direct image URL"}},"description":"Image information in search results."},{"type":"object","title":"RelatedSearchItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL for the related search"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Related search element type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Related search query text"}},"description":"Related search suggestion item."}],"properties":{}},"title":"Items","description":"Nested items for video, image, or related search types"},"links":{"type":"array","items":{"type":"object","title":"LinkInfo","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"ad_aclk":{"type":"string","title":"Ad Aclk","description":"Ad click identifier"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link information for search result items."},"title":"Links","description":"Additional links within the result"},"phone":{"type":"string","title":"Phone","description":"Phone number for local results"},"title":{"type":"string","title":"Title","description":"Result title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"images":{"type":"array","items":{"type":"object","title":"ImageInfo","properties":{"alt":{"type":"string","title":"Alt","description":"Alt text for the image"},"url":{"type":"string","title":"Url","description":"Image source URL"},"type":{"type":"string","title":"Type","description":"Image element type"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Image information in search results."},"title":"Images","description":"Images within the result"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum value for this rating scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for search result items.","additionalProperties":false},"is_paid":{"type":"boolean","title":"Is Paid","description":"Whether result is a paid ad"},"is_image":{"type":"boolean","title":"Is Image","description":"Whether result contains images"},"is_video":{"type":"boolean","title":"Is Video","description":"Whether result is a video"},"position":{"type":"string","title":"Position","description":"Element position on the page (left/right)"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate"},"y":{"type":"number","title":"Y","description":"Y coordinate"},"width":{"type":"number","title":"Width","description":"Rectangle width"},"height":{"type":"number","title":"Height","description":"Rectangle height"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the result publication"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"description":{"type":"string","title":"Description","description":"Result description snippet"},"is_malicious":{"type":"boolean","title":"Is Malicious","description":"Whether result is marked as malicious"},"is_web_story":{"type":"boolean","title":"Is Web Story","description":"Whether result is a web story"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"},"description_rows":{"type":"array","items":{"type":"string","properties":{}},"title":"Description Rows","description":"Description text split into rows"},"is_featured_snippet":{"type":"boolean","title":"Is Featured Snippet","description":"Whether result is a featured snippet"}},"description":"Organic search result item from Naver SERP."},"title":"Items","description":"Array of search result items including organic results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query used (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Naver domain used for search"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of SERP pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code used"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results found"}},"description":"Individual task result containing Naver Organic SERP data."},"title":"Result","description":"Array of Naver SERP result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to API docs for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_GET_ADVANCED","name":"Get SERP Naver Organic Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"faq":{"type":"array","items":{"type":"object","title":"FaqItem","properties":{"type":{"type":"string","title":"Type","description":"FAQ element type"},"title":{"type":"string","title":"Title","description":"Question text"},"description":{"type":"string","title":"Description","description":"Answer text"}},"description":"FAQ item in search results."},"title":"Faq","description":"FAQ section items"},"url":{"type":"string","title":"Url","description":"Result URL"},"page":{"type":"integer","title":"Page","description":"SERP page number"},"type":{"type":"string","title":"Type","description":"Element type (e.g., organic, paid, video)"},"links":{"type":"array","items":{"type":"object","title":"LinkInfo","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link information for search result items."},"title":"Links","description":"Additional links within the result"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price value"},"regular":{"type":"number","title":"Regular","description":"Regular price without discounts"},"currency":{"type":"string","title":"Currency","description":"ISO currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in a range"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether price represents a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for products in search results.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Result title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"images":{"type":"array","items":{"type":"object","title":"ImageInfo","properties":{"alt":{"type":"string","title":"Alt","description":"Alt text for the image"},"url":{"type":"string","title":"Url","description":"Image source URL"},"type":{"type":"string","title":"Type","description":"Image element type"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Image information in search results."},"title":"Images","description":"Images within the result"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum value for this rating scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for search result items.","additionalProperties":false},"position":{"type":"string","title":"Position","description":"Element position on the page (left/right)"},"cache_url":{"type":"string","title":"Cache Url","description":"Cached page URL"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate"},"y":{"type":"number","title":"Y","description":"Y coordinate"},"width":{"type":"number","title":"Width","description":"Rectangle width"},"height":{"type":"number","title":"Height","description":"Rectangle height"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the result publication"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"description":{"type":"string","title":"Description","description":"Result description snippet"},"highlighted":{"type":"array","items":{"type":"string","properties":{}},"title":"Highlighted","description":"Highlighted keywords in the result"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"}},"description":"Organic search result item from Naver SERP."},"title":"Items","description":"Array of search result items including organic results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query used (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Naver domain used for search"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of SERP pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code used"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results found"}},"description":"Individual task result containing Naver Organic SERP data."},"title":"Result","description":"Array of Naver SERP result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to API docs for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Naver Organic Task Regular By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{</article></body></html>

17:["$","$L21",null,{"toolkit":{"slug":"dataforseo","name":"Dataforseo","logo":"https://logos.composio.dev/api/dataforseo","description":"SEO data and analytics platform providing SERP data, backlinks, keywords, and competitive intelligence","category":"developer tools","authSchemes":["BASIC"],"toolCount":340,"triggerCount":0,"version":"00000000_00","tools":[{"slug":"DATAFORSEO_CREATE_APP_DATA_APPLE_APP_REVIEWS_TASK","name":"Create App Data Apple App Reviews Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_APP_DATA_APPLE_APP_SEARCHES_TASK","name":"Create Apple App Searches Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_APP_DATA_GOOGLE_APP_LIST_TASK","name":"Create App Data Google App List Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_APP_DATA_GOOGLE_APP_REVIEWS_TASK","name":"Create App Data Google App Reviews Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_BUSINESS_DATA_TRUSTPILOT_SEARCH_TASK","name":"Create Business Data Trustpilot Search Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_KEYWORDS_DATA_GOOGLE_TRENDS_EXPLORE_TASK","name":"Create Keywords Data Google Trends Explore Task","description":"Tool to create Google Trends Explore tasks for analyzing keyword popularity over time. Use when you need to get trend data from Google Search, YouTube, Google News, Google Images, or Google Shopping. Returns task IDs for retrieving results later using the task_get endpoint."},{"slug":"DATAFORSEO_CREATE_KW_BING_AUDIENCE_EST_TASK","name":"Create Keywords Data Bing Audience Estimation Task","description":"Tool to create a Bing Audience Estimation task for ad campaign planning. Use when you need to estimate audience size, clicks, impressions, and budget recommendations based on targeting criteria like age, gender, location, industry, and job function."},{"slug":"DATAFORSEO_CREATE_KW_GOOGLE_KW_FOR_KW_TASK","name":"Create Keywords Data Google Keywords For Keywords Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_MERCHANT_AMAZON_SELLERS_TASK","name":"Create Merchant Amazon Sellers Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_ON_PAGE_LIGHTHOUSE_TASK_POST","name":"Create On Page Lighthouse Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_ON_PAGE_TASK_POST","name":"Create On Page Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_AUTOCOMPLETE_TASK","name":"Create SERP Google Autocomplete Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_EVENTS_TASK","name":"Create SERP Google Events Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_FINANCE_EXPLORE_TASK","name":"Create SERP Google Finance Explore Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_LOCAL_FINDER_TASK","name":"Create SERP Google Local Finder Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_MAPS_TASK","name":"Create SERP Google Maps Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_ORGANIC_TASK_POST","name":"Create SERP Google Organic Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_SEZNAM_ORGANIC_TASK","name":"Create SERP Seznam Organic Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_YOUTUBE_VIDEO_COMMENTS_TASK","name":"Create YouTube Video Comments Task","description":"Tool 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."},{"slug":"DATAFORSEO_CREATE_SERP_YOUTUBE_VIDEO_SUBTITLES_TASK","name":"Create SERP YouTube Video Subtitles Task","description":"Tool 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."},{"slug":"DATAFORSEO_FORCE_ON_PAGE_CRAWL","name":"Force Stop On Page Crawl","description":"Tool 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."},{"slug":"DATAFORSEO_GET_AI_KEYWORD_DATA_AVAILABLE_FILTERS","name":"Get AI Keyword Data Available Filters","description":"Tool 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)."},{"slug":"DATAFORSEO_GET_AI_KEYWORD_DATA_LOCATIONS_AND_LANGUAGES","name":"Get AI Keyword Data Locations And Languages","description":"Tool 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."},{"slug":"DATAFORSEO_GET_AI_OPT_CHAT_GPT_LLM_SCRAPER_HTML_BY_ID","name":"Get AI Optimization Chat GPT LLM Scraper HTML by ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_AI_OPT_CHAT_GPT_LLM_SCRAPER_TASK_ADV_BY_ID","name":"Get AI Optimization ChatGPT LLM Scraper Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_AI_OPT_CHAT_GPT_LLM_SCRAPER_TASK_HTML","name":"Get AI Optimization LLM Scraper Task HTML","description":"Tool to retrieve HTML results from a DataForSEO AI Optimization LLM scraper task. Use when you need to fetch the HTML content from a previously created scraper task using its task ID."},{"slug":"DATAFORSEO_GET_AI_OPT_GEMINI_LLM_SCRAPER_TASK_ADV","name":"Get AI Optimization Gemini LLM Scraper Task Advanced","description":"Tool 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."},{"slug":"DATAFORSEO_GET_AI_OPTIMIZATION_CHAT_GPT_LLM_RESPONSES_LIVE","name":"Get Live ChatGPT LLM Responses","description":"Tool 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."},{"slug":"DATAFORSEO_GET_AI_OPTIMIZATION_GEMINI_LLM_SCRAPER_HTML_BY_ID","name":"Get Gemini LLM Scraper HTML Results","description":"Retrieve 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."},{"slug":"DATAFORSEO_GET_AI_OPTIMIZATION_HTML_RESULT","name":"Get AI Optimization HTML Result","description":"Tool to retrieve AI optimization LLM scraper HTML results by task ID. Use when you need to fetch the HTML content scraped for ChatGPT/LLM optimization after creating a scraping task. The task ID must be obtained from the initial task creation POST request and used within 7 days."},{"slug":"DATAFORSEO_GET_AI_OPTIMIZATION_LLM_MENTIONS_TOP_DOMAINS_LIVE","name":"Get AI Optimization LLM Mentions Top Domains Live","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APP_DATA_APPLE_APP_LIST_TASK_ADVANCED","name":"Get Apple App List Task Results","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APP_DATA_APPLE_APP_SEARCHES_TASK_ADVANCED","name":"Get Apple App Searches Task Advanced","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_INFO_HTML_BY_ID","name":"Get App Data Google App Info HTML By ID","description":"Tool to retrieve raw HTML results for a Google Play app information task by ID. Use when you need to get the unprocessed HTML content of a Google Play Store app page after creating an app info task."},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_INFO_TASK_HTML_BY_ID","name":"Get App Data Google App Info Task HTML By ID","description":"Tool to retrieve HTML content for a Google Play app by task ID. Use when you need to get the raw HTML page data from Google Play Store for a previously submitted app info task. Results are available for 7 days after task posting."},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_LIST_TASK_ADVANCED_BY_ID","name":"Get App Data Google App List Task Advanced By ID","description":"Tool 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)."},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_REVIEWS_TASK_HTML","name":"Get App Data Google App Reviews Task HTML","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_SEARCHES_TASK_ADVANCED","name":"Get Google App Searches Task Advanced","description":"Tool to retrieve Google Play Store app search 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."},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_SEARCHES_TASK_HTML_BY_ID","name":"Get App Data Google App Searches HTML By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APPENDIX_ERRORS","name":"Get Appendix Errors","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APPENDIX_STATUS","name":"Get Appendix Status","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APPENDIX_USER_DATA","name":"Get Appendix User Data","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APP_GOOGLE_APP_REVIEWS_TASK_GET_ADV_BY_ID","name":"Get App Data Google App Reviews Task Advanced By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_APP_GOOGLE_APP_SEARCHES_TASK_ADV_BY_ID","name":"Get App Data Google App Searches Task Advanced By ID","description":"Tool to retrieve Google Play app search results for a previously created task. Returns detailed app data including titles, ratings, prices, reviews, and icons for apps ranking on Google Play for the specified keyword. This is the second step in a two-step process: first create a task, then retrieve results using this action with the task ID."},{"slug":"DATAFORSEO_GET_APPLE_APP_INFO_ADVANCED_BY_ID","name":"Get Apple App Info Advanced by ID","description":"Get detailed Apple App Store information for a previously submitted task. Returns comprehensive app data including title, description, ratings, reviews, price, categories, developer info, screenshots, and similar apps."},{"slug":"DATAFORSEO_GET_APPLE_APP_INFO_TASK_ADVANCED","name":"Get Apple App Info Task Advanced","description":"Tool to retrieve advanced results for a previously created Apple App Info task. Use when you need complete app information from the App Store including ratings, reviews, pricing, categories, similar apps, and developer details. Requires a task ID from task_post or tasks_ready endpoint."},{"slug":"DATAFORSEO_GET_BACKLINKS_BULK_PAGES_SUMMARY_LIVE","name":"Get Backlinks Bulk Pages Summary Live","description":"Tool to get comprehensive backlinks summary data for multiple pages, domains, or subdomains in a single request. Use when you need to retrieve detailed backlink metrics for up to 1000 targets simultaneously, including rank, backlink counts, referring domains/pages/IPs, spam scores, and breakdowns by TLD, link type, platform, semantic location, and country."},{"slug":"DATAFORSEO_GET_BACKLINKS_BULK_SPAM_SCORE_LIVE","name":"Get Backlinks Bulk Spam Score Live","description":"Tool to get spam scores for multiple domains, subdomains, or pages in a single request. Use when you need to evaluate how 'spammy' target websites are using DataForSEO's proprietary metric (0-100 scale)."},{"slug":"DATAFORSEO_GET_BACKLINKS_SUMMARY_LIVE","name":"Get Backlinks Summary Live","description":"Tool to get a comprehensive overview of backlinks data for a domain, subdomain, or webpage. Use when you need backlinks statistics including referring domains, link types, spam scores, and geographical distribution. Returns metrics like total backlinks count, referring domains/pages, link attributes breakdown, and platform type analysis."},{"slug":"DATAFORSEO_GET_BING_KW_PERFORMANCE_LOCATIONS_AND_LANGUAGES","name":"Get Bing Keyword Performance Locations And Languages","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BIZ_BUSINESS_LISTINGS_AVAILABLE_FILTERS","name":"Get Business Data Business Listings Available Filters","description":"Tool 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)."},{"slug":"DATAFORSEO_GET_BIZ_GOOGLE_HOTEL_INFO_TASK_GET_ADV_BY_ID","name":"Get Business Data Google Hotel Info Task Advanced By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BIZ_GOOGLE_HOTEL_SEARCHES_TASK_BY_ID","name":"Get Business Data Google Hotel Searches Task By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BIZ_GOOGLE_MY_BUSINESS_UPDATES_TASK_BY_ID","name":"Get Business Data Google My Business Updates Task By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BIZ_GOOGLE_QUESTIONS_AND_ANSWERS_TASK","name":"Get Business Data Google Questions And Answers Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_EXTENDED_REVIEWS_TASK","name":"Get Business Data Google Extended Reviews Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_MY_BUSINESS_INFO_TASK","name":"Get Business Data Google My Business Info Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_REVIEWS_TASK","name":"Get Business Data Google Reviews Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_REVIEWS_TASK_BY_ID","name":"Get Business Data Google Reviews Task By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_TRIPADVISOR_REVIEWS_TASK_BY_ID","name":"Get Business Data TripAdvisor Reviews Task By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_TRIPADVISOR_SEARCH_TASK","name":"Get Business Data TripAdvisor Search Task","description":"Tool to retrieve TripAdvisor search results by task ID. Use when you need to fetch business listings, ratings, and reviews data from TripAdvisor for a previously created search task. The task ID must be from a task created within the last 30 days."},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_TRIPADVISOR_SEARCH_TASK_BY_ID","name":"Get Business Data TripAdvisor Search Task By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_TRUSTPILOT_SEARCH_TASK_BY_ID","name":"Get Business Data Trustpilot Search Task By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_CHAT_GPT_LLM_SCRAPER_LOCATIONS_BY_COUNTRY","name":"Get ChatGPT LLM Scraper Locations By Country","description":"Tool 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."},{"slug":"DATAFORSEO_GET_CONTENT_ANALYSIS_AVAILABLE_FILTERS","name":"Get Content Analysis Available Filters","description":"Tool to retrieve available filters for DataForSEO Content Analysis API endpoints. Use when you need to discover which fields can be filtered in content analysis queries including URL attributes, content metadata, sentiment analysis, quality metrics, and categorization fields."},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_AVAILABLE_FILTERS","name":"Get DataForSEO Labs Available Filters","description":"Tool 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."},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_BING_RELATED_KEYWORDS_LIVE","name":"Get Bing Related Keywords Live","description":"Tool to retrieve Bing related keywords appearing in 'searches related to' SERP element. Provides up to 4680 keyword ideas with search volume, cost-per-click, competition, and 12-month trend data. Use when you need to discover related keywords and expand keyword research for SEO or paid search campaigns on Bing."},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_GOOGLE_AVAILABLE_HISTORY","name":"Get DataForSEO Labs Google Available History","description":"Tool 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."},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_GOOGLE_TOP_SEARCHES_LIVE","name":"Get DataForSEO Labs Google Top Searches Live","description":"Tool 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."},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_STATUS","name":"Get DataForSEO Labs Status","description":"Tool 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."},{"slug":"DATAFORSEO_GET_DATAFORSEO_TRENDS_LOCATIONS_BY_COUNTRY","name":"Get DataForSEO Trends Locations By Country","description":"Tool to retrieve DataForSEO Trends locations filtered by country ISO code. Use when you need to get the list of valid locations for setting up DataForSEO Trends tasks. Note that the minimum geographic scope supported is country level."},{"slug":"DATAFORSEO_GET_DOMAIN_ANALYTICS_TECH_AVAILABLE_FILTERS","name":"Get Domain Analytics Technologies Available Filters","description":"Tool 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, boolean, array, or timestamp)."},{"slug":"DATAFORSEO_GET_DOMAIN_ANALYTICS_TECH_TECHNOLOGY_STATS_LIVE","name":"Get Domain Analytics Technologies Technology Stats Live","description":"Tool 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."},{"slug":"DATAFORSEO_GET_DOMAIN_ANALYTICS_WHOIS_AVAILABLE_FILTERS","name":"Get Domain Analytics Whois Available Filters","description":"Tool to retrieve available filters for Domain Analytics Whois API endpoints. Use when you need to discover which fields can be filtered in whois queries and their data types."},{"slug":"DATAFORSEO_GET_GEMINI_LLM_RESPONSES_TASK_BY_ID","name":"Get Gemini LLM Responses Task Results","description":"Tool 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."},{"slug":"DATAFORSEO_GET_GEMINI_LLM_SCRAPER_HTML","name":"Get Gemini LLM Scraper HTML Results","description":"Tool to retrieve HTML-formatted results for a completed Gemini LLM Scraper task. Use when you need to fetch the raw HTML response from Google Gemini LLM for a specific task ID. Tasks remain available for 7 days after creation."},{"slug":"DATAFORSEO_GET_GEMINI_LLM_SCRAPER_LOCATIONS","name":"Get Gemini LLM Scraper Locations","description":"Tool to retrieve available locations for DataForSEO's Gemini LLM Scraper. Use when you need to get the list of supported countries and territories (213 locations) where the Gemini LLM Scraper can be used. Returns location codes, names, country ISO codes, and location types."},{"slug":"DATAFORSEO_GET_GOOGLE_HIST_BULK_TRAFFIC_EST_LIVE","name":"Get Google Historical Bulk Traffic Estimation Live","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_BING_KEYWORDS_FOR_SITE_TASK","name":"Get Keywords Data Bing Keywords For Site Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASK","name":"Get Keywords Data Bing Search Volume Task","description":"Tool to retrieve Bing search volume task results by task ID. Use when you need to fetch keyword search volume data including monthly search trends, cost-per-click metrics, and competition levels from Bing Ads."},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASK_BY_ID","name":"Get Bing Search Volume Task By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_GOOGLE_ADS_STATUS","name":"Get Keywords Data Google Ads Status","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_GOOGLE_ADWORDS_STATUS","name":"Get Keywords Data Google Adwords Status","description":"Tool to get current status of Google AdWords 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."},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_GOOGLE_SEARCH_VOLUME_TASK_BY_ID","name":"Get Keywords Data Google Search Volume Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_BING_AUDIENCE_EST_INDUSTRIES","name":"Get Keywords Data Bing Audience Estimation Industries","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_BING_KW_FOR_KW_TASK_BY_ID","name":"Get Keywords Data Bing Keywords For Keywords Task By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_BING_KW_SUGGESTIONS_FOR_URL_LIVE","name":"Get Keywords Data Bing Keyword Suggestions For URL Live","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_BING_KW_SUGGESTIONS_FOR_URL_TASK","name":"Get Bing Keyword Suggestions for URL Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_BING_KW_SUGGESTIONS_FOR_URL_TASK_BY_ID","name":"Get Keywords Data Bing Keyword Suggestions For URL Task By ID","description":"Tool to retrieve Bing keyword suggestions for URL task results by task ID. Use when you need to fetch keyword suggestions related to a specific URL including relevance confidence scores."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_AD_TRAFFIC_BY_KW_TASK_BY_ID","name":"Get Keywords Data Google Ads Ad Traffic By Keywords Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_KW_LIVE","name":"Get Keywords Data Google Ads Keywords For Keywords Live","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_KW_TASK_BY_ID","name":"Get Keywords Data Google Ads Keywords For Keywords Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_SITE_TASK","name":"Get Google Ads Keywords For Site Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_SITE_TASK_BY_ID","name":"Get Keywords Data Google Ads Keywords For Site Task By ID","description":"Tool to retrieve Google Ads keyword data for a specific site by task ID. Use when you need to fetch keywords relevant to a domain along with their search volumes, bids, competition levels, and trends. The task ID must be from a task created within the last 30 days."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_SEARCH_VOL_TASK_BY_ID","name":"Get Keywords Data Google Ads Search Volume Task","description":"Tool 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)."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_AD_TRAFFIC_BY_KW_TASK","name":"Get Keywords Data Google Ad Traffic By Keywords Task","description":"Tool to retrieve Google Ad Traffic by Keywords task results by task ID. Use when you need to fetch estimated traffic data for specified keywords based on bid amount and match type, including CPC, impressions, clicks, and daily costs. Results are available for up to 30 days after task creation."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_KW_FOR_CATEGORY_LIVE","name":"Get Keywords Data Google Keywords For Category Live","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_KW_FOR_KW_TASK_BY_ID","name":"Get Keywords Data Google Keywords For Keywords Task","description":"Tool 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."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_TRENDS_EXPLORE_TASK_BY_ID","name":"Get Keywords Data Google Trends Explore Task","description":"Tool to retrieve Google Trends Explore task results by task ID. Use when you need to fetch trend analysis data including time-series popularity graphs, geographic distribution maps, and related topics/queries for previously submitted keywords."},{"slug":"DATAFORSEO_GET_KW_GOOGLE_TRENDS_LOCATIONS_BY_COUNTRY","name":"Get Google Trends Locations By Country","description":"Tool to retrieve available Google Trends locations filtered by country ISO code. Use when you need to get the list of valid locations for setting up Google Trends keyword data tasks in a specific country."},{"slug":"DATAFORSEO_GET_LLM_MENTIONS_AVAILABLE_FILTERS","name":"Get LLM Mentions Available Filters","description":"Tool 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."},{"slug":"DATAFORSEO_GET_LLM_SCRAPER_LOCATIONS","name":"Get LLM Scraper Locations","description":"Tool to retrieve available locations for DataForSEO ChatGPT LLM Scraper. Use when you need to see which locations are supported for LLM-based web scraping operations."},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_ASIN_TASK_ADVANCED_BY_ID","name":"Get Merchant Amazon ASIN Task Advanced By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_ASIN_TASK_HTML","name":"Get Merchant Amazon ASIN Task HTML","description":"Tool 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."},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_PRODUCTS_TASK_ADVANCED_BY_ID","name":"Get Merchant Amazon Products Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_PRODUCTS_TASK_HTML_BY_ID","name":"Get Merchant Amazon Products Task HTML By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_SELLERS_TASK_ADVANCED","name":"Get Merchant Amazon Sellers Task Advanced","description":"Tool to retrieve Amazon sellers task results from DataForSEO. Use when you need to get seller information for a previously created task."},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_SELLERS_TASK_HTML_BY_ID","name":"Get Merchant Amazon Sellers Task HTML By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_MERCHANT_GOOGLE_PRODUCTS_TASK_ADVANCED_BY_ID","name":"Get Merchant Google Products Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_MERCHANT_GOOGLE_PRODUCTS_TASK_HTML","name":"Get Merchant Google Products Task HTML","description":"Tool 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."},{"slug":"DATAFORSEO_GET_MERCHANT_GOOGLE_SELLERS_TASK_ADVANCED_BY_ID","name":"Get Merchant Google Sellers Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_MERCHANT_G_PRODUCT_INFO_TASK_ADV_BY_ID","name":"Get Merchant Google Product Info Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_DUPLICATE_CONTENT","name":"Get On Page Duplicate Content","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_DUPLICATE_TAGS","name":"Get On Page Duplicate Tags","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_KEYWORD_DENSITY","name":"Get On Page Keyword Density","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_LIGHTHOUSE_AUDITS","name":"Get On Page Lighthouse Audits","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_LIGHTHOUSE_TASK_GET_JSON","name":"Get On Page Lighthouse Task Get Json","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_LINKS","name":"Get On Page Links","description":"Tool to retrieve internal and external links detected on a target website by task ID. Use when you need to analyze link structure, check for broken links, filter links by type (anchor, image, canonical, meta, alternate, redirect), or examine link attributes like dofollow/nofollow status."},{"slug":"DATAFORSEO_GET_ON_PAGE_NON_INDEXABLE","name":"Get On Page Non Indexable","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_PAGES","name":"Get On Page Pages","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_PAGES_BY_RESOURCE","name":"Get On Page Pages By Resource","description":"Tool 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."},{"slug":"DATAFORSEO_GET_ON_PAGE_SUMMARY_BY_ID","name":"Get On Page Summary","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_BAIDU_LOCATIONS_BY_COUNTRY","name":"Get SERP Baidu Locations By Country","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_BAIDU_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Baidu Organic Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_BING_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Bing Organic Task Regular By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_G_ADS_ADVERTISERS_TASK_ADV_BY_ID","name":"Get SERP Google Ads Advertisers Task (Advanced)","description":"Tool to retrieve Google Ads Advertisers task results by task ID. Use when you need to fetch advertiser information from Google Ads Transparency Center, including advertiser names, locations, verification status, and approximate ad counts."},{"slug":"DATAFORSEO_GET_SERP_G_DATASET_SEARCH_TASK_ADV_BY_ID","name":"Get SERP Google Dataset Search Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_G_FINANCE_EXPLORE_TASK_ADV_BY_ID","name":"Get SERP Google Finance Explore Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_G_FINANCE_TICKER_SEARCH_TASK_ADV_BY_ID","name":"Get SERP Google Finance Ticker Search Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_G_LOCAL_FINDER_TASK_GET_ADV_BY_ID","name":"Get SERP Google Local Finder Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_ADVANCED","name":"Get SERP Google Ads Advertisers Advanced","description":"Tool to retrieve Google Ads Advertisers task results by task ID. Use when you need to fetch advertiser information from Google Ads Transparency Center, including advertiser names, locations, verification status, and approximate ad counts."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_LIVE_ADVANCED","name":"Get SERP Google Ads Advertisers Live Advanced","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_TASK_ADVANCED","name":"Get SERP Google Ads Advertisers Task Advanced","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_SEARCH_LIVE_ADVANCED","name":"Get SERP Google Ads Search Live Advanced","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_AI_MODE_TASK_ADVANCED_BY_ID","name":"Get SERP Google AI Mode Task Advanced Results","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_AUTOCOMPLETE_TASK_ADVANCED_BY_ID","name":"Get SERP Google Autocomplete Task (Advanced)","description":"Tool to retrieve Google Autocomplete task results by task ID. Use when you need to fetch autocomplete suggestions from a previously submitted Google Autocomplete task."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_DATASET_INFO_TASK_ADVANCED","name":"Get SERP Google Dataset Info Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_MARKETS_TASK_HTML_BY_ID","name":"Get SERP Google Finance Markets Task HTML By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_QUOTE_TASK_ADVANCED_BY_ID","name":"Get SERP Google Finance Quote Task (Advanced)","description":"Tool to retrieve Google Finance Quote task results by task ID. Use when you need real-time financial data from Google Finance Quote tab for a specific ticker symbol, including current price, market data, news, and financial metrics."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_QUOTE_TASK_HTML_BY_ID","name":"Get SERP Google Finance Quote HTML By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_IMAGES_TASK_GET_ADVANCED_BY_ID","name":"Get SERP Google Images Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_IMAGES_TASK_HTML_BY_ID","name":"Get SERP Google Images Task HTML By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_JOBS_TASK_ADVANCED","name":"Get SERP Google Jobs Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_MAPS_TASK_GET_ADVANCED_BY_ID","name":"Get SERP Google Maps Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_NEWS_TASK_GET_ADVANCED","name":"Get SERP Google News Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Google Organic Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_GET_HTML_BY_ID","name":"Get SERP Google Organic Task HTML By ID","description":"Tool 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 Organic search results page after creating an organic task. Task results are available within 7 days of creation."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_HTML_BY_ID","name":"Get SERP Google Organic Task HTML By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Google Organic Task Regular By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_SEARCH_BY_IMAGE_HTML","name":"Get SERP Google Search By Image HTML","description":"Tool to retrieve raw HTML results for a Google Search By Image SERP task by ID. Use when you need to get the unprocessed HTML content of a Google reverse image search results page after creating a search by image task. Task results are available within 7 days of creation."},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_SEARCH_BY_IMAGE_HTML_BY_ID","name":"Get SERP Google Search By Image HTML By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Naver Organic Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_GET_ADVANCED","name":"Get SERP Naver Organic Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Naver Organic Task Regular By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_SEZNAM_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Seznam Organic Task (Advanced)","description":"Tool to retrieve advanced Seznam Organic SERP task results by task ID. Use when you need to fetch detailed search engine results page data from Seznam including organic results, rankings, metadata, and various SERP features for a previously submitted task."},{"slug":"DATAFORSEO_GET_SERP_SEZNAM_ORGANIC_TASK_GET_ADVANCED_BY_ID","name":"Get SERP Seznam Organic Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_SEZNAM_ORGANIC_TASK_GET_REGULAR_BY_ID","name":"Get Serp Seznam Organic Task Get Regular By Id","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_YAHOO_ORGANIC_TASK_GET_ADVANCED","name":"Get SERP Yahoo Organic Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_YAHOO_ORGANIC_TASK_GET_ADVANCED_BY_ID","name":"Get SERP Yahoo Organic Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_YAHOO_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Yahoo Organic Task Regular By ID","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_YT_VIDEO_COMMENTS_TASK_ADV_BY_ID","name":"Get YouTube Video Comments Task (Advanced)","description":"Tool 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."},{"slug":"DATAFORSEO_GET_SERP_YT_VIDEO_SUBTITLES_TASK_ADV_BY_ID","name":"Get SERP YouTube Video Subtitles Task Advanced By ID","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_AI_OPT_CHAT_GPT_LLM_RESPONSES_MODELS","name":"List Chat GPT AI Models","description":"Retrieve 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."},{"slug":"DATAFORSEO_LIST_AI_OPT_CHAT_GPT_LLM_RESPONSES_TASKS_READY","name":"List Ready AI Optimization LLM Response Tasks","description":"Tool to list completed AI optimization LLM response tasks that are ready for result collection. Use when you need to retrieve task IDs of completed tasks that haven't been collected yet using the Standard method without postback_url."},{"slug":"DATAFORSEO_LIST_AI_OPT_CHAT_GPT_LLM_SCRAPER_LANGUAGES","name":"List AI Optimization ChatGPT LLM Scraper Languages","description":"Tool to list available languages for DataForSEO ChatGPT LLM Scraper. Use when you need to see which languages are supported for AI optimization scraping tasks."},{"slug":"DATAFORSEO_LIST_AI_OPT_CHAT_GPT_LLM_SCRAPER_LOCATIONS","name":"List ChatGPT LLM Scraper Locations","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_AI_OPT_CLAUDE_LLM_RESPONSES_TASKS_READY","name":"List AI Optimization Claude LLM Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_AI_OPT_GEMINI_LLM_SCRAPER_TASKS_READY","name":"List AI Optimization Gemini LLM Scraper Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_AI_OPTIMIZATION_GEMINI_LLM_SCRAPER_LANGUAGES","name":"List Gemini LLM Scraper Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_AI_OPTIMIZATION_GEMINI_LLM_SCRAPER_LOCATIONS","name":"List Gemini LLM Scraper Locations","description":"Tool to list available locations for AI Optimization Gemini LLM Scraper. Use when you need to see which geographic locations are supported for Gemini LLM scraping operations."},{"slug":"DATAFORSEO_LIST_AI_OPTIMIZATION_LLM_MENTIONS_FILTERS","name":"List AI Optimization LLM Mentions Filters","description":"Tool to retrieve available filters for AI Optimization LLM Mentions endpoint. Use when you need to discover which filter parameters are available for filtering LLM mentions data (e.g., platform, location_code, language_code, ai_search_volume, first_response_at, last_response_at)."},{"slug":"DATAFORSEO_LIST_AI_OPT_LLM_MENTIONS_LOCATIONS_AND_LANGUAGES","name":"List AI Optimization LLM Mentions Locations and Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_AI_OPT_PERPLEXITY_LLM_RESPONSES_MODELS","name":"List AI Optimization Perplexity LLM Response Models","description":"Tool 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)."},{"slug":"DATAFORSEO_LIST_APP_DATA_APPLE_APP_LIST_TASKS_READY","name":"List Apple App List Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_APPLE_CATEGORIES","name":"List App Data Apple Categories","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_APPLE_LANGUAGES","name":"List App Data Apple Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_APPLE_LOCATIONS","name":"List Apple App Data Locations","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_ERRORS","name":"List App Data Errors","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_INFO_TASKS_READY","name":"List Google App Info Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_LISTINGS_CATEGORIES","name":"List App Data Google App Listings Categories","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_LIST_TASKS_READY","name":"List Google App List Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_REVIEWS_TASKS_READY","name":"List Google App Reviews Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_GOOGLE_APP_SEARCHES_TASKS_READY","name":"List Google App Searches Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_GOOGLE_CATEGORIES","name":"List App Data Google Categories","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_GOOGLE_LANGUAGES","name":"List App Data Google Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_ID_LIST","name":"List App Data Task IDs","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APP_DATA_TASKS_READY","name":"List App Data Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_APPLE_APP_SEARCHES_TASKS_READY","name":"List Apple App Searches Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BACKLINKS_AVAILABLE_FILTERS","name":"List Backlinks Available Filters","description":"Tool to retrieve available filters for DataForSEO Backlinks API endpoints. Use when you need to discover which fields can be filtered in backlinks queries and their data types (string, boolean, numeric, time, or array types)."},{"slug":"DATAFORSEO_LIST_BACKLINKS_ERRORS","name":"List Backlinks Errors","description":"Tool to retrieve information about Backlinks API tasks that returned errors within the past 7 days. Use when you need to debug failed backlinks tasks, monitor error rates, or investigate specific function failures. Supports filtering by function name and datetime range."},{"slug":"DATAFORSEO_LIST_BING_SEARCH_VOLUME_HISTORY_LOCATIONS","name":"List Bing Search Volume History Locations","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BIZ_GOOGLE_EXTENDED_REVIEWS_TASKS_READY","name":"List Google Extended Reviews Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BIZ_GOOGLE_HOTEL_SEARCHES_TASKS_READY","name":"List Business Data Google Hotel Searches Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BIZ_GOOGLE_MY_BUSINESS_INFO_TASKS_READY","name":"List Google My Business Info Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BIZ_GOOGLE_MY_BUSINESS_UPDATES_TASKS_READY","name":"List Google My Business Updates Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BIZ_GOOGLE_QUESTIONS_ANSWERS_TASKS_READY","name":"List Google Questions And Answers Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BIZ_TRIPADVISOR_REVIEWS_TASKS_READY","name":"List TripAdvisor Reviews Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_BUSINESS_LISTINGS_CATEGORIES","name":"List Business Data Business Listings Categories","description":"Tool to list Business Data Business Listings categories by business count. Use when you need to retrieve the available business categories for business listings data."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_BUSINESS_LISTINGS_FILTERS","name":"List Business Data Business Listings Filters","description":"Tool to retrieve available filters for DataForSEO 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 timestamp)."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_BUSINESS_LISTINGS_LOCATIONS","name":"List Business Data Business Listings Locations","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_ERRORS","name":"List Business Data Errors","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_GOOGLE_HOTEL_INFO_TASKS_READY","name":"List Google Hotel Info Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_GOOGLE_LANGUAGES","name":"List Business Data Google Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_GOOGLE_REVIEWS_TASKS_READY","name":"List Google Reviews Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_TASKS_READY","name":"List Business Data Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_TRIPADVISOR_LANGUAGES","name":"List Business Data TripAdvisor Languages","description":"Tool to list available TripAdvisor languages supported in Business Data API. Use when you need to retrieve language codes for TripAdvisor Business Data queries."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_TRIPADVISOR_SEARCH_TASKS_READY","name":"List TripAdvisor Search Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_TRUSTPILOT_REVIEWS_TASKS_READY","name":"List Trustpilot Reviews Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_BUSINESS_DATA_TRUSTPILOT_SEARCH_TASKS_READY","name":"List Trustpilot Search Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_CLAUDE_LLM_RESPONSE_MODELS","name":"List Claude LLM Response Models","description":"Tool 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)."},{"slug":"DATAFORSEO_LIST_CONTENT_ANALYSIS_AVAILABLE_FILTERS","name":"List Content Analysis Available Filters","description":"Tool 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)."},{"slug":"DATAFORSEO_LIST_CONTENT_ANALYSIS_CATEGORIES","name":"List Content Analysis Categories","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_CONTENT_ANALYSIS_LANGUAGES","name":"List Content Analysis Languages","description":"Tool to list available languages supported in Content Analysis API. Use when you need to retrieve language codes for content analysis queries."},{"slug":"DATAFORSEO_LIST_CONTENT_ANALYSIS_LOCATIONS","name":"List Content Analysis Locations","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_DATAFORSEO_LABS_CATEGORIES","name":"List DataForSEO Labs Categories","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_DATAFORSEO_LABS_ERRORS","name":"List DataForSEO Labs Errors","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_DATAFORSEO_LABS_LOCATIONS_AND_LANGUAGES","name":"List DataForSEO Labs Locations and Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_DOMAIN_ANALYTICS_ERRORS","name":"List Domain Analytics Errors","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_DOMAIN_ANALYTICS_ID_LIST","name":"List Domain Analytics Task IDs","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_DOMAIN_ANALYTICS_TECHNOLOGIES","name":"List Domain Analytics Technologies","description":"Tool 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)."},{"slug":"DATAFORSEO_LIST_DOMAIN_ANALYTICS_TECHNOLOGIES_FILTERS","name":"List Domain Analytics Technologies Filters","description":"Tool 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)."},{"slug":"DATAFORSEO_LIST_DOMAIN_ANALYTICS_TECHNOLOGIES_LANGUAGES","name":"List Domain Analytics Technologies Languages","description":"Tool to list available languages for Domain Analytics Technologies API. Use when you need to retrieve language codes for domain analytics technology queries."},{"slug":"DATAFORSEO_LIST_DOMAIN_ANALYTICS_TECHNOLOGIES_LOCATIONS","name":"List Domain Analytics Technologies Locations","description":"Tool to list available locations supported in Domain Analytics Technologies API. Use when you need to retrieve location codes for technology stack analysis queries."},{"slug":"DATAFORSEO_LIST_DOMAIN_ANALYTICS_WHOIS_FILTERS","name":"List Domain Analytics Whois Filters","description":"Tool 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)."},{"slug":"DATAFORSEO_LIST_GEMINI_LLM_MODELS","name":"List Gemini LLM Models","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_GEMINI_LLM_RESPONSES_TASKS_READY","name":"List Gemini LLM Responses Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_BING_LANGUAGES","name":"List Keywords Data Bing Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASKS_READY","name":"List Bing Search Volume Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_DATAFORSEO_TRENDS_LOCATIONS","name":"List Keywords Data Dataforseo Trends Locations","description":"Tool to list available locations supported in DataForSEO Trends API. Use when you need to retrieve location codes and geographic information for DataForSEO Trends queries. Minimum geographic scope is country level."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_ENDPOINTS","name":"List Keywords Data Endpoints","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_ERRORS","name":"List Keywords Data Errors","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_ADS_LANGUAGES","name":"List Keywords Data Google Ads Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_CATEGORIES","name":"List Keywords Data Google Categories","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_LANGUAGES","name":"List Keywords Data Google Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_TRENDS_CATEGORIES","name":"List Keywords Data Google Trends Categories","description":"Tool to list available Google Trends categories for Keywords Data API. Use when you need category codes for filtering Google Trends data by topic or industry vertical."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_TRENDS_LANGUAGES","name":"List Keywords Data Google Trends Languages","description":"Tool to list available languages for DataForSEO Google Trends API. Use when you need to see which languages are supported for Google Trends keyword data queries."},{"slug":"DATAFORSEO_LIST_KEYWORDS_DATA_GOOGLE_TRENDS_LOCATIONS","name":"List Keywords Data Google Trends Locations","description":"Tool to list available Google Trends locations for Keywords Data API. Use when you need location codes for geographic targeting in Google Trends queries. Returns 2,383+ supported locations with Google Trends identifiers."},{"slug":"DATAFORSEO_LIST_KW_BING_AUDIENCE_EST_JOB_FUNCTIONS","name":"List Keywords Data Bing Audience Estimation Job Functions","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_BING_AUDIENCE_EST_TASKS_READY","name":"List Bing Audience Estimation Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_BING_KW_FOR_KW_TASKS_READY","name":"List Bing Keywords For Keywords Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_BING_KW_FOR_SITE_TASKS_READY","name":"List Bing Keywords For Site Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_BING_KW_PERFORMANCE_TASKS_READY","name":"List Bing Keyword Performance Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_BING_KW_SUGGESTIONS_FOR_URL_LANGUAGES","name":"List Keywords Data Bing Keyword Suggestions For URL Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_BING_KW_SUGGESTIONS_FOR_URL_TASKS_READY","name":"List Keywords Data Bing Keyword Suggestions For URL Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_BING_SEARCH_VOL_HISTORY_TASKS_READY","name":"List Bing Search Volume History Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_CLICKSTREAM_LOCATIONS_AND_LANGUAGES","name":"List Keywords Data Clickstream Data Locations And Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_ADS_AD_TRAFFIC_BY_KW_TASKS_READY","name":"List Google Ads Ad Traffic by Keywords Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_ADS_KW_FOR_KW_TASKS_READY","name":"List Google Ads Keywords For Keywords Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_ADS_KW_FOR_SITE_TASKS_READY","name":"List Keywords Data Google Ads Keywords For Site Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_ADS_SEARCH_VOL_TASKS_READY","name":"List Google Ads Search Volume Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_AD_TRAFFIC_BY_KW_TASKS_READY","name":"List Google Ad Traffic by Keywords Ready Tasks","description":"Tool to retrieve completed Google 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_KW_FOR_KW_TASKS_READY","name":"List Keywords For Keywords Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_KW_FOR_SITE_TASKS_READY","name":"List Keywords Data Google Keywords For Site Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_SEARCH_VOL_TASKS_READY","name":"List Google Search Volume Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_KW_GOOGLE_TRENDS_EXPLORE_TASKS_READY","name":"List Google Trends Explore Ready Tasks","description":"Tool to retrieve completed Google Trends 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."},{"slug":"DATAFORSEO_LIST_LABS_GOOGLE_CATEGORIES_FOR_KW_LANGUAGES","name":"List DataForSEO Labs Google Categories for Keywords Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_AMAZON_ASIN_TASKS_READY","name":"List Merchant Amazon Asin Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_AMAZON_LANGUAGES","name":"List Merchant Amazon Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_AMAZON_PRODUCTS_TASKS_READY","name":"List Merchant Amazon Products Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_AMAZON_SELLERS_TASKS_READY","name":"List Merchant Amazon Sellers Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_ERRORS","name":"List Merchant Errors","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_GOOGLE_LANGUAGES","name":"List Merchant Google Languages","description":"Tool to list available languages for DataForSEO Merchant Google API. Use when you need to see which languages are supported for Google Shopping data queries."},{"slug":"DATAFORSEO_LIST_MERCHANT_GOOGLE_PRODUCT_INFO_TASKS_READY","name":"List Merchant Google Product Info Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_GOOGLE_PRODUCTS_TASKS_READY","name":"List Merchant Google Products Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_GOOGLE_REVIEWS_TASKS_READY","name":"List Merchant Google Reviews Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_GOOGLE_SELLERS_TASKS_READY","name":"List Merchant Google Sellers Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_MERCHANT_TASKS_READY","name":"List Merchant Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_ON_PAGE_AVAILABLE_FILTERS","name":"List OnPage Available Filters","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_ON_PAGE_ERRORS","name":"List OnPage Errors","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_ON_PAGE_LIGHTHOUSE_LANGUAGES","name":"List On Page Lighthouse Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_ON_PAGE_LIGHTHOUSE_TASKS_READY","name":"List On Page Lighthouse Tasks Ready","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_ON_PAGE_LIGHTHOUSE_VERSIONS","name":"List OnPage Lighthouse Versions","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_ON_PAGE_RESOURCES","name":"List On Page Resources","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_ON_PAGE_TASKS_READY","name":"List On Page Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_BAIDU_LANGUAGES","name":"List Serp Baidu Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_BAIDU_ORGANIC_TASKS_FIXED","name":"List Baidu Organic Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_BAIDU_ORGANIC_TASKS_READY","name":"List SERP Baidu Organic Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_BING_LANGUAGES","name":"List SERP Bing Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_BING_ORGANIC_TASKS_FIXED","name":"List SERP Bing Organic Tasks Fixed","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_BING_ORGANIC_TASKS_READY","name":"List SERP Bing Organic Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_ENDPOINTS","name":"List SERP Endpoints","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_ERRORS","name":"List SERP Errors","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_G_FINANCE_TICKER_SEARCH_TASKS_READY","name":"List SERP Google Finance Ticker Search Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_ADS_ADVERTISERS_LOCATIONS","name":"List SERP Google Ads Advertisers Locations","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_ADS_ADVERTISERS_TASKS_READY","name":"List SERP Google Ads Advertisers Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_ADS_SEARCH_LOCATIONS","name":"List SERP Google Ads Search Locations","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_ADS_SEARCH_TASKS_READY","name":"List SERP Google Ads Search Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_AI_MODE_LANGUAGES","name":"List SERP Google AI Mode Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_AI_MODE_TASKS_FIXED","name":"List SERP Google AI Mode Tasks Fixed","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_AI_MODE_TASKS_READY","name":"List SERP Google AI Mode Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_AUTOCOMPLETE_TASKS_FIXED","name":"List Google Autocomplete Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_AUTOCOMPLETE_TASKS_READY","name":"List SERP Google Autocomplete Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_DATASET_INFO_TASKS_FIXED","name":"List SERP Google Dataset Info Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_DATASET_INFO_TASKS_READY","name":"List SERP Google Dataset Info Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_DATASET_SEARCH_TASKS_FIXED","name":"List Google Dataset Search Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_DATASET_SEARCH_TASKS_READY","name":"List SERP Google Dataset Search Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_EVENTS_TASKS_FIXED","name":"List Google Events Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_EVENTS_TASKS_READY","name":"List SERP Google Events Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_FINANCE_EXPLORE_TASKS_READY","name":"List SERP Google Finance Explore Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_FINANCE_MARKETS_TASKS_READY","name":"List SERP Google Finance Markets Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_FINANCE_QUOTE_TASKS_READY","name":"List SERP Google Finance Quote Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_IMAGES_TASKS_FIXED","name":"List Google Images Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_IMAGES_TASKS_READY","name":"List SERP Google Images Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_JOBS_TASKS_FIXED","name":"List Google Jobs Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_JOBS_TASKS_READY","name":"List SERP Google Jobs Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_LANGUAGES","name":"List SERP Google Languages","description":"Tool to list available languages for DataForSEO Google SERP API. Use when you need to see which languages are supported for Google SERP queries."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_LOCAL_FINDER_TASKS_FIXED","name":"List Google Local Finder Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_LOCAL_FINDER_TASKS_READY","name":"List Google Local Finder Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_MAPS_TASKS_FIXED","name":"List Google Maps Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_MAPS_TASKS_READY","name":"List SERP Google Maps Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_NEWS_TASKS_FIXED","name":"List Google News Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_NEWS_TASKS_READY","name":"List SERP Google News Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_ORGANIC_TASKS_FIXED","name":"List Google Organic Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_ORGANIC_TASKS_READY","name":"List SERP Google Organic Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_SEARCH_BY_IMAGE_TASKS_FIXED","name":"List Google Search By Image Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_GOOGLE_SEARCH_BY_IMAGE_TASKS_READY","name":"List SERP Google Search By Image Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_ID_LIST","name":"List SERP Task IDs","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_NAVER_ORGANIC_TASKS_FIXED","name":"List Naver Organic Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_NAVER_ORGANIC_TASKS_READY","name":"List SERP Naver Organic Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_SEZNAM_LANGUAGES","name":"List Serp Seznam Languages","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_SEZNAM_ORGANIC_TASKS_FIXED","name":"List Seznam Organic Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_SEZNAM_ORGANIC_TASKS_READY","name":"List Seznam Organic SERP Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_TASKS_READY","name":"List SERP Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YAHOO_LANGUAGES","name":"List SERP Yahoo Languages","description":"Tool to list available languages for DataForSEO Yahoo SERP API. Use when you need to see which languages are supported for Yahoo SERP queries."},{"slug":"DATAFORSEO_LIST_SERP_YAHOO_ORGANIC_TASKS_FIXED","name":"List Yahoo Organic Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YAHOO_ORGANIC_TASKS_READY","name":"List Yahoo Organic SERP Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YOUTUBE_LANGUAGES","name":"List SERP YouTube Languages","description":"Tool to list available languages for DataForSEO YouTube SERP API. Use when you need to see which languages are supported for YouTube SERP queries."},{"slug":"DATAFORSEO_LIST_SERP_YOUTUBE_ORGANIC_TASKS_READY","name":"List YouTube Organic Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_COMMENTS_TASKS_FIXED","name":"List YouTube Video Comments Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_COMMENTS_TASKS_READY","name":"List YouTube Video Comments Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_INFO_TASKS_FIXED","name":"List YouTube Video Info Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_INFO_TASKS_READY","name":"List SERP YouTube Video Info Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_SUBTITLES_TASKS_FIXED","name":"List SERP YouTube Video Subtitles Fixed Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_LIST_SERP_YOUTUBE_VIDEO_SUBTITLES_TASKS_READY","name":"List SERP YouTube Video Subtitles Ready Tasks","description":"Tool 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."},{"slug":"DATAFORSEO_POST_DATAFORSEO_LABS_BULK_KEYWORD_DIFFICULTY_LIVE","name":"Get Bulk Keyword Difficulty Live","description":"Tool 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."},{"slug":"DATAFORSEO_POST_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASK","name":"Create Bing Search Volume Task","description":"Tool to create a Bing Search Volume task for keyword analysis. Provides search volume data for the last month, search volume trends for up to 24 past months, current cost-per-click, and competition values. Use when you need to analyze keyword search volume and metrics for Bing search."},{"slug":"DATAFORSEO_POST_KEYWORDS_DATA_GOOGLE_SEARCH_VOLUME_TASK","name":"Post Keywords Data Google Search Volume Task","description":"Tool 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."},{"slug":"DATAFORSEO_POST_KW_GOOGLE_KW_FOR_CATEGORY_TASK","name":"Create Google Keywords For Category Task","description":"Tool 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."},{"slug":"DATAFORSEO_POST_ON_PAGE_SUMMARY","name":"Post On Page Summary","description":"Tool 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."},{"slug":"DATAFORSEO_RESEND_APPENDIX_WEBHOOKS","name":"Resend Appendix Webhooks","description":"Tool 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."}],"triggers":[],"authConfigDetails":[{"mode":"BASIC","name":"dataforseo_basic","fields":{"auth_config_creation":{"required":[],"optional":[]},"connected_account_initiation":{"required":[{"name":"username","displayName":"API Login","type":"string","description":"Your DataForSEO API login (email address). Get it from https://app.dataforseo.com/api-access","required":true,"default":null},{"name":"password","displayName":"API Password","type":"string","description":"Your DataForSEO API password (auto-generated, different from account password). Get it from https://app.dataforseo.com/api-access","required":true,"default":null}],"optional":[]}}}]},"tools":[{"slug":"DATAFORSEO_CREATE_APP_DATA_APPLE_APP_REVIEWS_TASK","name":"Create App Data Apple App Reviews Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires app_id and either location/language code or name.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateAppDataAppleAppReviewsTaskRequestItem","required":["app_id"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","test_query"],"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"depth":{"type":"integer","title":"Depth","maximum":500,"minimum":1,"examples":[200,100,50],"description":"Number of reviews to retrieve. Valid range: 1-500. Billing occurs per 50 results (e.g., depth=51 charges for 100 reviews). Multiples of 50 are recommended for cost efficiency."},"app_id":{"type":"string","title":"App Id","examples":["835599320","284882215"],"description":"ID of the mobile application on App Store. You can find the app_id in the URL of the app page (e.g., '835599320' for Instagram)."},"sort_by":{"enum":["most_recent","most_helpful"],"type":"string","title":"SortBy","description":"Sort order for app reviews."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id')."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de"],"description":"Language code for the reviews (e.g., 'en' for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German"],"description":"Language name for the reviews (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826],"description":"Geographic location code for the App Store region (e.g., 2840 for United States). Use either location_code or location_name, not both. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom"],"description":"Geographic location name for the App Store region (e.g., 'United States'). Use either location_name or location_code, not both."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced"],"description":"Result format for postback callback. Required if postback_url is specified. Valid value: 'advanced'."}},"description":"Individual task item for creating an Apple App Reviews task.","requiredFields":"$17:props:tools:0:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"depth":{"type":"integer","title":"Depth","description":"Depth from request"},"app_id":{"type":"string","title":"App Id","description":"App ID from request"},"sort_by":{"type":"string","title":"Sort By","description":"Sort order from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_APP_DATA_APPLE_APP_SEARCHES_TASK","name":"Create Apple App Searches Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires a keyword and either location/language code or name.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateAppDataAppleAppSearchesTaskRequestItem","required":["keyword"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","test_query"],"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"depth":{"type":"integer","title":"Depth","examples":[50,100,200],"description":"Number of app results to retrieve. Maximum 200. Determines how many apps will be returned in the search results."},"keyword":{"type":"string","title":"Keyword","examples":["vpn","photo editor","fitness tracker"],"description":"Search query keyword for finding apps on Apple App Store. The keyword you want to search apps for (e.g., 'vpn', 'games', 'photo editor')."},"priority":{"type":"integer","title":"Priority","examples":[1,2],"description":"Task execution priority. 1 for normal priority (default), 2 for high priority. High priority tasks incur additional charges but process faster."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback. Must be a valid URL."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de"],"description":"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."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German"],"description":"Language name for the search (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826],"description":"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."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom"],"description":"Geographic location name for the search context (e.g., 'United States'). Use either location_name or location_code, not both."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced","html"],"description":"Result format for postback callback. Valid values: 'advanced' or 'html'."}},"description":"Individual task item for Apple App Searches request.","requiredFields":"$17:props:tools:1:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using the get task advanced endpoint."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"depth":{"type":"integer","title":"Depth","description":"Depth parameter from request"},"keyword":{"type":"string","title":"Keyword","description":"Search query from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_APP_DATA_GOOGLE_APP_LIST_TASK","name":"Create App Data Google App List Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires app_collection and either location/language code or name.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateAppDataGoogleAppListTaskRequestItem","required":["app_collection"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","test_query"],"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"depth":{"type":"integer","title":"Depth","maximum":200,"minimum":1,"examples":[100,200],"description":"Number of apps to retrieve from the list. Valid range: 1-200. Billing occurs per 100 results. Multiples of 100 are recommended for cost efficiency."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"age_rating":{"enum":["ages_up_to_5","ages_6_8","ages_9_12"],"type":"string","title":"AgeRating","description":"Age rating filter for family category apps."},"app_category":{"type":"string","title":"App Category","examples":["family","games","education"],"description":"App category to filter results (e.g., 'family', 'games', 'education'). Cannot be used when app_collection is set to 'featured'. See DataForSEO app categories list for valid values."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id')."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de"],"description":"Language code for the app data (e.g., 'en' for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German"],"description":"Language name for the app data (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826],"description":"Geographic location code for the Google Play Store region (e.g., 2840 for United States). Use either location_code or location_name, not both. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom"],"description":"Geographic location name for the Google Play Store region (e.g., 'United States'). Use either location_name or location_code, not both."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced","html"],"description":"Result format for postback callback. Required if postback_url is specified. Valid values: 'advanced' or 'html'."},"app_collection":{"enum":["featured","topselling_paid","topselling_free","topselling_new_free","topselling_new_paid","topgrossing","movers_shakers"],"type":"string","title":"App Collection","examples":["topselling_free","topgrossing"],"description":"App collection type to retrieve from Google Play Store. Determines which top chart list to fetch (e.g., 'topselling_free' for free bestsellers, 'topgrossing' for highest revenue apps). Note: Cannot use 'app_category' parameter when 'featured' is selected."}},"description":"Individual task item for creating a Google App List task.","requiredFields":"$17:props:tools:2:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using the get task advanced endpoint within 30 days."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"depth":{"type":"integer","title":"Depth","description":"Depth from request"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"age_rating":{"type":"string","title":"Age Rating","description":"Age rating from request"},"app_category":{"type":"string","title":"App Category","description":"App category from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"},"app_collection":{"type":"string","title":"App Collection","description":"App collection from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"type":"string"}},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","important","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_APP_DATA_GOOGLE_APP_REVIEWS_TASK","name":"Create App Data Google App Reviews Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires app_id and either location/language code or name.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateAppDataGoogleAppReviewsTaskRequestItem","required":["app_id"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","test_query"],"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"depth":{"type":"integer","title":"Depth","maximum":100000,"minimum":1,"examples":[150,300,450],"description":"Number of reviews to retrieve. Valid range: 1-100,000. Default is 150. Billing occurs per 150 results. Multiples of 150 are strongly recommended for cost efficiency."},"app_id":{"type":"string","title":"App Id","examples":["org.telegram.messenger","com.instagram.android"],"description":"ID of the mobile application on Google Play. You can find the app_id in the URL of the app page (e.g., 'org.telegram.messenger' for Telegram)."},"rating":{"enum":[1,2,3,4,5],"type":"integer","title":"Rating","description":"Rating filter for app reviews."},"sort_by":{"enum":["newest","most_relevant"],"type":"string","title":"SortBy","description":"Sort order for app reviews."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id')."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de"],"description":"Language code for the reviews (e.g., 'en' for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German"],"description":"Language name for the reviews (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826],"description":"Geographic location code for the Google Play region (e.g., 2840 for United States). Use either location_code or location_name, not both. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom"],"description":"Geographic location name for the Google Play region (e.g., 'United States'). Use either location_name or location_code, not both."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced","html"],"description":"Result format for postback callback. Required if postback_url is specified. Valid values: 'advanced' or 'html'."}},"description":"Individual task item for creating a Google App Reviews task.","requiredFields":"$17:props:tools:3:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"depth":{"type":"integer","title":"Depth","description":"Depth from request"},"app_id":{"type":"string","title":"App Id","description":"App ID from request"},"rating":{"type":"integer","title":"Rating","description":"Rating filter from request"},"sort_by":{"type":"string","title":"Sort By","description":"Sort order from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_BUSINESS_DATA_TRUSTPILOT_SEARCH_TASK","name":"Create Business Data Trustpilot Search Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires a keyword.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateBusinessDataTrustpilotSearchTaskRequestItem","required":["keyword"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","test_query"],"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"depth":{"type":"integer","title":"Depth","minimum":1,"examples":[20,50,100],"description":"Number of results to return per search. Maximum depends on Trustpilot's available results. Typically set to 20-100."},"keyword":{"type":"string","title":"Keyword","examples":["pizza restaurant","dentist","coffee shop"],"description":"Search query to search for businesses on Trustpilot (e.g., 'pizza restaurant', 'dentist near me'). This is the main search term."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback when the task completes. Must be a valid URL."}},"description":"Individual task item for Trustpilot Search request.","requiredFields":"$17:props:tools:4:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later within 30 days."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"depth":{"type":"integer","title":"Depth","description":"Depth parameter from request"},"keyword":{"type":"string","title":"Keyword","description":"Search query from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"type":"string"}},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","important","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_KEYWORDS_DATA_GOOGLE_TRENDS_EXPLORE_TASK","name":"Create Keywords Data Google Trends Explore Task","description":"Tool to create Google Trends Explore tasks for analyzing keyword popularity over time. Use when you need to get trend data from Google Search, YouTube, Google News, Google Images, or Google Shopping. Returns task IDs for retrieving results later using the task_get endpoint.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to create. Each task will query Google Trends to analyze keyword popularity over time. Maximum 100 tasks per request.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateKeywordsDataGoogleTrendsExploreTaskRequestItem","required":["keywords"],"properties":{"tag":{"type":"string","title":"Tag","examples":["trends_campaign_001","keyword_research_batch_1"],"maxLength":255,"description":"Custom identifier for task tracking and grouping. Maximum 255 characters. Useful for organizing tasks in your system."},"type":{"enum":["web","news","youtube","images","froogle"],"type":"string","title":"TrendsType","description":"Google Trends data source type."},"date_to":{"type":"string","title":"Date To","examples":["2025-12-31","2026-01-18"],"description":"End date for trend data in YYYY-MM-DD format. Default is today's date. Use with date_from or omit to use time_range instead."},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","examples":[["seo api","rank api"],["digital marketing"]],"maxItems":5,"minItems":1,"description":"Array of search terms to analyze keyword popularity trends. Maximum 5 keywords per task, each keyword 1-100 characters. Cannot contain special characters: < > | \\ \" - + = ~ ! : * ( ) [ ] { }"},"date_from":{"type":"string","title":"Date From","examples":["2024-01-01","2025-06-01"],"description":"Start date for trend data in YYYY-MM-DD format. Minimum date is 2004-01-01 for web type, 2008-01-01 for other types. Use with date_to or omit to use time_range instead."},"item_types":{"type":"array","items":{"enum":["google_trends_graph","google_trends_map","google_trends_topics_list","google_trends_queries_list"],"type":"string","title":"ItemType","properties":{},"description":"Result data types for Google Trends response."},"title":"Item Types","examples":[["google_trends_graph","google_trends_map"]],"description":"Array of result data types to include in response. Default is google_trends_graph. Options: google_trends_graph (trend over time), google_trends_map (geographic data), google_trends_topics_list (related topics), google_trends_queries_list (related queries)."},"time_range":{"enum":["past_hour","past_4_hours","past_day","past_7_days","past_30_days","past_90_days","past_12_months","past_5_years","2004_present","2008_present"],"type":"string","title":"TimeRange","description":"Preset time range options for Google Trends data."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo?task_id=$id"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables. Use for simple task completion notifications."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo?task_id=$id"],"description":"URL endpoint for receiving task results via POST callback when task completes. Must be a valid URL. Supports $id and $tag variables for dynamic values. 10-second timeout applies."},"category_code":{"type":"integer","title":"Category Code","examples":[0,3,12,16],"description":"Google Trends category code to filter results by topic category. Default is 0 (all categories). Use specific codes to narrow search to categories like Business, Technology, etc."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Language code (e.g., 'en'). Use either language_code or language_name, not both. Default is 'en'."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Full language name (e.g., 'English'). Use either language_name or language_code, not both. Default is English."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Location code for geographic targeting (e.g., 2840 for United States). Use either location_code or location_name, not both. Omit for global results."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","Canada"],"description":"Full location name for geographic targeting (e.g., 'United States', 'United Kingdom'). Use either location_name or location_code, not both. Omit for global results."}},"description":"Individual task item for Google Trends Explore request.","requiredFields":"$17:props:tools:5:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using the task_get endpoint."},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"type":{"type":"string","title":"Type","description":"Trends data source from request"},"date_to":{"type":"string","title":"Date To","description":"End date from request"},"function":{"type":"string","title":"Function","description":"API function called"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"Keywords array from request"},"date_from":{"type":"string","title":"Date From","description":"Start date from request"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Item types from request"},"time_range":{"type":"string","title":"Time Range","description":"Time range from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"category_code":{"type":"integer","title":"Category Code","description":"Category code from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks using task_get endpoint)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully and queued for processing."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results later using the task_get endpoint, along with status and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_KW_BING_AUDIENCE_EST_TASK","name":"Create Keywords Data Bing Audience Estimation Task","description":"Tool to create a Bing Audience Estimation task for ad campaign planning. Use when you need to estimate audience size, clicks, impressions, and budget recommendations based on targeting criteria like age, gender, location, industry, and job function.","input_parameters":{"age":{"type":"array","description":"Target age groups for the ad campaign. Multiple age ranges can be specified to refine audience targeting","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"enum":["eighteen_to_twenty_four","twenty_five_to_thirty_four","thirty_five_to_forty_nine","fifty_to_sixty_four","sixty_five_plus","unknown"],"type":"string","title":"AgeGroup","properties":{},"description":"Age range targeting options for Bing audience estimation."}},"bid":{"type":"number","description":"Cost per click (CPC) bid amount in USD. Affects estimated reach and budget calculations","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"gender":{"type":"array","description":"Target gender(s) for the ad campaign. Can specify multiple genders for broader targeting","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"enum":["male","female","unknown"],"type":"string","title":"Gender","properties":{},"description":"Gender targeting options for Bing audience estimation."}},"industry":{"type":"array","description":"Industry targeting codes. Array of industry identifiers to target specific business sectors (e.g., 806303407 for Technology)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"integer","properties":{}}},"daily_budget":{"type":"number","description":"Daily advertising budget in USD. Used to estimate campaign reach and engagement metrics","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"job_function":{"type":"array","description":"Job function targeting codes. Array of job role identifiers to target specific professional functions (e.g., 806298607 for IT)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"integer","properties":{}}},"location_code":{"type":"integer","description":"Unique location identifier for geographic targeting. Use location_code, location_name, or location_coordinate (only one at a time)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Full name of target location (e.g., 'United States', 'New York'). Use location_code, location_name, or location_coordinate (only one at a time)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_coordinate":{"type":"string","description":"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)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original request parameters","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"array","items":{}}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"AudienceEstimationResult","properties":{"suggested_bid":{"type":"object","title":"SuggestedBid","properties":{"maximum":{"type":"number","title":"Maximum","description":"Maximum suggested bid in USD"},"minimum":{"type":"number","title":"Minimum","description":"Minimum suggested bid in USD"}},"description":"Suggested bid amount for optimal campaign performance.","additionalProperties":false},"estimated_spend":{"type":"object","title":"EstimatedSpend","properties":{"maximum":{"type":"number","title":"Maximum","description":"Maximum estimated spend in USD"},"minimum":{"type":"number","title":"Minimum","description":"Minimum estimated spend in USD"}},"description":"Estimated total ad spend for the campaign.","additionalProperties":false},"estimated_clicks":{"type":"object","title":"EstimatedClicks","properties":{"maximum":{"type":"integer","title":"Maximum","description":"Maximum estimated clicks"},"minimum":{"type":"integer","title":"Minimum","description":"Minimum estimated clicks"}},"description":"Estimated number of clicks on the ad campaign.","additionalProperties":false},"suggested_budget":{"type":"object","title":"SuggestedBudget","properties":{"maximum":{"type":"number","title":"Maximum","description":"Maximum suggested daily budget in USD"},"minimum":{"type":"number","title":"Minimum","description":"Minimum suggested daily budget in USD"}},"description":"Suggested budget amount for optimal campaign performance.","additionalProperties":false},"estimated_audience":{"type":"object","title":"EstimatedAudience","properties":{"maximum":{"type":"integer","title":"Maximum","description":"Maximum estimated audience size"},"minimum":{"type":"integer","title":"Minimum","description":"Minimum estimated audience size"}},"description":"Total estimated audience size for the specified targeting criteria.","additionalProperties":false},"estimated_ad_impressions":{"type":"object","title":"EstimatedAdImpressions","properties":{"maximum":{"type":"integer","title":"Maximum","description":"Maximum estimated ad impressions"},"minimum":{"type":"integer","title":"Minimum","description":"Minimum estimated ad impressions"}},"description":"Estimated number of ad impressions for the campaign.","additionalProperties":false},"estimated_cost_per_click":{"type":"object","title":"EstimatedCostPerClick","properties":{"maximum":{"type":"number","title":"Maximum","description":"Maximum estimated CPC in USD"},"minimum":{"type":"number","title":"Minimum","description":"Minimum estimated CPC in USD"}},"description":"Estimated cost per click (CPC) for the ad campaign.","additionalProperties":false}},"description":"Audience estimation metrics for the ad campaign."},"title":"Result","description":"List of audience estimation results"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task result containing audience estimation data."},"title":"Tasks","description":"Array of task objects containing audience estimation results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_KW_GOOGLE_KW_FOR_KW_TASK","name":"Create Keywords Data Google Keywords For Keywords Task","description":"Tool 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":{"tasks":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateKwGoogleKwForKwTaskRequestItem","required":["keywords"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","keyword_research_batch_1"],"maxLength":255,"description":"Custom identifier for task tracking and grouping. Maximum 255 characters. Useful for organizing tasks in your system."},"sort_by":{"enum":["search_volume","relevance"],"type":"string","title":"SortBy","description":"Sort order for keyword results."},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","examples":[["seo","digital marketing"],["python programming","web development"]],"maxItems":200,"minItems":1,"description":"Array of keywords to analyze. Maximum 200 keywords per task. Use this to get keyword suggestions and metrics related to your seed keywords."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Use for simple task completion notifications."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback when task completes. Must be a valid URL. Use for asynchronous result delivery."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Search engine language code (e.g., 'en' for English). Use either language_code or language_name, not both."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Full search engine language name (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Search engine location code for geographic targeting (e.g., 2840 for United States). Use either location_code or location_name, not both. Omit for global results."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","Canada"],"description":"Full search engine location name for geographic targeting (e.g., 'United States'). Use either location_name or location_code, not both. Omit for global results."},"search_partners":{"type":"boolean","title":"Search Partners","description":"Set to true to include Google search partners results. Default is false. Search partners extend reach beyond Google search to partner sites."},"closely_variants":{"type":"boolean","title":"Closely Variants","description":"Set to true to show only highly relevant keyword results. Default is false. When true, filters results to closely related variants of your seed keywords."},"keywords_negative":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords Negative","examples":[["free","cheap"],["tutorial","guide"]],"maxItems":200,"description":"Array of negative keywords to exclude from results. Maximum 200 terms. Use this to filter out unwanted keyword suggestions."},"location_coordinate":{"type":"string","title":"Location Coordinate","examples":["40.7128,-74.0060","51.5074,-0.1278"],"description":"GPS coordinates in 'latitude,longitude' format for precise location targeting (e.g., '40.7128,-74.0060' for New York City)."}},"description":"Individual task item for Google Keywords For Keywords request.","requiredFields":"$17:props:tools:7:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using the task_get endpoint."},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"sort_by":{"type":"string","title":"Sort By","description":"Sort order from request"},"function":{"type":"string","title":"Function","description":"API function called"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"Keywords array from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Search partners flag from request"},"closely_variants":{"type":"boolean","title":"Closely Variants","description":"Closely variants flag from request"},"keywords_negative":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords Negative","description":"Negative keywords from request"},"location_coordinate":{"type":"string","title":"Location Coordinate","description":"GPS coordinates from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks using task_get endpoint)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully and queued for processing."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results later using the task_get endpoint, along with status and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","important","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_MERCHANT_AMAZON_SELLERS_TASK","name":"Create Merchant Amazon Sellers Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires asin and either location/language code or name.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateMerchantAmazonSellersTaskRequestItem","required":["asin"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","product_analysis","sellers_check"],"maxLength":255,"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"asin":{"type":"string","title":"Asin","examples":["B085RFFC9Q","B08N5WRWNW"],"description":"Unique product identifier on Amazon (ASIN). You must obtain this ASIN from the Amazon Products endpoint before creating a sellers task. Example: 'B085RFFC9Q'"},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"se_domain":{"type":"string","title":"Se Domain","examples":["amazon.com","amazon.co.uk","amazon.de"],"description":"Amazon search engine domain to use (e.g., 'amazon.com', 'amazon.co.uk'). If not specified, the domain will be automatically selected based on location settings."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback. Must be a valid URL. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id'). Requires postback_data parameter."},"language_code":{"type":"string","title":"Language Code","examples":["en_US","en_GB","de_DE"],"description":"Language code for the search results (e.g., 'en_US' for English United States). Use either language_code or language_name (only one required). See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English (United States)","English (United Kingdom)","German"],"description":"Full language name for the search results (e.g., 'English (United States)'). Use either language_name or language_code (only one required)."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826],"description":"Geographic location code for the search region (e.g., 2840 for United States). Use either location_code, location_name, or location_coordinate (only one required). See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","London,England,United Kingdom"],"description":"Full location name for the search region (e.g., 'United States' or 'London,England,United Kingdom'). Use either location_name, location_code, or location_coordinate (only one required)."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced","html"],"description":"Result format for postback callback. Required if postback_url is specified. Valid values: 'advanced' or 'html'."},"location_coordinate":{"type":"string","title":"Location Coordinate","examples":["40.7127753,-74.0059728,199.9","51.5073509,-0.1277583,200"],"description":"GPS coordinates for the search location in 'latitude,longitude,radius' format (max 7 decimal places, minimum radius 199.9). Use either location_coordinate, location_name, or location_code (only one required)."}},"description":"Individual task item for creating a Merchant Amazon Sellers task.","requiredFields":"$17:props:tools:8:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later within 7 days."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"asin":{"type":"string","title":"Asin","description":"Product ASIN from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"},"location_coordinate":{"type":"string","title":"Location Coordinate","description":"Location coordinates from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"null","title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","important","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_ON_PAGE_LIGHTHOUSE_TASK_POST","name":"Create On Page Lighthouse Task","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"url":{"type":"string","description":"Target page URL with absolute path including protocol (http:// or https://). Example: 'https://dataforseo.com'","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"audits":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"version":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"categories":{"type":"array","description":"Specific audit categories to run. Available options: 'seo', 'pwa', 'performance', 'best_practices', 'accessibility'. If not specified, all categories will be audited.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"for_mobile":{"type":"boolean","description":"Enable mobile device emulation for the audit. Set to true to test mobile version, false for desktop. Defaults to false if not specified.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"pingback_url":{"type":"string","description":"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'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"postback_url":{"type":"string","description":"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'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_code":{"type":"string","description":"Language code for the audit. Defaults to 'en' if not specified. Use the 'List On Page Lighthouse Languages' action to get available language codes.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Language name for the audit. Defaults to 'English' if not specified. Use the 'List On Page Lighthouse Languages' action to get available languages.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using 'Get On Page Lighthouse Task Get Json' action."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API type (e.g., 'on_page')"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the original request"},"url":{"type":"string","title":"Url","description":"Target page URL from the original request"},"audits":{"type":"array","items":{"type":"string","properties":{}},"title":"Audits","description":"Specific audits from the original request"},"version":{"type":"string","title":"Version","description":"Lighthouse version from the original request"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'task_post')"},"categories":{"type":"array","items":{"type":"string","properties":{}},"title":"Categories","description":"Audit categories from the original request"},"for_mobile":{"type":"boolean","title":"For Mobile","description":"Mobile emulation flag from the original request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from the original request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from the original request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"type":"string"}},"title":"Result","description":"Array of result objects. Will be null until task completes. Use 'List On Page Lighthouse Tasks Ready' to check completion status and 'Get On Page Lighthouse Task Get Json' to retrieve results."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (10000-60000 range). 20000 indicates successful task creation."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array. Will be null until task completes."},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing task creation results and metadata."},"title":"Tasks","description":"Array of task objects containing task creation results. The task ID can be used to retrieve results later."},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range). 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks processed"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_ON_PAGE_TASK_POST","name":"Create On Page Task","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"target":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"custom_js":{"type":"string","description":"Custom JavaScript code to execute on each page during crawling. Code should return a valid JavaScript object. Example: 'meta = {}; meta.url = document.URL; meta;'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"start_url":{"type":"string","description":"Specific URL to start crawling from. If not specified, crawling will start from the target domain's homepage. Must be within the target domain.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"enable_xhr":{"type":"boolean","description":"Enable capturing of XMLHttpRequest (XHR) data during crawling. Useful for analyzing AJAX requests and dynamic content loading.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"check_spell":{"type":"boolean","description":"Enable spell checking on page content. When enabled, spelling errors will be detected and reported.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"crawl_delay":{"type":"integer","description":"Delay in milliseconds between requests to avoid overloading the target server. Minimum value is 0.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"switch_pool":{"type":"boolean","description":"Switch to a different IP pool for requests. Can help avoid rate limiting or blocks from target websites.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"pingback_url":{"type":"string","description":"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'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"priority_urls":{"type":"array","description":"List of URLs to prioritize during crawling. These URLs will be crawled first before other discovered URLs.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"browser_preset":{"type":"string","description":"Browser configuration preset for rendering. Available presets define viewport size, user agent, and other browser settings.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"custom_sitemap":{"type":"string","description":"URL of a custom sitemap to use instead of auto-discovering the sitemap. Must be a valid sitemap URL.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"load_resources":{"type":"boolean","description":"Load external resources (CSS, JS, images) during crawling. Required for accurate page rendering and resource analysis.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"store_raw_html":{"type":"boolean","description":"Store raw HTML of crawled pages for later retrieval. Enabling this will increase storage costs but allows detailed page analysis.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"accept_language":{"type":"string","description":"Accept-Language header value for HTTP requests. Format: language codes with quality values (e.g., 'en-US,en;q=0.9').","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"max_crawl_depth":{"type":"integer","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"max_crawl_pages":{"type":"integer","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"respect_sitemap":{"type":"boolean","description":"Whether to respect and use the website's sitemap for crawling. If enabled, pages in the sitemap will be prioritized.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"support_cookies":{"type":"boolean","description":"Enable cookie support during crawling. Useful for sites that require cookies for proper functionality.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"allow_subdomains":{"type":"boolean","description":"Allow crawling of subdomains of the target domain. When enabled, links to subdomains will be followed.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"checks_threshold":{"type":"object","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"custom_robots_txt":{"type":"string","description":"Custom robots.txt content to use instead of fetching from the website. Useful for testing crawl behavior with different robots.txt rules.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"custom_user_agent":{"type":"string","description":"Custom User-Agent string for HTTP requests. If not specified, DataForSEO's default user agent will be used.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"enable_javascript":{"type":"boolean","description":"Enable JavaScript rendering during crawling. Required for crawling single-page applications and JavaScript-heavy sites.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"allowed_subdomains":{"type":"array","description":"Specific list of subdomains to allow during crawling. Only these subdomains will be crawled if encountered. Example: ['blog.example.com', 'shop.example.com']","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"crawl_sitemap_only":{"type":"boolean","description":"Only crawl pages listed in the sitemap. When enabled, the crawler will not follow links outside the sitemap.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"disable_page_checks":{"type":"array","description":"List of page-level checks to disable during crawling. Use to skip specific analysis metrics you don't need.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"browser_screen_width":{"type":"integer","description":"Browser viewport width in pixels for rendering. Default is typically 1920.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"check_spell_language":{"type":"string","description":"Language code for spell checking (e.g., 'en', 'es', 'fr'). Required if check_spell is enabled.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"disable_cookie_popup":{"type":"boolean","description":"Attempt to automatically dismiss cookie consent popups during crawling. Improves crawl accuracy by removing overlay elements.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"validate_micromarkup":{"type":"boolean","description":"Validate structured data and micromarkup (Schema.org, JSON-LD, etc.) on crawled pages. Checks for correct implementation of structured data.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"browser_screen_height":{"type":"integer","description":"Browser viewport height in pixels for rendering. Default is typically 1080.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"disallowed_subdomains":{"type":"array","description":"Specific list of subdomains to exclude from crawling. Links to these subdomains will be ignored.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"force_sitewide_checks":{"type":"boolean","description":"Force execution of site-wide checks even if the crawl doesn't complete all pages. Useful for getting partial results from large sites.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"robots_txt_merge_mode":{"type":"string","description":"How to merge custom robots.txt with the site's existing robots.txt. Options may include 'replace', 'merge', etc.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"check_spell_exceptions":{"type":"array","description":"List of words to exclude from spell checking. Useful for brand names, technical terms, etc. that may be flagged as misspelled.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"enable_content_parsing":{"type":"boolean","description":"Enable parsing and extraction of page content (headings, paragraphs, images, etc.). Required for detailed content analysis.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"return_despite_timeout":{"type":"boolean","description":"Return partial results even if the crawl times out before completion. Useful for large sites where complete crawl may take too long.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"disable_sitewide_checks":{"type":"array","description":"List of site-wide checks to disable. Site-wide checks analyze patterns across all crawled pages.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"enable_browser_rendering":{"type":"boolean","description":"Enable full browser rendering (headless browser) for crawling. Provides more accurate rendering of modern web pages but increases processing time.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"calculate_keyword_density":{"type":"boolean","description":"Calculate keyword density metrics for crawled pages. Useful for SEO analysis to understand keyword usage patterns.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"enable_www_redirect_check":{"type":"boolean","description":"Check if www and non-www versions of the site redirect correctly. Important for SEO to avoid duplicate content issues.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"browser_screen_scale_factor":{"type":"number","description":"Browser screen scale factor for high-DPI displays. Default is 1.0. Use 2.0 for retina displays.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using the On Page API endpoints."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API type (e.g., 'on_page')"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the original request"},"target":{"type":"string","title":"Target","description":"Target website from the original request"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'task_post')"},"start_url":{"type":"string","title":"Start Url","description":"Start URL from the original request"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum crawl pages from the original request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Array of result objects. Will be null until task completes. Use task ID to retrieve results when the crawl is finished."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (10000-60000 range). 20000 indicates successful task creation."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array. Will be null until task completes."},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing task creation results and metadata."},"title":"Tasks","description":"Array of task objects containing task creation results. The task ID can be used to retrieve results later."},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range). 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks processed"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","important","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_AUTOCOMPLETE_TASK","name":"Create SERP Google Autocomplete Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires keyword and optionally location/language parameters.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateSerpGoogleAutocompleteTaskRequestItem","required":["keyword"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","test_query","autocomplete_batch_1"],"maxLength":255,"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"client":{"enum":["chrome","chrome-omni","gws-wiz","gws-wiz-serp","safari","firefox","psy-ab","toolbar","youtube","gws-wiz-local","img","products-cc"],"type":"string","title":"Client","description":"Search client type for Google Autocomplete."},"keyword":{"type":"string","title":"Keyword","examples":["albert einstein","python programming","best restaurants"],"maxLength":700,"description":"Search query to get autocomplete suggestions for. Supports up to 700 characters with URL decoding. Required field."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback with gzip-compressed results. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id')."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Language code for the search engine (e.g., 'en' for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Language name for the search engine (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Geographic location code for the search engine (e.g., 2840 for United States). Use either location_code or location_name, not both. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","Australia"],"description":"Geographic location name for the search engine (e.g., 'United States'). Use either location_name or location_code, not both."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced"],"description":"Result format for postback callback. Required if postback_url is specified. Valid value: 'advanced'."},"cursor_pointer":{"type":"integer","title":"Cursor Pointer","minimum":0,"examples":[6,10,0],"description":"Horizontal cursor position in the search bar (0 to keyword length). Determines where the cursor would be when typing. Defaults to the final character position if not specified."}},"description":"Individual task item for creating a Google Autocomplete task.","requiredFields":"$17:props:tools:11:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"client":{"type":"string","title":"Client","description":"Client type from request"},"keyword":{"type":"string","title":"Keyword","description":"Keyword from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"},"cursor_pointer":{"type":"integer","title":"Cursor Pointer","description":"Cursor pointer position from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_EVENTS_TASK","name":"Create SERP Google Events Task","description":"Tool 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":{"tasks":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateSerpGoogleEventsTaskRequestItem","required":["keyword"],"properties":{"os":{"type":"string","title":"Os","examples":["windows","macos"],"description":"Operating system for the search context. Valid values: 'windows' or 'macos'. Desktop device only."},"tag":{"type":"string","title":"Tag","examples":["campaign_001","event_search_batch_1"],"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"depth":{"type":"integer","title":"Depth","examples":[10,50,100],"description":"Number of event results to retrieve. Default: 10, maximum: 700. Billing applies per 10 results (e.g., depth=11 charges for 20 results)."},"keyword":{"type":"string","title":"Keyword","examples":["albert einstein","concerts near me","art exhibitions"],"description":"Search term or query for finding events (maximum 700 characters). Special characters like '%' must be URL-encoded as '%25'. Example: 'albert einstein' or 'concerts in new york'."},"priority":{"type":"integer","title":"Priority","examples":[1,2],"description":"Task execution priority. 1 for normal priority (default), 2 for high priority. High priority tasks incur additional charges but process faster."},"se_domain":{"type":"string","title":"Se Domain","examples":["google.com","google.co.uk"],"description":"Search engine domain to use (e.g., 'google.com', 'google.co.uk'). If not specified, the domain is automatically selected based on location."},"date_range":{"type":"string","title":"Date Range","examples":["today","week","month"],"description":"Filter events by time period. Valid values: 'today', 'tomorrow', 'week', 'weekend', 'next_week', 'month', 'next_month'. If not specified, all upcoming events are returned."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. A GET request will be sent to this URL upon task completion."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback. Must be a valid URL. When task completes, gzip-compressed results will be posted to this endpoint."},"language_code":{"type":"string","title":"Language Code","examples":["en"],"description":"Language code for the event results (e.g., 'en' for English). Note: Google Events SERP API works for English language only. Use either language_code or language_name, not both."},"language_name":{"type":"string","title":"Language Name","examples":["English"],"description":"Language name for the event results (e.g., 'English'). Note: Google Events SERP API works for English language only. Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2276],"description":"Geographic location code for event search context (e.g., 2840 for United States). Use either location_code, location_name, or location_coordinate, not multiple. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","Germany"],"description":"Geographic location name for event search context (e.g., 'United States'). Use either location_name, location_code, or location_coordinate, not multiple."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced"],"description":"Result format for postback callback. Required if postback_url is specified. Currently only 'advanced' is supported."},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","examples":[10,50,100],"description":"Maximum number of pages to crawl for event data. Maximum value: 100."},"location_coordinate":{"type":"string","title":"Location Coordinate","examples":["40.7128,-74.0060,10","51.5074,-0.1278,5"],"description":"GPS coordinates for event search in format 'latitude,longitude,radius' where radius is in miles (e.g., '40.7128,-74.0060,10'). Use either location_coordinate, location_code, or location_name, not multiple."}},"description":"Individual task item for Google Events SERP request.","requiredFields":"$17:props:tools:12:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using the get task advanced endpoint."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"depth":{"type":"integer","title":"Depth","description":"Depth from request"},"device":{"type":"string","title":"Device","description":"Device type"},"keyword":{"type":"string","title":"Keyword","description":"Keyword from request"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"date_range":{"type":"string","title":"Date Range","description":"Date range from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Max crawl pages from request"},"location_coordinate":{"type":"string","title":"Location Coordinate","description":"Location coordinate from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_FINANCE_EXPLORE_TASK","name":"Create SERP Google Finance Explore Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires location and language parameters.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateSerpGoogleFinanceExploreTaskRequestItem","properties":{"os":{"type":"string","title":"Os","examples":["windows","macos","android","ios"],"description":"Operating system for the search. Options vary by device. For mobile: 'android', 'ios'. For desktop: 'windows', 'macos'. If not specified, defaults are used based on device."},"tag":{"type":"string","title":"Tag","examples":["campaign_001","finance_research","market_data_batch_1"],"maxLength":255,"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"device":{"type":"string","title":"Device","examples":["desktop","mobile","tablet"],"description":"Device type for the search. Options: 'desktop', 'mobile', 'tablet'. If not specified, defaults to 'desktop'."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"news_type":{"enum":["all_news","latest_news"],"type":"string","title":"NewsType","description":"News type filter for Google Finance Explore results."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback with gzip-compressed results. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id')."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Language code for the search engine (e.g., 'en' for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Language name for the search engine (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Geographic location code for the search engine (e.g., 2840 for United States). Use either location_code or location_name, not both. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","Australia"],"description":"Geographic location name for the search engine (e.g., 'United States'). Use either location_name or location_code, not both."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced"],"description":"Result format for postback callback. Required if postback_url is specified. Valid value: 'advanced'."}},"description":"Individual task item for creating a Google Finance Explore task."}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system from request"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"device":{"type":"string","title":"Device","description":"Device type from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"news_type":{"type":"integer","title":"News Type","description":"News type filter from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_LOCAL_FINDER_TASK","name":"Create SERP Google Local Finder Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateSerpGoogleLocalFinderTaskRequestItem","required":["keyword"],"properties":{"os":{"type":"string","title":"Os","examples":["windows","macos","android","ios"],"description":"Operating system for the search. For mobile: 'android' or 'ios'. For desktop: 'windows' or 'macos'. If not specified, defaults are used based on device."},"tag":{"type":"string","title":"Tag","examples":["campaign_001","local_search_batch","business_research"],"maxLength":255,"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"depth":{"type":"integer","title":"Depth","examples":[20,50,100],"description":"Number of results to return. Default: 20 for desktop, 10 for mobile. Maximum: 500 for desktop, 350 for mobile."},"device":{"type":"string","title":"Device","examples":["desktop","mobile"],"description":"Device type for the search. Options: 'desktop' or 'mobile'. If not specified, defaults to 'desktop'."},"keyword":{"type":"string","title":"Keyword","examples":["local nail services","coffee shop","italian restaurants"],"maxLength":700,"description":"Search query for local businesses or services. Maximum 700 characters. Examples: 'coffee shop near me', 'italian restaurants', 'dentist'."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"min_rating":{"type":"number","title":"Min Rating","maximum":4.5,"minimum":3.5,"examples":[3.5,4,4.5],"description":"Minimum rating filter for local businesses. Accepts values between 3.5 and 4.5 (e.g., 3.5, 4.0, 4.5)."},"time_filter":{"type":"string","title":"Time Filter","examples":["open_now","24_hours","monday","friday"],"description":"Filter by business open hours. Options: 'open_now' (currently open), '24_hours' (open 24 hours), or specific day names ('monday', 'tuesday', etc.)."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback with gzip-compressed results. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id')."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Language code for the search engine (e.g., 'en' for English). Use either language_code or language_name. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Language name for the search engine (e.g., 'English'). Use either language_name or language_code."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Geographic location code for the search engine (e.g., 2840 for United States). Use either location_code, location_name, or location_coordinate. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","New York,New York,United States"],"description":"Geographic location name for the search engine (e.g., 'United States', 'New York,New York,United States'). Use either location_name, location_code, or location_coordinate."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced","html"],"description":"Result format for postback callback. Required if postback_url is specified. Valid values: 'advanced' or 'html'."},"location_coordinate":{"type":"string","title":"Location Coordinate","examples":["40.7128,-74.0060,15","51.5074,-0.1278,12"],"description":"GPS coordinates in 'latitude,longitude,zoom' format. Zoom should be in range 0-21. Use either location_coordinate, location_code, or location_name. Example: '40.7128,-74.0060,15'."}},"description":"Individual task item for creating a Google Local Finder task.","requiredFields":"$17:props:tools:14:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system from request"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"depth":{"type":"integer","title":"Depth","description":"Number of results requested from request"},"device":{"type":"string","title":"Device","description":"Device type from request"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"min_rating":{"type":"number","title":"Min Rating","description":"Minimum rating filter from request"},"time_filter":{"type":"string","title":"Time Filter","description":"Time filter from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"},"location_coordinate":{"type":"string","title":"Location Coordinate","description":"GPS coordinates from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_MAPS_TASK","name":"Create SERP Google Maps Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires keyword (or url) and optionally location/language parameters.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateSerpGoogleMapsTaskRequestItem","required":["keyword"],"properties":{"os":{"enum":["windows","macos","android","ios"],"type":"string","title":"OSType","description":"Operating system types for search results."},"tag":{"type":"string","title":"Tag","examples":["campaign_001","maps_query","local_search_batch_1"],"maxLength":255,"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"url":{"type":"string","title":"Url","description":"Direct Google Maps search URL. Cannot be used together with keyword parameter. Use this to specify exact search parameters via URL."},"depth":{"type":"integer","title":"Depth","minimum":1,"examples":[10,20,50],"description":"Number of results to retrieve. Maximum value depends on the search type. Default is determined by the API."},"device":{"enum":["desktop","mobile"],"type":"string","title":"DeviceType","description":"Device types for Google Maps search results."},"keyword":{"type":"string","title":"Keyword","examples":["restaurants near me","coffee shops","hotels in New York"],"maxLength":700,"description":"Search query for Google Maps results. Required field. Supports up to 700 characters with URL encoding."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"se_domain":{"type":"string","title":"Se Domain","examples":["google.com","google.co.uk","google.de"],"description":"Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). If not specified, the API will use the default domain based on location."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback with gzip-compressed results. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id')."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Language code for the search results (e.g., 'en' for English). Use language_code or language_name (only one at a time). See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Language name for the search results (e.g., 'English'). Use language_code or language_name (only one at a time)."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Geographic location code for the search (e.g., 2840 for United States). Use location_code, location_name, or location_coordinate (only one at a time). See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","New York"],"description":"Geographic location name for the search (e.g., 'United States'). Use location_code, location_name, or location_coordinate (only one at a time)."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced","regular","html"],"description":"Result format for postback callback. Required if postback_url is specified. Valid values: 'regular', 'advanced', 'html'."},"search_places":{"type":"boolean","title":"Search Places","description":"Whether to search for places instead of businesses. Default is false."},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","minimum":1,"examples":[1,2,5],"description":"Maximum number of result pages to crawl. Default is 1."},"search_this_area":{"type":"boolean","title":"Search This Area","description":"Whether to limit search to a specific geographic area. Default is false."},"location_coordinate":{"type":"string","title":"Location Coordinate","examples":["40.7127837,-74.0059413","51.5074,-0.1278"],"description":"GPS coordinates for location targeting. Format: 'latitude,longitude' with max 7 decimal places (e.g., '40.7127837,-74.0059413'). Use location_code, location_name, or location_coordinate (only one at a time)."}},"description":"Individual task item for creating a Google Maps SERP task.","requiredFields":"$17:props:tools:15:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system from request"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"url":{"type":"string","title":"Url","description":"Direct URL from request"},"depth":{"type":"integer","title":"Depth","description":"Depth from request"},"device":{"type":"string","title":"Device","description":"Device type from request"},"keyword":{"type":"string","title":"Keyword","description":"Keyword from request"},"se_type":{"type":"string","title":"Se Type","description":"Search engine result type"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Priority","description":"Priority level from request (can be int or string)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"},"search_places":{"type":"boolean","title":"Search Places","description":"Search places flag from request"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum crawl pages from request"},"search_this_area":{"type":"boolean","title":"Search This Area","description":"Search this area flag from request"},"location_coordinate":{"type":"string","title":"Location Coordinate","description":"GPS coordinates from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_GOOGLE_ORGANIC_TASK_POST","name":"Create SERP Google Organic Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateSerpGoogleOrganicTaskPostRequestItem","properties":{"os":{"enum":["windows","macos","android","ios"],"type":"string","title":"OS","description":"Operating system for the search."},"tag":{"type":"string","title":"Tag","examples":["campaign_001","serp_analysis","competitor_research"],"maxLength":255,"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"url":{"type":"string","title":"Url","examples":["https://www.google.co.uk/search?q=albert%20einstein&hl=en&gl=GB"],"description":"Direct URL of a Google search results page. Required if 'keyword' is not specified. Use this to specify exact search parameters including location, language, and other search modifiers via the URL."},"depth":{"type":"integer","title":"Depth","maximum":700,"minimum":1,"examples":[10,50,100],"description":"Parsing depth - number of results to retrieve (default is 100, max is 700). Higher depths allow retrieving more search results but increase processing time and cost."},"device":{"enum":["desktop","mobile"],"type":"string","title":"Device","description":"Device type for the search."},"keyword":{"type":"string","title":"Keyword","examples":["artificial intelligence","best restaurants in london","python tutorial"],"maxLength":700,"description":"Search keyword to get organic results for. Required if 'url' is not specified. Supports up to 700 characters. You can use a keyword or provide a direct Google search URL."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"se_domain":{"type":"string","title":"Se Domain","examples":["google.com","google.co.uk","google.de"],"description":"Search engine domain to use (e.g., 'google.com', 'google.co.uk', 'google.de'). Defaults to google.com if not specified."},"match_type":{"enum":["exact","partial"],"type":"string","title":"MatchType","description":"Match type for target search mode."},"match_value":{"type":"string","title":"Match Value","examples":["example.com","https://www.example.com/page"],"description":"Value to match when using target_search_mode. The specific URL, domain, or text to look for in search results."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback?id=$id&tag=$tag"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback with gzip-compressed results. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables."},"search_param":{"type":"string","title":"Search Param","examples":["&tbs=qdr:d","&as_qdr=m"],"description":"Additional search parameters to append to the search URL. Allows customizing search with advanced Google parameters like date ranges, file types, etc."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Language code for the search engine (e.g., 'en' for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Language name for the search engine (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Geographic location code for the search engine (e.g., 2840 for United States). Use either location_code, location_name, or location_coordinate, not multiple. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","Australia"],"description":"Geographic location name for the search engine (e.g., 'United States'). Use either location_name, location_code, or location_coordinate, not multiple."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced","html"],"description":"Result format for postback callback. Required if postback_url is specified. Valid values: 'advanced', 'html'."},"find_targets_in":{"type":"array","items":{"type":"string","properties":{}},"title":"Find Targets In","examples":[["organic","featured_snippet"],["local_pack"]],"description":"List of result types to search for target matches in. Limits target search to specific SERP element types."},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","minimum":1,"examples":[1,5,10],"description":"Maximum number of search result pages to crawl. Allows retrieving results beyond the first page. Each page typically contains 10 results."},"remove_from_url":{"type":"array","items":{"type":"string","properties":{}},"title":"Remove From Url","examples":[["utm_source","utm_campaign"],["ref","fbclid"]],"description":"List of URL parameters to remove from result URLs. Useful for cleaning tracking parameters like 'utm_source', 'utm_campaign', etc."},"ignore_targets_in":{"type":"array","items":{"type":"string","properties":{}},"title":"Ignore Targets In","examples":[["ads","shopping"]],"description":"List of result types to exclude when searching for targets. Prevents matching in specified SERP element types."},"expand_ai_overview":{"type":"boolean","title":"Expand Ai Overview","description":"Expand AI Overview (formerly SGE - Search Generative Experience) sections in search results to retrieve full content. Applies to Google's AI-generated overview boxes."},"target_search_mode":{"enum":["standard","deep"],"type":"string","title":"TargetSearchMode","description":"Target search mode for finding specific results."},"location_coordinate":{"type":"string","title":"Location Coordinate","examples":["52.6178,-155.9852,1000"],"description":"GPS coordinates for location targeting in 'latitude,longitude,radius' format. Radius is in meters. Use either location_coordinate, location_code, or location_name, not multiple."},"stop_crawl_on_match":{"type":"array","items":{"type":"string","properties":{}},"title":"Stop Crawl On Match","description":"Stop crawling when specified conditions are met. List of match conditions that trigger crawl termination."},"browser_screen_width":{"type":"integer","title":"Browser Screen Width","minimum":0,"examples":[1920,1366,375],"description":"Browser viewport width in pixels. Only used when calculate_rectangles is enabled."},"calculate_rectangles":{"type":"boolean","title":"Calculate Rectangles","description":"Calculate pixel positions and dimensions of elements in search results. Useful for visual analysis of SERP layout."},"browser_screen_height":{"type":"integer","title":"Browser Screen Height","minimum":0,"examples":[1080,768,667],"description":"Browser viewport height in pixels. Only used when calculate_rectangles is enabled."},"group_organic_results":{"type":"boolean","title":"Group Organic Results","description":"Group organic results from the same domain. When enabled, multiple results from the same website will be grouped together in the response."},"load_async_ai_overview":{"type":"boolean","title":"Load Async Ai Overview","description":"Load asynchronously generated AI Overview content. Enables fetching AI-generated content that loads after initial page render."},"people_also_ask_click_depth":{"type":"integer","title":"People Also Ask Click Depth","minimum":0,"examples":[1,2,3],"description":"Number of times to click 'People Also Ask' accordion to reveal more questions. Each click reveals additional questions. Max value depends on available questions."},"browser_screen_resolution_ratio":{"type":"integer","title":"Browser Screen Resolution Ratio","minimum":1,"examples":[1,2],"description":"Browser screen resolution ratio for high-DPI displays. Default is 1. Use 2 for retina displays. Only used when calculate_rectangles is enabled."}},"description":"Individual task item for creating a Google Organic SERP task."}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using 'Get SERP Google Organic Task' actions."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system from request"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"url":{"type":"string","title":"Url","description":"URL from request"},"depth":{"type":"integer","title":"Depth","description":"Parsing depth from request"},"device":{"type":"string","title":"Device","description":"Device type from request"},"keyword":{"type":"string","title":"Keyword","description":"Keyword from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"},"location_coordinate":{"type":"string","title":"Location Coordinate","description":"Location coordinate from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information. Use task IDs with 'List SERP Google Organic Tasks Ready' to check completion status."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","important","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_SEZNAM_ORGANIC_TASK","name":"Create SERP Seznam Organic Task","description":"Tool 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.","input_parameters":{"os":{"type":"string","description":"Operating system for the search. Default depends on the device type selected.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"tag":{"type":"string","description":"User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"url":{"type":"string","description":"Direct Seznam search URL with exact language/location parameters. Cannot be used with keyword parameter.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"depth":{"type":"integer","description":"Number of results to return in SERP. Default is 10, maximum is 700.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"device":{"type":"string","description":"Device type for the search: 'desktop', 'mobile', or 'tablet'. Default is 'desktop'.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"keyword":{"type":"string","description":"Search query keyword (up to 700 characters). Use %25 for '%' and %2B for '+' in the query string. Required if url parameter is not specified.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"priority":{"type":"integer","description":"Task execution priority: 1 for normal speed (default), 2 for high priority (higher charges apply). Higher priority tasks are processed faster.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"se_domain":{"type":"string","description":"Search engine domain to use for the search. Default is 'search.seznam.cz'.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"pingback_url":{"type":"string","description":"URL for GET notification when task completes. Supports variables: $id (task ID) and $tag (user-defined tag).","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"postback_url":{"type":"string","description":"URL for POST notification with results when task completes. Supports variables: $id (task ID) and $tag (user-defined tag).","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"search_param":{"type":"string","description":"Additional Seznam-specific search parameters or query modifiers to customize the search.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_code":{"type":"string","description":"Language code (e.g., 'cs'). Required if language_name is not specified. Use 'List SERP Seznam Languages' action to get available language codes.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Full language name (e.g., 'Czech'). Required if language_code is not specified. Use 'List SERP Seznam Languages' action to get available languages.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"Location identifier code. Required if location_name is not specified. Use 'List SERP Seznam Locations' action to get available location codes.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Full name of the search engine location. Required if location_code is not specified. Use 'List SERP Seznam Locations' action to get available locations.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"postback_data":{"type":"string","description":"Data type for postback results: 'regular', 'advanced', or 'html'. Required if postback_url is specified.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"max_crawl_pages":{"type":"integer","description":"Maximum number of pages to crawl. Default is 1, maximum is 100.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"stop_crawl_on_match":{"type":"array","description":"Array of match criteria to stop crawling (maximum 10 objects). When any criterion is met, crawling stops immediately.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"object","title":"StopCrawlMatch","properties":{"match_type":{"type":"string","title":"Match Type","examples":["title","url","description"],"description":"Type of match to apply: 'title', 'url', or 'description'"},"match_value":{"type":"string","title":"Match Value","examples":["example.cz","Albert Einstein"],"description":"Value to match against the specified match_type"}},"description":"Match criteria for stopping the crawl operation."}},"calculate_rectangles":{"type":"boolean","description":"Enable calculation of pixel rectangles for SERP elements. Adds a small additional cost per task. Default is false.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using 'Get SERP Seznam Organic Task Advanced' action."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system from the original request"},"se":{"type":"string","title":"Se","description":"Search engine identifier (e.g., 'seznam')"},"api":{"type":"string","title":"Api","description":"API type (e.g., 'serp')"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the original request"},"url":{"type":"string","title":"Url","description":"URL from the original request"},"depth":{"type":"integer","title":"Depth","description":"Depth from the original request"},"device":{"type":"string","title":"Device","description":"Device type from the original request"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword from the original request"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type (e.g., 'organic')"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'task_post')"},"priority":{"type":"integer","title":"Priority","description":"Priority from the original request"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain from the original request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from the original request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from the original request"},"search_param":{"type":"string","title":"Search Param","description":"Search parameters from the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from the original request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from the original request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data type from the original request"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Max crawl pages from the original request"},"stop_crawl_on_match":{"type":"array","items":{"type":"object","title":"StopCrawlMatch","properties":{"match_type":{"type":"string","title":"Match Type","examples":["title","url","description"],"description":"Type of match to apply: 'title', 'url', or 'description'"},"match_value":{"type":"string","title":"Match Value","examples":["example.cz","Albert Einstein"],"description":"Value to match against the specified match_type"}},"description":"Match criteria for stopping the crawl operation."},"title":"Stop Crawl On Match","description":"Stop crawl criteria from the original request"},"calculate_rectangles":{"type":"boolean","title":"Calculate Rectangles","description":"Calculate rectangles flag from the original request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"ResultItem","properties":{},"description":"Generic result item structure. Will be null for task_post responses.","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}},"title":"Result","description":"Array of result objects. Will be null until task completes. Use 'List SERP Seznam Organic Ready Tasks' to check completion status and 'Get SERP Seznam Organic Task Advanced' to retrieve results."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (10000-60000 range). 20000 indicates successful task creation."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array. Will be null until task completes."},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing task creation results and metadata."},"title":"Tasks","description":"Array of task objects containing task creation results. The task ID can be used to retrieve results later."},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range). 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks processed"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_YOUTUBE_VIDEO_COMMENTS_TASK","name":"Create YouTube Video Comments Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be created. Maximum 100 tasks per request. Each task requires video_id and optionally location/language parameters.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateSerpYoutubeVideoCommentsTaskRequestItem","required":["video_id"],"properties":{"os":{"type":"string","title":"Os","examples":["windows","macos","android","ios"],"description":"Operating system for the search. For mobile: 'android' or 'ios'. For desktop: 'windows' or 'macos'. If not specified, defaults are used based on device."},"tag":{"type":"string","title":"Tag","examples":["campaign_001","youtube_analysis","comment_batch_1"],"maxLength":255,"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"depth":{"type":"integer","title":"Depth","minimum":1,"examples":[20,50,100],"description":"Number of comments to retrieve from the video. If not specified, returns the default amount (typically top 20 comments)."},"device":{"type":"string","title":"Device","examples":["desktop","mobile"],"description":"Device type for the search. Options: 'desktop' or 'mobile'. If not specified, defaults to 'desktop'."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"video_id":{"type":"string","title":"Video Id","examples":["vQXvyV0zIP4","dQw4w9WgXcQ","jNQXAC9IVRw"],"maxLength":11,"minLength":11,"description":"YouTube video identifier for which to retrieve comments. The 11-character ID from the video URL (e.g., 'vQXvyV0zIP4' from youtube.com/watch?v=vQXvyV0zIP4). Required field."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback/dataforseo"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback with gzip-compressed results. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables (e.g., 'https://example.com/webhook?id=$id')."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Language code for the search engine (e.g., 'en' for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Language name for the search engine (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Geographic location code for the search engine (e.g., 2840 for United States). Use either location_code or location_name, not both. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","Australia"],"description":"Geographic location name for the search engine (e.g., 'United States'). Use either location_name or location_code, not both."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced"],"description":"Result format for postback callback. Required if postback_url is specified. Valid value: 'advanced'."}},"description":"Individual task item for creating a YouTube Video Comments task.","requiredFields":"$17:props:tools:18:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system from request"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"depth":{"type":"integer","title":"Depth","description":"Number of comments requested from request"},"device":{"type":"string","title":"Device","description":"Device type from request"},"se_type":{"type":"string","title":"Se Type","description":"Search engine result type"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"video_id":{"type":"string","title":"Video Id","description":"Video ID from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_CREATE_SERP_YOUTUBE_VIDEO_SUBTITLES_TASK","name":"Create SERP YouTube Video Subtitles Task","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"CreateSerpYoutubeVideoSubtitlesTaskRequestItem","required":["video_id"],"properties":{"os":{"type":"string","title":"Os","examples":["windows","macos","android","ios"],"description":"Operating system for the search. Used in combination with device parameter to simulate specific device/OS combinations."},"tag":{"type":"string","title":"Tag","examples":["video_analysis_001","subtitle_extraction","translation_task"],"maxLength":255,"description":"Custom identifier for task tracking. Maximum 255 characters. Useful for grouping or identifying tasks in your system."},"device":{"type":"string","title":"Device","examples":["desktop","mobile"],"description":"Device type for the search. Determines whether to get desktop or mobile search results. Defaults to desktop if not specified."},"priority":{"enum":["normal","high"],"type":"string","title":"Priority","description":"Priority level for task execution."},"video_id":{"type":"string","title":"Video Id","examples":["Y8Wu4rSNJms","dQw4w9WgXcQ","jNQXAC9IVRw"],"description":"YouTube video identifier. The unique ID of the video to retrieve subtitles for (e.g., 'Y8Wu4rSNJms'). Found in the video URL after 'v='."},"pingback_url":{"type":"string","title":"Pingback Url","examples":["https://example.com/pingback?id=$id&tag=$tag"],"description":"URL endpoint for receiving GET notification when task completes. Must be a valid URL. Supports $id and $tag variables."},"postback_url":{"type":"string","title":"Postback Url","examples":["https://example.com/webhook/dataforseo"],"description":"URL endpoint for receiving task results via POST callback with gzip-compressed results. Must be a valid URL. Requires postback_data parameter. Supports $id and $tag variables."},"language_code":{"type":"string","title":"Language Code","examples":["en","es","de","fr"],"description":"Language code for the search engine (e.g., 'en' for English). Use either language_code or language_name, not both. See DataForSEO languages list for valid codes."},"language_name":{"type":"string","title":"Language Name","examples":["English","Spanish","German","French"],"description":"Language name for the search engine (e.g., 'English'). Use either language_name or language_code, not both."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826,2036],"description":"Geographic location code for the search engine (e.g., 2840 for United States). Use either location_code or location_name, not both. See DataForSEO locations list for valid codes."},"location_name":{"type":"string","title":"Location Name","examples":["United States","United Kingdom","Australia"],"description":"Geographic location name for the search engine (e.g., 'United States'). Use either location_name or location_code, not both."},"postback_data":{"type":"string","title":"Postback Data","examples":["advanced"],"description":"Result format for postback callback. Required if postback_url is specified. Valid value: 'advanced'."},"subtitles_language":{"type":"string","title":"Subtitles Language","examples":["en","es","fr","de"],"description":"Language code of the subtitles to retrieve. If not specified, returns original video language subtitles. Use this to get subtitles in a specific language if available."},"subtitles_translate_language":{"type":"string","title":"Subtitles Translate Language","examples":["en","es","fr","de"],"description":"Language code to translate subtitles to. If specified, subtitles will be machine-translated to this language. Works with subtitles_language parameter."}},"description":"Individual task item for creating a YouTube Video Subtitles task.","requiredFields":"$17:props:tools:19:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format. Use this ID to retrieve task results later using 'Get SERP YouTube Video Subtitles Task Advanced By ID' action."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system from request"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"device":{"type":"string","title":"Device","description":"Device type from request"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"video_id":{"type":"string","title":"Video Id","description":"Video ID from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"},"subtitles_language":{"type":"string","title":"Subtitles Language","description":"Subtitles language from request"},"subtitles_translate_language":{"type":"string","title":"Subtitles Translate Language","description":"Translation language from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array (null for task_post, populated when retrieving completed tasks)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20100 indicates task created successfully, 20000 indicates completed task."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects (typically 0 for task_post)"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects. Each task contains an ID for retrieving results and cost information. Use task IDs with 'List SERP YouTube Video Subtitles Tasks Ready' to check completion status."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_FORCE_ON_PAGE_CRAWL","name":"Force Stop On Page Crawl","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to force stop. Each task requires the unique task ID of the crawl to terminate.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"ForceOnPageCrawlRequestItem","required":["id"],"properties":{"id":{"type":"string","title":"Id","examples":["08121600-1535-0216-0000-37b4c7a34453"],"description":"Unique task identifier in UUID format for the On Page crawl task to force stop. You can obtain task IDs from task creation responses or from the tasks_ready endpoint."}},"description":"Individual task item for force stopping an On Page crawl task.","requiredFields":"$17:props:tools:20:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for the operation"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format for the stopped task."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Task ID from request"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"function":{"type":"string","title":"Function","description":"API function called"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"title":"Result","description":"Result data array containing information about the stopped task"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates successful operation."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects returned"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects containing operation results and status information."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_KEYWORD_DATA_AVAILABLE_FILTERS","name":"Get AI Keyword Data Available Filters","description":"Tool 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).","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD."},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format."},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD."},"data":{"type":"object","title":"TaskData","properties":{},"description":"Represents task-level data in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"type":"object","additionalProperties":{"type":"string"}}},"title":"Result","description":"Array containing filter definitions organized by endpoint. Each object maps endpoint names to field definitions, where field names map to their type indicators ('str' or 'num')."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status."}},"description":"Represents a single task in the response containing filter information."},"title":"Tasks","description":"Array of tasks containing filter definitions for different endpoints."},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API."},"status_code":{"type":"integer","title":"Status Code","description":"Response status code (e.g., 20000 for success)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_KEYWORD_DATA_LOCATIONS_AND_LANGUAGES","name":"Get AI Keyword Data Locations And Languages","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total tasks cost in USD (always 0 for this endpoint)"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"time":{"type":"string","title":"Time","description":"Execution time for this task"},"result":{"type":"array","items":{"type":"object","title":"LocationResult","properties":{"location_code":{"type":"integer","title":"Location Code","description":"Numeric location identifier code"},"location_name":{"type":"string","title":"Location Name","description":"Full location name (e.g., 'Albania', 'United States')"},"available_languages":{"type":"array","items":{"type":"object","title":"Language","properties":{"language_code":{"type":"string","title":"Language Code","description":"ISO 639-1 language code (e.g., 'sq', 'en')"},"language_name":{"type":"string","title":"Language Name","description":"Full name of the language (e.g., 'Albanian', 'English')"}},"description":"Language object with name and code."},"title":"Available Languages","description":"List of languages supported for this location"}},"description":"Location with available languages."},"title":"Result","description":"Array of location and language data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task status information message"}},"description":"Task result containing locations and languages data."},"title":"Tasks","description":"Array of task results containing locations and languages"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that returned with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_OPT_CHAT_GPT_LLM_SCRAPER_HTML_BY_ID","name":"Get AI Optimization Chat GPT LLM Scraper HTML by ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD."},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format."},"cost":{"type":"number","title":"Cost","description":"Task cost in USD."},"data":{"type":"object","title":"Data","description":"Original POST request parameters used to create the task.","additionalProperties":true},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components from the request."},"time":{"type":"string","title":"Time","description":"Execution time for this task in seconds."},"result":{"type":"array","items":{"type":"object","title":"HtmlResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlItem","properties":{"date":{"type":"string","title":"Date","description":"UTC timestamp when the page was scanned."},"html":{"type":"string","title":"Html","description":"Complete HTML page content retrieved from the target URL."},"page":{"type":"integer","title":"Page","description":"Serial page number of the result."}},"description":"Represents a single HTML page result."},"title":"Items","description":"Array of HTML page results."},"keyword":{"type":"string","title":"Keyword","description":"Decoded search keyword or URL from the original request."},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when the result was retrieved."},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the items array."},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request."},"location_code":{"type":"integer","title":"Location Code","description":"Location parameter from the original request."}},"description":"Represents a result object containing HTML page data."},"title":"Result","description":"Array of result objects containing HTML page data."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code."},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in the result array."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status."}},"description":"Represents a task object in the response."},"title":"Tasks","description":"Array of task objects containing results."},"version":{"type":"string","title":"Version","description":"Current API version."},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks returned with errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_OPT_CHAT_GPT_LLM_SCRAPER_TASK_ADV_BY_ID","name":"Get AI Optimization ChatGPT LLM Scraper Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID format)"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"ChatGptResultItem","properties":{"text":{"type":"string","title":"Text","description":"Element text content"},"type":{"type":"string","title":"Type","description":"Element type (chat_gpt_text, chat_gpt_table, chat_gpt_navigation_list, chat_gpt_images, chat_gpt_local_businesses, chat_gpt_products)"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"ChatGptImagesElement","properties":{"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt","default":null,"description":"Image alt text"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Relevant URL"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (chat_gpt_images_element)"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown","default":null,"description":"Markdown format"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"URL leading to image on original resource or DataForSEO storage"}},"description":"Individual image element."}},{"type":"array","items":{"type":"object","title":"ChatGptLocalBusinessesElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Business website URL"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (chat_gpt_local_businesses_element)"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","default":null,"description":"Business phone number"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Business name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Business domain name"},"rating":{"anyOf":[{"type":"object","title":"RatingInfo","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Rating type identifier"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","default":null,"description":"Rating value"},"rating_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating Max","default":null,"description":"Maximum possible rating"},"votes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes Count","default":null,"description":"Number of votes/reviews"}},"description":"Rating information for products or businesses."},{"type":"null"}],"default":null,"description":"Business rating information"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null,"description":"Business address"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":null,"description":"Business description"},"reviews_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews Count","default":null,"description":"Total number of reviews"}},"description":"Individual local business element."}},{"type":"array","items":{"type":"object","title":"ChatGptProductsElement","properties":{"tag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag","default":null,"description":"Product tag text"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Product result URL"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (chat_gpt_products_element)"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Product price"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Product name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Product result domain"},"images":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Images","default":null,"description":"Array of product image URLs"},"rating":{"anyOf":[{"type":"object","title":"RatingInfo","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Rating type identifier"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","default":null,"description":"Rating value"},"rating_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating Max","default":null,"description":"Maximum possible rating"},"votes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes Count","default":null,"description":"Number of votes/reviews"}},"description":"Rating information for products or businesses."},{"type":"null"}],"default":null,"description":"Product rating information"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","default":null,"description":"ISO currency code"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id","default":null,"description":"Product identifier"}},"description":"Individual product element."}}],"title":"Items","description":"Nested items for image, business, or product elements"},"table":{"type":"object","title":"TableStructure","properties":{"table_header":{"type":"array","items":{"type":"string","properties":{}},"title":"Table Header","description":"Table header columns"},"table_content":{"type":"array","items":{"type":"array","items":{"type":"string"},"properties":{}},"title":"Table Content","description":"Table content rows"}},"description":"Table structure for chat_gpt_table elements.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Element title (for navigation lists)"},"sources":{"type":"array","items":{"type":"object","title":"ChatGptSource","properties":{"url":{"type":"string","title":"Url","description":"Source URL"},"type":{"type":"string","title":"Type","description":"Element type (chat_gpt_source)"},"title":{"type":"string","title":"Title","description":"Source title"},"domain":{"type":"string","title":"Domain","description":"Source domain"},"snippet":{"type":"string","title":"Snippet","description":"Source description snippet"},"markdown":{"type":"string","title":"Markdown","description":"Markdown-formatted content"},"thumbnail":{"type":"string","title":"Thumbnail","description":"Source thumbnail URL"},"source_name":{"type":"string","title":"Source Name","description":"Source name identifier"},"publication_date":{"type":"string","title":"Publication Date","description":"Publication timestamp"}},"description":"Source citation from ChatGPT response."},"title":"Sources","description":"Associated source citations"},"markdown":{"type":"string","title":"Markdown","description":"Content formatted in markdown markup language"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position among elements of the same type"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position among all elements"},"brand_entities":{"type":"array","items":{"type":"object","title":"ChatGptBrandEntity","properties":{"type":{"type":"string","title":"Type","description":"Element type (chat_gpt_brand_entity)"},"urls":{"type":"array","items":{"type":"string","properties":{}},"title":"Urls","description":"URLs and domains relevant to brand"},"title":{"type":"string","title":"Title","description":"Brand name"},"category":{"type":"string","title":"Category","description":"Brand category classification"},"markdown":{"type":"string","title":"Markdown","description":"Brand name in markdown format"}},"description":"Brand entity mentioned in ChatGPT response."},"title":"Brand Entities","description":"Brand entities mentioned in element"}},"description":"Individual result item in ChatGPT response (supports multiple element types)."},"title":"Items","description":"Result elements with specific types"},"model":{"type":"string","title":"Model","description":"Model version used (e.g., gpt-4o)"},"keyword":{"type":"string","title":"Keyword","description":"Decoded search term from POST request"},"sources":{"type":"array","items":{"type":"object","title":"ChatGptSource","properties":{"url":{"type":"string","title":"Url","description":"Source URL"},"type":{"type":"string","title":"Type","description":"Element type (chat_gpt_source)"},"title":{"type":"string","title":"Title","description":"Source title"},"domain":{"type":"string","title":"Domain","description":"Source domain"},"snippet":{"type":"string","title":"Snippet","description":"Source description snippet"},"markdown":{"type":"string","title":"Markdown","description":"Markdown-formatted content"},"thumbnail":{"type":"string","title":"Thumbnail","description":"Source thumbnail URL"},"source_name":{"type":"string","title":"Source Name","description":"Source name identifier"},"publication_date":{"type":"string","title":"Publication Date","description":"Publication timestamp"}},"description":"Source citation from ChatGPT response."},"title":"Sources","description":"Cited or relied-upon sources"},"datetime":{"type":"string","title":"Datetime","description":"Result timestamp in UTC format"},"markdown":{"type":"string","title":"Markdown","description":"Complete content formatted in markdown markup language"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to search engine results verification"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of results present in items array"},"items_count":{"type":"integer","title":"Items Count","description":"Number of result items"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"brand_entities":{"type":"array","items":{"type":"object","title":"ChatGptBrandEntity","properties":{"type":{"type":"string","title":"Type","description":"Element type (chat_gpt_brand_entity)"},"urls":{"type":"array","items":{"type":"string","properties":{}},"title":"Urls","description":"URLs and domains relevant to brand"},"title":{"type":"string","title":"Title","description":"Brand name"},"category":{"type":"string","title":"Category","description":"Brand category classification"},"markdown":{"type":"string","title":"Markdown","description":"Brand name in markdown format"}},"description":"Brand entity mentioned in ChatGPT response."},"title":"Brand Entities","description":"Brand information mentioned in response"},"search_results":{"type":"array","items":{"type":"object","title":"ChatGptSearchResult","properties":{"url":{"type":"string","title":"Url","description":"Result URL"},"type":{"type":"string","title":"Type","description":"Element type (chatgpt_search_result)"},"title":{"type":"string","title":"Title","description":"Result title"},"domain":{"type":"string","title":"Domain","description":"Result domain"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation"},"description":{"type":"string","title":"Description","description":"Result description"}},"description":"Search result item from ChatGPT scraper."},"title":"Search Results","description":"Web search outputs retrieved by model"},"fan_out_queries":{"type":"array","items":{"type":"string","properties":{}},"title":"Fan Out Queries","description":"Related search queries for comprehensive response"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total search engine results count"}},"description":"Individual task result containing ChatGPT LLM scraper data."},"title":"Result","description":"Result objects array"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to error documentation for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_OPT_CHAT_GPT_LLM_SCRAPER_TASK_HTML","name":"Get AI Optimization LLM Scraper Task HTML","description":"Tool to retrieve HTML results from a DataForSEO AI Optimization LLM scraper task. Use when you need to fetch the HTML content from a previously created scraper task using its task ID.","input_parameters":{"id":{"type":"string","description":"Task ID obtained from task_post response. Format: UUID string (e.g., '02281836-1424-0626-0000-decbf70dfe55')","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Cost of the API request in credits"},"time":{"type":"string","title":"Time","description":"Time taken for the API request"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Task ID"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlItem","properties":{"date":{"type":"string","title":"Date","description":"Date of the result"},"html":{"type":"string","title":"Html","description":"HTML content of the scraped page"},"page":{"type":"integer","title":"Page","description":"Page number of the result"}},"description":"Individual HTML result item."},"title":"Items","description":"List of HTML items from the scraper task"},"keyword":{"type":"string","title":"Keyword","description":"Keyword used for the scraper task"},"datetime":{"type":"string","title":"Datetime","description":"Datetime when the task was completed"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code for the search"}},"description":"Result details for the LLM scraper task."},"title":"Result","description":"List of task results containing HTML data"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message for the task (e.g., 'Ok.')"}},"description":"Task data containing the original request parameters."},"title":"Tasks","description":"List of task data containing results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_OPT_GEMINI_LLM_SCRAPER_TASK_ADV","name":"Get AI Optimization Gemini LLM Scraper Task Advanced","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier (UUID) obtained from task_post or tasks_ready endpoint. Results accessible for 30 days after task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD"},"time":{"type":"string","title":"Time","description":"Execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID format)"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Request parameters echoed back","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution duration"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"ResultItem","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (gemini_text, gemini_table, gemini_images)"},"items":{"type":"array","items":{"type":"object","title":"GeminiImagesElement","properties":{"alt":{"type":"string","title":"Alt","description":"Image alt text description"},"url":{"type":"string","title":"Url","description":"Page URL containing the image"},"type":{"type":"string","title":"Type","description":"Element type, typically 'gemini_images_element'"},"markdown":{"type":"string","title":"Markdown","description":"Formatted image markup"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Individual image element within gemini_images item."},"title":"Items","description":"Image elements array (for gemini_images items)"},"table":{"type":"object","title":"GeminiTable","properties":{"table_header":{"type":"array","items":{"type":"string","properties":{}},"title":"Table Header","description":"Column headers array"},"table_content":{"type":"array","items":{"type":"array","items":{"type":"string"},"properties":{}},"title":"Table Content","description":"Row data arrays"}},"description":"Table structure container with headers and content rows.","additionalProperties":false},"sources":{"type":"array","items":{"type":"object","title":"GeminiSource","properties":{"url":{"type":"string","title":"Url","description":"Full source URL"},"type":{"type":"string","title":"Type","description":"Source type, typically 'gemini_source'"},"title":{"type":"string","title":"Title","description":"Source page title"},"domain":{"type":"string","title":"Domain","description":"Source domain name"},"snippet":{"type":"string","title":"Snippet","description":"Source description excerpt"},"markdown":{"type":"string","title":"Markdown","description":"Formatted source content"},"thumbnail":{"type":"string","title":"Thumbnail","description":"Favicon URL"},"source_name":{"type":"string","title":"Source Name","description":"Publication or site name"},"publication_date":{"type":"string","title":"Publication Date","description":"Publication timestamp"}},"description":"Source citation object containing origin information."},"title":"Sources","description":"Cited sources array (for text items)"},"markdown":{"type":"string","title":"Markdown","description":"Formatted content (markdown or markup)"},"rank_group":{"type":"integer","title":"Rank Group","description":"Group position within type"},"original_text":{"type":"string","title":"Original Text","description":"Unformatted text representation"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"}},"description":"Generic result item supporting multiple types (text, table, images)."},"title":"Items","description":"Detailed result elements array"},"model":{"type":"string","title":"Model","description":"Model version identifier"},"keyword":{"type":"string","title":"Keyword","description":"Search query (URL-decoded)"},"sources":{"type":"array","items":{"type":"object","title":"GeminiSource","properties":{"url":{"type":"string","title":"Url","description":"Full source URL"},"type":{"type":"string","title":"Type","description":"Source type, typically 'gemini_source'"},"title":{"type":"string","title":"Title","description":"Source page title"},"domain":{"type":"string","title":"Domain","description":"Source domain name"},"snippet":{"type":"string","title":"Snippet","description":"Source description excerpt"},"markdown":{"type":"string","title":"Markdown","description":"Formatted source content"},"thumbnail":{"type":"string","title":"Thumbnail","description":"Favicon URL"},"source_name":{"type":"string","title":"Source Name","description":"Publication or site name"},"publication_date":{"type":"string","title":"Publication Date","description":"Publication timestamp"}},"description":"Source citation object containing origin information."},"title":"Sources","description":"Source citations array"},"datetime":{"type":"string","title":"Datetime","description":"Timestamp in UTC format"},"markdown":{"type":"string","title":"Markdown","description":"Formatted response content"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Result element types present"},"items_count":{"type":"integer","title":"Items Count","description":"Count of result items"},"language_code":{"type":"string","title":"Language Code","description":"Language specification"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total search results count"}},"description":"Individual task result containing LLM scraper output."},"title":"Result","description":"Array of result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements"},"status_message":{"type":"string","title":"Status Message","description":"Task-specific informational message"}},"description":"Task object containing execution metadata and results."},"title":"Tasks","description":"Array of task objects with results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in response array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks returned with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_OPTIMIZATION_CHAT_GPT_LLM_RESPONSES_LIVE","name":"Get Live ChatGPT LLM Responses","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined identifier for tracking or organizing this request","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"top_p":{"type":"number","description":"Nucleus sampling parameter. Alternative to temperature. Model considers tokens with top_p probability mass","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"model_name":{"type":"string","description":"Name of the ChatGPT model to use (e.g., 'gpt-4o', 'gpt-4.1-mini'). If not specified, the default model will be used","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"web_search":{"type":"boolean","description":"Enable web search to augment the AI response with current information from the internet","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"temperature":{"type":"number","description":"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","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"user_prompt":{"type":"string","description":"The main prompt or question to send to the ChatGPT model","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"message_chain":{"type":"array","description":"Prior conversation history to provide context for the current prompt","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"object","title":"MessageChainItem","required":["message","role"],"properties":{"role":{"enum":["user","ai"],"type":"string","title":"Role","examples":["user"],"description":"Role of the message sender: 'user' for human messages, 'ai' for AI responses"},"message":{"type":"string","title":"Message","examples":["Hello, what's up?"],"description":"Message content from either user or AI in the conversation"}},"description":"Individual message in a conversation chain for context-aware AI responses.","requiredFields":"$17:props:tools:27:input_parameters:message_chain:items:required"}},"system_message":{"type":"string","description":"System-level instruction that sets the behavior or context for the AI model","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"web_search_city":{"type":"string","description":"City name to focus web search results for location-specific queries","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"force_web_search":{"type":"boolean","description":"Force web search even if the model determines it's not necessary","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"max_output_tokens":{"type":"integer","description":"Maximum number of tokens to generate in the response. Controls response length","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"web_search_country_iso_code":{"type":"string","description":"ISO country code (e.g., 'FR', 'US') to focus web search results","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of all tasks in the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of this specific task in USD"},"data":{"type":"object","title":"Data","description":"Echo of the original request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true},{"type":"null"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments used for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"ResponseItem","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (e.g., 'message')"},"sections":{"type":"array","items":{"type":"object","title":"Section","properties":{"text":{"type":"string","title":"Text","description":"AI-generated text content in this section"},"type":{"type":"string","title":"Type","description":"Section type identifier (e.g., 'text')"},"annotations":{"type":"array","items":{"type":"object","title":"Annotation","properties":{"url":{"type":"string","title":"Url","description":"URL of the source that was cited or quoted"},"title":{"type":"string","title":"Title","description":"Domain name or source title of the referenced content"}},"description":"Source reference annotation with URL and title from web search results."},"title":"Annotations","description":"Source references and citations for this section's content"}},"description":"Content section within a response item."},"title":"Sections","description":"Array of content sections making up this response item"}},"description":"Individual response item containing structured AI-generated content."},"title":"Items","description":"Array of response items containing the AI-generated content"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when the result was generated (format: YYYY-MM-DD HH:MM:SS +00:00)"},"model_name":{"type":"string","title":"Model Name","description":"Name of the ChatGPT model that generated this response"},"web_search":{"type":"boolean","title":"Web Search","description":"Indicates whether web search was enabled for this response"},"money_spent":{"type":"number","title":"Money Spent","description":"Cost of AI token usage in USD for this request"},"input_tokens":{"type":"integer","title":"Input Tokens","description":"Number of tokens processed in the input prompt and context"},"output_tokens":{"type":"integer","title":"Output Tokens","description":"Number of tokens generated in the AI response"}},"description":"Result object containing ChatGPT model response details and metadata."},"title":"Result","description":"Array of result objects containing AI responses and metadata"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 40200 for payment required)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task execution status"}},"description":"Task object containing execution details and results for a single request."},"title":"Tasks","description":"Array of task objects with execution details and AI responses"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range) indicating overall response status"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the overall API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_OPTIMIZATION_GEMINI_LLM_SCRAPER_HTML_BY_ID","name":"Get Gemini LLM Scraper HTML Results","description":"Retrieve 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request"},"time":{"type":"string","title":"Time","description":"Total execution time"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system used for the task"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"device":{"type":"string","title":"Device","description":"Device type used for the task"},"keyword":{"type":"string","title":"Keyword","description":"Keyword used for the task"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Task request data parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path used for the task"},"time":{"type":"string","title":"Time","description":"Execution time of the task"},"result":{"type":"array","items":{"type":"object","title":"ResultItem","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time of the result in UTC format"},"html":{"type":"string","title":"Html","description":"HTML content scraped from the page"},"page":{"type":"integer","title":"Page","description":"Page number of the result"}},"description":"Individual HTML result item containing page number and HTML content."},"title":"Items","description":"Array of HTML items containing page content"},"keyword":{"type":"string","title":"Keyword","description":"Target keyword for the scraping task"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was generated in UTC format"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code for the task"}},"description":"Result item containing HTML scraping results for a keyword."},"title":"Result","description":"Array of result items containing HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the task state"}},"description":"Individual task information with results."},"title":"Tasks","description":"Array of tasks with their results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the overall response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the overall response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_OPTIMIZATION_HTML_RESULT","name":"Get AI Optimization HTML Result","description":"Tool to retrieve AI optimization LLM scraper HTML results by task ID. Use when you need to fetch the HTML content scraped for ChatGPT/LLM optimization after creating a scraping task. The task ID must be obtained from the initial task creation POST request and used within 7 days.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format obtained from task creation. Must be used within 7 days of task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Request parameters echoed back from original POST request","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"AiOptimizationResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlItem","properties":{"date":{"type":"string","title":"Date","description":"UTC timestamp when HTML was scanned in format: YYYY-MM-DD HH:MM:SS +00:00"},"html":{"type":"string","title":"Html","description":"The actual HTML page content"},"page":{"type":"integer","title":"Page","description":"Serial number of returned HTML page"}},"description":"HTML page item containing scraped content."},"title":"Items","description":"Array of HTML page items containing scraped content"},"keyword":{"type":"string","title":"Keyword","description":"Decoded search keyword from POST request"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when result was received in format: YYYY-MM-DD HH:MM:SS +00:00"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in items array"},"language_code":{"type":"string","title":"Language Code","description":"Language code from POST request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from POST request"}},"description":"Result object containing HTML scraping results."},"title":"Result","description":"Array of result objects containing HTML scraping data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. Values range from 10000-60000. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task-specific informational message"}},"description":"Task object containing execution details and results."},"title":"Tasks","description":"Array of task objects containing execution details and results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code. 20000 indicates successful completion."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks returned with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_AI_OPTIMIZATION_LLM_MENTIONS_TOP_DOMAINS_LIVE","name":"Get AI Optimization LLM Mentions Top Domains Live","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined tag for request tracking. Maximum 255 characters.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"domain":{"type":"string","description":"Specific domain to filter results by.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"target":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"TargetItem","required":["keyword"],"properties":{"keyword":{"type":"string","title":"Keyword","examples":["bmw","auto"],"description":"Keyword or phrase to search for in LLM responses. Maximum 2000 characters."},"match_type":{"enum":["exact_match","partial_match"],"type":"string","title":"Match Type","examples":["partial_match"],"description":"Type of keyword matching: 'exact_match' requires exact keyword appearance, 'partial_match' finds keywords as part of other words. Defaults to 'exact_match' if not specified."},"search_scope":{"type":"array","items":{"enum":["question","answer"],"type":"string","properties":{}},"title":"Search Scope","examples":[["answer"],["question","answer"]],"description":"Where to search for the keyword: 'question' searches in user prompts/questions, 'answer' searches in LLM responses/answers. If not specified, searches both question and answer."}},"description":"Target keyword with search scope for LLM mentions analysis.","requiredFields":"$17:props:tools:30:input_parameters:target:items:required"}},"keyword":{"type":"string","description":"Alternative single keyword parameter (deprecated, use target array instead).","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"platform":{"type":"string","description":"LLM platform to search: 'google' for Google AI Overview, 'chat_gpt' for ChatGPT responses.","default":"$undefined","example":"$undefined","enum":["google","chat_gpt"],"required":true},"links_scope":{"type":"string","description":"Scope of links to include: 'sources' for source citations only, 'related_links' for related links only, 'all_links' for both sources and related links.","default":"$undefined","example":"$undefined","enum":["sources","related_links","all_links"],"required":false},"language_code":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Language name for the search (e.g., 'English'). Use either language_name or language_code, not both.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Geographic location name for the search context (e.g., 'United States'). Use either location_name or location_code, not both.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"search_filter":{"type":"string","description":"Advanced search filter expression to apply to results. Uses DataForSEO filter syntax.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"items_list_limit":{"type":"integer","description":"Maximum number of top domains to return. Limits the total number of domains in the result.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"include_subdomains":{"type":"boolean","description":"Whether to include subdomains when filtering by domain.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"internal_list_limit":{"type":"integer","description":"Maximum number of internal items to return per domain. Limits the detail level for each domain's mentions.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"initial_dataset_filters":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]},"properties":{}}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"domain":{"type":"string","title":"Domain","description":"Domain from request"},"target":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"title":"Target","description":"Target keywords from request"},"keyword":{"type":"string","title":"Keyword","description":"Keyword from request"},"function":{"type":"string","title":"Function","description":"API function called"},"platform":{"type":"string","title":"Platform","description":"Platform from request"},"links_scope":{"type":"string","title":"Links Scope","description":"Links scope from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"search_filter":{"type":"string","title":"Search Filter","description":"Search filter from request"},"items_list_limit":{"type":"integer","title":"Items List Limit","description":"Items list limit from request"},"include_subdomains":{"type":"boolean","title":"Include Subdomains","description":"Include subdomains flag from request"},"internal_list_limit":{"type":"integer","title":"Internal List Limit","description":"Internal list limit from request"},"initial_dataset_filters":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]},"properties":{}},"title":"Initial Dataset Filters","description":"Initial dataset filters from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"DomainResult","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (e.g., 'llm_mentions_domain_item')"},"items":{"type":"array","items":{"type":"object","title":"MentionItem","properties":{"url":{"type":"string","title":"Url","description":"The specific URL that was mentioned or cited"},"type":{"type":"string","title":"Type","description":"Element type identifier for this mention"},"answer":{"type":"string","title":"Answer","description":"The LLM's answer or response containing the mention"},"domain":{"type":"string","title":"Domain","description":"The domain that was mentioned in the response"},"keyword":{"type":"string","title":"Keyword","description":"The keyword that was mentioned"},"question":{"type":"string","title":"Question","description":"The user question or prompt that triggered this mention"},"link_type":{"type":"string","title":"Link Type","description":"Type of link mention (e.g., 'source', 'related_link')"},"ai_search_volume":{"type":"integer","title":"Ai Search Volume","description":"Estimated search volume for AI-related queries"},"last_response_at":{"type":"string","title":"Last Response At","description":"Timestamp of the most recent response containing this mention (ISO format)"},"first_response_at":{"type":"string","title":"First Response At","description":"Timestamp of the first response containing this mention (ISO format)"}},"description":"Individual mention item within a domain's results."},"title":"Items","description":"Array of individual mention items for this domain (limited by internal_list_limit parameter)"},"domain":{"type":"string","title":"Domain","description":"The domain being reported on"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position among all results"},"total_mentions":{"type":"integer","title":"Total Mentions","description":"Total number of mentions for this domain across all keywords"},"last_response_at":{"type":"string","title":"Last Response At","description":"Timestamp of the most recent mention for this domain (ISO format)"},"first_response_at":{"type":"string","title":"First Response At","description":"Timestamp of the earliest mention for this domain (ISO format)"},"total_ai_search_volume":{"type":"integer","title":"Total Ai Search Volume","description":"Aggregated AI search volume for all mentions of this domain"}},"description":"Domain-level aggregated LLM mentions result."},"title":"Items","description":"Array of domain results sorted by mention frequency or relevance"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when results were retrieved (format: YYYY-MM-DD HH:MM:SS +00:00)"},"platform":{"type":"string","title":"Platform","description":"Platform that was searched (google or chat_gpt)"},"items_count":{"type":"integer","title":"Items Count","description":"Total number of domain items returned"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the request"}},"description":"Result object containing aggregated top domains data."},"title":"Result","description":"Array of result objects with top domains data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success, 40200 indicates payment required, other codes indicate errors or processing status."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects containing top domains results and metadata"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_DATA_APPLE_APP_LIST_TASK_ADVANCED","name":"Get Apple App List Task Results","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"function":{"type":"string","title":"Function","description":"API function called"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"},"app_collection":{"type":"string","title":"App Collection","description":"App collection type requested (e.g., 'top_free_ios')"}},"description":"Original task parameters from the POST request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"AppItem","properties":{"url":{"type":"string","title":"Url","description":"App Store page URL"},"icon":{"type":"string","title":"Icon","description":"App icon image URL"},"type":{"type":"string","title":"Type","description":"Result type (typically 'app_store_search_organic')"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price amount"},"regular":{"type":"number","title":"Regular","description":"Regular price (null if no discount)"},"currency":{"type":"string","title":"Currency","description":"ISO currency code (e.g., USD)"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in range (null if not a price range)"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether the price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Raw price string as displayed in App Store"}},"description":"Price information for an app.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"App title/name"},"app_id":{"type":"string","title":"App Id","description":"Unique application identifier"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes/reviews for this rating"}},"description":"Rating information for an app.","additionalProperties":false},"is_free":{"type":"boolean","title":"Is Free","description":"Whether the app is free"},"position":{"type":"string","title":"Position","description":"Position alignment (e.g., 'left')"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all results"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews"}},"description":"Individual app result from the App Store search."},"title":"Items","description":"List of app results from the App Store"},"keyword":{"type":"string","title":"Keyword","description":"App collection keyword from the original request"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when results were retrieved"},"check_url":{"type":"string","title":"Check Url","description":"URL to check the results directly (typically null)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of app items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original request"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results available"}},"description":"Result object containing app list data."},"title":"Result","description":"Array of result objects with app data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (10000-60000 range). 20000 means OK, 40000+ indicates task in queue or processing."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects with results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 = success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_DATA_APPLE_APP_SEARCHES_TASK_ADVANCED","name":"Get Apple App Searches Task Advanced","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in API credits."},"time":{"type":"string","title":"Time","description":"Total time taken for the request (e.g., '0.1234 seconds')."},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier."},"cost":{"type":"number","title":"Cost","description":"Cost of the task in API credits."},"data":{"type":"object","title":"TaskData","properties":{"keyword":{"type":"string","title":"Keyword","description":"Search keyword that was submitted in the task."},"api_version":{"type":"string","title":"Api Version","description":"API version used for the request."},"language_code":{"type":"string","title":"Language Code","description":"Language code that was submitted in the task."},"location_code":{"type":"integer","title":"Location Code","description":"Location code that was submitted in the task."}},"description":"Data associated with the task request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments for the task."},"time":{"type":"string","title":"Time","description":"Execution time for the task (e.g., '0.1234 seconds')."},"result":{"type":"array","items":{"type":"object","title":"AppSearchResult","properties":{"items":{"type":"array","items":{"type":"object","title":"AppSearchItem","properties":{"url":{"type":"string","title":"Url","description":"URL to the app's page in the App Store."},"icon":{"type":"string","title":"Icon","description":"URL of the app's icon image."},"type":{"type":"string","title":"Type","description":"Type of the result item (e.g., 'app_data_apple_app_searches_item')."},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price of the app."},"regular":{"type":"number","title":"Regular","description":"Regular price of the app (before any discount)."},"currency":{"type":"string","title":"Currency","description":"Currency code (e.g., 'USD', 'EUR')."},"max_value":{"type":"number","title":"Max Value","description":"Maximum price value."},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether the price is a range."},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed in the app store."}},"description":"Price information for an app.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Title of the app."},"app_id":{"type":"string","title":"App Id","description":"Unique identifier of the app."},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value."},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum possible rating value."},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating (e.g., 'Max5')."},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes for this rating."}},"description":"Rating information for an app.","additionalProperties":false},"is_free":{"type":"boolean","title":"Is Free","description":"Whether the app is free to download."},"position":{"type":"string","title":"Position","description":"Position of the result on the page."},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of similar rank results."},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute rank position in search results."},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Number of user reviews for the app."}},"description":"Individual app search result item."},"title":"Items","description":"List of app search result items."},"keyword":{"type":"string","title":"Keyword","description":"Search keyword used for the query."},"datetime":{"type":"string","title":"Datetime","description":"Timestamp when the search was performed (ISO 8601 format)."},"check_url":{"type":"string","title":"Check Url","description":"URL that was checked for results."},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (e.g., 'apps.apple.com')."},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this result set."},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search (e.g., 'en')."},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the search."},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results returned by the search engine."}},"description":"Result data for an Apple App Searches task."},"title":"Result","description":"List of result objects containing app search data."},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates success."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned."},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the task state."}},"description":"Individual task details in the response."},"title":"Tasks","description":"List of task objects containing results and metadata."},"version":{"type":"string","title":"Version","description":"API version number."},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors."},"status_message":{"type":"string","title":"Status Message","description":"Overall response status message."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_INFO_HTML_BY_ID","name":"Get App Data Google App Info HTML By ID","description":"Tool to retrieve raw HTML results for a Google Play app information task by ID. Use when you need to get the unprocessed HTML content of a Google Play Store app page after creating an app info task.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"HtmlTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"HtmlTaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the app page from Google Play Store"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"app_id":{"type":"string","title":"App Id","description":"Application ID specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the HTML task containing the HTML content."},"title":"Result","description":"Array of HTML task results containing the app HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Play app information"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_INFO_TASK_HTML_BY_ID","name":"Get App Data Google App Info Task HTML By ID","description":"Tool to retrieve HTML content for a Google Play app by task ID. Use when you need to get the raw HTML page data from Google Play Store for a previously submitted app info task. Results are available for 7 days after task posting.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Task ID in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD (charges apply only at task posting)"},"data":{"type":"object","title":"TaskRequestData","properties":{"os":{"type":"string","title":"Os","description":"Operating system"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"app_id":{"type":"string","title":"App Id","description":"Application ID"},"device":{"type":"string","title":"Device","description":"Device type"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"Function name"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"type":"object","title":"HtmlPageItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the page was scanned in UTC format"},"html":{"type":"string","title":"Html","description":"HTML content of the page from Google Play Store"},"page":{"type":"integer","title":"Page","description":"Page sequence number of the HTML result"}},"description":"Individual HTML page item containing page number, date, and HTML content."},"title":"Items","description":"Array of HTML page items containing the app's HTML content"},"app_id":{"type":"string","title":"App Id","description":"Application ID specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of HTML page items in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the Google App Info HTML task."},"title":"Result","description":"List of task results containing HTML content for the app"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message for the task"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of tasks containing HTML results for Google Play app pages"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code of the API response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_LIST_TASK_ADVANCED_BY_ID","name":"Get App Data Google App List Task Advanced By ID","description":"Tool 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).","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"API function called"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"},"app_collection":{"type":"string","title":"App Collection","description":"App collection type requested (e.g., 'top_free_android')"}},"description":"Original task parameters from the POST request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"AppItem","properties":{"url":{"type":"string","title":"Url","description":"Google Play Store page URL"},"icon":{"type":"string","title":"Icon","description":"App icon image URL"},"type":{"type":"string","title":"Type","description":"Result type (e.g., 'google_play_search_organic')"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price amount"},"regular":{"type":"number","title":"Regular","description":"Regular price (null if no discount)"},"currency":{"type":"string","title":"Currency","description":"ISO currency code (e.g., USD)"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in range (null if not a price range)"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether the price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Raw price string as displayed in Google Play Store"}},"description":"Price information for an app.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"App title/name"},"app_id":{"type":"string","title":"App Id","description":"Unique application identifier"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes/reviews for this rating"}},"description":"Rating information for an app.","additionalProperties":false},"is_free":{"type":"boolean","title":"Is Free","description":"Whether the app is free"},"installs":{"type":"string","title":"Installs","description":"Installation count range (e.g., '1,000,000+')"},"position":{"type":"string","title":"Position","description":"Position alignment (e.g., 'left')"},"developer":{"type":"string","title":"Developer","description":"Developer name"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"description":{"type":"string","title":"Description","description":"App description"},"developer_id":{"type":"string","title":"Developer Id","description":"Developer ID"},"developer_url":{"type":"string","title":"Developer Url","description":"URL to the developer's page"},"main_category":{"type":"string","title":"Main Category","description":"Main category of the app"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all results"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews"},"installs_count":{"type":"integer","title":"Installs Count","description":"Approximate number of installs"}},"description":"Individual app result from the Google Play Store app list."},"title":"Items","description":"List of app results from the Google Play Store"},"keyword":{"type":"string","title":"Keyword","description":"App collection keyword from the original request"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when results were retrieved"},"check_url":{"type":"string","title":"Check Url","description":"URL to check the results directly (typically null)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of app items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original request"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results available"}},"description":"Result object containing app list data."},"title":"Result","description":"Array of result objects with app data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (10000-60000 range). 20000 means OK, 40000+ indicates task in queue or processing."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects with results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 = success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_REVIEWS_TASK_HTML","name":"Get App Data Google App Reviews Task HTML","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Task ID in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD (charges apply only at task posting)"},"data":{"type":"object","title":"TaskRequestData","properties":{"os":{"type":"string","title":"Os","description":"Operating system"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"app_id":{"type":"string","title":"App Id","description":"Application ID"},"device":{"type":"string","title":"Device","description":"Device type"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"Function name"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"type":"object","title":"HtmlPageItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the page was scanned in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the app reviews page from Google Play Store"},"page":{"type":"integer","title":"Page","description":"Serial number of the HTML page"}},"description":"HTML page item containing the raw HTML content of app reviews."},"title":"Items","description":"Array of HTML page items containing the app reviews HTML content"},"app_id":{"type":"string","title":"App Id","description":"Application ID specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of HTML page items in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the Google App Reviews HTML task."},"title":"Result","description":"List of task results containing HTML content for app reviews"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message for the task"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of tasks containing HTML results for Google Play app reviews"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code of the API response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_SEARCHES_TASK_ADVANCED","name":"Get Google App Searches Task Advanced","description":"Tool to retrieve Google Play Store app search 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.","input_parameters":{"id":{"type":"string","description":"Task ID returned from POST /v3/app_data/google/app_searches/task_post endpoint. This is a two-step API where you first create a task and then retrieve results using this ID. Task ID is valid for 30 days.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in API credits."},"time":{"type":"string","title":"Time","description":"Total time taken for the request (e.g., '0.1234 seconds')."},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier."},"cost":{"type":"number","title":"Cost","description":"Cost of the task in API credits."},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system used for the search (e.g., 'android')."},"device":{"type":"string","title":"Device","description":"Device type used for the search (e.g., 'mobile', 'tablet')."},"keyword":{"type":"string","title":"Keyword","description":"Search keyword that was submitted in the task."},"api_version":{"type":"string","title":"Api Version","description":"API version used for the request."},"language_code":{"type":"string","title":"Language Code","description":"Language code that was submitted in the task."},"location_code":{"type":"integer","title":"Location Code","description":"Location code that was submitted in the task."}},"description":"Data associated with the task request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments for the task."},"time":{"type":"string","title":"Time","description":"Execution time for the task (e.g., '0.1234 seconds')."},"result":{"type":"array","items":{"type":"object","title":"AppSearchResult","properties":{"items":{"type":"array","items":{"type":"object","title":"AppSearchItem","properties":{"url":{"type":"string","title":"Url","description":"URL to the app's page in the Google Play Store."},"icon":{"type":"string","title":"Icon","description":"URL of the app's icon image."},"size":{"type":"string","title":"Size","description":"App size (e.g., '50M')."},"type":{"type":"string","title":"Type","description":"Type of the result item (e.g., 'app_data_google_app_searches_item')."},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price of the app."},"regular":{"type":"number","title":"Regular","description":"Regular price of the app (before any discount)."},"currency":{"type":"string","title":"Currency","description":"Currency code (e.g., 'USD', 'EUR')."},"max_value":{"type":"number","title":"Max Value","description":"Maximum price value."},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether the price is a range."},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed in the Google Play Store."}},"description":"Price information for an app.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Title of the app."},"app_id":{"type":"string","title":"App Id","description":"Unique identifier of the app in Google Play Store."},"images":{"type":"array","items":{"type":"string","properties":{}},"title":"Images","description":"List of screenshot image URLs."},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value."},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum possible rating value."},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating (e.g., 'Max5')."},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes for this rating."}},"description":"Rating information for an app.","additionalProperties":false},"videos":{"type":"array","items":{"type":"string","properties":{}},"title":"Videos","description":"List of promotional video URLs."},"is_free":{"type":"boolean","title":"Is Free","description":"Whether the app is free to download."},"version":{"type":"string","title":"Version","description":"Current version of the app."},"installs":{"type":"string","title":"Installs","description":"Installation count range (e.g., '10,000,000+')."},"position":{"type":"string","title":"Position","description":"Position of the result on the page."},"developer":{"type":"string","title":"Developer","description":"Name of the app developer."},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of similar rank results."},"description":{"type":"string","title":"Description","description":"Short description of the app."},"developer_id":{"type":"string","title":"Developer Id","description":"Unique identifier of the developer."},"update_notes":{"type":"string","title":"Update Notes","description":"Release notes for the latest update."},"developer_url":{"type":"string","title":"Developer Url","description":"URL to the developer's page in Google Play Store."},"main_category":{"type":"string","title":"Main Category","description":"Main category of the app in Google Play Store."},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute rank position in search results."},"released_date":{"type":"string","title":"Released Date","description":"Date when the app was first released."},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Number of user reviews for the app."},"installs_count":{"type":"integer","title":"Installs Count","description":"Approximate number of installs as an integer."},"developer_email":{"type":"string","title":"Developer Email","description":"Developer's contact email address."},"last_update_date":{"type":"string","title":"Last Update Date","description":"Date of the most recent update."},"developer_address":{"type":"string","title":"Developer Address","description":"Developer's physical address."},"developer_website":{"type":"string","title":"Developer Website","description":"Developer's website URL."},"minimum_os_version":{"type":"string","title":"Minimum Os Version","description":"Minimum Android OS version required."}},"description":"Individual app search result item from Google Play Store."},"title":"Items","description":"List of app search result items from Google Play Store."},"keyword":{"type":"string","title":"Keyword","description":"Search keyword used for the query."},"datetime":{"type":"string","title":"Datetime","description":"Timestamp when the search was performed (ISO 8601 format)."},"check_url":{"type":"string","title":"Check Url","description":"URL that was checked for results."},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (e.g., 'play.google.com')."},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this result set."},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search (e.g., 'en')."},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the search."},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results returned by Google Play."}},"description":"Result data for a Google App Searches task."},"title":"Result","description":"List of result objects containing app search data from Google Play Store."},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates success."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned."},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the task state."}},"description":"Individual task details in the response."},"title":"Tasks","description":"List of task objects containing results and metadata."},"version":{"type":"string","title":"Version","description":"API version number."},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors."},"status_message":{"type":"string","title":"Status Message","description":"Overall response status message."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_DATA_GOOGLE_APP_SEARCHES_TASK_HTML_BY_ID","name":"Get App Data Google App Searches HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"sandbox":{"type":"boolean","description":"Enable sandbox mode for testing without charges. When true, uses sandbox.dataforseo.com instead of api.dataforseo.com.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"HtmlTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":true},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"HtmlSearchResult","properties":{"type":{"type":"string","title":"Type","description":"Type of search results (e.g., organic)"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the search results page from Google Play Store"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword specified in the original request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request (e.g., play.google.com)"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the HTML task containing search results and HTML content."},"title":"Result","description":"Array of HTML search results containing the app search HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Play app search queries"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APPENDIX_ERRORS","name":"Get Appendix Errors","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD (typically 0 for this endpoint)"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD (typically 0 for this endpoint)"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API type (e.g., 'appendix')"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'errors')"}},"description":"Represents task metadata information.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"Path to the result in the API response"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"ErrorCode","required":["code","message"],"properties":{"code":{"type":"integer","title":"Code","description":"Numeric error code (range 10000-60000)"},"message":{"type":"string","title":"Message","description":"Human-readable error message describing the error condition"}},"description":"Represents a single DataForSEO API error code definition."},"title":"Result","description":"Array of error code definitions"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of error codes returned in this task"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Represents a task result containing error codes."},"title":"Tasks","description":"Array of task objects containing error code information"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Appendix"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APPENDIX_STATUS","name":"Get Appendix Status","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskData","properties":{},"description":"Represents request parameters used for the task.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"ApiStatusResult","properties":{"api":{"type":"string","title":"Api","description":"Name of the API (e.g., 'serp', 'keywords_data', 'dataforseo_labs', 'merchant', 'on_page', 'content_analysis', 'content_generation', 'business_data', 'backlinks', 'app_data', 'domain_analytics', 'ai_optimization')"},"status":{"type":"string","title":"Status","description":"Overall status of the API (e.g., 'ok', 'major_outage', 'partial_outage', 'long_response_time')"},"endpoints":{"type":"array","items":{"type":"object","title":"EndpointStatus","properties":{"status":{"type":"string","title":"Status","description":"Current operational status of the endpoint (e.g., 'ok', 'major_outage', 'partial_outage', 'long_response_time')"},"endpoint":{"type":"string","title":"Endpoint","description":"Type of endpoint (e.g., 'task_get', 'task_post', 'live', 'postback/pingback')"}},"description":"Represents the status of a specific endpoint within an API."},"title":"Endpoints","description":"List of endpoint statuses within this API. Null if no endpoint-level details are available."}},"description":"Represents the status information for a specific DataForSEO API."},"title":"Result","description":"Array of API status results showing current operational status of all DataForSEO APIs and their endpoints"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Represents a single task in the response containing status information."},"title":"Tasks","description":"Array of tasks containing status information for all DataForSEO APIs and endpoints"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"Response status code in range 10000-60000 (e.g., 20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","Appendix"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APPENDIX_USER_DATA","name":"Get Appendix User Data","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total tasks cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Parameters from GET request","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"UserDataResult","properties":{"login":{"type":"string","title":"Login","description":"Account login email address"},"money":{"type":"object","title":"MoneyInfo","properties":{"total":{"type":"number","title":"Total","description":"Total funds deposited into the account in USD"},"limits":{"type":"object","title":"MoneyLimitPeriod","properties":{"day":{"type":"object","title":"Day","description":"Daily spending limits organized by function","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}},"minute":{"type":"object","title":"Minute","description":"Per-minute spending limits organized by function","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}}},"description":"Represents spending limits for a specific time period.","additionalProperties":false},"balance":{"type":"number","title":"Balance","description":"Remaining account balance in USD"},"statistics":{"type":"object","title":"MoneyStatisticsPeriod","properties":{"day":{"type":"object","title":"Day","description":"Daily spending statistics with actual costs","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}},"minute":{"type":"object","title":"Minute","description":"Per-minute spending statistics with actual costs","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}}},"description":"Represents spending statistics for a specific time period.","additionalProperties":false}},"description":"Contains account balance and spending information.","additionalProperties":false},"price":{"type":"object","title":"Price","description":"Pricing structure organized by API name, function type, and priority level. Each entry contains cost_type (per_result or per_request) and cost in USD.","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}},"rates":{"type":"object","title":"RatesInfo","properties":{"limits":{"type":"object","title":"RatesLimitPeriod","properties":{"day":{"type":"object","title":"Day","description":"Daily rate limits organized by function name and type","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}},"minute":{"type":"object","title":"Minute","description":"Per-minute rate limits organized by function name and type","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}}},"description":"Represents rate limits for a specific time period (day or minute).","additionalProperties":false},"statistics":{"type":"object","title":"RatesStatisticsPeriod","properties":{"day":{"type":"object","title":"Day","description":"Daily rate usage statistics with actual call counts","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}},"minute":{"type":"object","title":"Minute","description":"Per-minute rate usage statistics with actual call counts","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}]}}},"description":"Represents rate usage statistics for a specific time period.","additionalProperties":false}},"description":"Contains API call rate limits and usage statistics.","additionalProperties":false},"timezone":{"type":"string","title":"Timezone","description":"User's configured timezone (e.g., 'America/New_York')"},"backlinks_subscription_expiry_date":{"type":"string","title":"Backlinks Subscription Expiry Date","description":"Expiration date of Backlinks API subscription in UTC format (null if no active subscription)"},"llm_mentions_subscription_expiry_date":{"type":"string","title":"Llm Mentions Subscription Expiry Date","description":"Expiration date of LLM Mentions API subscription in UTC format (null if no active subscription)"}},"description":"Contains detailed user account information including rates, money, and pricing."},"title":"Result","description":"Array containing user account information"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Represents a single task result within the response."},"title":"Tasks","description":"Array of task objects containing user account information"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Appendix"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_GOOGLE_APP_REVIEWS_TASK_GET_ADV_BY_ID","name":"Get App Data Google App Reviews Task Advanced By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"app_id":{"type":"string","title":"App Id","description":"Application ID from the original request"},"device":{"type":"string","title":"Device","description":"Device type"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Task priority level"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original task parameters from the POST request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type (e.g., 'reviews')"},"items":{"type":"array","items":{"type":"object","title":"ReviewItem","properties":{"id":{"type":"string","title":"Id","description":"Unique review identifier"},"type":{"type":"string","title":"Type","description":"Result type (e.g., 'google_play_reviews_search')"},"title":{"type":"string","title":"Title","description":"Review title (typically null for Google Play)"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating score value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes/ratings"}},"description":"Rating information for an app or review.","additionalProperties":false},"version":{"type":"string","title":"Version","description":"App version that was reviewed"},"position":{"type":"string","title":"Position","description":"Position alignment (e.g., 'left')"},"responses":{"type":"array","items":{"type":"object","title":"ReviewResponse","properties":{"text":{"type":"string","title":"Text","description":"Developer response content"},"title":{"type":"string","title":"Title","description":"Response title (typically null for Google Play)"},"author":{"type":"string","title":"Author","description":"Developer/author name who responded"},"timestamp":{"type":"string","title":"Timestamp","description":"UTC timestamp when the response was published"}},"description":"Developer response to a review."},"title":"Responses","description":"Developer replies to this review"},"timestamp":{"type":"string","title":"Timestamp","description":"UTC timestamp when the review was published"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"review_text":{"type":"string","title":"Review Text","description":"Review content text"},"user_profile":{"type":"object","title":"UserProfile","properties":{"profile_name":{"type":"string","title":"Profile Name","description":"Reviewer's display name"},"profile_image_url":{"type":"string","title":"Profile Image Url","description":"URL to the reviewer's profile image"}},"description":"Reviewer profile information.","additionalProperties":false},"helpful_count":{"type":"integer","title":"Helpful Count","description":"Number of thumbs-up votes the review received"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all results"}},"description":"Individual review item from Google Play Store."},"title":"Items","description":"List of individual review objects"},"title":{"type":"string","title":"Title","description":"Application title"},"app_id":{"type":"string","title":"App Id","description":"Application identifier"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating score value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes/ratings"}},"description":"Rating information for an app or review.","additionalProperties":false},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when the data was retrieved"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (e.g., 'play.google.com')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of review items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original request"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews for the app"}},"description":"Result data containing app reviews."},"title":"Result","description":"Array of result objects containing app review data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success, 40000+ indicates task in queue or processing."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects containing app review results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APP_GOOGLE_APP_SEARCHES_TASK_ADV_BY_ID","name":"Get App Data Google App Searches Task Advanced By ID","description":"Tool to retrieve Google Play app search results for a previously created task. Returns detailed app data including titles, ratings, prices, reviews, and icons for apps ranking on Google Play for the specified keyword. This is the second step in a two-step process: first create a task, then retrieve results using this action with the task ID.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"sandbox":{"type":"boolean","description":"Enable sandbox mode for testing without charges. When true, uses sandbox.dataforseo.com instead of api.dataforseo.com.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword that was submitted"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"API function called"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original task parameters from the POST request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"AppSearchItem","properties":{"url":{"type":"string","title":"Url","description":"Google Play Store page URL"},"icon":{"type":"string","title":"Icon","description":"App icon image URL"},"type":{"type":"string","title":"Type","description":"Result type (e.g., 'google_play_search_organic')"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price amount"},"regular":{"type":"number","title":"Regular","description":"Regular price (null if no discount)"},"currency":{"type":"string","title":"Currency","description":"ISO currency code (e.g., USD)"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in range (null if not a price range)"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether the price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Raw price string as displayed in Google Play Store"}},"description":"Price information for an app.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"App title/name"},"app_id":{"type":"string","title":"App Id","description":"Unique application identifier"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes/reviews for this rating"}},"description":"Rating information for an app.","additionalProperties":false},"is_free":{"type":"boolean","title":"Is Free","description":"Whether the app is free"},"installs":{"type":"string","title":"Installs","description":"Installation count range (e.g., '1,000,000+')"},"position":{"type":"string","title":"Position","description":"Position alignment (e.g., 'left')"},"developer":{"type":"string","title":"Developer","description":"Developer name"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"description":{"type":"string","title":"Description","description":"App description"},"developer_id":{"type":"string","title":"Developer Id","description":"Developer ID"},"developer_url":{"type":"string","title":"Developer Url","description":"URL to the developer's page"},"main_category":{"type":"string","title":"Main Category","description":"Main category of the app"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all results"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews"},"installs_count":{"type":"integer","title":"Installs Count","description":"Approximate number of installs"}},"description":"Individual app search result from the Google Play Store."},"title":"Items","description":"List of app results from the Google Play Store"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword from the original request"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when results were retrieved"},"check_url":{"type":"string","title":"Check Url","description":"URL to check the results directly (typically null)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of app items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original request"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results available"}},"description":"Result object containing Google App Searches data."},"title":"Result","description":"Array of result objects with app search data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (10000-60000 range). 20000 means OK, 40000+ indicates task in queue or processing."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects with results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 = success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APPLE_APP_INFO_ADVANCED_BY_ID","name":"Get Apple App Info Advanced by ID","description":"Get detailed Apple App Store information for a previously submitted task. Returns comprehensive app data including title, description, ratings, reviews, price, categories, developer info, screenshots, and similar apps.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskInfo","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Echo of request parameters","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"items":{"type":"array","items":{"type":"object","title":"AppStoreInfoItem","properties":{"url":{"type":"string","title":"Url","description":"URL to the app on App Store"},"icon":{"type":"string","title":"Icon","description":"URL to the app icon"},"size":{"type":"string","title":"Size","description":"App file size"},"type":{"type":"string","title":"Type","description":"Type of the item"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price"},"regular":{"type":"number","title":"Regular","description":"Regular price"},"currency":{"type":"string","title":"Currency","description":"Currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price value"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Indicates if the price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price string as displayed"}},"description":"Price information for the app.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Application title"},"app_id":{"type":"string","title":"App Id","description":"Application identifier"},"images":{"type":"array","items":{"type":"string","properties":{}},"title":"Images","description":"List of screenshot URLs"},"rating":{"type":"object","title":"RatingInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of rating element"},"value":{"type":"number","title":"Value","description":"Rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes"}},"description":"Rating information for the app.","additionalProperties":false},"is_free":{"type":"boolean","title":"Is Free","description":"Indicates if the app is free"},"version":{"type":"string","title":"Version","description":"Current app version"},"position":{"type":"string","title":"Position","description":"Alignment of the element"},"developer":{"type":"string","title":"Developer","description":"Developer name"},"languages":{"type":"array","items":{"type":"string","properties":{}},"title":"Languages","description":"List of supported languages"},"advisories":{"type":"array","items":{"type":"string","properties":{}},"title":"Advisories","description":"Age ratings and content advisories"},"categories":{"type":"array","items":{"type":"string","properties":{}},"title":"Categories","description":"List of app categories"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of elements with identical type"},"description":{"type":"string","title":"Description","description":"Application description"},"developer_id":{"type":"string","title":"Developer Id","description":"Developer identifier"},"similar_apps":{"type":"array","items":{"type":"object","title":"SimilarApp","properties":{"url":{"type":"string","title":"Url","description":"URL to similar app"},"title":{"type":"string","title":"Title","description":"Similar app title"},"app_id":{"type":"string","title":"App Id","description":"Similar app identifier"}},"description":"Information about a similar app."},"title":"Similar Apps","description":"List of similar apps"},"update_notes":{"type":"string","title":"Update Notes","description":"Notes about the latest update"},"developer_url":{"type":"string","title":"Developer Url","description":"URL to developer page"},"main_category":{"type":"string","title":"Main Category","description":"Main app category"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute rank among all elements"},"released_date":{"type":"string","title":"Released Date","description":"Date the app was released"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews"},"last_update_date":{"type":"string","title":"Last Update Date","description":"Date of the last update in UTC"},"minimum_os_version":{"type":"string","title":"Minimum Os Version","description":"Minimum OS version required"},"more_apps_by_developer":{"type":"array","items":{"type":"object","title":"SimilarApp","properties":{"url":{"type":"string","title":"Url","description":"URL to similar app"},"title":{"type":"string","title":"Title","description":"Similar app title"},"app_id":{"type":"string","title":"App Id","description":"Similar app identifier"}},"description":"Information about a similar app."},"title":"More Apps By Developer","description":"List of other apps by the same developer"}},"description":"Detailed information about an app from the Apple App Store."},"title":"Items","description":"List of app information items"},"app_id":{"type":"string","title":"App Id","description":"Application identifier"},"datetime":{"type":"string","title":"Datetime","description":"Date and time the result was generated in UTC"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to search result"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search engine results"}},"description":"Result data containing app information."},"title":"Result","description":"Array of task results"},"status_code":{"type":"integer","title":"Status Code","description":"Task status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements"},"status_message":{"type":"string","title":"Status Message","description":"Task status message"}},"description":"Information about a DataForSEO task."},"title":"Tasks","description":"Array of task information"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_APPLE_APP_INFO_TASK_ADVANCED","name":"Get Apple App Info Task Advanced","description":"Tool to retrieve advanced results for a previously created Apple App Info task. Use when you need complete app information from the App Store including ratings, reviews, pricing, categories, similar apps, and developer details. Requires a task ID from task_post or tasks_ready endpoint.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format obtained from task_post response or tasks_ready endpoint. Accessible for 30 days.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task UUID identifier"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"os":{"type":"string","title":"Os","description":"Operating system"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"app_id":{"type":"string","title":"App Id","description":"App ID from request"},"device":{"type":"string","title":"Device","description":"Device type"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Priority level from request"},"pingback_url":{"type":"string","title":"Pingback Url","description":"Pingback URL from request"},"postback_url":{"type":"string","title":"Postback Url","description":"Postback URL from request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from request"},"postback_data":{"type":"string","title":"Postback Data","description":"Postback data format from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"AppStoreInfoItem","properties":{"url":{"type":"string","title":"Url","description":"App Store page URL"},"icon":{"type":"string","title":"Icon","description":"App icon image URL"},"size":{"type":"string","title":"Size","description":"App file size"},"type":{"type":"string","title":"Type","description":"Item type (e.g., 'app_store_info_organic')"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price"},"regular":{"type":"number","title":"Regular","description":"Regular price"},"currency":{"type":"string","title":"Currency","description":"Currency code (e.g., 'USD')"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price value"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether this is a price range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Pricing information for an app.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Application name"},"images":{"type":"array","items":{"type":"string","properties":{}},"title":"Images","description":"App preview image URLs"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum possible rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes/ratings"}},"description":"Rating information for an app.","additionalProperties":false},"is_free":{"type":"boolean","title":"Is Free","description":"Whether the app is free"},"version":{"type":"string","title":"Version","description":"Current app version"},"position":{"type":"string","title":"Position","description":"Element alignment"},"developer":{"type":"string","title":"Developer","description":"Developer name"},"languages":{"type":"array","items":{"type":"string","properties":{}},"title":"Languages","description":"Supported languages"},"advisories":{"type":"array","items":{"type":"string","properties":{}},"title":"Advisories","description":"Age ratings and content warnings"},"categories":{"type":"array","items":{"type":"string","properties":{}},"title":"Categories","description":"All relevant categories"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type elements"},"description":{"type":"string","title":"Description","description":"Full app description"},"developer_id":{"type":"string","title":"Developer Id","description":"Developer identifier"},"similar_apps":{"type":"array","items":{"type":"object","title":"SimilarApp","properties":{"url":{"type":"string","title":"Url","description":"Similar app URL"},"title":{"type":"string","title":"Title","description":"Similar app name"},"app_id":{"type":"string","title":"App Id","description":"Similar app identifier"}},"description":"Information about a similar app."},"title":"Similar Apps","description":"Related applications"},"update_notes":{"type":"string","title":"Update Notes","description":"Latest developer update notes"},"developer_url":{"type":"string","title":"Developer Url","description":"Developer App Store page URL"},"main_category":{"type":"string","title":"Main Category","description":"Primary genre/category"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute ranking position"},"released_date":{"type":"string","title":"Released Date","description":"UTC timestamp of app release"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total review count"},"last_update_date":{"type":"string","title":"Last Update Date","description":"UTC timestamp of last update"},"minimum_os_version":{"type":"string","title":"Minimum Os Version","description":"Required iOS version"},"more_apps_by_developer":{"type":"array","items":{"type":"object","title":"SimilarApp","properties":{"url":{"type":"string","title":"Url","description":"Similar app URL"},"title":{"type":"string","title":"Title","description":"Similar app name"},"app_id":{"type":"string","title":"App Id","description":"Similar app identifier"}},"description":"Information about a similar app."},"title":"More Apps By Developer","description":"Other apps from same developer"}},"description":"Detailed information about an Apple App Store application."},"title":"Items","description":"Array of app information items"},"app_id":{"type":"string","title":"App Id","description":"Application identifier"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval"},"check_url":{"type":"string","title":"Check Url","description":"Direct App Store results URL"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned"},"language_code":{"type":"string","title":"Language Code","description":"Language code from request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from request"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total results available"}},"description":"Result data for a single app info task."},"title":"Result","description":"Array of task results"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task information with results."},"title":"Tasks","description":"Array of task information with results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","App Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BACKLINKS_BULK_PAGES_SUMMARY_LIVE","name":"Get Backlinks Bulk Pages Summary Live","description":"Tool to get comprehensive backlinks summary data for multiple pages, domains, or subdomains in a single request. Use when you need to retrieve detailed backlink metrics for up to 1000 targets simultaneously, including rank, backlink counts, referring domains/pages/IPs, spam scores, and breakdowns by TLD, link type, platform, semantic location, and country.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier to match results. Maximum length is 255 characters. This tag will be returned in the response for identifying the task.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"targets":{"type":"array","description":"Array of domains, subdomains or webpages to get summary data for. You can specify up to 1000 targets, but they cannot belong to more than 100 different domains. For domains and subdomains, do not include https:// and www. prefixes. For pages, provide the absolute URL including https://","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"string","properties":{}}},"rank_scale":{"type":"string","description":"Scale for rank values. Options: 'one_hundred' (0-100 scale) or 'one_thousand' (0-1000 scale, default). Choose based on your preferred granularity for page rank metrics.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"include_subdomains":{"type":"boolean","description":"Include subdomains in the search. If set to true, subdomains of the target will be included in the results. Default is true.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API name (e.g., 'backlinks')"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the request"},"targets":{"type":"array","items":{"type":"string","properties":{}},"title":"Targets","description":"Array of targets that were requested"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'bulk_pages_summary')"},"rank_scale":{"type":"string","title":"Rank Scale","description":"Rank scale setting from the request"},"include_subdomains":{"type":"boolean","title":"Include Subdomains","description":"Include subdomains setting from the request"}},"description":"Represents the request data echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"PagesSummaryItem","properties":{"url":{"type":"string","title":"Url","description":"Page URL from the request"},"rank":{"type":"integer","title":"Rank","description":"Page rank calculated using DataForSEO's node ranking algorithm based on backlink data. Scale depends on rank_scale parameter (0-100 or 0-1000)."},"type":{"type":"string","title":"Type","description":"Result type, always 'backlinks_page_summary' for this endpoint"},"backlinks":{"type":"integer","title":"Backlinks","description":"Total number of live backlinks pointing to this page. This includes all referring links with all attributes (e.g., nofollow, noreferrer, ugc, sponsored)."},"lost_date":{"type":"string","title":"Lost Date","description":"Date when the most recent backlink was lost, in UTC format. Null if no backlinks have been lost."},"first_seen":{"type":"string","title":"First Seen","description":"Date when the first backlink to this page was discovered, in UTC format (e.g., '2024-01-15 12:30:45 +00:00')"},"broken_pages":{"type":"integer","title":"Broken Pages","description":"Number of pages that have broken backlinks with 4xx or 5xx HTTP status codes"},"referring_ips":{"type":"integer","title":"Referring Ips","description":"Number of unique IP addresses hosting pages that link to this page"},"referring_pages":{"type":"integer","title":"Referring Pages","description":"Total number of unique pages linking to this page"},"broken_backlinks":{"type":"integer","title":"Broken Backlinks","description":"Number of broken backlinks (links that return 404 or other error codes)"},"main_domain_rank":{"type":"integer","title":"Main Domain Rank","description":"Rank of the main domain this page belongs to. Scale depends on rank_scale parameter."},"referring_domains":{"type":"integer","title":"Referring Domains","description":"Total number of unique domains linking to this page"},"referring_subnets":{"type":"integer","title":"Referring Subnets","description":"Number of unique subnetworks (IP subnets) hosting referring pages"},"referring_links_tld":{"type":"object","title":"Referring Links Tld","description":"Breakdown of referring links by top-level domain (TLD). Keys are TLD codes (e.g., 'com', 'org'), values are link counts.","additionalProperties":{"type":"integer"}},"backlinks_spam_score":{"type":"integer","title":"Backlinks Spam Score","description":"Average spam score of all backlinks pointing to this page. Range 0-100, higher values indicate higher spam likelihood."},"referring_links_types":{"type":"object","title":"Referring Links Types","description":"Breakdown of referring links by HTML element type (e.g., 'anchor', 'image', 'link', 'meta', 'canonical', 'alternate', 'redirect'). Keys are types, values are counts.","additionalProperties":{"type":"integer"}},"referring_main_domains":{"type":"integer","title":"Referring Main Domains","description":"Number of unique main domains (root domains) linking to this page"},"referring_pages_nofollow":{"type":"integer","title":"Referring Pages Nofollow","description":"Number of referring pages where the link has the nofollow attribute"},"referring_links_countries":{"type":"object","title":"Referring Links Countries","description":"Breakdown of referring links by country of origin using ISO 3166-1 alpha-2 country codes (e.g., 'US', 'GB', 'DE'). Keys are country codes, values are counts.","additionalProperties":{"type":"integer"}},"referring_domains_nofollow":{"type":"integer","title":"Referring Domains Nofollow","description":"Number of referring domains where all links have the nofollow attribute"},"referring_links_attributes":{"type":"object","title":"Referring Links Attributes","description":"Breakdown of referring links by HTML attributes (e.g., 'nofollow', 'ugc', 'sponsored', 'noreferrer'). Keys are attributes, values are counts.","additionalProperties":{"type":"integer"}},"referring_links_platform_types":{"type":"object","title":"Referring Links Platform Types","description":"Breakdown of referring links by platform type (e.g., 'cms', 'ecommerce', 'message_board', 'blogs'). Keys are platform types, values are counts.","additionalProperties":{"type":"integer"}},"referring_main_domains_nofollow":{"type":"integer","title":"Referring Main Domains Nofollow","description":"Number of referring main domains where all links have the nofollow attribute"},"referring_links_semantic_locations":{"type":"object","title":"Referring Links Semantic Locations","description":"Breakdown of referring links by semantic HTML location (e.g., 'header', 'footer', 'sidebar', 'article', 'nav'). Keys are semantic elements, values are counts.","additionalProperties":{"type":"integer"}}},"description":"Represents backlinks summary data for a specific page."},"title":"Result","description":"Array of backlinks page summary data for each target. Each element contains comprehensive backlink metrics, rank, referring domains/pages/IPs, and detailed breakdowns by TLD, link type, platform, semantic location, and country."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Represents a single task in the response containing pages summary data."},"title":"Tasks","description":"Array of tasks containing backlinks page summary data for the requested targets"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (e.g., 20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Backlinks"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BACKLINKS_BULK_SPAM_SCORE_LIVE","name":"Get Backlinks Bulk Spam Score Live","description":"Tool to get spam scores for multiple domains, subdomains, or pages in a single request. Use when you need to evaluate how 'spammy' target websites are using DataForSEO's proprietary metric (0-100 scale).","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"targets":{"type":"array","description":"Array of target domains, subdomains, or page URLs to check spam scores for. You can specify up to 100 targets per request. Examples: ['forbes.com', 'cnn.com', 'https://www.apple.com/iphone/']","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"string","properties":{}}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the request"},"targets":{"type":"array","items":{"type":"string","properties":{}},"title":"Targets","description":"Array of target domains/URLs from the request"},"function":{"type":"string","title":"Function","description":"API function name"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"SpamScoreResult","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier, typically 'backlinks_bulk_spam_score'"},"target":{"type":"string","title":"Target","description":"The domain, subdomain, or URL that was analyzed"},"spam_score":{"type":"integer","title":"Spam Score","description":"DataForSEO's proprietary spam score metric on a scale from 0 to 100. Higher values indicate a more 'spammy' target. Score considers factors like backlink quality, domain authority signals, and other spam indicators."}},"description":"Represents spam score data for a single target."},"title":"Result","description":"Array of spam score results, one for each target in the request"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success, 40000+ indicates error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects containing spam score results"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Backlinks"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BACKLINKS_SUMMARY_LIVE","name":"Get Backlinks Summary Live","description":"Tool to get a comprehensive overview of backlinks data for a domain, subdomain, or webpage. Use when you need backlinks statistics including referring domains, link types, spam scores, and geographical distribution. Returns metrics like total backlinks count, referring domains/pages, link attributes breakdown, and platform type analysis.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier to match results. Maximum length is 255 characters. This tag will be returned in the response for identifying the task","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"target":{"type":"string","description":"Domain, subdomain, or webpage to analyze backlinks for. For domains and subdomains, do not include https:// and www. prefixes. For pages, provide the absolute URL including https://","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"rank_scale":{"type":"string","description":"Ranking metric scale for calculation.","default":"one_thousand","example":"$undefined","enum":["one_hundred","one_thousand"],"required":false},"backlinks_filters":{"type":"array","description":"Filter backlinks by field values. Accepts arrays in format: [field, operator, value]. Example: [['dofollow', '=', true]] to filter only dofollow links. Supports all fields from backlinks endpoint","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"boolean"},{"type":"number"}]},"properties":{}}},"include_subdomains":{"type":"boolean","description":"Whether to include subdomains in the search. If set to true, backlinks from subdomains will be included in the results. Default: true","default":true,"example":"$undefined","enum":"$undefined","required":false},"internal_list_limit":{"type":"integer","description":"Maximum number of elements in internal arrays (e.g., referring_links_tld). Default: 10, Maximum: 1000","default":10,"example":"$undefined","enum":"$undefined","required":false},"backlinks_status_type":{"type":"string","description":"Backlink status filter types.","default":"live","example":"$undefined","enum":["all","live","lost"],"required":false},"include_indirect_links":{"type":"boolean","description":"Whether to include indirect links (redirects, canonicals) in the results. Default: true","default":true,"example":"$undefined","enum":"$undefined","required":false},"exclude_internal_backlinks":{"type":"boolean","description":"Whether to exclude internal backlinks from subdomains. If true, backlinks from the same domain/subdomain will be excluded. Default: true","default":true,"example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier (e.g., 'backlinks')"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the request"},"target":{"type":"string","title":"Target","description":"Target domain/subdomain/URL from the request"},"function":{"type":"string","title":"Function","description":"API function name (e.g., 'summary')"},"rank_scale":{"type":"string","title":"Rank Scale","description":"Rank scale from the request"},"backlinks_filters":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"boolean"},{"type":"number"}]},"properties":{}},"title":"Backlinks Filters","description":"Backlinks filters from the request"},"include_subdomains":{"type":"boolean","title":"Include Subdomains","description":"Include subdomains flag from the request"},"internal_list_limit":{"type":"integer","title":"Internal List Limit","description":"Internal list limit from the request"},"backlinks_status_type":{"type":"string","title":"Backlinks Status Type","description":"Backlinks status type from the request"},"include_indirect_links":{"type":"boolean","title":"Include Indirect Links","description":"Include indirect links flag from the request"},"exclude_internal_backlinks":{"type":"boolean","title":"Exclude Internal Backlinks","description":"Exclude internal backlinks flag from the request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"BacklinksSummaryResult","properties":{"info":{"type":"object","title":"TargetInfo","properties":{"cms":{"type":"string","title":"Cms","description":"Content management system detected on the target"},"is_ip":{"type":"boolean","title":"Is Ip","description":"Boolean indicating if the target is accessed by IP address rather than domain"},"server":{"type":"string","title":"Server","description":"Server type hosting the target"},"country":{"type":"string","title":"Country","description":"ISO country code where the target is hosted"},"ip_address":{"type":"string","title":"Ip Address","description":"IP address of the target"},"platform_type":{"type":"array","items":{"type":"string","properties":{}},"title":"Platform Type","description":"Array of platform types detected (e.g., cms, blogs, ecommerce)"},"target_spam_score":{"type":"integer","title":"Target Spam Score","description":"Average spam score for the domain or subdomain"}},"description":"Information about the target domain/page.","additionalProperties":false},"rank":{"type":"integer","title":"Rank","description":"Target ranking metric based on the selected rank_scale"},"target":{"type":"string","title":"Target","description":"The domain, subdomain, or page that was analyzed"},"backlinks":{"type":"integer","title":"Backlinks","description":"Total number of backlinks pointing to this target"},"lost_date":{"type":"string","title":"Lost Date","description":"When the backlink was lost due to 4xx/5xx response or removal (UTC datetime). Null if still active"},"first_seen":{"type":"string","title":"First Seen","description":"When the first backlink to this target was discovered (UTC datetime)"},"broken_pages":{"type":"integer","title":"Broken Pages","description":"Number of pages with 4xx or 5xx status codes"},"crawled_pages":{"type":"integer","title":"Crawled Pages","description":"Number of pages crawled for this target"},"referring_pages":{"type":"integer","title":"Referring Pages","description":"Count of unique pages pointing to this target"},"broken_backlinks":{"type":"integer","title":"Broken Backlinks","description":"Number of broken links pointing to this target"},"referring_domains":{"type":"integer","title":"Referring Domains","description":"Count of unique referring domains"},"referring_links_tld":{"type":"object","title":"Referring Links Tld","description":"Distribution of referring links by top-level domain (TLD). Keys are TLD strings, values are counts","additionalProperties":{"type":"integer"}},"backlinks_spam_score":{"type":"integer","title":"Backlinks Spam Score","description":"Aggregate spam score of all backlinks to this target"},"referring_links_types":{"type":"object","title":"Referring Links Types","description":"Distribution by link type (anchor, image, link, meta, canonical, alternate, redirect). Keys are type names, values are counts","additionalProperties":{"type":"integer"}},"referring_main_domains":{"type":"integer","title":"Referring Main Domains","description":"Count of unique referring main domains (root domains)"},"referring_links_countries":{"type":"object","title":"Referring Links Countries","description":"Distribution by ISO country codes of referring link sources. Keys are ISO country codes, values are counts","additionalProperties":{"type":"integer"}},"referring_links_attributes":{"type":"object","title":"Referring Links Attributes","description":"Distribution by HTML link attributes (nofollow, noopener, noreferrer, external, ugc, sponsored). Keys are attribute names, values are counts","additionalProperties":{"type":"integer"}},"referring_links_platform_types":{"type":"object","title":"Referring Links Platform Types","description":"Distribution by platform type (cms, blogs, ecommerce, message_boards, wikis, news, organization). Keys are platform types, values are counts","additionalProperties":{"type":"integer"}},"referring_links_semantic_locations":{"type":"object","title":"Referring Links Semantic Locations","description":"Distribution by HTML semantic elements containing the links. Keys are semantic element names, values are counts","additionalProperties":{"type":"integer"}}},"description":"Represents backlinks summary data for the target."},"title":"Result","description":"Array of backlinks summary results"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success, 40000+ indicates error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects containing backlinks summary results"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","Backlinks"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BING_KW_PERFORMANCE_LOCATIONS_AND_LANGUAGES","name":"Get Bing Keyword Performance Locations And Languages","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total tasks cost in USD (always 0 for this endpoint)"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Additional task metadata","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path segments"},"time":{"type":"string","title":"Time","description":"Execution time for this task"},"result":{"type":"array","items":{"type":"object","title":"LanguageResult","properties":{"language_code":{"type":"string","title":"Language Code","description":"ISO 639-1 language code (e.g., 'en', 'es')"},"language_name":{"type":"string","title":"Language Name","description":"Full name of the language (e.g., 'English', 'Spanish')"},"available_locations":{"type":"array","items":{"type":"object","title":"Location","properties":{"location_code":{"type":"integer","title":"Location Code","description":"Numeric location identifier code"},"location_name":{"type":"string","title":"Location Name","description":"Full location name (e.g., 'United States', 'United Kingdom')"},"location_type":{"type":"string","title":"Location Type","description":"Type of location (e.g., 'Country', 'Region')"},"country_iso_code":{"type":"string","title":"Country Iso Code","description":"ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB')"}},"description":"Location object with code, name and country info."},"title":"Available Locations","description":"List of locations supported for this language"}},"description":"Language with available locations."},"title":"Result","description":"Array of language and location data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task status information message"}},"description":"Task result containing locations and languages data."},"title":"Tasks","description":"Array of task results containing locations and languages"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that returned with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BIZ_BUSINESS_LISTINGS_AVAILABLE_FILTERS","name":"Get Business Data Business Listings Available Filters","description":"Tool 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).","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD."},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format."},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD."},"data":{"type":"object","title":"Data","description":"Request parameters used for the task.","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","title":"TaskResultItem","properties":{"search":{"type":"object","title":"Search","description":"Filter parameters available for the search endpoint. Keys are field names (e.g., 'title', 'rating.value'), values indicate type ('str', 'num', 'bool', 'array.str', 'time').","additionalProperties":{"type":"string"}},"categories_aggregation":{"type":"object","title":"Categories Aggregation","description":"Filter parameters available for the categories_aggregation endpoint. Keys are field names, values indicate type.","additionalProperties":{"type":"string"}}},"description":"Represents filter definitions grouped by endpoint."},"title":"Result","description":"Array containing filter definitions organized by endpoint. Each object contains 'search' and 'categories_aggregation' with their respective filter fields and types."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status."}},"description":"Represents a single task in the response containing filter information."},"title":"Tasks","description":"Array of tasks containing filter definitions for Business Listings endpoints."},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API."},"status_code":{"type":"integer","title":"Status Code","description":"Response status code (e.g., 20000 for success)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BIZ_GOOGLE_HOTEL_INFO_TASK_GET_ADV_BY_ID","name":"Get Business Data Google Hotel Info Task Advanced By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Time taken for the API request"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Task ID in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"check_in":{"type":"string","title":"Check In","description":"Check-in date"},"visitors":{"type":"integer","title":"Visitors","description":"Number of visitors"},"check_out":{"type":"string","title":"Check Out","description":"Check-out date"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"},"hotel_identifier":{"type":"string","title":"Hotel Identifier","description":"Hotel identifier from the request"}},"description":"Original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task"},"result":{"type":"array","items":{"type":"object","title":"HotelInfoResult","properties":{"about":{"type":"object","title":"AboutInfo","properties":{"url":{"type":"string","title":"Url","description":"Hotel website URL"},"domain":{"type":"string","title":"Domain","description":"Hotel website domain"},"amenities":{"type":"array","items":{"type":"object","title":"AmenityCategory","properties":{"items":{"type":"array","items":{"type":"object","title":"AmenityItem","properties":{"hint":{"type":"string","title":"Hint","description":"Additional hint or information about the amenity"},"amenity":{"type":"string","title":"Amenity","description":"Amenity identifier"},"hint_label":{"type":"string","title":"Hint Label","description":"Human-readable hint label"},"is_available":{"type":"boolean","title":"Is Available","description":"Whether the amenity is available"},"amenity_label":{"type":"string","title":"Amenity Label","description":"Human-readable amenity label"}},"description":"Individual amenity information."},"title":"Items","description":"List of amenities in this category"},"category":{"type":"string","title":"Category","description":"Category identifier"},"category_label":{"type":"string","title":"Category Label","description":"Human-readable category label"}},"description":"Category of amenities with its items."},"title":"Amenities","description":"List of amenity categories with their items"},"description":{"type":"string","title":"Description","description":"Main hotel description"},"full_address":{"type":"string","title":"Full Address","description":"Complete hotel address"},"check_in_time":{"type":"object","title":"CheckTime","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour value (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute value (0-59)"}},"description":"Time information for check-in or check-out.","additionalProperties":false},"check_out_time":{"type":"object","title":"CheckTime","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour value (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute value (0-59)"}},"description":"Time information for check-in or check-out.","additionalProperties":false},"sub_descriptions":{"type":"array","items":{"type":"string","properties":{}},"title":"Sub Descriptions","description":"Additional descriptive text about the hotel"},"popular_amenities":{"type":"array","items":{"type":"object","title":"AmenityItem","properties":{"hint":{"type":"string","title":"Hint","description":"Additional hint or information about the amenity"},"amenity":{"type":"string","title":"Amenity","description":"Amenity identifier"},"hint_label":{"type":"string","title":"Hint Label","description":"Human-readable hint label"},"is_available":{"type":"boolean","title":"Is Available","description":"Whether the amenity is available"},"amenity_label":{"type":"string","title":"Amenity Label","description":"Human-readable amenity label"}},"description":"Individual amenity information."},"title":"Popular Amenities","description":"List of popular amenities"}},"description":"Detailed information about the hotel.","additionalProperties":false},"phone":{"type":"string","title":"Phone","description":"Hotel contact phone number"},"stars":{"type":"integer","title":"Stars","description":"Hotel star rating (1-5)"},"title":{"type":"string","title":"Title","description":"Hotel name"},"prices":{"type":"object","title":"PricesInfo","properties":{"items":{"type":"array","items":{"type":"object","title":"HotelPriceItem","properties":{"url":{"type":"string","title":"Url","description":"URL to booking page"},"type":{"type":"string","title":"Type","description":"Type of price item (e.g., 'hotel_info_price')"},"price":{"type":"integer","title":"Price","description":"Price from this source"},"title":{"type":"string","title":"Title","description":"Booking source title"},"domain":{"type":"string","title":"Domain","description":"Booking source domain"},"offers":{"type":"array","items":{"type":"object","title":"HotelPriceOffer","properties":{"url":{"type":"string","title":"Url","description":"URL to book this offer"},"type":{"type":"string","title":"Type","description":"Type of offer (e.g., 'hotel_info_price_offer')"},"price":{"type":"integer","title":"Price","description":"Offer price"},"title":{"type":"string","title":"Title","description":"Offer title or room type"},"currency":{"type":"string","title":"Currency","description":"Currency code (ISO format)"},"max_visitors":{"type":"integer","title":"Max Visitors","description":"Maximum number of visitors for this offer"},"offer_images":{"type":"array","items":{"type":"string","properties":{}},"title":"Offer Images","description":"List of image URLs for this offer"},"free_cancellation_until":{"type":"string","title":"Free Cancellation Until","description":"Free cancellation deadline (datetime format)"}},"description":"Individual hotel room or rate offer."},"title":"Offers","description":"List of room or rate offers from this source"},"is_paid":{"type":"boolean","title":"Is Paid","description":"Whether this is a paid listing"},"currency":{"type":"string","title":"Currency","description":"Currency code (ISO format)"},"free_cancellation_until":{"type":"string","title":"Free Cancellation Until","description":"Free cancellation deadline (datetime format)"}},"description":"Price item from a booking source."},"title":"Items","description":"List of price items from different booking sources"},"price":{"type":"integer","title":"Price","description":"Current price"},"check_in":{"type":"string","title":"Check In","description":"Check-in date (datetime format)"},"currency":{"type":"string","title":"Currency","description":"Currency code (ISO format)"},"visitors":{"type":"integer","title":"Visitors","description":"Number of visitors for this price"},"check_out":{"type":"string","title":"Check Out","description":"Check-out date (datetime format)"},"discount_text":{"type":"string","title":"Discount Text","description":"Text describing the discount"},"prices_by_dates":{"type":"array","items":{"type":"object","title":"PriceByDate","properties":{"price":{"type":"integer","title":"Price","description":"Price for this date range"},"currency":{"type":"string","title":"Currency","description":"Currency code (ISO format)"},"check_in_date":{"type":"string","title":"Check In Date","description":"Check-in date (datetime format)"},"check_out_date":{"type":"string","title":"Check Out Date","description":"Check-out date (datetime format)"}},"description":"Price information for specific date range."},"title":"Prices By Dates","description":"Price information for different date ranges"},"price_without_discount":{"type":"integer","title":"Price Without Discount","description":"Price without discount"}},"description":"Pricing information for the hotel.","additionalProperties":false},"address":{"type":"string","title":"Address","description":"Hotel physical address"},"reviews":{"type":"object","title":"ReviewsInfo","properties":{"value":{"type":"number","title":"Value","description":"Average review rating value"},"mentions":{"type":"array","items":{"type":"object","title":"MentionItem","properties":{"title":{"type":"string","title":"Title","description":"Mention topic title"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of mentions"},"negative_count":{"type":"integer","title":"Negative Count","description":"Number of negative mentions"},"positive_count":{"type":"integer","title":"Positive Count","description":"Number of positive mentions"},"positive_score":{"type":"number","title":"Positive Score","description":"Positive sentiment score for this mention"},"visible_by_default":{"type":"boolean","title":"Visible By Default","description":"Whether this mention is visible by default"}},"description":"Review mention topic with sentiment scores."},"title":"Mentions","description":"List of review mentions with sentiment analysis"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"},"other_sites_reviews":{"type":"array","items":{"type":"object","title":"OtherSiteReview","properties":{"url":{"type":"string","title":"Url","description":"URL to the review site"},"title":{"type":"string","title":"Title","description":"Review site title"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information from external review sites.","additionalProperties":false},"review_text":{"type":"string","title":"Review Text","description":"Review text or summary"}},"description":"Review from an external site."},"title":"Other Sites Reviews","description":"Reviews from other sites"},"rating_distribution":{"type":"object","title":"RatingDistribution","properties":{"1":{"type":"integer","title":"1","description":"Number of 1-star ratings"},"2":{"type":"integer","title":"2","description":"Number of 2-star ratings"},"3":{"type":"integer","title":"3","description":"Number of 3-star ratings"},"4":{"type":"integer","title":"4","description":"Number of 4-star ratings"},"5":{"type":"integer","title":"5","description":"Number of 5-star ratings"}},"description":"Distribution of ratings by star count.","additionalProperties":false}},"description":"Review and rating information for the hotel.","additionalProperties":false},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved (UTC format)"},"location":{"type":"object","title":"LocationInfo","properties":{"latitude":{"type":"number","title":"Latitude","description":"Latitude coordinate"},"maps_url":{"type":"string","title":"Maps Url","description":"URL to the hotel location on maps"},"longitude":{"type":"number","title":"Longitude","description":"Longitude coordinate"},"neighborhood":{"type":"string","title":"Neighborhood","description":"Neighborhood name"},"overall_score":{"type":"number","title":"Overall Score","description":"Overall location score"},"location_chain":{"type":"array","items":{"type":"object","title":"LocationChainItem","properties":{"cid":{"type":"string","title":"Cid","description":"CID identifier"},"title":{"type":"string","title":"Title","description":"Location name or title"},"card_id":{"type":"string","title":"Card Id","description":"Card identifier"},"feature_id":{"type":"string","title":"Feature Id","description":"Feature identifier"}},"description":"Location chain element providing context for the hotel's location."},"title":"Location Chain","description":"Chain of location context items"},"score_by_categories":{"type":"object","title":"ScoreByCategories","properties":{"overall":{"type":"number","title":"Overall","description":"Overall location score"},"transit":{"type":"number","title":"Transit","description":"Score for transit accessibility"},"restaurants":{"type":"number","title":"Restaurants","description":"Score for nearby restaurants"},"things_to_do":{"type":"number","title":"Things To Do","description":"Score for nearby things to do"},"airport_access":{"type":"number","title":"Airport Access","description":"Score for airport access"}},"description":"Location scores by different categories.","additionalProperties":false},"neighborhood_description":{"type":"string","title":"Neighborhood Description","description":"Description of the neighborhood"}},"description":"Geographic and location information for the hotel.","additionalProperties":false},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to search engine results"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"},"overview_images":{"type":"array","items":{"type":"string","properties":{}},"title":"Overview Images","description":"List of hotel overview image URLs"},"hotel_identifier":{"type":"string","title":"Hotel Identifier","description":"Unique hotel identifier"},"stars_description":{"type":"string","title":"Stars Description","description":"Descriptive label for star rating"}},"description":"Detailed hotel information result."},"title":"Result","description":"List of hotel information results"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message for the task"}},"description":"Task data containing the request parameters and results."},"title":"Tasks","description":"List of task data containing hotel information results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BIZ_GOOGLE_HOTEL_SEARCHES_TASK_BY_ID","name":"Get Business Data Google Hotel Searches Task By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"HotelSearchesTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"Data","description":"Original request parameters echoed back","additionalProperties":true},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"HotelSearchesResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HotelSearchItem","properties":{"type":{"type":"string","title":"Type","description":"Type of item (always 'hotel_search_item')"},"stars":{"type":"integer","title":"Stars","description":"Hotel star rating (1-5 stars)"},"title":{"type":"string","title":"Title","description":"Name of the hotel"},"prices":{"type":"object","title":"PricesData","properties":{"items":{"type":"null","title":"Items","description":"Reserved field for additional pricing items"},"price":{"type":"integer","title":"Price","description":"Per-night rate for the hotel"},"check_in":{"type":"string","title":"Check In","description":"Check-in date and time in UTC format"},"currency":{"type":"string","title":"Currency","description":"Currency code (e.g., USD, EUR)"},"visitors":{"type":"integer","title":"Visitors","description":"Number of guests for the pricing"},"check_out":{"type":"string","title":"Check Out","description":"Check-out date and time in UTC format"},"discount_text":{"type":"string","title":"Discount Text","description":"Discount description text if a discount is available"},"price_without_discount":{"type":"integer","title":"Price Without Discount","description":"Full price before discount (if applicable)"}},"description":"Hotel pricing information for the specified dates.","additionalProperties":false},"is_paid":{"type":"boolean","title":"Is Paid","description":"Indicates if this is a paid advertisement result"},"reviews":{"type":"object","title":"ReviewsData","properties":{"value":{"type":"number","title":"Value","description":"Average rating score for the hotel"},"mentions":{"type":"null","title":"Mentions","description":"Reserved field for future use"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of reviews for the hotel"},"other_sites_reviews":{"type":"null","title":"Other Sites Reviews","description":"Reserved field for reviews from other sites"},"rating_distribution":{"type":"null","title":"Rating Distribution","description":"Reserved field for rating distribution data"}},"description":"Hotel review and rating information.","additionalProperties":false},"location":{"type":"object","title":"LocationData","properties":{"latitude":{"type":"number","title":"Latitude","description":"GPS latitude coordinate of the hotel"},"longitude":{"type":"number","title":"Longitude","description":"GPS longitude coordinate of the hotel"}},"description":"Geographic location coordinates of the hotel.","additionalProperties":false},"overview_images":{"type":"array","items":{"type":"string","properties":{}},"title":"Overview Images","description":"Array of featured hotel image URLs"},"hotel_identifier":{"type":"string","title":"Hotel Identifier","description":"Unique Google hotel entity identifier"}},"description":"Individual hotel search result item."},"title":"Items","description":"Array of hotel search result items"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword with location appended"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when results were retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to the search engine results page"},"items_count":{"type":"integer","title":"Items Count","description":"Number of hotel items returned in the results"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Location identifier code used for the search"}},"description":"Result data containing hotel search results and metadata."},"title":"Result","description":"Array of hotel search results"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing request parameters and hotel search results."},"title":"Tasks","description":"Array of task data containing hotel search results"},"version":{"type":"string","title":"Version","description":"API version identifier"},"status_code":{"type":"integer","title":"Status Code","description":"General status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks returned in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the overall request"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BIZ_GOOGLE_MY_BUSINESS_UPDATES_TASK_BY_ID","name":"Get Business Data Google My Business Updates Task By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format. Retrieves results within 30 days of task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"os":{"type":"string","title":"Os","description":"Operating system"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"device":{"type":"string","title":"Device","description":"Device type"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or search query"},"function":{"type":"string","title":"Function","description":"Function name"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"cid":{"type":"string","title":"Cid","description":"Customer ID of the Google My Business listing"},"items":{"type":"array","items":{"type":"object","title":"BusinessUpdateItem","properties":{"url":{"type":"string","title":"Url","description":"URL of the business update"},"type":{"type":"string","title":"Type","description":"Type of item (e.g., 'google_business_post')"},"links":{"type":"array","items":{"type":"object","title":"BusinessUpdateLink","properties":{"url":{"type":"string","title":"Url","description":"URL of the link"},"type":{"type":"string","title":"Type","description":"Type of link"},"title":{"type":"string","title":"Title","description":"Title of the link"}},"description":"Represents a link within a business update item."},"title":"Links","description":"List of links contained in the business update"},"xpath":{"type":"string","title":"Xpath","description":"XPath selector for the item"},"author":{"type":"string","title":"Author","description":"Author of the business update"},"snippet":{"type":"string","title":"Snippet","description":"Snippet or preview text"},"position":{"type":"string","title":"Position","description":"Position of the item on page"},"post_date":{"type":"string","title":"Post Date","description":"Date when the post was published"},"post_text":{"type":"string","title":"Post Text","description":"Full text content of the post"},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the post in ISO format"},"images_url":{"type":"string","title":"Images Url","description":"URL of images in the post"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of similar items"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position among all items"}},"description":"Represents a single business update/post item."},"title":"Items","description":"Array of business update items containing posts and updates from Google My Business"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or search query used for the task"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format"},"check_url":{"type":"string","title":"Check Url","description":"URL that was checked for business updates"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (e.g., 'google.com')"},"feature_id":{"type":"string","title":"Feature Id","description":"Feature identifier for the business listing"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of items found in the results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of business update items in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"},"business_updates_id":{"type":"string","title":"Business Updates Id","description":"Unique identifier for the business updates"}},"description":"Result data for a Google My Business Updates task."},"title":"Result","description":"List of task results containing Google My Business updates and posts"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message for the task"}},"description":"Represents a single task in the tasks array."},"title":"Tasks","description":"Array of tasks containing Google My Business updates results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code of the API response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BIZ_GOOGLE_QUESTIONS_AND_ANSWERS_TASK","name":"Get Business Data Google Questions And Answers Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format, obtained from task_post or tasks_ready endpoint. Task ID is usable within 30 days of task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword or business name"},"function":{"type":"string","title":"Function","description":"API function called"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original request parameters from the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"cid":{"type":"string","title":"Cid","description":"Google client ID for the business establishment"},"items":{"type":"array","items":{"type":"object","title":"QuestionItem","properties":{"url":{"type":"string","title":"Url","description":"Direct URL to the question"},"type":{"type":"string","title":"Type","description":"Element type identifier (e.g., 'google_business_question_item')"},"items":{"type":"array","items":{"type":"object","title":"AnswerElement","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (e.g., 'google_business_answer_element')"},"time_ago":{"type":"string","title":"Time Ago","description":"Relative posting time (e.g., '2 weeks ago')"},"answer_id":{"type":"string","title":"Answer Id","description":"Unique answer identifier"},"timestamp":{"type":"string","title":"Timestamp","description":"Exact posting time in UTC format"},"answer_text":{"type":"string","title":"Answer Text","description":"Current answer text (may be translated)"},"profile_url":{"type":"string","title":"Profile Url","description":"Responder's profile URL"},"profile_name":{"type":"string","title":"Profile Name","description":"Responder's displayed name"},"profile_image_url":{"type":"string","title":"Profile Image Url","description":"Responder's profile image URL"},"original_answer_text":{"type":"string","title":"Original Answer Text","description":"Original answer text in source language"}},"description":"Individual answer element within a question."},"title":"Items","description":"List of answers to this question (maximum 5 answers per question)"},"time_ago":{"type":"string","title":"Time Ago","description":"Relative posting time (e.g., '3 months ago')"},"timestamp":{"type":"string","title":"Timestamp","description":"Exact posting time in UTC format"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"profile_url":{"type":"string","title":"Profile Url","description":"Question asker's profile URL"},"question_id":{"type":"string","title":"Question Id","description":"Unique question identifier"},"profile_name":{"type":"string","title":"Profile Name","description":"Question asker's displayed name"},"question_text":{"type":"string","title":"Question Text","description":"Current question text (may be translated)"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all results"},"profile_image_url":{"type":"string","title":"Profile Image Url","description":"Question asker's profile image URL"},"original_question_text":{"type":"string","title":"Original Question Text","description":"Original question text in source language"}},"description":"Individual question item with metadata and optional answers."},"title":"Items","description":"List of questions that have answers"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword or business name from the original request"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when results were retrieved"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to check the results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used"},"feature_id":{"type":"string","title":"Feature Id","description":"Unique SERP feature identifier"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Array of element types present in the results"},"items_count":{"type":"integer","title":"Items Count","description":"Total number of questions with answers in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original request"},"items_without_answers":{"type":"array","items":{"type":"object","title":"QuestionItem","properties":{"url":{"type":"string","title":"Url","description":"Direct URL to the question"},"type":{"type":"string","title":"Type","description":"Element type identifier (e.g., 'google_business_question_item')"},"items":{"type":"array","items":{"type":"object","title":"AnswerElement","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (e.g., 'google_business_answer_element')"},"time_ago":{"type":"string","title":"Time Ago","description":"Relative posting time (e.g., '2 weeks ago')"},"answer_id":{"type":"string","title":"Answer Id","description":"Unique answer identifier"},"timestamp":{"type":"string","title":"Timestamp","description":"Exact posting time in UTC format"},"answer_text":{"type":"string","title":"Answer Text","description":"Current answer text (may be translated)"},"profile_url":{"type":"string","title":"Profile Url","description":"Responder's profile URL"},"profile_name":{"type":"string","title":"Profile Name","description":"Responder's displayed name"},"profile_image_url":{"type":"string","title":"Profile Image Url","description":"Responder's profile image URL"},"original_answer_text":{"type":"string","title":"Original Answer Text","description":"Original answer text in source language"}},"description":"Individual answer element within a question."},"title":"Items","description":"List of answers to this question (maximum 5 answers per question)"},"time_ago":{"type":"string","title":"Time Ago","description":"Relative posting time (e.g., '3 months ago')"},"timestamp":{"type":"string","title":"Timestamp","description":"Exact posting time in UTC format"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"profile_url":{"type":"string","title":"Profile Url","description":"Question asker's profile URL"},"question_id":{"type":"string","title":"Question Id","description":"Unique question identifier"},"profile_name":{"type":"string","title":"Profile Name","description":"Question asker's displayed name"},"question_text":{"type":"string","title":"Question Text","description":"Current question text (may be translated)"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all results"},"profile_image_url":{"type":"string","title":"Profile Image Url","description":"Question asker's profile image URL"},"original_question_text":{"type":"string","title":"Original Question Text","description":"Original question text in source language"}},"description":"Individual question item with metadata and optional answers."},"title":"Items Without Answers","description":"List of questions that do not have answers yet"},"items_without_answers_count":{"type":"integer","title":"Items Without Answers Count","description":"Number of questions without answers"}},"description":"Result data containing questions and answers for a business."},"title":"Result","description":"Array of result objects with questions and answers data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success, 40000+ indicates task in queue or error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects with questions and answers results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 = success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_EXTENDED_REVIEWS_TASK","name":"Get Business Data Google Extended Reviews Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format, obtained from task_post or tasks_ready endpoint. Task ID is usable within 30 days of task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"depth":{"type":"integer","title":"Depth","description":"Search depth parameter"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword"},"sort_by":{"type":"string","title":"Sort By","description":"Sort order parameter"},"function":{"type":"string","title":"Function","description":"API function called"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original request parameters from the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"cid":{"type":"string","title":"Cid","description":"Customer ID"},"type":{"type":"string","title":"Type","description":"Result type"},"items":{"type":"array","items":{"type":"object","title":"ReviewItem","properties":{"type":{"type":"string","title":"Type","description":"Type of review item (e.g., 'google_reviews_search')"},"images":{"type":"array","items":{"type":"object","title":"ImageElement","properties":{"alt":{"type":"string","title":"Alt","description":"Alternative text for the image"},"url":{"type":"string","title":"Url","description":"URL of the image"}},"description":"Image associated with a review."},"title":"Images","description":"List of images attached to the review"},"rating":{"type":"object","title":"RatingObject","properties":{"value":{"type":"number","title":"Value","description":"Rating score value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes for this rating"}},"description":"Rating information for a business or review.","additionalProperties":false},"source":{"type":"object","title":"SourceMetadata","properties":{"image":{"type":"string","title":"Image","description":"Source image URL"},"title":{"type":"string","title":"Title","description":"Source title"},"domain":{"type":"string","title":"Domain","description":"Source domain"}},"description":"Metadata about the source of a review.","additionalProperties":false},"position":{"type":"string","title":"Position","description":"Position alignment"},"time_ago":{"type":"string","title":"Time Ago","description":"Human-readable time since review was posted (e.g., '2 weeks ago')"},"timestamp":{"type":"string","title":"Timestamp","description":"UTC timestamp when the review was posted"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"local_guide":{"type":"boolean","title":"Local Guide","description":"Whether the reviewer is a Local Guide"},"profile_url":{"type":"string","title":"Profile Url","description":"URL to reviewer's profile"},"review_text":{"type":"string","title":"Review Text","description":"Translated review text (if applicable)"},"owner_answer":{"type":"string","title":"Owner Answer","description":"Business owner's response to the review"},"photos_count":{"type":"integer","title":"Photos Count","description":"Number of photos posted by this reviewer"},"profile_name":{"type":"string","title":"Profile Name","description":"Reviewer's profile name"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all results"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews by this reviewer"},"owner_time_ago":{"type":"string","title":"Owner Time Ago","description":"Human-readable time since owner's response"},"owner_timestamp":{"type":"string","title":"Owner Timestamp","description":"UTC timestamp of owner's response"},"profile_image_url":{"type":"string","title":"Profile Image Url","description":"URL to reviewer's profile image"},"review_highlights":{"type":"array","items":{"type":"object","title":"ReviewHighlight","properties":{"feature":{"type":"string","title":"Feature","description":"Feature or aspect being highlighted (e.g., 'Food', 'Service')"},"assessment":{"type":"string","title":"Assessment","description":"Assessment of the feature (e.g., 'Great', 'Average')"}},"description":"Highlighted feature or aspect mentioned in a review."},"title":"Review Highlights","description":"Highlighted features or aspects mentioned in the review"},"original_review_text":{"type":"string","title":"Original Review Text","description":"Original review text in the source language"}},"description":"Individual review item with detailed information."},"title":"Items","description":"List of individual review items"},"title":{"type":"string","title":"Title","description":"Business establishment name"},"rating":{"type":"object","title":"RatingObject","properties":{"value":{"type":"number","title":"Value","description":"Rating score value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes for this rating"}},"description":"Rating information for a business or review.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword from the original request"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when results were retrieved"},"place_id":{"type":"string","title":"Place Id","description":"Google Place ID"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to check the results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"sub_title":{"type":"string","title":"Sub Title","description":"Additional details such as address"},"feature_id":{"type":"string","title":"Feature Id","description":"Feature identifier"},"items_count":{"type":"integer","title":"Items Count","description":"Number of review items in the current result set"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original request"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews for this business"}},"description":"Result data containing business and review information."},"title":"Result","description":"Array of result objects with business and review data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success, 40000+ indicates task in queue or error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects with review results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 = success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_MY_BUSINESS_INFO_TASK","name":"Get Business Data Google My Business Info Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format, obtained from task_post or tasks_ready endpoint. Task ID is usable within 30 days of task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword or CID"},"function":{"type":"string","title":"Function","description":"API function called"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original request parameters from the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"BusinessInfoItem","properties":{"cid":{"type":"string","title":"Cid","description":"Google client ID"},"url":{"type":"string","title":"Url","description":"Business website URL"},"logo":{"type":"string","title":"Logo","description":"Business logo image URL"},"type":{"type":"string","title":"Type","description":"Item type (e.g., 'google_business_info')"},"phone":{"type":"string","title":"Phone","description":"Business phone number"},"title":{"type":"string","title":"Title","description":"Business name"},"domain":{"type":"string","title":"Domain","description":"Business website domain"},"rating":{"type":"object","title":"RatingObject","properties":{"value":{"type":"number","title":"Value","description":"Rating score value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes for this rating"}},"description":"Rating information for a business.","additionalProperties":false},"address":{"type":"string","title":"Address","description":"Full business address"},"snippet":{"type":"string","title":"Snippet","description":"Additional information snippet"},"category":{"type":"string","title":"Category","description":"Primary Google My Business category"},"latitude":{"type":"number","title":"Latitude","description":"Map latitude coordinate"},"place_id":{"type":"string","title":"Place Id","description":"Google Places API place ID"},"position":{"type":"string","title":"Position","description":"SERP alignment position"},"directory":{"type":"object","title":"Directory","properties":{"items":{"type":"array","items":{"type":"object","title":"DirectoryBusinessItem","properties":{"type":{"type":"string","title":"Type","description":"Item type (e.g., 'google_business_info')"},"phone":{"type":"string","title":"Phone","description":"Phone number"},"title":{"type":"string","title":"Title","description":"Business name"},"domain":{"type":"string","title":"Domain","description":"Business domain"},"rating":{"type":"object","title":"RatingObject","properties":{"value":{"type":"number","title":"Value","description":"Rating score value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes for this rating"}},"description":"Rating information for a business.","additionalProperties":false},"snippet":{"type":"string","title":"Snippet","description":"Additional information snippet"}},"description":"Business item within a directory listing."},"title":"Items","description":"List of businesses in the directory"}},"description":"Directory information containing co-located businesses.","additionalProperties":false},"longitude":{"type":"number","title":"Longitude","description":"Map longitude coordinate"},"work_time":{"type":"object","title":"WorkTime","properties":{"work_hours":{"type":"object","title":"WorkHours","properties":{"timetable":{"type":"object","title":"WorkHoursTimetable","properties":{"friday":{"type":"array","items":{"type":"object","title":"DaySchedule","properties":{"open":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"close":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false}},"description":"Operating hours for a specific day."},"title":"Friday","description":"Friday operating hours"},"monday":{"type":"array","items":{"type":"object","title":"DaySchedule","properties":{"open":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"close":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false}},"description":"Operating hours for a specific day."},"title":"Monday","description":"Monday operating hours"},"sunday":{"type":"array","items":{"type":"object","title":"DaySchedule","properties":{"open":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"close":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false}},"description":"Operating hours for a specific day."},"title":"Sunday","description":"Sunday operating hours"},"tuesday":{"type":"array","items":{"type":"object","title":"DaySchedule","properties":{"open":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"close":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false}},"description":"Operating hours for a specific day."},"title":"Tuesday","description":"Tuesday operating hours"},"saturday":{"type":"array","items":{"type":"object","title":"DaySchedule","properties":{"open":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"close":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false}},"description":"Operating hours for a specific day."},"title":"Saturday","description":"Saturday operating hours"},"thursday":{"type":"array","items":{"type":"object","title":"DaySchedule","properties":{"open":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"close":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false}},"description":"Operating hours for a specific day."},"title":"Thursday","description":"Thursday operating hours"},"wednesday":{"type":"array","items":{"type":"object","title":"DaySchedule","properties":{"open":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"close":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false}},"description":"Operating hours for a specific day."},"title":"Wednesday","description":"Wednesday operating hours"}},"description":"Weekly timetable of operating hours.","additionalProperties":false}},"description":"Operating hours information.","additionalProperties":false},"current_status":{"type":"string","title":"Current Status","description":"Current operating status (e.g., 'opened', 'closed', 'temporarily_closed', 'closed_forever')"}},"description":"Business work time and current operating status.","additionalProperties":false},"attributes":{"type":"object","title":"Attributes","description":"Service details and feature checks","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"feature_id":{"type":"string","title":"Feature Id","description":"Unique identifier for this SERP element"},"is_claimed":{"type":"boolean","title":"Is Claimed","description":"Whether the business is claimed by owner"},"main_image":{"type":"string","title":"Main Image","description":"Primary image URL"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"contact_url":{"type":"string","title":"Contact Url","description":"Preferred contact page URL"},"description":{"type":"string","title":"Description","description":"Business description"},"price_level":{"type":"string","title":"Price Level","description":"Pricing tier (e.g., '$', '$$', '$$$', '$$$$')"},"address_info":{"type":"object","title":"AddressInfo","properties":{"zip":{"type":"string","title":"Zip","description":"Postal or ZIP code"},"city":{"type":"string","title":"City","description":"City name"},"region":{"type":"string","title":"Region","description":"State or region name"},"address":{"type":"string","title":"Address","description":"Street address"},"borough":{"type":"string","title":"Borough","description":"Borough or district name"},"country_code":{"type":"string","title":"Country Code","description":"ISO country code (e.g., 'US')"}},"description":"Structured address information for a business location.","additionalProperties":false},"category_ids":{"type":"array","items":{"type":"string","properties":{}},"title":"Category Ids","description":"Universal category identifiers"},"hotel_rating":{"type":"integer","title":"Hotel Rating","description":"Hotel star rating (1-5 stars)"},"place_topics":{"type":"object","title":"Place Topics","description":"Keywords extracted from reviews","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}},"total_photos":{"type":"integer","title":"Total Photos","description":"Total number of photos for this business"},"popular_times":{"type":"object","title":"PopularTimes","properties":{"popular_times_by_days":{"type":"object","title":"PopularTimesByDays","properties":{"friday":{"type":"array","items":{"type":"object","title":"PopularTimeBlock","properties":{"time":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"popular_index":{"type":"integer","title":"Popular Index","description":"Popularity index from 0 (least busy) to 100 (most busy)"}},"description":"Popular time data point with hour, minute, and popularity index."},"title":"Friday","description":"Friday popular times"},"monday":{"type":"array","items":{"type":"object","title":"PopularTimeBlock","properties":{"time":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"popular_index":{"type":"integer","title":"Popular Index","description":"Popularity index from 0 (least busy) to 100 (most busy)"}},"description":"Popular time data point with hour, minute, and popularity index."},"title":"Monday","description":"Monday popular times"},"sunday":{"type":"array","items":{"type":"object","title":"PopularTimeBlock","properties":{"time":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"popular_index":{"type":"integer","title":"Popular Index","description":"Popularity index from 0 (least busy) to 100 (most busy)"}},"description":"Popular time data point with hour, minute, and popularity index."},"title":"Sunday","description":"Sunday popular times"},"tuesday":{"type":"array","items":{"type":"object","title":"PopularTimeBlock","properties":{"time":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"popular_index":{"type":"integer","title":"Popular Index","description":"Popularity index from 0 (least busy) to 100 (most busy)"}},"description":"Popular time data point with hour, minute, and popularity index."},"title":"Tuesday","description":"Tuesday popular times"},"saturday":{"type":"array","items":{"type":"object","title":"PopularTimeBlock","properties":{"time":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"popular_index":{"type":"integer","title":"Popular Index","description":"Popularity index from 0 (least busy) to 100 (most busy)"}},"description":"Popular time data point with hour, minute, and popularity index."},"title":"Saturday","description":"Saturday popular times"},"thursday":{"type":"array","items":{"type":"object","title":"PopularTimeBlock","properties":{"time":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"popular_index":{"type":"integer","title":"Popular Index","description":"Popularity index from 0 (least busy) to 100 (most busy)"}},"description":"Popular time data point with hour, minute, and popularity index."},"title":"Thursday","description":"Thursday popular times"},"wednesday":{"type":"array","items":{"type":"object","title":"PopularTimeBlock","properties":{"time":{"type":"object","title":"TimeBlock","properties":{"hour":{"type":"integer","title":"Hour","description":"Hour in 24-hour format (0-23)"},"minute":{"type":"integer","title":"Minute","description":"Minute (0-59)"}},"description":"Time block representing opening or closing time.","additionalProperties":false},"popular_index":{"type":"integer","title":"Popular Index","description":"Popularity index from 0 (least busy) to 100 (most busy)"}},"description":"Popular time data point with hour, minute, and popularity index."},"title":"Wednesday","description":"Wednesday popular times"}},"description":"Popular times data organized by day of the week.","additionalProperties":false}},"description":"Popular times information showing busy hours by day.","additionalProperties":false},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all results"},"original_title":{"type":"string","title":"Original Title","description":"Business name in original language (untranslated)"},"is_directory_item":{"type":"boolean","title":"Is Directory Item","description":"Whether this business is part of a directory listing"},"people_also_search":{"type":"array","items":{"type":"object","title":"PeopleAlsoSearch","properties":{"cid":{"type":"string","title":"Cid","description":"Google client ID"},"title":{"type":"string","title":"Title","description":"Business name"}},"description":"Related business that people also search for."},"title":"People Also Search","description":"Related businesses"},"rating_distribution":{"type":"object","title":"RatingDistribution","properties":{"rating_1":{"type":"integer","title":"Rating 1","description":"Count of 1-star ratings"},"rating_2":{"type":"integer","title":"Rating 2","description":"Count of 2-star ratings"},"rating_3":{"type":"integer","title":"Rating 3","description":"Count of 3-star ratings"},"rating_4":{"type":"integer","title":"Rating 4","description":"Count of 4-star ratings"},"rating_5":{"type":"integer","title":"Rating 5","description":"Count of 5-star ratings"}},"description":"Distribution of ratings across different star levels (1-5).","additionalProperties":false},"local_business_links":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"object","additionalProperties":{"type":"string"}}}]}},"title":"Local Business Links","description":"Reservation, order, and menu links"},"additional_categories":{"type":"array","items":{"type":"string","properties":{}},"title":"Additional Categories","description":"Additional business categories"}},"description":"Individual business information item with comprehensive details."},"title":"Items","description":"List of business information items"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword from the original request"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when results were retrieved"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to check the results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of items encountered in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result set"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original request"}},"description":"Result data containing business information."},"title":"Result","description":"Array of result objects with business information data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success, 40000+ indicates task in queue or error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects with business info results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 = success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_REVIEWS_TASK","name":"Get Business Data Google Reviews Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"os":{"type":"string","title":"Os","description":"Operating system used for the task"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"depth":{"type":"integer","title":"Depth","description":"Number of results requested"},"device":{"type":"string","title":"Device","description":"Device type used for the task"},"keyword":{"type":"string","title":"Keyword","description":"Keyword used for the task (business identifier or search query)"},"sort_by":{"type":"string","title":"Sort By","description":"Sorting method for reviews"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"cid":{"type":"string","title":"Cid","description":"Google client ID for the business"},"type":{"type":"string","title":"Type","description":"Result type (typically 'google_reviews')"},"items":{"type":"array","items":{"type":"object","title":"GoogleReviewItem","properties":{"type":{"type":"string","title":"Type","description":"Type of review item (typically 'google_reviews_search')"},"xpath":{"type":"string","title":"Xpath","description":"XPath to the review element in the page"},"images":{"type":"array","items":{"type":"object","title":"ReviewImage","properties":{"alt":{"type":"string","title":"Alt","description":"Image alt text attribute"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'images_element')"},"image_url":{"type":"string","title":"Image Url","description":"URL to the image resource"}},"description":"Image attached to a review."},"title":"Images","description":"List of images attached to the review"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score or individual rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value for the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"}},"description":"Rating information for a business or individual review.","additionalProperties":false},"position":{"type":"string","title":"Position","description":"Alignment in SERP (e.g., 'left')"},"time_ago":{"type":"string","title":"Time Ago","description":"Relative publication time (e.g., '2 months ago')"},"review_id":{"type":"string","title":"Review Id","description":"Unique Google review identifier"},"timestamp":{"type":"string","title":"Timestamp","description":"Absolute publication datetime in UTC format"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within identical type group"},"review_url":{"type":"string","title":"Review Url","description":"Direct link to this review"},"local_guide":{"type":"boolean","title":"Local Guide","description":"Indicates if reviewer is a Google Local Guide"},"profile_url":{"type":"string","title":"Profile Url","description":"Link to reviewer's profile"},"review_text":{"type":"string","title":"Review Text","description":"Review content (potentially translated to requested language)"},"owner_answer":{"type":"string","title":"Owner Answer","description":"Business owner's response text (potentially translated)"},"photos_count":{"type":"integer","title":"Photos Count","description":"Number of photos submitted by this reviewer"},"profile_name":{"type":"string","title":"Profile Name","description":"Reviewer's display name"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall position among all reviews"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews by this reviewer"},"owner_time_ago":{"type":"string","title":"Owner Time Ago","description":"Relative time when business responded (e.g., '1 week ago')"},"owner_timestamp":{"type":"string","title":"Owner Timestamp","description":"Absolute business response datetime in UTC format"},"original_language":{"type":"string","title":"Original Language","description":"Language code of the original review text"},"profile_image_url":{"type":"string","title":"Profile Image Url","description":"URL to reviewer's avatar image"},"review_highlights":{"type":"array","items":{"type":"object","title":"ReviewHighlight","properties":{"feature":{"type":"string","title":"Feature","description":"Reviewed aspect (e.g., 'Rooms', 'Service', 'Location')"},"assessment":{"type":"string","title":"Assessment","description":"Score or assessment for that feature"}},"description":"Featured criteria assessment for a review."},"title":"Review Highlights","description":"Featured criteria assessments for the review"},"original_review_text":{"type":"string","title":"Original Review Text","description":"Untranslated review content in original language"},"original_owner_answer":{"type":"string","title":"Original Owner Answer","description":"Untranslated business owner response in original language"}},"description":"Individual review item with complete review details."},"title":"Items","description":"List of individual review items with detailed review information"},"title":{"type":"string","title":"Title","description":"Business establishment name"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score or individual rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value for the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"}},"description":"Rating information for a business or individual review.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Business identifier or search query used for the task"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format"},"place_id":{"type":"string","title":"Place Id","description":"Google-assigned location ID for the business"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify results in SERP"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the task"},"sub_title":{"type":"string","title":"Sub Title","description":"Additional business information (e.g., address, business type)"},"feature_id":{"type":"string","title":"Feature Id","description":"Unique SERP element identifier"},"items_count":{"type":"integer","title":"Items Count","description":"Number of review items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location identifier used for the request"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews for this business"}},"description":"Result data containing Google reviews for a business establishment."},"title":"Result","description":"List of task results containing Google reviews data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with results."},"title":"Tasks","description":"Array of task objects containing Google reviews results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_GOOGLE_REVIEWS_TASK_BY_ID","name":"Get Business Data Google Reviews Task By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"os":{"type":"string","title":"Os","description":"Operating system used for the task"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"depth":{"type":"integer","title":"Depth","description":"Number of results requested"},"device":{"type":"string","title":"Device","description":"Device type used for the task"},"keyword":{"type":"string","title":"Keyword","description":"Keyword used for the task (typically business CID)"},"sort_by":{"type":"string","title":"Sort By","description":"Sorting method for reviews"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"cid":{"type":"string","title":"Cid","description":"Google client ID for the business"},"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"type":"object","title":"ReviewItem","properties":{"type":{"type":"string","title":"Type","description":"Type of review item"},"xpath":{"type":"string","title":"Xpath","description":"XPath to the review element in the page"},"images":{"type":"array","items":{"type":"object","title":"ReviewImage","properties":{"alt":{"type":"string","title":"Alt","description":"Image alt text attribute"},"url":{"type":"string","title":"Url","description":"URL to the image resource"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'images_element')"},"image_url":{"type":"string","title":"Image Url","description":"Direct URL to the image file"}},"description":"Image attached to a review."},"title":"Images","description":"List of images attached to the review"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score or individual rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value for the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"}},"description":"Rating information for a business or individual review.","additionalProperties":false},"position":{"type":"string","title":"Position","description":"Alignment in SERP (e.g., 'left')"},"time_ago":{"type":"string","title":"Time Ago","description":"Relative publication time (e.g., '2 months ago')"},"review_id":{"type":"string","title":"Review Id","description":"Unique Google review identifier"},"timestamp":{"type":"string","title":"Timestamp","description":"Absolute publication datetime in UTC format"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within identical type group"},"review_url":{"type":"string","title":"Review Url","description":"Direct link to this review"},"local_guide":{"type":"boolean","title":"Local Guide","description":"Indicates if reviewer is a Google Local Guide"},"profile_url":{"type":"string","title":"Profile Url","description":"Link to reviewer's profile"},"review_text":{"type":"string","title":"Review Text","description":"Review content (potentially translated to requested language)"},"owner_answer":{"type":"string","title":"Owner Answer","description":"Business owner's response text (potentially translated)"},"photos_count":{"type":"integer","title":"Photos Count","description":"Number of photos submitted by this reviewer"},"profile_name":{"type":"string","title":"Profile Name","description":"Reviewer's display name"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall position among all reviews"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews by this reviewer"},"owner_time_ago":{"type":"string","title":"Owner Time Ago","description":"Relative time when business responded (e.g., '1 week ago')"},"owner_timestamp":{"type":"string","title":"Owner Timestamp","description":"Absolute business response datetime in UTC format"},"original_language":{"type":"string","title":"Original Language","description":"Original language of the review"},"profile_image_url":{"type":"string","title":"Profile Image Url","description":"URL to reviewer's avatar image"},"review_highlights":{"type":"array","items":{"type":"object","title":"ReviewHighlight","properties":{"feature":{"type":"string","title":"Feature","description":"Reviewed aspect (e.g., 'Rooms', 'Service', 'Location')"},"assessment":{"type":"string","title":"Assessment","description":"Score or assessment for that feature"}},"description":"Featured criteria assessment for a review."},"title":"Review Highlights","description":"Featured criteria assessments for the review"},"original_review_text":{"type":"string","title":"Original Review Text","description":"Untranslated review content in original language"},"original_owner_answer":{"type":"string","title":"Original Owner Answer","description":"Untranslated business owner response in original language"}},"description":"Individual review item with complete review details."},"title":"Items","description":"List of individual review items with detailed review information"},"title":{"type":"string","title":"Title","description":"Business establishment name"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score or individual rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value for the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"}},"description":"Rating information for a business or individual review.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Business identifier or search keyword"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format"},"place_id":{"type":"string","title":"Place Id","description":"Google-assigned location ID for the business"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify results in SERP"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the task"},"sub_title":{"type":"string","title":"Sub Title","description":"Additional business information (e.g., address, business type)"},"feature_id":{"type":"string","title":"Feature Id","description":"Unique SERP element identifier"},"items_count":{"type":"integer","title":"Items Count","description":"Number of review items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location identifier used for the request"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews for this business"}},"description":"Result data containing reviews for a business establishment."},"title":"Result","description":"List of task results containing reviews data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with results."},"title":"Tasks","description":"Array of task objects containing reviews results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_TRIPADVISOR_REVIEWS_TASK_BY_ID","name":"Get Business Data TripAdvisor Reviews Task By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Task identifier in UUID format. Unique task identifier valid for 30 days after task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"depth":{"type":"integer","title":"Depth","description":"Number of results requested"},"sort_by":{"type":"string","title":"Sort By","description":"Sorting method for reviews"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"url_path":{"type":"string","title":"Url Path","description":"URL path for the TripAdvisor business page"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_name":{"type":"string","title":"Location Name","description":"Location name used for the request"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type (e.g., 'tripadvisor_reviews')"},"items":{"type":"array","items":{"type":"object","title":"TripAdvisorReviewItem","properties":{"url":{"type":"string","title":"Url","description":"Direct URL to the individual review"},"type":{"type":"string","title":"Type","description":"Type of review item (typically 'tripadvisor_review_search')"},"title":{"type":"string","title":"Title","description":"Review headline or title"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score or individual rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value for the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating scale type (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"}},"description":"Rating information for a business or individual review.","additionalProperties":false},"language":{"type":"string","title":"Language","description":"Language of the review text"},"position":{"type":"string","title":"Position","description":"Alignment in results page (e.g., 'left', 'right')"},"responses":{"type":"array","items":{"type":"object","title":"OwnerResponse","properties":{"text":{"type":"string","title":"Text","description":"Response content text"},"title":{"type":"string","title":"Title","description":"Owner's name or response title"},"language":{"type":"string","title":"Language","description":"Language of the response"},"timestamp":{"type":"string","title":"Timestamp","description":"Date and time when the response was published in UTC format"},"response_id":{"type":"string","title":"Response Id","description":"Unique identifier for the response"}},"description":"Business owner's response to a review."},"title":"Responses","description":"List of business owner responses to this review"},"review_id":{"type":"string","title":"Review Id","description":"Unique TripAdvisor review identifier"},"timestamp":{"type":"string","title":"Timestamp","description":"Publication date and time in UTC format"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within identical type group"},"review_text":{"type":"string","title":"Review Text","description":"Full review content text"},"user_profile":{"type":"object","title":"UserProfile","properties":{"url":{"type":"string","title":"Url","description":"URL to reviewer's profile page"},"name":{"type":"string","title":"Name","description":"Reviewer's profile name"},"location":{"type":"string","title":"Location","description":"Reviewer's location"},"image_url":{"type":"string","title":"Image Url","description":"URL to reviewer's profile image"},"reviews_count":{"type":"string","title":"Reviews Count","description":"Total number of reviews submitted by this reviewer"}},"description":"TripAdvisor reviewer profile information.","additionalProperties":false},"date_of_visit":{"type":"string","title":"Date Of Visit","description":"Date when reviewer visited the establishment"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall position among all reviews"},"review_images":{"type":"array","items":{"type":"string","properties":{}},"title":"Review Images","description":"List of image URLs attached to the review"},"original_language":{"type":"string","title":"Original Language","description":"Original language of the untranslated review"},"review_highlights":{"type":"array","items":{"type":"object","title":"ReviewHighlight","properties":{"feature":{"type":"string","title":"Feature","description":"Reviewed aspect (e.g., 'Value', 'Rooms', 'Service', 'Location')"},"assessment":{"type":"string","title":"Assessment","description":"Rating or assessment for that specific feature"}},"description":"Highlighted criteria assessment for a review."},"title":"Review Highlights","description":"List of highlighted criteria assessments for the review"}},"description":"Individual TripAdvisor review item with complete review details."},"title":"Items","description":"List of individual review items with detailed review information"},"title":{"type":"string","title":"Title","description":"Business establishment name"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Average rating score or individual rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value for the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating scale type (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"}},"description":"Rating information for a business or individual review.","additionalProperties":false},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received in UTC format"},"location":{"type":"string","title":"Location","description":"Business address"},"url_path":{"type":"string","title":"Url Path","description":"URL path from the original POST request"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to search results for verification"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (typically 'tripadvisor.com')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of review items returned in this response"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews for this establishment"},"rating_distribution":{"type":"object","title":"RatingDistribution","properties":{"1":{"type":"integer","title":"1","description":"Number of 1-star ratings"},"2":{"type":"integer","title":"2","description":"Number of 2-star ratings"},"3":{"type":"integer","title":"3","description":"Number of 3-star ratings"},"4":{"type":"integer","title":"4","description":"Number of 4-star ratings"},"5":{"type":"integer","title":"5","description":"Number of 5-star ratings"}},"description":"Vote distribution across 1-5 rating scale.","additionalProperties":false}},"description":"Result data containing TripAdvisor reviews for a business establishment."},"title":"Result","description":"List of task results containing TripAdvisor reviews data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with results."},"title":"Tasks","description":"Array of task objects containing TripAdvisor reviews results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_TRIPADVISOR_SEARCH_TASK","name":"Get Business Data TripAdvisor Search Task","description":"Tool to retrieve TripAdvisor search results by task ID. Use when you need to fetch business listings, ratings, and reviews data from TripAdvisor for a previously created search task. The task ID must be from a task created within the last 30 days.","input_parameters":{"id":{"type":"string","description":"Task identifier in UUID format. Unique task identifier obtained from task_post or tasks_ready endpoint. You will be able to use it within 30 days to request the results of the task at any time.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword"},"function":{"type":"string","title":"Function","description":"API function called"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"string","title":"Location Code","description":"Location code"}},"description":"Original request parameters from the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TripadvisorSearchResult","properties":{"items":{"type":"array","items":{"type":"object","title":"TripadvisorSearchItem","properties":{"type":{"type":"string","title":"Type","description":"Type of item (e.g., 'tripadvisor_search_organic')"},"title":{"type":"string","title":"Title","description":"Name of the business"},"rating":{"type":"object","title":"RatingObject","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum possible rating on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type format (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes for this rating"}},"description":"Rating information for a business listing.","additionalProperties":false},"category":{"type":"string","title":"Category","description":"Business category classification"},"url_path":{"type":"string","title":"Url Path","description":"URL path to the TripAdvisor business page"},"price_rate":{"type":"string","title":"Price Rate","description":"Average pricing indicator for the business"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"is_sponsored":{"type":"boolean","title":"Is Sponsored","description":"Indicates if this is a paid advertisement result"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all search results"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews for this business"}},"description":"Individual business listing item from TripAdvisor search results."},"title":"Items","description":"Array of business listing items"},"keyword":{"type":"string","title":"Keyword","description":"Search term used for the query"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when results were retrieved in UTC format (yyyy-mm-dd hh-mm-ss +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to TripAdvisor search results page"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (tripadvisor.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Array of result types present in the response (e.g., 'tripadvisor_search_organic')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of business items returned in this result set"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"string","title":"Location Code","description":"Geographic location identifier code used for the search"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results available on TripAdvisor"}},"description":"Result data containing TripAdvisor search results and metadata."},"title":"Result","description":"Array of result objects with TripAdvisor search data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success, 40000+ indicates task in queue or error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects with TripAdvisor search results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 = success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_TRIPADVISOR_SEARCH_TASK_BY_ID","name":"Get Business Data TripAdvisor Search Task By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TripadvisorSearchTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"Data","description":"Original request parameters echoed back","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"TripadvisorSearchResult","properties":{"items":{"type":"array","items":{"type":"object","title":"TripadvisorSearchItem","properties":{"type":{"type":"string","title":"Type","description":"Type of search result item (e.g., 'tripadvisor_search_organic')"},"title":{"type":"string","title":"Title","description":"Name of the business or attraction"},"rating":{"type":"object","title":"RatingData","properties":{"value":{"type":"number","title":"Value","description":"Average rating value for the business"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum possible rating value on the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of reviews/votes for the rating"}},"description":"Rating information for a TripAdvisor business listing.","additionalProperties":false},"category":{"type":"string","title":"Category","description":"Business category classification (e.g., 'Restaurant', 'Hotel')"},"url_path":{"type":"string","title":"Url Path","description":"TripAdvisor URL path to the business page"},"price_rate":{"type":"string","title":"Price Rate","description":"Price range indicator for the business"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within the same result type group"},"is_sponsored":{"type":"boolean","title":"Is Sponsored","description":"Indicates if this is a paid/sponsored listing"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall position in all search results"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Total number of reviews for the business"}},"description":"Individual TripAdvisor business listing result item."},"title":"Items","description":"Array of TripAdvisor business listing items"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword used for the task"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when results were retrieved in UTC format"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify results on TripAdvisor"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (e.g., 'tripadvisor.com')"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of items found in the search results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of business listing items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search results"},"location_code":{"type":"integer","title":"Location Code","description":"Location identifier code used for the search"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results available on TripAdvisor"}},"description":"Result data containing TripAdvisor search results and metadata."},"title":"Result","description":"Array of TripAdvisor search results"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing request parameters and TripAdvisor search results."},"title":"Tasks","description":"Array of task data containing TripAdvisor search results"},"version":{"type":"string","title":"Version","description":"API version identifier"},"status_code":{"type":"integer","title":"Status Code","description":"General status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks returned in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the overall request"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_BUSINESS_DATA_TRUSTPILOT_SEARCH_TASK_BY_ID","name":"Get Business Data Trustpilot Search Task By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format. You can use it within 30 days to request the results of the task at any time.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or search query"},"function":{"type":"string","title":"Function","description":"Function name"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"}},"description":"Original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TrustpilotSearchResult","properties":{"items":{"type":"array","items":{"type":"object","title":"TrustpilotSearchItem","properties":{"url":{"type":"string","title":"Url","description":"URL to the establishment on Trustpilot"},"type":{"type":"string","title":"Type","description":"Type of the result item (e.g., 'trustpilot_search_organic')"},"title":{"type":"string","title":"Title","description":"Title of the establishment"},"domain":{"type":"string","title":"Domain","description":"Domain of the establishment"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"The value of the rating"},"rating_max":{"type":"integer","title":"Rating Max","description":"The maximum value for this rating_type"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating system (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"The amount of feedback or votes received"}},"description":"Represents rating information for a Trustpilot business profile.","additionalProperties":false},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of elements with identical type values"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute rank among all the listed reviews"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"The total number of reviews for the business"}},"description":"Represents a single business profile item from Trustpilot search results."},"title":"Items","description":"Array of business profile items found in Trustpilot search"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or search query specified in the POST request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the search results on Trustpilot"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain specified in the POST request"},"items_count":{"type":"integer","title":"Items Count","description":"The number of items in the results array"}},"description":"Result data for a Trustpilot Search task containing business profiles."},"title":"Result","description":"Array of Trustpilot search results containing business profiles"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Informational message of the task"}},"description":"Represents a single task in the tasks array."},"title":"Tasks","description":"Array of tasks containing Trustpilot search results"},"version":{"type":"string","title":"Version","description":"Current version of the API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code of the API response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"The number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"The number of tasks that returned an error"},"status_message":{"type":"string","title":"Status Message","description":"General informational message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Business Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_CHAT_GPT_LLM_SCRAPER_LOCATIONS_BY_COUNTRY","name":"Get ChatGPT LLM Scraper Locations By Country","description":"Tool 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.","input_parameters":{"country":{"type":"string","description":"Country ISO code to filter the list of locations. Example: 'us' for United States, 'gb' for United Kingdom.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD."},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique UUID task identifier."},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD."},"data":{"type":"object","title":"Data","description":"Request parameters used for this task.","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","title":"LocationResult","properties":{"location_code":{"type":"integer","title":"Location Code","description":"Unique location identifier code."},"location_name":{"type":"string","title":"Location Name","description":"Full name of the location."},"location_type":{"type":"string","title":"Location Type","description":"Classification of the location (e.g., Country, State, City)."},"country_iso_code":{"type":"string","title":"Country Iso Code","description":"ISO country code for the location."},"location_code_parent":{"type":"integer","title":"Location Code Parent","description":"Parent location code (null for top-level locations)."}},"description":"Represents a single location entry for ChatGPT LLM Scraper."},"title":"Result","description":"Array of location results."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code."},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned for this task."},"status_message":{"type":"string","title":"Status Message","description":"Task-specific status message."}},"description":"Represents a single task result in the DataForSEO response."},"title":"Tasks","description":"Array of task result objects containing location data."},"version":{"type":"string","title":"Version","description":"Current API version."},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about request status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_CONTENT_ANALYSIS_AVAILABLE_FILTERS","name":"Get Content Analysis Available Filters","description":"Tool to retrieve available filters for DataForSEO Content Analysis API endpoints. Use when you need to discover which fields can be filtered in content analysis queries including URL attributes, content metadata, sentiment analysis, quality metrics, and categorization fields.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API name (e.g., 'content_analysis')"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'available_filters')"}},"description":"Represents task-level data in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"type":"object","additionalProperties":{"type":"string"}}},"title":"Result","description":"Array containing filter definitions organized by endpoint. Each object maps endpoint names to field definitions, where field names map to their type indicators (e.g., 'str', 'bool', 'num', 'time', 'array.str', 'array.num'). Filter fields include url, domain, content_info (title, author, language, sentiment analysis), quality metrics, and categorization fields."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Represents a single task in the response containing filter information."},"title":"Tasks","description":"Array of tasks containing filter definitions for Content Analysis API endpoints"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"Response status code (e.g., 20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Content Analysis"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_AVAILABLE_FILTERS","name":"Get DataForSEO Labs Available Filters","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API name (e.g., 'dataforseo_labs')"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'available_filters')"}},"description":"Represents task-level data in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":{"type":"string"}}]}},{"type":"string"}]}},"title":"Result","description":"Array containing filter definitions organized by endpoint. Each object maps endpoint names to field definitions, where field names map to their type indicators ('str', 'bool', 'num', 'time', 'array.str', 'array.num')"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Represents a single task in the response containing filter information."},"title":"Tasks","description":"Array of tasks containing filter definitions for different DataForSEO Labs API endpoints"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"Response status code (e.g., 20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","DataForSEO Labs"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_BING_RELATED_KEYWORDS_LIVE","name":"Get Bing Related Keywords Live","description":"Tool to retrieve Bing related keywords appearing in 'searches related to' SERP element. Provides up to 4680 keyword ideas with search volume, cost-per-click, competition, and 12-month trend data. Use when you need to discover related keywords and expand keyword research for SEO or paid search campaigns on Bing.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier for tracking purposes. Maximum 255 characters","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"depth":{"type":"integer","description":"Search depth for related keywords (0-4). Determines how many levels of related keywords to retrieve. Default: 1. Higher values return more keywords but cost more","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"limit":{"type":"integer","description":"Maximum number of results to return. Default: 100, Maximum: 1000. You can get up to 4680 keyword ideas depending on depth","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"offset":{"type":"integer","description":"Offset in the results array for pagination. Default: 0","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"filters":{"type":"array","description":"Results filtering parameters using logical operators. Maximum 8 filters. Supports operators like regex, <, >, =, like, ilike, in, etc. Example: ['keyword_data.keyword_info.search_volume', '>', 0]","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"anyOf":[{"type":"string"},{"type":"array","items":{}}],"properties":{}}},"keyword":{"type":"string","description":"UTF-8 encoded keyword (converted to lowercase, e.g., 'smartphone'). The seed keyword for which to find related keywords appearing in 'searches related to' SERP element","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"order_by":{"type":"array","description":"Results sorting rules. Maximum 3 sorting rules. Format: ['field,asc'] or ['field,desc']. Example: ['keyword_data.keyword_info.search_volume,desc']","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"language_code":{"type":"string","description":"Language code (e.g., 'en'). Use language_code OR language_name","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Language name for the search (e.g., 'English'). Use language_name OR language_code","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"Geographic location code (e.g., 2840 for United States). Use location_code OR location_name","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Geographic location name for the search (e.g., 'United States'). Use location_name OR location_code","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"include_serp_info":{"type":"boolean","description":"If true, includes additional SERP data for each keyword. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"include_seed_keyword":{"type":"boolean","description":"If true, includes data for the seed keyword in the response. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of all tasks in the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of this specific task in USD"},"data":{"type":"object","title":"Data","description":"Echo of the original request parameters","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true},{"type":"null"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments used for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"ResultData","properties":{"items":{"type":"array","items":{"type":"object","title":"RelatedKeywordItem","properties":{"depth":{"type":"integer","title":"Depth","description":"Depth level at which this related keyword was found (0 = seed keyword, 1+ = related keywords)"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type (e.g., 'bing')"},"keyword_data":{"type":"object","title":"KeywordData","properties":{"keyword":{"type":"string","title":"Keyword","description":"The related keyword"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type (e.g., 'bing')"},"serp_info":{"type":"object","title":"Serp Info","description":"SERP information for the keyword (included if include_serp_info is true)","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true},{"type":"null"}]}},"keyword_info":{"type":"object","title":"KeywordInfo","properties":{"cpc":{"type":"number","title":"Cpc","description":"Cost-per-click for the keyword in USD"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type (e.g., 'bing')"},"categories":{"type":"array","items":{"type":"integer","properties":{}},"title":"Categories","description":"List of category IDs the keyword belongs to"},"competition":{"type":"number","title":"Competition","description":"Competition level for the keyword in paid search (0-1 range, where 1 is highest competition)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average monthly search volume for the keyword in the specified location"},"monthly_searches":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}]}},"title":"Monthly Searches","description":"Search volume trend for the previous 12 months. Array of objects with 'year', 'month', and 'search_volume' fields"},"last_updated_time":{"type":"string","title":"Last Updated Time","description":"Date and time when the keyword data was last updated (in UTC format)"}},"description":"Contains keyword metrics and information.","additionalProperties":false},"language_code":{"type":"string","title":"Language Code","description":"Language code for this keyword data"},"location_code":{"type":"integer","title":"Location Code","description":"Location code for this keyword data"},"impressions_info":{"type":"object","title":"Impressions Info","description":"Impressions data for the keyword if available","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"null"}]}},"avg_backlinks_info":{"type":"object","title":"Avg Backlinks Info","description":"Average backlinks information for ranking pages","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"null"}]}}},"description":"Contains detailed keyword data including metrics.","additionalProperties":false},"related_keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Related Keywords","description":"Array of keywords related to this keyword (if depth allows further traversal)"}},"description":"Individual related keyword result."},"title":"Items","description":"Array of related keyword data with search volume, CPC, competition, and trends"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type (e.g., 'bing')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of related keyword results returned in this response"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of related keywords available"},"seed_keyword":{"type":"string","title":"Seed Keyword","description":"The original seed keyword from the request"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the search"}},"description":"Contains the array of related keyword results."},"title":"Result","description":"Array of result objects containing related keyword data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about task execution status"}},"description":"Individual task execution details and results."},"title":"Tasks","description":"Array of task objects with execution details and related keyword results"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range) indicating overall response status"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the overall API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","DataForSEO Labs"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_GOOGLE_AVAILABLE_HISTORY","name":"Get DataForSEO Labs Google Available History","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD."},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format."},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD."},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API type (e.g., 'dataforseo_labs')"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'available_history')"}},"description":"Represents task metadata information.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","title":"DateResult","properties":{"date":{"type":"string","title":"Date","examples":["2022-07-01","2022-06-01","2022-05-01"],"description":"Available date in ISO 8601 format (YYYY-MM-DD). This date can be used in the first_date and second_date fields of the Domain Metrics by Categories endpoint."}},"description":"Represents a single available date."},"title":"Result","description":"Array of available dates that can be used for historical domain metrics queries. Each object contains a date field in YYYY-MM-DD format."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure."},"result_count":{"type":"integer","title":"Result Count","description":"Number of available dates returned."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status."}},"description":"Represents a single task in the response containing available history dates."},"title":"Tasks","description":"Array of tasks containing available historical dates for domain metrics queries."},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API."},"status_code":{"type":"integer","title":"Status Code","description":"Response status code (e.g., 20000 for success)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","DataForSEO Labs"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_GOOGLE_TOP_SEARCHES_LIVE","name":"Get DataForSEO Labs Google Top Searches Live","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier (max 255 characters) for matching tasks with results","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"limit":{"type":"integer","description":"Maximum number of results to return. Maximum is 1000. Default: 1000","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"offset":{"type":"integer","description":"Pagination offset. Recommended for results under 10,000. Default: 0","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"filters":{"type":"array","description":"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]]","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]},"properties":{}}},"order_by":{"type":"array","description":"Sorting rules (up to 3). Format: 'field,direction'. Example: ['keyword_info.search_volume,desc']","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"offset_token":{"type":"string","description":"Token for pagination beyond 10,000 results. Use instead of offset for large result sets to avoid timeouts","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_code":{"type":"string","description":"Language code for the search. Either language_name or language_code is required. Example: 'en'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Full language name for the search. Either language_name or language_code is required. Example: 'English'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"Location code for the search. Either location_name or location_code is required. Example: 2840 (United States)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Full location name for the search. Either location_name or location_code is required. Example: 'United States'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"ignore_synonyms":{"type":"boolean","description":"Return only core keywords, excluding synonyms. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"include_serp_info":{"type":"boolean","description":"Include SERP data for each keyword. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"include_clickstream_data":{"type":"boolean","description":"Include clickstream metrics (gender/age distribution, search volume). Doubles the cost. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the request"},"limit":{"type":"integer","title":"Limit","description":"Limit from the request"},"offset":{"type":"integer","title":"Offset","description":"Offset from the request"},"filters":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]},"properties":{}},"title":"Filters","description":"Filters from the request"},"function":{"type":"string","title":"Function","description":"API function name"},"order_by":{"type":"array","items":{"type":"string","properties":{}},"title":"Order By","description":"Order by rules from the request"},"offset_token":{"type":"string","title":"Offset Token","description":"Offset token from the request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from the request"},"ignore_synonyms":{"type":"boolean","title":"Ignore Synonyms","description":"Ignore synonyms flag from the request"},"include_serp_info":{"type":"boolean","title":"Include Serp Info","description":"Include SERP info flag from the request"},"include_clickstream_data":{"type":"boolean","title":"Include Clickstream Data","description":"Include clickstream data flag from the request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"ResultSet","properties":{"items":{"type":"array","items":{"type":"object","title":"KeywordItem","properties":{"keyword":{"type":"string","title":"Keyword","description":"The keyword text"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"serp_info":{"type":"object","title":"SerpInfo","properties":{"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"check_url":{"type":"string","title":"Check Url","description":"URL to check SERP results"},"serp_item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Serp Item Types","description":"Types of SERP elements present (organic, paid, featured_snippet, etc.)"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results"},"last_updated_time":{"type":"string","title":"Last Updated Time","description":"Last time SERP was checked in UTC format"}},"description":"Represents SERP information for a keyword.","additionalProperties":false},"keyword_info":{"type":"object","title":"KeywordInfo","properties":{"cpc":{"type":"number","title":"Cpc","description":"Cost per click in USD"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type (e.g., 'google')"},"categories":{"type":"array","items":{"type":"integer","properties":{}},"title":"Categories","description":"Product category codes"},"competition":{"type":"number","title":"Competition","description":"Competition level as a value from 0 to 1"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average monthly search volume"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearch","properties":{"year":{"type":"integer","title":"Year","description":"Year of the search data"},"month":{"type":"integer","title":"Month","description":"Month of the search data (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly search volume for this period"}},"description":"Represents monthly search volume data."},"title":"Monthly Searches","description":"Historical monthly search volumes"},"competition_level":{"type":"string","title":"Competition Level","description":"Competition level category: LOW, MEDIUM, or HIGH"},"last_updated_time":{"type":"string","title":"Last Updated Time","description":"Last time keyword data was updated in UTC format"},"low_top_of_page_bid":{"type":"number","title":"Low Top Of Page Bid","description":"Minimum bid for top of page placement in USD"},"search_volume_trend":{"type":"object","title":"SearchVolumeTrend","properties":{"yearly":{"type":"integer","title":"Yearly","description":"Yearly search volume change percentage"},"monthly":{"type":"integer","title":"Monthly","description":"Monthly search volume change percentage"},"quarterly":{"type":"integer","title":"Quarterly","description":"Quarterly search volume change percentage"}},"description":"Represents search volume trend percentages.","additionalProperties":false},"high_top_of_page_bid":{"type":"number","title":"High Top Of Page Bid","description":"Maximum bid for top of page placement in USD"}},"description":"Represents Google Ads keyword metrics and search volume data.","additionalProperties":false},"language_code":{"type":"string","title":"Language Code","description":"Language code for this keyword"},"location_code":{"type":"integer","title":"Location Code","description":"Location code for this keyword"},"avg_backlinks_info":{"type":"object","title":"AvgBacklinksInfo","properties":{"rank":{"type":"number","title":"Rank","description":"Average rank"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"dofollow":{"type":"number","title":"Dofollow","description":"Average number of dofollow backlinks"},"backlinks":{"type":"number","title":"Backlinks","description":"Average number of backlinks"},"referring_pages":{"type":"number","title":"Referring Pages","description":"Average number of referring pages"},"main_domain_rank":{"type":"number","title":"Main Domain Rank","description":"Average main domain rank"},"last_updated_time":{"type":"string","title":"Last Updated Time","description":"Last update time in UTC format"},"referring_domains":{"type":"number","title":"Referring Domains","description":"Average number of referring domains"},"referring_main_domains":{"type":"number","title":"Referring Main Domains","description":"Average number of referring main domains"}},"description":"Represents average backlink metrics for ranking pages.","additionalProperties":false},"keyword_properties":{"type":"object","title":"KeywordProperties","properties":{"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"words_count":{"type":"integer","title":"Words Count","description":"Number of words in the keyword"},"core_keyword":{"type":"string","title":"Core Keyword","description":"Core keyword if this is a synonym variant"},"detected_language":{"type":"string","title":"Detected Language","description":"Detected language of the keyword"},"keyword_difficulty":{"type":"integer","title":"Keyword Difficulty","description":"Keyword difficulty score from 0 to 100"},"is_another_language":{"type":"boolean","title":"Is Another Language","description":"Whether keyword is in a different language than requested"},"synonym_clustering_algorithm":{"type":"string","title":"Synonym Clustering Algorithm","description":"Algorithm used for synonym clustering: keyword_metrics or text_processing"}},"description":"Represents keyword properties and metadata.","additionalProperties":false},"search_intent_info":{"type":"object","title":"SearchIntentInfo","properties":{"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"main_intent":{"type":"string","title":"Main Intent","description":"Primary search intent: informational, navigational, commercial, or transactional"},"foreign_intent":{"type":"array","items":{"type":"string","properties":{}},"title":"Foreign Intent","description":"Secondary intents detected"},"last_updated_time":{"type":"string","title":"Last Updated Time","description":"Last update time in UTC format"}},"description":"Represents search intent classification.","additionalProperties":false},"clickstream_keyword_info":{"type":"object","title":"ClickstreamKeywordInfo","properties":{"search_volume":{"type":"integer","title":"Search Volume","description":"Clickstream-based search volume"},"age_distribution":{"type":"object","title":"AgeDistribution","properties":{"18-24":{"type":"integer","title":"18 24","description":"Percentage of searchers aged 18-24"},"25-34":{"type":"integer","title":"25 34","description":"Percentage of searchers aged 25-34"},"35-44":{"type":"integer","title":"35 44","description":"Percentage of searchers aged 35-44"},"45-54":{"type":"integer","title":"45 54","description":"Percentage of searchers aged 45-54"},"55-64":{"type":"integer","title":"55 64","description":"Percentage of searchers aged 55-64"}},"description":"Represents age distribution in search traffic.","additionalProperties":false},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearch","properties":{"year":{"type":"integer","title":"Year","description":"Year of the search data"},"month":{"type":"integer","title":"Month","description":"Month of the search data (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly search volume for this period"}},"description":"Represents monthly search volume data."},"title":"Monthly Searches","description":"Historical monthly search volumes from clickstream data"},"last_updated_time":{"type":"string","title":"Last Updated Time","description":"Last update time in UTC format"},"gender_distribution":{"type":"object","title":"GenderDistribution","properties":{"male":{"type":"integer","title":"Male","description":"Percentage of male searchers"},"female":{"type":"integer","title":"Female","description":"Percentage of female searchers"}},"description":"Represents gender distribution in search traffic.","additionalProperties":false}},"description":"Represents clickstream data including demographics.","additionalProperties":false},"keyword_info_normalized_with_bing":{"type":"object","title":"NormalizedKeywordInfo","properties":{"is_normalized":{"type":"boolean","title":"Is Normalized","description":"Whether data has been normalized"},"search_volume":{"type":"integer","title":"Search Volume","description":"Normalized search volume"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearch","properties":{"year":{"type":"integer","title":"Year","description":"Year of the search data"},"month":{"type":"integer","title":"Month","description":"Month of the search data (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly search volume for this period"}},"description":"Represents monthly search volume data."},"title":"Monthly Searches","description":"Normalized historical monthly search volumes"},"last_updated_time":{"type":"string","title":"Last Updated Time","description":"Last update time in UTC format"}},"description":"Represents normalized keyword metrics.","additionalProperties":false},"keyword_info_normalized_with_clickstream":{"type":"object","title":"NormalizedKeywordInfo","properties":{"is_normalized":{"type":"boolean","title":"Is Normalized","description":"Whether data has been normalized"},"search_volume":{"type":"integer","title":"Search Volume","description":"Normalized search volume"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearch","properties":{"year":{"type":"integer","title":"Year","description":"Year of the search data"},"month":{"type":"integer","title":"Month","description":"Month of the search data (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly search volume for this period"}},"description":"Represents monthly search volume data."},"title":"Monthly Searches","description":"Normalized historical monthly search volumes"},"last_updated_time":{"type":"string","title":"Last Updated Time","description":"Last update time in UTC format"}},"description":"Represents normalized keyword metrics.","additionalProperties":false}},"description":"Represents a single keyword with all associated metrics."},"title":"Items","description":"Array of keyword items with metrics"},"offset":{"type":"integer","title":"Offset","description":"Offset used for this result"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type (e.g., 'google')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of keyword items returned in this response"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of keywords matching the query in the database"},"offset_token":{"type":"string","title":"Offset Token","description":"Token for next page of results (for pagination beyond 10k)"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for this result"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for this result"}},"description":"Represents a result set containing keyword items."},"title":"Result","description":"Array of result sets containing top search keywords with metrics"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success, 40000+ indicates error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects containing keyword results with metrics"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","DataForSEO Labs"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DATAFORSEO_LABS_STATUS","name":"Get DataForSEO Labs Status","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD (typically 0 for this endpoint)"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD (typically 0 for this endpoint)"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API type (e.g., 'dataforseo_labs')"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'status')"}},"description":"Represents task metadata information.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"LabsStatusResult","properties":{"bing":{"type":"object","title":"LabsUpdateDate","properties":{"date_update":{"type":"string","title":"Date Update","description":"Last update date in YYYY-MM-DD format"}},"description":"Represents the last update date for a specific Labs data source.","additionalProperties":false},"amazon":{"type":"object","title":"LabsUpdateDate","properties":{"date_update":{"type":"string","title":"Date Update","description":"Last update date in YYYY-MM-DD format"}},"description":"Represents the last update date for a specific Labs data source.","additionalProperties":false},"google":{"type":"object","title":"LabsUpdateDate","properties":{"date_update":{"type":"string","title":"Date Update","description":"Last update date in YYYY-MM-DD format"}},"description":"Represents the last update date for a specific Labs data source.","additionalProperties":false}},"description":"Contains update date information for Google, Bing, and Amazon Labs data sources."},"title":"Result","description":"Array containing update date information for Google, Bing, and Amazon Labs data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Represents a single task in the response containing Labs status information."},"title":"Tasks","description":"Array of task objects containing Labs update status information"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","DataForSEO Labs"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DATAFORSEO_TRENDS_LOCATIONS_BY_COUNTRY","name":"Get DataForSEO Trends Locations By Country","description":"Tool to retrieve DataForSEO Trends locations filtered by country ISO code. Use when you need to get the list of valid locations for setting up DataForSEO Trends tasks. Note that the minimum geographic scope supported is country level.","input_parameters":{"country":{"type":"string","description":"Country ISO code to filter the list of locations. Example: 'us' for United States, 'gb' for United Kingdom.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD."},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique UUID task identifier."},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD."},"data":{"type":"object","title":"Data","description":"Request parameters used for this task.","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","title":"LocationResult","properties":{"location_code":{"type":"integer","title":"Location Code","description":"Unique location identifier code."},"location_name":{"type":"string","title":"Location Name","description":"Full name of the location."},"location_type":{"type":"string","title":"Location Type","description":"Classification of the location (e.g., Country, State, City)."},"country_iso_code":{"type":"string","title":"Country Iso Code","description":"ISO country code for the location."},"location_code_parent":{"type":"integer","title":"Location Code Parent","description":"Parent location code (null for top-level locations)."}},"description":"Represents a single location entry for DataForSEO Trends."},"title":"Result","description":"Array of location results."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code."},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned for this task."},"status_message":{"type":"string","title":"Status Message","description":"Task-specific status message."}},"description":"Represents a single task result in the DataForSEO response."},"title":"Tasks","description":"Array of task result objects containing location data."},"version":{"type":"string","title":"Version","description":"Current API version."},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about request status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DOMAIN_ANALYTICS_TECH_AVAILABLE_FILTERS","name":"Get Domain Analytics Technologies Available Filters","description":"Tool 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, boolean, array, or timestamp).","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD."},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format."},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD."},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API type (e.g., 'domain_analytics')"},"function":{"type":"string","title":"Function","description":"Function name (e.g., 'available_filters')"}},"description":"Represents task metadata information.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"aggregated_pages":{"type":"object","title":"Aggregated Pages","description":"Filter fields available for aggregated_pages endpoint. Keys are field names, values indicate type (e.g., 'str' for string, 'num' for numeric, 'bool' for boolean, 'array.str' for string array, 'time' for timestamp).","additionalProperties":{"type":"string"}},"technology_stats":{"type":"object","title":"Technology Stats","description":"Filter fields available for technology_stats endpoint. Keys are field names, values indicate type (e.g., 'str' for string, 'num' for numeric, 'bool' for boolean, 'array.str' for string array, 'time' for timestamp).","additionalProperties":{"type":"string"}},"domain_technologies":{"type":"object","title":"Domain Technologies","description":"Filter fields available for domain_technologies endpoint. Keys are field names, values indicate type (e.g., 'str' for string, 'num' for numeric, 'bool' for boolean, 'array.str' for string array, 'time' for timestamp).","additionalProperties":{"type":"string"}},"technologies_summary":{"type":"object","title":"Technologies Summary","description":"Filter fields available for technologies_summary endpoint. Keys are field names, values indicate type (e.g., 'str' for string, 'num' for numeric, 'bool' for boolean, 'array.str' for string array, 'time' for timestamp).","additionalProperties":{"type":"string"}},"domains_by_technology":{"type":"object","title":"Domains By Technology","description":"Filter fields available for domains_by_technology endpoint. Keys are field names, values indicate type (e.g., 'str' for string, 'num' for numeric, 'bool' for boolean, 'array.str' for string array, 'time' for timestamp).","additionalProperties":{"type":"string"}}},"description":"Represents filter definitions for Domain Analytics Technologies endpoints.\nFilter definitions are organized by endpoint name with field names and types."},"title":"Result","description":"Array containing filter definitions organized by endpoint. Each object contains endpoint names mapping to field definitions where field names map to their type indicators."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status."}},"description":"Represents a single task in the response containing filter information."},"title":"Tasks","description":"Array of tasks containing filter definitions for Domain Analytics Technologies endpoints."},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API."},"status_code":{"type":"integer","title":"Status Code","description":"Response status code (e.g., 20000 for success)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Domain Analytics"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DOMAIN_ANALYTICS_TECH_TECHNOLOGY_STATS_LIVE","name":"Get Domain Analytics Technologies Technology Stats Live","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"GetDomainAnalyticsTechTechnologyStatsLiveRequestItem","required":["technology"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","tech_analysis_q1"],"description":"Custom identifier for task tracking. Maximum 255 characters. This tag will be returned in the response to help match tasks with your internal system."},"date_to":{"type":"string","title":"Date To","examples":["2024-01-31","2024-12-31","2025-03-15"],"description":"End date for the analysis period in 'yyyy-mm-dd' format (e.g., '2024-01-31'). If omitted, defaults to the current date. Must be after date_from if both are specified."},"date_from":{"type":"string","title":"Date From","examples":["2023-01-01","2022-10-31","2024-06-15"],"description":"Start date for the analysis period in 'yyyy-mm-dd' format (e.g., '2023-01-01'). Minimum allowed date is 2022-10-31. If omitted, defaults to the minimum date. Note: Historical data may be limited for some technologies."},"technology":{"type":"string","title":"Technology","examples":["jQuery","React","WordPress","Google Analytics"],"description":"Target technology to analyze (e.g., 'jQuery', 'React', 'WordPress'). Must be a valid technology name from DataForSEO's technologies list. This field is required."}},"description":"Individual task item for Domain Analytics Technologies Technology Stats Live request.","requiredFields":"$17:props:tools:72:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Custom tag from request"},"date_to":{"type":"string","title":"Date To","description":"End date from request"},"function":{"type":"string","title":"Function","description":"API function called"},"date_from":{"type":"string","title":"Date From","description":"Start date from request"},"technology":{"type":"string","title":"Technology","description":"Technology name from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds (e.g., '0.5612')"},"result":{"type":"array","items":{"type":"object","title":"Result","properties":{"items":{"type":"array","items":{"type":"object","title":"TechnologyStatsItem","properties":{"date":{"type":"string","title":"Date","description":"Date of this data point in 'yyyy-mm-dd' format"},"type":{"type":"string","title":"Type","description":"Item type, always 'technology_stats_item'"},"countries":{"type":"object","title":"Countries","description":"Domain count distribution by country. Keys are ISO 3166-1 alpha-2 country codes (e.g., 'US', 'GB'), values are domain counts.","additionalProperties":{"type":"integer"}},"languages":{"type":"object","title":"Languages","description":"Domain count distribution by language. Keys are ISO 639-1 language codes (e.g., 'en', 'es'), values are domain counts.","additionalProperties":{"type":"integer"}},"domains_rank":{"type":"object","title":"Domains Rank","description":"Distribution of domains across backlink rank ranges. Keys represent rank range buckets, values are domain counts.","additionalProperties":{"type":"integer"}},"domains_count":{"type":"integer","title":"Domains Count","description":"Total number of domains using the technology on this date"}},"description":"Individual data point for technology statistics on a specific date."},"title":"Items","description":"Array of daily technology statistics, each containing domain counts and distributions"},"date_to":{"type":"string","title":"Date To","description":"End date of the analysis period"},"date_from":{"type":"string","title":"Date From","description":"Start date of the analysis period"},"technology":{"type":"string","title":"Technology","description":"Name of the analyzed technology"},"items_count":{"type":"integer","title":"Items Count","description":"Number of data points (items) in the result"}},"description":"Result data containing technology statistics."},"title":"Result","description":"Array containing technology statistics results"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates successful completion, codes 40000+ indicate errors."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects returned"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects containing technology statistics results"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Domain Analytics"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_DOMAIN_ANALYTICS_WHOIS_AVAILABLE_FILTERS","name":"Get Domain Analytics Whois Available Filters","description":"Tool to retrieve available filters for Domain Analytics Whois API endpoints. Use when you need to discover which fields can be filtered in whois queries and their data types.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the task in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"Data","description":"Request parameters used for the task","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":{"type":"string"}}]}},"title":"Result","description":"Array containing filter definitions. Each object contains endpoint-specific filter groups (e.g., 'overview') which map field names to their type indicators (e.g., 'str', 'bool', 'num', 'time', 'array.str', 'array.num')"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Represents a single task in the response containing filter information."},"title":"Tasks","description":"Array of tasks containing filter definitions for Domain Analytics Whois API endpoints"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"Response status code (e.g., 20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Domain Analytics"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_GEMINI_LLM_RESPONSES_TASK_BY_ID","name":"Get Gemini LLM Responses Task Results","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Cost of the API call"},"time":{"type":"string","title":"Time","description":"Time taken to process the request"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Cost of the task"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API identifier"},"top_p":{"type":"number","title":"Top P","description":"Top-p parameter for sampling"},"function":{"type":"string","title":"Function","description":"Function name"},"model_name":{"type":"string","title":"Model Name","description":"Name of the model used"},"temperature":{"type":"number","title":"Temperature","description":"Temperature parameter for generation"},"user_prompt":{"type":"string","title":"User Prompt","description":"User prompt provided to the model"},"message_chain":{"type":"array","items":{"type":"object","title":"MessageChainItem","properties":{"role":{"type":"string","title":"Role","description":"Role of the message sender (e.g., 'user' or 'ai')"},"message":{"type":"string","title":"Message","description":"The message content"}},"description":"Represents a single message in the conversation chain."},"title":"Message Chain","description":"Array of role-based message exchanges in the conversation"},"system_message":{"type":"string","title":"System Message","description":"System message provided to the model"},"max_output_tokens":{"type":"integer","title":"Max Output Tokens","description":"Maximum number of output tokens"}},"description":"Echo of the original request parameters for this task.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task"},"result":{"type":"array","items":{"type":"object","title":"TaskResultItem","properties":{"items":{"type":"array","items":{"type":"object","title":"ResponseItem","properties":{"type":{"type":"string","title":"Type","description":"Type of item (e.g., 'message')"},"sections":{"type":"array","items":{"type":"object","title":"Section","properties":{"text":{"type":"string","title":"Text","description":"The text content of the section"},"type":{"type":"string","title":"Type","description":"Type of section (e.g., 'text')"},"annotations":{"type":"array","items":{"type":"object","title":"Annotation","properties":{"url":{"type":"string","title":"Url","description":"URL of the referenced source"},"title":{"type":"string","title":"Title","description":"Title of the referenced source"}},"description":"Represents a citation or reference annotation in the response text."},"title":"Annotations","description":"List of annotations/citations for this section"}},"description":"Represents a section within a message item."},"title":"Sections","description":"List of sections in this item"}},"description":"Represents an item in the result array."},"title":"Items","description":"List of response items containing the LLM output"},"datetime":{"type":"string","title":"Datetime","description":"Datetime when the task was executed"},"model_name":{"type":"string","title":"Model Name","description":"Name of the Gemini model"},"web_search":{"type":"boolean","title":"Web Search","description":"Whether web search was enabled"},"money_spent":{"type":"number","title":"Money Spent","description":"Cost of this task execution"},"input_tokens":{"type":"integer","title":"Input Tokens","description":"Number of input tokens used"},"output_tokens":{"type":"integer","title":"Output Tokens","description":"Number of output tokens generated"},"fan_out_queries":{"type":"array","items":{"type":"string","properties":{}},"title":"Fan Out Queries","description":"List of related search queries derived from the main query"}},"description":"Represents a single result item in the task results array."},"title":"Result","description":"Array of result items containing the LLM responses"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message for the task"}},"description":"Represents a single task in the tasks array."},"title":"Tasks","description":"Array of task objects containing the results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"HTTP status code of the response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that had errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_GEMINI_LLM_SCRAPER_HTML","name":"Get Gemini LLM Scraper HTML Results","description":"Tool to retrieve HTML-formatted results for a completed Gemini LLM Scraper task. Use when you need to fetch the raw HTML response from Google Gemini LLM for a specific task ID. Tasks remain available for 7 days after creation.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format obtained from task_post endpoint","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"UUID format task identifier"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"keyword":{"type":"string","title":"Keyword","description":"Keyword parameter from POST request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from POST request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from POST request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"ResultItem","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlItem","properties":{"date":{"type":"string","title":"Date","description":"UTC timestamp when the page was scanned"},"html":{"type":"string","title":"Html","description":"Raw HTML page content returned by Google Gemini LLM"},"page":{"type":"integer","title":"Page","description":"Sequential page number"}},"description":"Individual HTML page item from the Gemini LLM Scraper result."},"title":"Items","description":"Array of HTML page items"},"keyword":{"type":"string","title":"Keyword","description":"Decoded search query or keyword used in the task"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when the result was retrieved"},"items_count":{"type":"integer","title":"Items Count","description":"Number of HTML page items returned"},"language_code":{"type":"string","title":"Language Code","description":"Language specification code (e.g., 'en', 'es')"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier code"}},"description":"Result object containing Gemini LLM Scraper HTML results."},"title":"Result","description":"Array of result objects containing HTML data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Task-specific informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array containing task results with HTML data"},"version":{"type":"string","title":"Version","description":"Current API version string"},"status_code":{"type":"integer","title":"Status Code","description":"General status indicator (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_GEMINI_LLM_SCRAPER_LOCATIONS","name":"Get Gemini LLM Scraper Locations","description":"Tool to retrieve available locations for DataForSEO's Gemini LLM Scraper. Use when you need to get the list of supported countries and territories (213 locations) where the Gemini LLM Scraper can be used. Returns location codes, names, country ISO codes, and location types.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Cost of the API call (always 0 for this endpoint)"},"time":{"type":"string","title":"Time","description":"Time taken to process the request"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"result":{"type":"array","items":{"type":"object","title":"LocationInfo","required":["location_code","location_name","country_iso_code","location_type"],"properties":{"location_code":{"type":"integer","title":"Location Code","description":"Unique numeric identifier for the location"},"location_name":{"type":"string","title":"Location Name","description":"Human-readable name of the location"},"location_type":{"type":"string","title":"Location Type","description":"Type of the location (e.g., Country, Region, City)"},"country_iso_code":{"type":"string","title":"Country Iso Code","description":"ISO 3166-1 alpha-2 country code"},"location_code_parent":{"type":"integer","title":"Location Code Parent","description":"Parent location code, if applicable"}},"description":"Represents a single location where Gemini LLM Scraper can be used."},"title":"Result","description":"List of available locations for Gemini LLM Scraper"}},"description":"Represents a task result containing location data."},"title":"Tasks","description":"Array of task results containing location data"},"version":{"type":"string","title":"Version","description":"API version string"},"status_code":{"type":"integer","title":"Status Code","description":"Status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the result"}},"requiredFields":["status_code"]},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_GOOGLE_HIST_BULK_TRAFFIC_EST_LIVE","name":"Get Google Historical Bulk Traffic Estimation Live","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier (max 255 characters) for matching tasks with results in callbacks or when retrieving results later.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"date_to":{"type":"string","description":"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'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"targets":{"type":"array","description":"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']","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"string","properties":{}}},"date_from":{"type":"string","description":"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'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"item_types":{"type":"array","description":"Filter results by type. Can include: organic, paid, featured_snippet, local_pack. Default: ['organic', 'paid']","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"enum":["organic","paid","featured_snippet","local_pack"],"type":"string","title":"ItemType","properties":{},"description":"Enum for result item types available in traffic estimation."}},"language_code":{"type":"string","description":"Language code for the search results. Use language_code OR language_name. Example: 'en'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Language name for the search results. Use language_name OR language_code. Example: 'English'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"Geographic location code for the search. Use location_code OR location_name. Example: 2840 (United States)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Geographic location name for the search. Use location_name OR location_code. Example: 'United States'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"ignore_synonyms":{"type":"boolean","description":"Excludes highly similar keywords from traffic estimation when set to true. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier, typically 'dataforseo_labs'"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the request"},"date_to":{"type":"string","title":"Date To","description":"Ending date from the request"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type, typically 'google'"},"targets":{"type":"array","items":{"type":"string","properties":{}},"title":"Targets","description":"Array of target domains/URLs from the request"},"function":{"type":"string","title":"Function","description":"API function name, typically 'historical_bulk_traffic_estimation'"},"date_from":{"type":"string","title":"Date From","description":"Starting date from the request"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Result types from the request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the request"},"location_name":{"type":"string","title":"Location Name","description":"Location name from the request"},"ignore_synonyms":{"type":"boolean","title":"Ignore Synonyms","description":"Synonym exclusion setting from the request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"HistoricalBulkTrafficEstimationResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HistoricalTrafficEstimationItem","properties":{"target":{"type":"string","title":"Target","description":"The domain, subdomain, or webpage that was analyzed"},"metrics":{"type":"array","items":{"type":"object","title":"MonthlyMetrics","properties":{"paid":{"type":"integer","title":"Paid","description":"Estimated monthly paid search traffic volume"},"year":{"type":"integer","title":"Year","description":"Year of the data point"},"month":{"type":"integer","title":"Month","description":"Month of the data point (1-12)"},"organic":{"type":"integer","title":"Organic","description":"Estimated monthly organic search traffic volume"},"local_pack":{"type":"integer","title":"Local Pack","description":"Estimated monthly traffic from local pack results"},"featured_snippet":{"type":"integer","title":"Featured Snippet","description":"Estimated monthly traffic from featured snippets"}},"description":"Represents traffic metrics for a specific month."},"title":"Metrics","description":"Array of monthly traffic volume estimates broken down by result type (organic, paid, featured_snippet, local_pack)"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type identifier, typically 'google'"}},"description":"Represents historical traffic estimation data for a single target."},"title":"Items","description":"Array of historical traffic estimation items, one for each requested target"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type identifier, typically 'google'"},"items_count":{"type":"integer","title":"Items Count","description":"Number of historical traffic estimation items returned"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of targets in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for this result"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for this result"}},"description":"Represents the result data for historical bulk traffic estimation."},"title":"Result","description":"Array of historical bulk traffic estimation results containing monthly traffic volumes for each requested target over the specified time period"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success, 40000+ indicates error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects containing historical traffic estimation results"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","DataForSEO Labs"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_BING_KEYWORDS_FOR_SITE_TASK","name":"Get Keywords Data Bing Keywords For Site Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"target":{"type":"string","title":"Target","description":"Target website URL used in the original request"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD (or null if unavailable)"},"device":{"type":"string","title":"Device","description":"Device type (all, mobile, desktop, tablet)"},"keyword":{"type":"string","title":"Keyword","description":"Suggested keyword term"},"categories":{"type":"array","items":{"type":"string","properties":{}},"title":"Categories","description":"Product/service categories (legacy field, may be null)"},"competition":{"type":"number","title":"Competition","description":"Paid SERP competition level (0.1 for low, 0.5 for medium, 0.9 for high, or null)"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume (rounded, or null if unavailable)"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether partner network data is included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearchVolume","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly search volume for this keyword (rounded values)"}},"description":"Monthly search volume data for a specific month and year."},"title":"Monthly Searches","description":"12-month search volume history with year, month, and search volume data"}},"description":"Individual keyword suggestion result with metrics."},"title":"Result","description":"List of keyword data results for the target site including search volume, CPC, competition, and monthly search trends"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 for success, 40401 for not found, 40403 for expired, 40200 for payment required)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with keyword results for a site."},"title":"Tasks","description":"Array of task objects containing keyword data results for the specified site"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASK","name":"Get Keywords Data Bing Search Volume Task","description":"Tool to retrieve Bing search volume task results by task ID. Use when you need to fetch keyword search volume data including monthly search trends, cost-per-click metrics, and competition levels from Bing Ads.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier (e.g., 'bing')"},"api":{"type":"string","title":"Api","description":"API endpoint identifier (e.g., 'keywords_data')"},"function":{"type":"string","title":"Function","description":"Function name used in the task (e.g., 'search_volume')"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"Array of keywords submitted in the original task"},"language_name":{"type":"string","title":"Language Name","description":"Language name used for the task"},"location_name":{"type":"string","title":"Location Name","description":"Location name used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD. Null if unavailable."},"device":{"type":"string","title":"Device","description":"Device type (e.g., 'all', 'desktop', 'mobile'). Null if unavailable."},"keyword":{"type":"string","title":"Keyword","description":"The queried keyword"},"categories":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"object","additionalProperties":true},{"type":"array","items":{}}],"properties":{}},"title":"Categories","description":"Category information (always null for this endpoint)"},"competition":{"type":"number","title":"Competition","description":"Relative paid search competition level (0.1=low, 0.5=medium, 0.9=high). Null if unavailable."},"language_code":{"type":"string","title":"Language Code","description":"Language code (e.g., 'en')"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume, rounded to nearest ten"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether partner network is included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearches","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly search count, rounded to nearest ten. Null if data unavailable."}},"description":"Monthly search volume data for a specific month."},"title":"Monthly Searches","description":"12-month historical search volume data"}},"description":"Search volume data for a single keyword."},"title":"Result","description":"List of keyword search volume results with monthly trends and metrics"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with search volume results."},"title":"Tasks","description":"Array of task objects containing Bing search volume results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_BING_SEARCH_VOLUME_TASK_BY_ID","name":"Get Bing Search Volume Task By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format. You can use it within 30 days to request the results of the task at any time.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier (bing)"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier tag"},"function":{"type":"string","title":"Function","description":"Function name"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"Array of keywords submitted for search volume analysis"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code"}},"description":"Original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordSearchVolumeResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click for the keyword in USD. Null if unavailable."},"device":{"type":"string","title":"Device","description":"Device type for the search data (desktop, mobile, tablet). Null if unavailable."},"keyword":{"type":"string","title":"Keyword","description":"Keyword that was submitted for search volume analysis"},"categories":{"type":"array","items":{"type":"string","properties":{}},"title":"Categories","description":"Categories associated with the keyword. Always null for this endpoint."},"competition":{"type":"number","title":"Competition","description":"Relative competition level for the keyword. Values can be 0.1 (low), 0.5 (medium), 0.9 (high), or null if unavailable."},"language_code":{"type":"string","title":"Language Code","description":"Language code for the search data"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code for the search data"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average monthly search volume rounded to the nearest tens. Null if unavailable."},"search_partners":{"type":"boolean","title":"Search Partners","description":"Indicates whether search data includes partner networks"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearch","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year for the search data"},"month":{"type":"integer","title":"Month","description":"Month number (1-12) for the search data"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly search volume rounded to the nearest tens. Null if data is unavailable for that month."}},"description":"Represents monthly search volume data for a keyword."},"title":"Monthly Searches","description":"Array of 12 monthly search volume data points showing historical search trends"}},"description":"Represents search volume data for a single keyword."},"title":"Result","description":"Array of keyword search volume results with historical data"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Informational message of the task"}},"description":"Represents a single task in the tasks array."},"title":"Tasks","description":"Array of tasks containing Bing search volume results with monthly historical data"},"version":{"type":"string","title":"Version","description":"Current version of the API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code of the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"The number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"The number of tasks that returned an error"},"status_message":{"type":"string","title":"Status Message","description":"General informational message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_GOOGLE_ADS_STATUS","name":"Get Keywords Data Google Ads Status","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD (typically 0 for this endpoint)"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD (typically 0 for this endpoint)"},"data":{"type":"object","title":"TaskData","properties":{},"description":"Represents task metadata information.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"GoogleAdsStatusResult","properties":{"actual_data":{"type":"boolean","title":"Actual Data","description":"Whether Google updated keyword data for the previous month"},"date_update":{"type":"string","title":"Date Update","description":"Latest update date in YYYY-MM-DD format"},"last_year_in_monthly_searches":{"type":"integer","title":"Last Year In Monthly Searches","description":"Latest year with available search volume data"},"last_month_in_monthly_searches":{"type":"integer","title":"Last Month In Monthly Searches","description":"Latest month with available search volume data (1-12)"}},"description":"Represents the current status of Google Ads keyword data."},"title":"Result","description":"Array containing Google Ads keyword data status information"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Represents a single task in the response containing Google Ads status information."},"title":"Tasks","description":"Array of tasks containing Google Ads keyword data status information"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"Response status code in range 10000-60000 (e.g., 20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_GOOGLE_ADWORDS_STATUS","name":"Get Keywords Data Google Adwords Status","description":"Tool to get current status of Google AdWords 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD (typically 0 for this endpoint)"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD (typically 0 for this endpoint)"},"data":{"type":"object","title":"TaskData","properties":{},"description":"Represents task metadata information.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"AdwordsStatusResult","properties":{"actual_data":{"type":"boolean","title":"Actual Data","description":"Whether Google updated keyword data for the previous month"},"date_update":{"type":"string","title":"Date Update","description":"Latest update date in YYYY-MM-DD format"},"last_year_in_monthly_searches":{"type":"integer","title":"Last Year In Monthly Searches","description":"Latest year with available search volume data"},"last_month_in_monthly_searches":{"type":"integer","title":"Last Month In Monthly Searches","description":"Latest month with available search volume data (1-12)"}},"description":"Represents the current status of Google AdWords keyword data."},"title":"Result","description":"Array containing Google AdWords keyword data status information"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Represents a single task in the response containing AdWords status information."},"title":"Tasks","description":"Array of tasks containing Google AdWords keyword data status information"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"Response status code in range 10000-60000 (e.g., 20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KEYWORDS_DATA_GOOGLE_SEARCH_VOLUME_TASK_BY_ID","name":"Get Keywords Data Google Search Volume Task","description":"Tool 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":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords used in the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD (null if unavailable)"},"keyword":{"type":"string","title":"Keyword","description":"Keyword term from the original request"},"categories":{"type":"array","items":{"type":"integer","properties":{}},"title":"Categories","description":"Product or service category IDs associated with the keyword"},"competition":{"type":"number","title":"Competition","description":"Relative competition level for paid search (0-1 range, null if unavailable). Based on Google Ads data."},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request (null if unavailable)"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request (null if unavailable)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume (null if unavailable)"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether partner network data is included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearchVolume","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume for this keyword"}},"description":"Monthly search volume data for a specific month and year."},"title":"Monthly Searches","description":"Historical monthly search volume data (12 months) with year, month, and search volume values"}},"description":"Individual keyword search volume result with metrics."},"title":"Result","description":"List of keywords with search volume metrics including monthly average, CPC, competition level, and 12-month historical search trends"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with keyword search volume results."},"title":"Tasks","description":"Array of task objects containing keyword search volume metrics results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_BING_AUDIENCE_EST_INDUSTRIES","name":"Get Keywords Data Bing Audience Estimation Industries","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total tasks cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Parameters from GET request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Execution time for this task"},"result":{"type":"array","items":{"type":"object","title":"Industry","properties":{"industry_id":{"type":"integer","title":"Industry Id","description":"Unique industry identifier for Bing Ads audience estimation"},"industry_name":{"type":"string","title":"Industry Name","description":"Name of the industry (e.g., 'Technology', 'Healthcare')"}},"description":"Industry object with ID and name."},"title":"Result","description":"Array of industry data with IDs and names"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task status information message"}},"description":"Task result containing industries data."},"title":"Tasks","description":"Array of task results containing industries data"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that returned with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_BING_KW_FOR_KW_TASK_BY_ID","name":"Get Keywords Data Bing Keywords For Keywords Task By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords used in the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD (or null if unavailable)"},"device":{"type":"string","title":"Device","description":"Device type (all, mobile, desktop, tablet)"},"keyword":{"type":"string","title":"Keyword","description":"Suggested keyword term"},"categories":{"type":"array","items":{"type":"string","properties":{}},"title":"Categories","description":"Product/service categories (legacy field, always null)"},"competition":{"type":"number","title":"Competition","description":"Paid SERP competition level (0.1 for low, 0.5 for medium, 0.9 for high, or null)"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume (rounded, or null if unavailable)"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether partner network data is included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearchVolume","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly search volume for this keyword (rounded values)"}},"description":"Monthly search volume data for a specific month and year."},"title":"Monthly Searches","description":"12-month search volume history with year, month, and search volume data"}},"description":"Individual keyword suggestion result with metrics."},"title":"Result","description":"List of keyword suggestions with metrics including search volume, CPC, competition, and monthly search trends"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with keyword suggestion results."},"title":"Tasks","description":"Array of task objects containing keyword suggestion results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_BING_KW_SUGGESTIONS_FOR_URL_LIVE","name":"Get Keywords Data Bing Keyword Suggestions For URL Live","description":"Tool 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.","input_parameters":{"target":{"type":"string","description":"The webpage URL to analyze for keyword suggestions (max 2000 characters)","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"language_code":{"type":"string","description":"Language code (e.g., 'en'). Either language_name or language_code is required","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Full language name (e.g., 'English'). Either language_name or language_code is required","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"exclude_brands":{"type":"boolean","description":"Filters out brand-related keywords from results. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier (bing)"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"target":{"type":"string","title":"Target","description":"Target URL from the request"},"function":{"type":"string","title":"Function","description":"API function name"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the request"},"language_name":{"type":"string","title":"Language Name","description":"Language name from the request"},"exclude_brands":{"type":"boolean","title":"Exclude Brands","description":"Exclude brands flag from the request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordData","properties":{"cpc":{"type":"number","title":"Cpc","description":"Cost per click in USD"},"keyword":{"type":"string","title":"Keyword","description":"The suggested keyword phrase"},"categories":{"type":"array","items":{"type":"string","properties":{}},"title":"Categories","description":"Product or service categories associated with the keyword"},"competition":{"type":"string","title":"Competition","description":"Competition level: Low, Medium, or High"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for this keyword"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for this keyword"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average monthly search volume"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether search partners are included in the data"},"monthly_searches":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]}},"title":"Monthly Searches","description":"Historical monthly search volume data"}},"description":"Represents keyword suggestion data with competition and volume metrics."},"title":"Result","description":"Array of keyword suggestions with metrics"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success, 40000+ indicates error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword results in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects containing keyword suggestion results"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_BING_KW_SUGGESTIONS_FOR_URL_TASK","name":"Get Bing Keyword Suggestions for URL Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Task identifier in UUID format returned from task_post endpoint. Results are available for 30 days after task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost for the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier (bing)"},"api":{"type":"string","title":"Api","description":"API identifier"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier tag"},"url":{"type":"string","title":"Url","description":"Target URL for keyword suggestions"},"function":{"type":"string","title":"Function","description":"Function name"},"language_code":{"type":"string","title":"Language Code","description":"Language code for keyword suggestions"},"location_code":{"type":"integer","title":"Location Code","description":"Location code for keyword suggestions"}},"description":"Echo of the original request parameters for this task.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordSuggestion","properties":{"keyword":{"type":"string","title":"Keyword","description":"Suggested keyword phrase based on URL content"},"confidence_score":{"type":"number","title":"Confidence Score","description":"Confidence score from 0.0 to 1.0 indicating keyword relevance probability. Higher scores indicate better match."}},"description":"Represents a single keyword suggestion with confidence score."},"title":"Result","description":"Array of keyword suggestions sorted by confidence score (highest to lowest)"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword suggestions returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution status message"}},"description":"Represents a single task in the tasks array."},"title":"Tasks","description":"Array of task objects containing keyword suggestion results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_BING_KW_SUGGESTIONS_FOR_URL_TASK_BY_ID","name":"Get Keywords Data Bing Keyword Suggestions For URL Task By ID","description":"Tool to retrieve Bing keyword suggestions for URL task results by task ID. Use when you need to fetch keyword suggestions related to a specific URL including relevance confidence scores.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format. You will be able to use it within 30 days to request the results of the task at any time.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"target":{"type":"string","title":"Target","description":"Target URL for which keyword suggestions were requested"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"keyword":{"type":"string","title":"Keyword","description":"Suggested keyword phrase"},"confidence_score":{"type":"number","title":"Confidence Score","description":"Relevance probability score (0.0-1.0)"}},"description":"Result data containing keyword suggestions for the target URL."},"title":"Result","description":"List of keyword suggestions with confidence scores"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword suggestions returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with results."},"title":"Tasks","description":"Array of task objects containing keyword suggestions results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_AD_TRAFFIC_BY_KW_TASK_BY_ID","name":"Get Keywords Data Google Ads Ad Traffic By Keywords Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords used in the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"AdTrafficResult","properties":{"bid":{"type":"number","title":"Bid","description":"Maximum custom bid specified for the keyword"},"ctr":{"type":"number","title":"Ctr","description":"Projected clickthrough rate (null if unavailable)"},"cost":{"type":"number","title":"Cost","description":"Projected total ad charge in USD (null if unavailable)"},"match":{"type":"string","title":"Match","description":"Match type for the keyword: exact, broad, or phrase"},"clicks":{"type":"number","title":"Clicks","description":"Projected number of ad clicks (null if unavailable)"},"keyword":{"type":"string","title":"Keyword","description":"Keyword from the original request array"},"average_cpc":{"type":"number","title":"Average Cpc","description":"Average cost-per-click in USD (null if unavailable)"},"impressions":{"type":"number","title":"Impressions","description":"Projected number of ad impressions (null if unavailable)"},"date_interval":{"type":"string","title":"Date Interval","description":"Forecasting period for the ad traffic projection"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request (null if unavailable)"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request (null if unavailable)"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether Google search partners are included in the forecast"}},"description":"Ad traffic forecast result for a specific keyword with bid and match type."},"title":"Result","description":"Array of ad traffic forecast results including impressions, CTR, average CPC, projected cost, and clicks for each keyword"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with ad traffic forecast results."},"title":"Tasks","description":"Array of task objects containing ad traffic forecast results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_KW_LIVE","name":"Get Keywords Data Google Ads Keywords For Keywords Live","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier (max 255 characters) for matching tasks with results","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"date_to":{"type":"string","description":"Ending date for historical data in 'yyyy-mm-dd' format. Cannot exceed yesterday's date.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"sort_by":{"type":"string","description":"Sort results by: relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid. Default: relevance","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"keywords":{"type":"array","description":"Array of keywords to get suggestions for. Maximum 20 keywords, each up to 80 characters. Keywords will be converted to lowercase automatically.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"string","properties":{}}},"date_from":{"type":"string","description":"Starting date for historical data in 'yyyy-mm-dd' format. Minimal value is 4 years prior to current date.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_code":{"type":"string","description":"Search engine language code. Example: 'en' for English","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Full search engine language name. Example: 'English'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"Search engine location code. Example: 2840 for United States. You can get location codes from the locations endpoint.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Full search engine location name. Example: 'London,England,United Kingdom' or 'United States'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"search_partners":{"type":"boolean","description":"Include Google search partners in results. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_coordinate":{"type":"string","description":"GPS coordinates in 'latitude,longitude' format. Example: '40.7128,-74.0060' for New York City","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"include_adult_keywords":{"type":"boolean","description":"Include adult content keywords in results. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier from the request"},"date_to":{"type":"string","title":"Date To","description":"Ending date from the request"},"sort_by":{"type":"string","title":"Sort By","description":"Sort by parameter from the request"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords from the original request"},"date_from":{"type":"string","title":"Date From","description":"Starting date from the request"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the request"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Search partners flag from the request"},"include_adult_keywords":{"type":"boolean","title":"Include Adult Keywords","description":"Include adult keywords flag from the request"}},"description":"Echo of the original request parameters sent in the POST request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordSuggestion","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD (null if unavailable)"},"keyword":{"type":"string","title":"Keyword","description":"Keyword text from the original request"},"competition":{"type":"string","title":"Competition","description":"Relative competition level: LOW, MEDIUM, or HIGH"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request (null if unavailable)"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request (null if unavailable)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume (null if unavailable)"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether Google search partners are included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearch","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average search volume for this month"}},"description":"Monthly search volume data for a specific period."},"title":"Monthly Searches","description":"Historical monthly search volume data for the past 12 months"},"competition_index":{"type":"integer","title":"Competition Index","description":"Competition index from 0 to 100 (higher means more competitive)"},"keyword_annotations":{"type":"object","title":"KeywordAnnotations","properties":{"concepts":{"type":"array","items":{"type":"string","properties":{}},"title":"Concepts","description":"Array of concepts associated with the keyword"}},"description":"Keyword annotations containing concepts.","additionalProperties":false},"low_top_of_page_bid":{"type":"number","title":"Low Top Of Page Bid","description":"Minimum bid in USD for top of page placement (null if unavailable)"},"high_top_of_page_bid":{"type":"number","title":"High Top Of Page Bid","description":"Maximum bid in USD for top of page placement (null if unavailable)"}},"description":"Individual keyword suggestion result with Google Ads metrics."},"title":"Result","description":"Array of keyword suggestions with Google Ads metrics including search volume, CPC, competition, and bid estimates"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success, 40000+ indicates error)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword suggestion results returned"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task execution"}},"description":"Individual task object containing keyword suggestion results and metadata."},"title":"Tasks","description":"Array of task objects containing keyword suggestion results with Google Ads metrics"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success, 10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_KW_TASK_BY_ID","name":"Get Keywords Data Google Ads Keywords For Keywords Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords used in the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD (null if unavailable)"},"keyword":{"type":"string","title":"Keyword","description":"Keyword term from the original request"},"competition":{"type":"string","title":"Competition","description":"Competition level for paid search: LOW, MEDIUM, or HIGH"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request (null if unavailable)"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume (null if unavailable)"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether Google search partners data is included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearchVolume","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Search volume for that specific month"}},"description":"Monthly search volume data for a specific month and year."},"title":"Monthly Searches","description":"Historical monthly search volume data for the past 12 months with year, month, and search volume values"},"competition_index":{"type":"integer","title":"Competition Index","description":"Competition score ranging from 0 to 100"},"keyword_annotations":{"type":"object","title":"KeywordAnnotations","properties":{"concepts":{"type":"array","items":{"type":"object","title":"ConceptItem","properties":{"name":{"type":"string","title":"Name","description":"Concept name (e.g., 'Non-Brands', 'Brands')"},"concept_group":{"type":"object","title":"ConceptGroup","properties":{"name":{"type":"string","title":"Name","description":"Concept group name identifier"},"type":{"type":"string","title":"Type","description":"Concept group type classification"}},"description":"Concept group metadata for keyword classification.","additionalProperties":false}},"description":"Individual concept classification item."},"title":"Concepts","description":"List of concept classifications for the keyword (null if unavailable)"}},"description":"Keyword concept classifications and annotations.","additionalProperties":false},"low_top_of_page_bid":{"type":"number","title":"Low Top Of Page Bid","description":"Minimum cost-per-click bid for top-of-page placement in USD (null if unavailable)"},"high_top_of_page_bid":{"type":"number","title":"High Top Of Page Bid","description":"Maximum cost-per-click bid for top-of-page placement in USD (null if unavailable)"}},"description":"Individual keyword suggestion result with metrics from Google Ads."},"title":"Result","description":"List of keywords with metrics including search volume, CPC, competition level, bid estimates, and monthly search trends from Google Ads API"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with keyword metrics results from Google Ads API."},"title":"Tasks","description":"Array of task objects containing keyword metrics results from Google Ads API"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_SITE_TASK","name":"Get Google Ads Keywords For Site Task","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Task identifier in UUID format returned from task_post endpoint. Results are available for 30 days after task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost for the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API identifier"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier tag"},"target":{"type":"string","title":"Target","description":"Target domain or URL"},"function":{"type":"string","title":"Function","description":"Function name"},"language_code":{"type":"string","title":"Language Code","description":"Language code for keyword data"},"location_code":{"type":"integer","title":"Location Code","description":"Location code for keyword data"}},"description":"Echo of the original request parameters for this task.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordData","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click for paid advertising in USD"},"keyword":{"type":"string","title":"Keyword","description":"Keyword term or phrase"},"categories":{"type":"array","items":{"type":"integer","properties":{}},"title":"Categories","description":"Product or service category codes associated with this keyword"},"competition":{"type":"string","title":"Competition","description":"Competition level for paid search. Possible values: 'LOW', 'MEDIUM', 'HIGH'"},"language_code":{"type":"string","title":"Language Code","description":"Language code for the keyword data"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code for the keyword data"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average monthly search volume over the last 12 months"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Indicates whether Google search partners data is included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearches","properties":{"year":{"type":"integer","title":"Year","description":"Year of the data point"},"month":{"type":"integer","title":"Month","description":"Month of the data point (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Search volume for that specific month"}},"description":"Represents monthly search volume data for a specific month."},"title":"Monthly Searches","description":"Array of 12-month historical search volume data"},"competition_index":{"type":"integer","title":"Competition Index","description":"Competition index representing ad slot availability (0-100 range). Higher values indicate more competition."},"keyword_annotations":{"type":"object","title":"KeywordAnnotations","properties":{"concepts":{"type":"array","items":{"type":"object","title":"Concept","properties":{"name":{"type":"string","title":"Name","description":"Concept identifier or name"},"concept_group":{"type":"object","title":"ConceptGroup","properties":{"name":{"type":"string","title":"Name","description":"Name of the concept group"},"type":{"type":"string","title":"Type","description":"Type of concept group (e.g., 'NON_BRAND', 'BRAND')"}},"description":"Represents a concept group classification.","additionalProperties":false}},"description":"Represents a keyword concept with its categorization."},"title":"Concepts","description":"Array of concept categorizations providing semantic classification beyond standard keyword metrics, distinguishing branded versus non-branded search intent"}},"description":"Semantic annotations for keyword classification.","additionalProperties":false},"low_top_of_page_bid":{"type":"number","title":"Low Top Of Page Bid","description":"Minimum bid amount in USD for top-of-page ad placement"},"high_top_of_page_bid":{"type":"number","title":"High Top Of Page Bid","description":"Maximum bid amount in USD for top-of-page ad placement"}},"description":"Represents keyword data including search volume, competition metrics, and bidding information."},"title":"Result","description":"Array of keyword data objects containing search volume, competition metrics, bidding information, and semantic annotations"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword results returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution status message"}},"description":"Represents a single task in the tasks array."},"title":"Tasks","description":"Array of task objects containing keyword data results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_KW_FOR_SITE_TASK_BY_ID","name":"Get Keywords Data Google Ads Keywords For Site Task By ID","description":"Tool to retrieve Google Ads keyword data for a specific site by task ID. Use when you need to fetch keywords relevant to a domain along with their search volumes, bids, competition levels, and trends. The task ID must be from a task created within the last 30 days.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"target":{"type":"string","title":"Target","description":"Target domain or URL for keyword extraction"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether search partner networks were included"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Cost per click for this keyword (in USD)"},"keyword":{"type":"string","title":"Keyword","description":"The keyword term"},"competition":{"type":"string","title":"Competition","description":"Competition level for the keyword (LOW, MEDIUM, HIGH)"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the keyword data"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the keyword data"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average monthly search volume"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Indicates if the data includes Google search partner networks"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearch","properties":{"year":{"type":"integer","title":"Year","description":"Year of the data point"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Number of searches in this month"}},"description":"Monthly search volume data point for historical trends."},"title":"Monthly Searches","description":"Historical search volume data for the last 12 months"},"competition_index":{"type":"integer","title":"Competition Index","description":"Competition metric ranging from 0 to 100"},"keyword_annotations":{"type":"object","title":"KeywordAnnotations","properties":{"concepts":{"type":"array","items":{"type":"object","title":"Concept","properties":{"name":{"type":"string","title":"Name","description":"Name of the concept"},"concept_group":{"type":"object","title":"ConceptGroup","properties":{"name":{"type":"string","title":"Name","description":"Name of the concept group"},"type":{"type":"string","title":"Type","description":"Type of the concept group"}},"description":"Grouping information for a keyword concept.","additionalProperties":false}},"description":"Semantic concept classification for a keyword."},"title":"Concepts","description":"List of concept classifications for this keyword"}},"description":"Semantic annotations and concept classifications for a keyword.","additionalProperties":false},"low_top_of_page_bid":{"type":"number","title":"Low Top Of Page Bid","description":"Minimum bid amount to appear at the top of the page (in USD)"},"high_top_of_page_bid":{"type":"number","title":"High Top Of Page Bid","description":"Maximum bid amount to appear at the top of the page (in USD)"}},"description":"Detailed keyword data including search volume, competition, and bidding metrics."},"title":"Result","description":"List of keyword results with search volume, competition, and bid data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword results returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with keyword results."},"title":"Tasks","description":"Array of task objects containing keyword results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_ADS_SEARCH_VOL_TASK_BY_ID","name":"Get Keywords Data Google Ads Search Volume Task","description":"Tool 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).","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords used in the original request"},"date_from":{"type":"string","title":"Date From","description":"Starting date for the search volume data"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD for paid search ads"},"spell":{"type":"string","title":"Spell","description":"Correct spelling of the keyword. Provided when the input keyword is misspelled."},"keyword":{"type":"string","title":"Keyword","description":"Keyword term from the original request"},"competition":{"type":"string","title":"Competition","description":"Relative amount of competition in paid SERP. Possible values: HIGH, MEDIUM, LOW"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume for the keyword"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether Google search partner network data is included in the metrics"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearchVolume","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average search volume for this keyword in the specified month"}},"description":"Monthly search volume data for a specific month and year."},"title":"Monthly Searches","description":"Historical monthly search volume data (12 months) with year, month, and search volume values"},"competition_index":{"type":"integer","title":"Competition Index","description":"Competition index for paid search on a scale of 0-100. Higher values indicate more competition."},"low_top_of_page_bid":{"type":"number","title":"Low Top Of Page Bid","description":"Minimum bid in USD for the ad to be displayed at the top of the first page"},"high_top_of_page_bid":{"type":"number","title":"High Top Of Page Bid","description":"Maximum bid in USD for the ad to be displayed at the top of the first page"}},"description":"Individual keyword search volume result with Google Ads metrics."},"title":"Result","description":"List of keywords with Google Ads search volume metrics including competition index, CPC, top-of-page bid estimates, and 12-month historical search trends"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with keyword search volume results."},"title":"Tasks","description":"Array of task objects containing keyword search volume metrics results from Google Ads API"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_AD_TRAFFIC_BY_KW_TASK","name":"Get Keywords Data Google Ad Traffic By Keywords Task","description":"Tool to retrieve Google Ad Traffic by Keywords task results by task ID. Use when you need to fetch estimated traffic data for specified keywords based on bid amount and match type, including CPC, impressions, clicks, and daily costs. Results are available for up to 30 days after task creation.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format. You will be able to use it within 30 days to request the results of the task at any time.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"bid":{"type":"number","title":"Bid","description":"Maximum custom bid specified in the original request"},"match":{"type":"string","title":"Match","description":"Match type used in the original request: exact, broad, or phrase"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords used in the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"AdTrafficResult","properties":{"bid":{"type":"number","title":"Bid","description":"Maximum custom bid specified in the original request"},"match":{"type":"string","title":"Match","description":"Match type: exact, broad, or phrase"},"cpc_max":{"type":"number","title":"Cpc Max","description":"Maximum cost-per-click value in USD"},"cpc_min":{"type":"number","title":"Cpc Min","description":"Minimum cost-per-click value in USD"},"keyword":{"type":"string","title":"Keyword","description":"Keyword from the original POST request"},"cpc_average":{"type":"number","title":"Cpc Average","description":"Average cost-per-click value in USD"},"language_code":{"type":"string","title":"Language Code","description":"Language code from the original POST request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code from the original POST request"},"daily_cost_max":{"type":"number","title":"Daily Cost Max","description":"Maximum daily charge in USD"},"daily_cost_min":{"type":"number","title":"Daily Cost Min","description":"Minimum daily charge in USD"},"ad_position_max":{"type":"number","title":"Ad Position Max","description":"Maximum ad position for the keyword"},"ad_position_min":{"type":"number","title":"Ad Position Min","description":"Minimum ad position for the keyword"},"daily_clicks_max":{"type":"number","title":"Daily Clicks Max","description":"Maximum daily clicks estimated for the keyword"},"daily_clicks_min":{"type":"number","title":"Daily Clicks Min","description":"Minimum daily clicks estimated for the keyword"},"daily_cost_average":{"type":"number","title":"Daily Cost Average","description":"Average daily charge in USD"},"ad_position_average":{"type":"number","title":"Ad Position Average","description":"Average ad position for the keyword"},"daily_clicks_average":{"type":"number","title":"Daily Clicks Average","description":"Average daily clicks estimated for the keyword"},"daily_impressions_max":{"type":"number","title":"Daily Impressions Max","description":"Maximum daily impressions estimated for the keyword"},"daily_impressions_min":{"type":"number","title":"Daily Impressions Min","description":"Minimum daily impressions estimated for the keyword"},"daily_impressions_average":{"type":"number","title":"Daily Impressions Average","description":"Average daily impressions estimated for the keyword"}},"description":"Individual keyword ad traffic result with estimated metrics based on bid and match type."},"title":"Result","description":"List of ad traffic estimation results with CPC, impressions, clicks, and cost metrics for each keyword"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with ad traffic estimation results."},"title":"Tasks","description":"Array of task objects containing ad traffic estimation results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_KW_FOR_CATEGORY_LIVE","name":"Get Keywords Data Google Keywords For Category Live","description":"Tool 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":{"tag":{"type":"string","description":"User-defined task identifier for tracking and matching results. Maximum 255 characters","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"sort_by":{"type":"string","description":"Sort results by 'search_volume' or 'relevance' in descending order. Default: 'search_volume'","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"category_code":{"type":"integer","description":"Category ID from Google's product/service taxonomy. Obtain via /v3/keywords_data/google/categories endpoint","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"language_code":{"type":"string","description":"Language code for search results (e.g., 'en'). Alternative to language_name","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"language_name":{"type":"string","description":"Full language name for search results (e.g., 'English'). Mutually exclusive with language_code","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"Search engine location code for geographic targeting. Alternative to location_name","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Full location name for geographic targeting (e.g., 'United States', 'London,England,United Kingdom'). Mutually exclusive with location_code or location_coordinate","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"search_partners":{"type":"boolean","description":"Include Google search partners data when true. Default: false","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"keywords_negative":{"type":"array","description":"Up to 200 keywords to exclude from results. Terms are converted to lowercase automatically","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"location_coordinate":{"type":"string","description":"GPS coordinates in 'latitude,longitude' format for country-level targeting. Mutually exclusive with location_name or location_code","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier (e.g., 'google')"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"tag":{"type":"string","title":"Tag","description":"User-defined task identifier"},"sort_by":{"type":"string","title":"Sort By","description":"Sort method used for results"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"category_code":{"type":"integer","title":"Category Code","description":"Category code used for the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether search partners data was included"},"keywords_negative":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords Negative","description":"Excluded keywords from the request"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD for paid advertising (null if unavailable)"},"keyword":{"type":"string","title":"Keyword","description":"Suggested keyword term from the category"},"categories":{"type":"array","items":{"type":"integer","properties":{}},"title":"Categories","description":"Associated product or service category codes from Google's taxonomy"},"competition":{"type":"number","title":"Competition","description":"Relative competition level for paid search (0-1 range, where 1 is highest competition, null if unavailable)"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request (null if unavailable)"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request (null if unavailable)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume for this keyword (null if unavailable)"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether Google search partner network data is included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearchVolume","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year for this monthly search volume data"},"month":{"type":"integer","title":"Month","description":"Month number (1-12) for this search volume data"},"search_volume":{"type":"integer","title":"Search Volume","description":"Average monthly search volume for this keyword during the specified month"}},"description":"Monthly search volume data for a specific month and year."},"title":"Monthly Searches","description":"Historical monthly search volume data for the past 12 months with year, month, and search volume values"}},"description":"Individual keyword suggestion result with metrics."},"title":"Result","description":"List of keywords with metrics including search volume, CPC, competition level, and 12-month search trends"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword result elements returned (up to 700 per request)"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with keyword metrics results."},"title":"Tasks","description":"Array of task objects containing keyword metrics results"},"version":{"type":"string","title":"Version","description":"Current DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_KW_FOR_KW_TASK_BY_ID","name":"Get Keywords Data Google Keywords For Keywords Task","description":"Tool 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":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords used in the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordResult","properties":{"cpc":{"type":"number","title":"Cpc","description":"Average cost-per-click in USD (null if unavailable)"},"keyword":{"type":"string","title":"Keyword","description":"Keyword term from the original request"},"categories":{"type":"array","items":{"type":"integer","properties":{}},"title":"Categories","description":"Product or service category IDs associated with the keyword"},"competition":{"type":"number","title":"Competition","description":"Relative competition level for paid search (0-1 range, null if unavailable)"},"language_code":{"type":"string","title":"Language Code","description":"Language code identifier used for the request (null if unavailable)"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request (null if unavailable)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume (null if unavailable)"},"search_partners":{"type":"boolean","title":"Search Partners","description":"Whether partner network data is included"},"monthly_searches":{"type":"array","items":{"type":"object","title":"MonthlySearchVolume","properties":{"year":{"type":"integer","title":"Year","description":"Calendar year"},"month":{"type":"integer","title":"Month","description":"Month number (1-12)"},"search_volume":{"type":"integer","title":"Search Volume","description":"Monthly average search volume for this keyword"}},"description":"Monthly search volume data for a specific month and year."},"title":"Monthly Searches","description":"Historical monthly search volume data with year, month, and search volume values"}},"description":"Individual keyword suggestion result with metrics."},"title":"Result","description":"List of keywords with metrics including search volume, CPC, competition level, and monthly search trends"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of keyword result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with keyword metrics results."},"title":"Tasks","description":"Array of task objects containing keyword metrics results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_TRENDS_EXPLORE_TASK_BY_ID","name":"Get Keywords Data Google Trends Explore Task","description":"Tool to retrieve Google Trends Explore task results by task ID. Use when you need to fetch trend analysis data including time-series popularity graphs, geographic distribution maps, and related topics/queries for previously submitted keywords.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"Keywords from the original request"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TrendsResult","properties":{"type":{"type":"string","title":"Type","description":"Type of result (typically 'trends')"},"items":{"type":"array","items":{"type":"object","title":"TrendsItem","properties":{"data":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"object","title":"GraphDataPoint","properties":{"values":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Values","default":null,"description":"Popularity scores (0-100) for each keyword in the query"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","default":null,"description":"End date of the time period in UTC format (yyyy-mm-dd)"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","default":null,"description":"Start date of the time period in UTC format (yyyy-mm-dd)"},"timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Unix timestamp for this data point"},"missing_data":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Missing Data","default":null,"description":"Indicates whether data is missing for this time period"}},"description":"Individual data point in a Google Trends graph time series."},{"type":"object","title":"MapDataPoint","properties":{"geo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Id","default":null,"description":"Geographic location identifier"},"values":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Values","default":null,"description":"Popularity values for each keyword in this location"},"geo_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Name","default":null,"description":"Geographic location name"},"max_value_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Value Index","default":null,"description":"Index of the keyword with maximum value (null for single keyword)"}},"description":"Geographic data point for Google Trends map visualization."}]}},{"type":"object","title":"TopicsQueriesData","properties":{"top":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"object","title":"TopicItem","properties":{"value":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Value","default":null,"description":"Popularity value (integer for top, percentage string for rising)"},"topic_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Id","default":null,"description":"Unique identifier for the topic"},"topic_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Type","default":null,"description":"Type classification of the topic"},"topic_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Title","default":null,"description":"Display title of the topic"}},"description":"Related topic item from Google Trends."},{"type":"object","title":"QueryItem","properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","default":null,"description":"Search query string"},"value":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Value","default":null,"description":"Popularity value (integer for top, percentage string for rising)"}},"description":"Related query item from Google Trends."}]}},{"type":"null"}],"title":"Top","default":null,"description":"Top trending topics or queries by popularity"},"rising":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"object","title":"TopicItem","properties":{"value":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Value","default":null,"description":"Popularity value (integer for top, percentage string for rising)"},"topic_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Id","default":null,"description":"Unique identifier for the topic"},"topic_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Type","default":null,"description":"Type classification of the topic"},"topic_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Title","default":null,"description":"Display title of the topic"}},"description":"Related topic item from Google Trends."},{"type":"object","title":"QueryItem","properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","default":null,"description":"Search query string"},"value":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Value","default":null,"description":"Popularity value (integer for top, percentage string for rising)"}},"description":"Related query item from Google Trends."}]}},{"type":"null"}],"title":"Rising","default":null,"description":"Rising topics or queries with increasing popularity"}},"description":"Collection of top and rising topics or queries."}],"title":"Data","description":"Data payload - array for graph/map types, object for topics/queries types"},"type":{"type":"string","title":"Type","description":"Type of trends item (google_trends_graph, google_trends_map, google_trends_topics_list, google_trends_queries_list)"},"title":{"type":"string","title":"Title","description":"Display title for this trends item"},"averages":{"type":"array","items":{"type":"integer","properties":{}},"title":"Averages","description":"Average popularity values for each keyword (present in google_trends_graph)"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"List of keywords included in this trends analysis"},"position":{"type":"integer","title":"Position","description":"Position of this item in the results array"}},"description":"Individual item in Google Trends results (graph, map, topics, or queries)."},"title":"Items","description":"Array of trends data items including graphs, maps, and related topics/queries"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when result was received in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"keywords":{"type":"array","items":{"type":"string","properties":{}},"title":"Keywords","description":"Keywords specified in the original request"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify results on Google Trends"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"}},"description":"Result data for a Google Trends Explore task."},"title":"Result","description":"Array of Google Trends explore results including time-series graphs, geographic maps, and related topics/queries"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Trends explore results."},"title":"Tasks","description":"Array of task objects containing Google Trends explore results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_KW_GOOGLE_TRENDS_LOCATIONS_BY_COUNTRY","name":"Get Google Trends Locations By Country","description":"Tool to retrieve available Google Trends locations filtered by country ISO code. Use when you need to get the list of valid locations for setting up Google Trends keyword data tasks in a specific country.","input_parameters":{"country":{"type":"string","description":"Country ISO code to filter the list of locations. Example: 'us' for United States, 'gb' for United Kingdom.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD."},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique UUID task identifier."},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD."},"data":{"type":"object","title":"Data","description":"Request parameters used for this task.","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","title":"LocationResult","properties":{"location_code":{"type":"integer","title":"Location Code","description":"Unique location identifier code."},"location_name":{"type":"string","title":"Location Name","description":"Full name of the location."},"location_type":{"type":"string","title":"Location Type","description":"Classification of the location (e.g., Country, State, City)."},"country_iso_code":{"type":"string","title":"Country Iso Code","description":"ISO country code for the location."},"location_code_parent":{"type":"integer","title":"Location Code Parent","description":"Parent location code (null for top-level locations)."}},"description":"Represents a single location entry for Google Trends."},"title":"Result","description":"Array of location results."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code."},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned for this task."},"status_message":{"type":"string","title":"Status Message","description":"Task-specific status message."}},"description":"Represents a single task result in the DataForSEO response."},"title":"Tasks","description":"Array of task result objects containing location data."},"version":{"type":"string","title":"Version","description":"Current API version."},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about request status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Keywords Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_LLM_MENTIONS_AVAILABLE_FILTERS","name":"Get LLM Mentions Available Filters","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for the request"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Parameters from the GET request","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"platform":{"type":"array","items":{"type":"string","properties":{}},"title":"Platform","description":"List of available platform filter values"},"language_code":{"type":"array","items":{"type":"string","properties":{}},"title":"Language Code","description":"List of available language code filter values"},"location_code":{"type":"array","items":{"anyOf":[{"type":"integer"},{"type":"string"}],"properties":{}},"title":"Location Code","description":"List of available location code filter values"},"ai_search_volume":{"type":"array","items":{"anyOf":[{"type":"integer"},{"type":"string"}],"properties":{}},"title":"Ai Search Volume","description":"List of available AI search volume filter values"},"last_response_at":{"type":"array","items":{"type":"string","properties":{}},"title":"Last Response At","description":"List of available last response timestamp filter values"},"first_response_at":{"type":"array","items":{"type":"string","properties":{}},"title":"First Response At","description":"List of available first response timestamp filter values"}},"description":"Represents filter parameters available for the LLM mentions endpoint."},"title":"Result","description":"Filter parameters grouped by endpoint"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in results array"},"status_message":{"type":"string","title":"Status Message","description":"Task-specific informational message"}},"description":"Represents a single task in the response."},"title":"Tasks","description":"Array containing task details with filter information"},"version":{"type":"string","title":"Version","description":"Current API version identifier"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks returning errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_LLM_SCRAPER_LOCATIONS","name":"Get LLM Scraper Locations","description":"Tool to retrieve available locations for DataForSEO ChatGPT LLM Scraper. Use when you need to see which locations are supported for LLM-based web scraping operations.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Cost of the API call in credits."},"time":{"type":"string","title":"Time","description":"Timestamp of when the request was processed."},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"result":{"type":"array","items":{"type":"object","title":"LocationResult","required":["location_code","location_name","country_iso_code","location_type"],"properties":{"location_code":{"type":"integer","title":"Location Code","description":"Unique numeric identifier for the location."},"location_name":{"type":"string","title":"Location Name","description":"Human-readable name of the location."},"location_type":{"type":"string","title":"Location Type","description":"Type of location (e.g., 'Country', 'City', 'Region')."},"country_iso_code":{"type":"string","title":"Country Iso Code","description":"ISO country code for this location (e.g., 'US', 'GB', 'DE')."},"location_code_parent":{"type":"integer","title":"Location Code Parent","description":"Parent location code if this location is part of a larger region. Null for top-level locations."}},"description":"Represents a single location available for ChatGPT LLM Scraper."},"title":"Result","description":"List of available locations for ChatGPT LLM Scraper."}},"description":"Represents the task result containing the list of locations."},"title":"Tasks","description":"List of task results containing location data."},"version":{"type":"string","title":"Version","description":"API version used for the request."},"status_code":{"type":"integer","title":"Status Code","description":"HTTP status code of the response."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response."},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the result."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","AI Optimization"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_ASIN_TASK_ADVANCED_BY_ID","name":"Get Merchant Amazon ASIN Task Advanced By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier (UUID format)"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"asin":{"type":"string","title":"Asin","description":"Amazon Standard Identification Number"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"asin":{"type":"string","title":"Asin","description":"Amazon Standard Identification Number specified in the request"},"type":{"type":"string","title":"Type","description":"Type of the result"},"items":{"type":"array","items":{"type":"object","title":"ProductItem","properties":{"asin":{"type":"string","title":"Asin","description":"Amazon Standard Identification Number"},"type":{"type":"string","title":"Type","description":"Type of the item (e.g., 'amazon_product_info')"},"title":{"type":"string","title":"Title","description":"Product title"},"xpath":{"type":"string","title":"Xpath","description":"XPath location in DOM"},"author":{"type":"string","title":"Author","description":"Brand or author name"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes"}},"description":"Rating information for a product.","additionalProperties":false},"currency":{"type":"string","title":"Currency","description":"Currency code (ISO format)"},"position":{"type":"string","title":"Position","description":"Visual alignment (e.g., 'left', 'right')"},"price_to":{"type":"number","title":"Price To","description":"Ending price for the product"},"data_asin":{"type":"string","title":"Data Asin","description":"ASIN from POST request"},"image_url":{"type":"string","title":"Image Url","description":"URL to the main product image"},"categories":{"type":"array","items":{"type":"object","title":"CategoryInfo","properties":{"url":{"type":"string","title":"Url","description":"URL to the category page"},"category":{"type":"string","title":"Category","description":"Name of the category"}},"description":"Product category information."},"title":"Categories","description":"List of product categories"},"price_from":{"type":"number","title":"Price From","description":"Starting price for the product"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within identical-type elements"},"description":{"type":"string","title":"Description","description":"Product description text"},"parent_asin":{"type":"string","title":"Parent Asin","description":"Parent ASIN if applicable"},"is_available":{"type":"boolean","title":"Is Available","description":"Indicates if the product is available for purchase"},"product_asins":{"type":"array","items":{"type":"string","properties":{}},"title":"Product Asins","description":"All modification ASINs for this product"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in response"},"is_prime_video":{"type":"boolean","title":"Is Prime Video","description":"Prime Video inclusion indicator"},"is_amazon_choice":{"type":"boolean","title":"Is Amazon Choice","description":"Indicates if the product is marked as Amazon's Choice"},"top_local_reviews":{"type":"array","items":{"type":"object","title":"ReviewItem","properties":{"type":{"type":"string","title":"Type","description":"Review item type (e.g., 'amazon_review_item')"},"title":{"type":"string","title":"Title","description":"Review title"},"images":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"title":"Images","description":"List of images attached to the review"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes"}},"description":"Rating information for a product.","additionalProperties":false},"videos":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"title":"Videos","description":"List of videos included in the review"},"verified":{"type":"boolean","title":"Verified","description":"Indicates if the purchase was verified"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within review type group"},"review_text":{"type":"string","title":"Review Text","description":"Full text of the review"},"user_profile":{"type":"object","title":"UserProfile","properties":{"url":{"type":"string","title":"Url","description":"URL to reviewer profile"},"name":{"type":"string","title":"Name","description":"Reviewer name"},"avatar":{"type":"string","title":"Avatar","description":"URL to reviewer avatar image"}},"description":"User profile information for a reviewer.","additionalProperties":false},"helpful_votes":{"type":"integer","title":"Helpful Votes","description":"Number of helpful votes for this review"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position among all reviews"},"publication_date":{"type":"string","title":"Publication Date","description":"Date when the review was published (UTC format)"}},"description":"Individual product review information."},"title":"Top Local Reviews","description":"List of top local reviews for the product"},"top_global_reviews":{"type":"array","items":{"type":"object","title":"ReviewItem","properties":{"type":{"type":"string","title":"Type","description":"Review item type (e.g., 'amazon_review_item')"},"title":{"type":"string","title":"Title","description":"Review title"},"images":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"title":"Images","description":"List of images attached to the review"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating (e.g., 'Max5')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes"}},"description":"Rating information for a product.","additionalProperties":false},"videos":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"title":"Videos","description":"List of videos included in the review"},"verified":{"type":"boolean","title":"Verified","description":"Indicates if the purchase was verified"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within review type group"},"review_text":{"type":"string","title":"Review Text","description":"Full text of the review"},"user_profile":{"type":"object","title":"UserProfile","properties":{"url":{"type":"string","title":"Url","description":"URL to reviewer profile"},"name":{"type":"string","title":"Name","description":"Reviewer name"},"avatar":{"type":"string","title":"Avatar","description":"URL to reviewer avatar image"}},"description":"User profile information for a reviewer.","additionalProperties":false},"helpful_votes":{"type":"integer","title":"Helpful Votes","description":"Number of helpful votes for this review"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position among all reviews"},"publication_date":{"type":"string","title":"Publication Date","description":"Date when the review was published (UTC format)"}},"description":"Individual product review information."},"title":"Top Global Reviews","description":"List of top global reviews for the product"},"percentage_discount":{"type":"number","title":"Percentage Discount","description":"Discount percentage if applicable"},"product_images_list":{"type":"array","items":{"type":"string","properties":{}},"title":"Product Images List","description":"All product image URLs"},"product_information":{"type":"array","items":{"type":"object","title":"ProductInformationSection","properties":{"section_items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"null"}]}},"title":"Section Items","description":"List of product specification key-value pairs"},"section_title":{"type":"string","title":"Section Title","description":"Title of the information section"}},"description":"A section of product information."},"title":"Product Information","description":"Detailed product specifications organized by sections"},"product_videos_list":{"type":"array","items":{"type":"string","properties":{}},"title":"Product Videos List","description":"Product video URLs"},"is_newer_model_available":{"type":"boolean","title":"Is Newer Model Available","description":"Indicates if newer version is available"}},"description":"Detailed product information for an Amazon ASIN."},"title":"Items","description":"List of product information items"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was generated (UTC format)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to Amazon search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Amazon domain used for the request"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"List of result types found"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result"}},"description":"Result data containing Amazon product information."},"title":"Result","description":"List of task results containing Amazon product information"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message for the task"}},"description":"Task data containing the request parameters and results."},"title":"Tasks","description":"List of task data containing Amazon product information results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code of the API response"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_ASIN_TASK_HTML","name":"Get Merchant Amazon ASIN Task HTML","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits (USD)"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"MerchantTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits (USD)"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"MerchantTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of search engine (e.g., 'shopping')"},"items":{"type":"array","items":{"type":"object","title":"HtmlItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML page was scanned in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Amazon product page"},"page":{"type":"integer","title":"Page","description":"Serial number of the HTML page"}},"description":"HTML page item containing raw HTML content."},"title":"Items","description":"Array of HTML page items containing raw HTML content of Amazon product pages"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request (e.g., 'amazon.com')"},"product_id":{"type":"string","title":"Product Id","description":"Product identifier (ASIN) specified in the original POST request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data containing Amazon product HTML content."},"title":"Result","description":"Array of results containing Amazon product HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Amazon ASIN product pages"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_PRODUCTS_TASK_ADVANCED_BY_ID","name":"Get Merchant Amazon Products Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID format)"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search type identifier"},"items":{"type":"array","items":{"type":"object","title":"AmazonProductItem","properties":{"url":{"type":"string","title":"Url","description":"Product page link"},"type":{"type":"string","title":"Type","description":"Element classification (amazon_serp, amazon_paid, editorial_recommendations, top_rated_from_our_brands, related_searches)"},"title":{"type":"string","title":"Title","description":"Product name"},"xpath":{"type":"string","title":"Xpath","description":"DOM location identifier"},"domain":{"type":"string","title":"Domain","description":"Amazon domain reference"},"labels":{"type":"array","items":{"type":"string","properties":{}},"title":"Labels","description":"Product category/type labels"},"rating":{"type":"object","title":"RatingInfo","properties":{"type":{"type":"string","title":"Type","description":"Element identifier"},"value":{"type":"string","title":"Value","description":"Numeric rating value"},"position":{"type":"string","title":"Position","description":"Layout alignment (left/right)"},"rating_max":{"type":"string","title":"Rating Max","description":"Maximum scale value"},"rating_type":{"type":"string","title":"Rating Type","description":"Scale type (Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Feedback/review count"}},"description":"Rating information for Amazon products.","additionalProperties":false},"currency":{"type":"string","title":"Currency","description":"ISO 4217 currency code"},"price_to":{"type":"number","title":"Price To","description":"Range maximum price"},"data_asin":{"type":"string","title":"Data Asin","description":"Amazon product identifier"},"image_url":{"type":"string","title":"Image Url","description":"Product image resource"},"price_from":{"type":"number","title":"Price From","description":"Base/minimum price"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"delivery_info":{"type":"object","title":"DeliveryInfo","properties":{"delivery_price":{"type":"object","title":"DeliveryPrice","properties":{"current":{"type":"number","title":"Current","description":"Active delivery charge"},"regular":{"type":"number","title":"Regular","description":"Standard undiscounted rate"},"currency":{"type":"string","title":"Currency","description":"ISO currency format"},"max_value":{"type":"number","title":"Max Value","description":"Ceiling undiscounted amount"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether value spans a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Formatted display text"}},"description":"Delivery cost breakdown.","additionalProperties":false},"delivery_message":{"type":"string","title":"Delivery Message","description":"Shipping status description"}},"description":"Shipping cost and timing information.","additionalProperties":false},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"},"is_best_seller":{"type":"boolean","title":"Is Best Seller","description":"Best seller badge status"},"special_offers":{"type":"array","items":{"type":"object","title":"SpecialOffer","properties":{"type":{"type":"string","title":"Type","description":"Special offer type identifier"},"title":{"type":"string","title":"Title","description":"Offer title or description"},"description":{"type":"string","title":"Description","description":"Additional offer details"}},"description":"Discount or coupon details."},"title":"Special Offers","description":"Discount/coupon details"},"is_amazon_choice":{"type":"boolean","title":"Is Amazon Choice","description":"Amazon's Choice badge status"},"bought_past_month":{"type":"integer","title":"Bought Past Month","description":"Monthly purchase count"}},"description":"Individual product item from Amazon search results."},"title":"Items","description":"Product data collection"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Decoded search query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct Amazon results link"},"se_domain":{"type":"string","title":"Se Domain","description":"Amazon domain used"},"categories":{"type":"array","items":{"type":"object","title":"CategoryInfo","properties":{"url":{"type":"string","title":"Url","description":"Category page URL"},"type":{"type":"string","title":"Type","description":"Category element type"},"title":{"type":"string","title":"Title","description":"Category name"}},"description":"Department/category hierarchy information."},"title":"Categories","description":"Department/category hierarchy"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Available result categories"},"items_count":{"type":"integer","title":"Items Count","description":"Number of product listings"},"language_code":{"type":"string","title":"Language Code","description":"Language specification"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total matches found"}},"description":"Individual task result containing Amazon Products data."},"title":"Result","description":"Result objects array"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to error documentation for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_PRODUCTS_TASK_HTML_BY_ID","name":"Get Merchant Amazon Products Task HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"HtmlTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"HtmlTaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Amazon products page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the HTML task containing the HTML content."},"title":"Result","description":"Array of HTML task results containing the Amazon products HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Amazon products"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_SELLERS_TASK_ADVANCED","name":"Get Merchant Amazon Sellers Task Advanced","description":"Tool to retrieve Amazon sellers task results from DataForSEO. Use when you need to get seller information for a previously created task.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format obtained from task_post endpoint. Results accessible for 30 days after task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD."},"time":{"type":"string","title":"Time","description":"Execution time in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID format)."},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD."},"data":{"type":"object","title":"TaskRequestData","properties":{"asin":{"type":"string","title":"Asin","description":"ASIN from the request."},"language_code":{"type":"string","title":"Language Code","description":"Language code."},"language_name":{"type":"string","title":"Language Name","description":"Language name."},"location_code":{"type":"integer","title":"Location Code","description":"Location code."},"location_name":{"type":"string","title":"Location Name","description":"Location name."}},"description":"Original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components."},"time":{"type":"string","title":"Time","description":"Task execution duration."},"result":{"type":"array","items":{"type":"object","title":"AmazonSellersResult","properties":{"asin":{"type":"string","title":"Asin","description":"Amazon Standard Identification Number."},"type":{"type":"string","title":"Type","description":"Type of the result (e.g., 'amazon_sellers')."},"image":{"type":"string","title":"Image","description":"Product image URL."},"items":{"type":"array","items":{"type":"object","title":"AmazonSellerItem","properties":{"type":{"type":"string","title":"Type","description":"Type of the result item (e.g., 'amazon_seller_item', 'amazon_seller_main_item')."},"price":{"type":"object","title":"SellerPrice","properties":{"current":{"type":"number","title":"Current","description":"Current price."},"regular":{"type":"number","title":"Regular","description":"Regular price before any discount."},"currency":{"type":"string","title":"Currency","description":"Currency code (e.g., 'USD')."},"max_value":{"type":"number","title":"Max Value","description":"Maximum price value."},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether the price is a range."},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed on Amazon."}},"description":"Price information for a seller's offer.","additionalProperties":false},"xpath":{"type":"string","title":"Xpath","description":"XPath selector for the element."},"rating":{"type":"object","title":"SellerRating","properties":{"type":{"type":"string","title":"Type","description":"Type of rating (e.g., 'Max5')."},"value":{"type":"number","title":"Value","description":"Rating value."},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum possible rating value."},"rating_type":{"type":"string","title":"Rating Type","description":"Rating type identifier."},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes for this rating."}},"description":"Rating information for a seller.","additionalProperties":false},"position":{"type":"string","title":"Position","description":"Position of the result on the page."},"condition":{"type":"string","title":"Condition","description":"Condition of the item (e.g., 'New', 'Used')."},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of similar rank results."},"seller_url":{"type":"string","title":"Seller Url","description":"URL to the seller's page."},"ships_from":{"type":"string","title":"Ships From","description":"Location from where the item ships."},"seller_name":{"type":"string","title":"Seller Name","description":"Name of the seller."},"delivery_info":{"type":"object","title":"DeliveryInfo","properties":{"delivery_price":{"type":"number","title":"Delivery Price","description":"Delivery price amount."},"delivery_date_to":{"type":"string","title":"Delivery Date To","description":"Estimated delivery end date."},"delivery_message":{"type":"string","title":"Delivery Message","description":"Delivery message text."},"delivery_date_from":{"type":"string","title":"Delivery Date From","description":"Estimated delivery start date."},"fastest_delivery_date_to":{"type":"string","title":"Fastest Delivery Date To","description":"Fastest delivery end date."},"fastest_delivery_date_from":{"type":"string","title":"Fastest Delivery Date From","description":"Fastest delivery start date."}},"description":"Delivery information for a seller's offer.","additionalProperties":false},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute rank position in results."},"applicable_vouchers":{"type":"string","title":"Applicable Vouchers","description":"Information about applicable vouchers."},"percentage_discount":{"type":"integer","title":"Percentage Discount","description":"Percentage discount applied."},"condition_description":{"type":"string","title":"Condition Description","description":"Detailed description of item condition."}},"description":"Individual Amazon seller item."},"title":"Items","description":"List of seller items."},"title":{"type":"string","title":"Title","description":"Product title."},"datetime":{"type":"string","title":"Datetime","description":"Timestamp when the data was retrieved (UTC format)."},"check_url":{"type":"string","title":"Check Url","description":"URL that was checked for results."},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (e.g., 'amazon.com')."},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"List of item types present in results."},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this result set."},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request (e.g., 'en')."},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request."}},"description":"Result data for an Amazon sellers task."},"title":"Result","description":"List of Amazon sellers result objects."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements."},"status_message":{"type":"string","title":"Status Message","description":"Task-specific informational message."}},"description":"Task object containing execution metadata and results."},"title":"Tasks","description":"Array of task objects with results."},"version":{"type":"string","title":"Version","description":"Current API version."},"status_code":{"type":"integer","title":"Status Code","description":"General status code. 20000 indicates success."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in response array."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks returned with errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about request outcome."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_AMAZON_SELLERS_TASK_HTML_BY_ID","name":"Get Merchant Amazon Sellers Task HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"MerchantAmazonSellersTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"MerchantAmazonSellersTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of the result"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Amazon sellers page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content for Amazon sellers."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"product_id":{"type":"string","title":"Product Id","description":"Product ID specified in the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the Amazon Sellers HTML task containing the HTML content."},"title":"Result","description":"Array of HTML task results containing the Amazon sellers HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Amazon sellers information"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_GOOGLE_PRODUCTS_TASK_ADVANCED_BY_ID","name":"Get Merchant Google Products Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"type":"object","title":"GoogleShoppingProductItem","properties":{"gid":{"type":"string","title":"Gid","description":"Google product group ID"},"url":{"type":"string","title":"Url","description":"Product page URL"},"tags":{"type":"array","items":{"type":"string","properties":{}},"title":"Tags","description":"Product tags/labels"},"type":{"type":"string","title":"Type","description":"Element type (google_shopping_serp, google_shopping_paid, google_shopping_carousel, google_shopping_sponsored_carousel, related_searches)"},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"title":"Items","description":"Nested items for carousel/container elements"},"price":{"type":"number","title":"Price","description":"Current product price"},"title":{"type":"string","title":"Title","description":"Product title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in HTML"},"domain":{"type":"string","title":"Domain","description":"Seller domain"},"seller":{"type":"string","title":"Seller","description":"Seller name"},"currency":{"type":"string","title":"Currency","description":"ISO 4217 currency code"},"position":{"type":"string","title":"Position","description":"Position on the page"},"old_price":{"type":"number","title":"Old Price","description":"Original price before discount"},"data_docid":{"type":"string","title":"Data Docid","description":"Google document ID"},"product_id":{"type":"string","title":"Product Id","description":"Product identifier"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"description":{"type":"string","title":"Description","description":"Product description"},"shop_rating":{"type":"object","title":"RatingElement","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier"},"value":{"type":"number","title":"Value","description":"Numeric rating value"},"position":{"type":"string","title":"Position","description":"Layout position (left/right)"},"rating_max":{"type":"number","title":"Rating Max","description":"Maximum rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Scale type (Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of reviews/votes"}},"description":"Rating information for products and shops.","additionalProperties":false},"shop_ad_aclk":{"type":"string","title":"Shop Ad Aclk","description":"Ad click tracking parameter"},"delivery_info":{"type":"object","title":"DeliveryInfo","properties":{"delivery_price":{"type":"object","title":"DeliveryPrice","properties":{"current":{"type":"number","title":"Current","description":"Current delivery charge"},"regular":{"type":"number","title":"Regular","description":"Regular undiscounted price"},"currency":{"type":"string","title":"Currency","description":"ISO currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum undiscounted price"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether the price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to user"}},"description":"Delivery cost breakdown.","additionalProperties":false},"delivery_message":{"type":"string","title":"Delivery Message","description":"Delivery status or timing message"}},"description":"Shipping cost and timing information.","additionalProperties":false},"is_best_match":{"type":"boolean","title":"Is Best Match","description":"Best match indicator"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"},"reviews_count":{"type":"integer","title":"Reviews Count","description":"Number of reviews"},"product_images":{"type":"array","items":{"type":"string","properties":{}},"title":"Product Images","description":"Product image URLs"},"product_rating":{"type":"object","title":"RatingElement","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier"},"value":{"type":"number","title":"Value","description":"Numeric rating value"},"position":{"type":"string","title":"Position","description":"Layout position (left/right)"},"rating_max":{"type":"number","title":"Rating Max","description":"Maximum rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Scale type (Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of reviews/votes"}},"description":"Rating information for products and shops.","additionalProperties":false},"stores_count_info":{"type":"object","title":"StoresCountInfo","properties":{"type":{"type":"string","title":"Type","description":"Element type"},"count":{"type":"integer","title":"Count","description":"Number of stores with product"}},"description":"Store availability information.","additionalProperties":false},"special_offer_info":{"type":"object","title":"SpecialOfferInfo","properties":{"type":{"type":"string","title":"Type","description":"Special offer type"},"title":{"type":"string","title":"Title","description":"Offer title"},"sub_title":{"type":"string","title":"Sub Title","description":"Additional offer description"},"coupon_code":{"type":"string","title":"Coupon Code","description":"Coupon code if applicable"},"coupon_info":{"type":"string","title":"Coupon Info","description":"Additional coupon information"},"fixed_discount":{"type":"number","title":"Fixed Discount","description":"Fixed amount discount"},"percentage_discount":{"type":"number","title":"Percentage Discount","description":"Percentage discount"}},"description":"Discount or special offer details.","additionalProperties":false}},"description":"Individual product item from Google Shopping results."},"title":"Items","description":"Product data collection"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Correction type/reason"},"keyword":{"type":"string","title":"Keyword","description":"Corrected search term"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to Google Shopping results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present"},"items_count":{"type":"integer","title":"Items Count","description":"Number of product items returned"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"}},"description":"Individual task result containing Google Shopping Products data."},"title":"Result","description":"Array of result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (see error documentation)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message for status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_GOOGLE_PRODUCTS_TASK_HTML","name":"Get Merchant Google Products Task HTML","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits (USD)"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"GoogleProductsTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits (USD)"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":true},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"GoogleProductsTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of search engine (e.g., 'shopping')"},"items":{"type":"array","items":{"type":"object","title":"HtmlPageItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML page was scanned in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Shopping products page"},"page":{"type":"integer","title":"Page","description":"Serial number of the HTML page"}},"description":"HTML page item containing raw HTML content."},"title":"Items","description":"Array of HTML page items containing raw HTML content of Google Shopping product pages"},"keyword":{"type":"string","title":"Keyword","description":"Keyword specified in the original POST request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request (e.g., 'google.com')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data containing Google Shopping products HTML content."},"title":"Result","description":"Array of results containing Google Shopping products HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Shopping products"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_GOOGLE_SELLERS_TASK_ADVANCED_BY_ID","name":"Get Merchant Google Sellers Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID format)"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"url":{"type":"string","title":"Url","description":"Product page URL"},"type":{"type":"string","title":"Type","description":"Result type identifier"},"items":{"type":"array","items":{"type":"object","title":"SellerListingItem","properties":{"tax":{"type":"number","title":"Tax","description":"Tax amount"},"url":{"type":"string","title":"Url","description":"Product page link"},"type":{"type":"string","title":"Type","description":"Element classification (shops_list, buy_on_google)"},"title":{"type":"string","title":"Title","description":"Product title"},"xpath":{"type":"string","title":"Xpath","description":"DOM location identifier"},"domain":{"type":"string","title":"Domain","description":"Seller domain reference"},"rating":{"type":"object","title":"RatingInfo","properties":{"type":{"type":"string","title":"Type","description":"Element identifier"},"value":{"type":"number","title":"Value","description":"Numeric rating value"},"position":{"type":"string","title":"Position","description":"Layout alignment (left/right)"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum scale value"},"rating_type":{"type":"string","title":"Rating Type","description":"Scale type (Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Feedback/review count"}},"description":"Rating information for products or sellers.","additionalProperties":false},"currency":{"type":"string","title":"Currency","description":"ISO 4217 currency code"},"base_price":{"type":"number","title":"Base Price","description":"Base product price"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"seller_name":{"type":"string","title":"Seller Name","description":"Name of the seller"},"total_price":{"type":"number","title":"Total Price","description":"Total price including tax and shipping"},"shop_ad_aclk":{"type":"string","title":"Shop Ad Aclk","description":"Ad click identifier"},"delivery_info":{"type":"string","title":"Delivery Info","description":"Delivery information text"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall position in results"},"shipping_price":{"type":"number","title":"Shipping Price","description":"Shipping cost"},"product_condition":{"type":"string","title":"Product Condition","description":"Product condition (New, Refurbished, Used, etc.)"},"product_annotation":{"type":"string","title":"Product Annotation","description":"Additional product notes"},"product_availability":{"type":"string","title":"Product Availability","description":"Availability status (in_stock, out_of_stock, etc.)"}},"description":"Individual seller listing item from Google Sellers results."},"title":"Items","description":"Seller listing data collection"},"title":{"type":"string","title":"Title","description":"Product title"},"rating":{"type":"object","title":"RatingInfo","properties":{"type":{"type":"string","title":"Type","description":"Element identifier"},"value":{"type":"number","title":"Value","description":"Numeric rating value"},"position":{"type":"string","title":"Position","description":"Layout alignment (left/right)"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum scale value"},"rating_type":{"type":"string","title":"Rating Type","description":"Scale type (Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Feedback/review count"}},"description":"Rating information for products or sellers.","additionalProperties":false},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct Google Shopping results link"},"image_url":{"type":"string","title":"Image Url","description":"Product image resource"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Available result categories"},"product_id":{"type":"string","title":"Product Id","description":"Product identifier"},"items_count":{"type":"integer","title":"Items Count","description":"Number of seller listings"},"language_code":{"type":"string","title":"Language Code","description":"Language specification"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"}},"description":"Individual task result containing Google Sellers data."},"title":"Result","description":"Result objects array"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to error documentation for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_MERCHANT_G_PRODUCT_INFO_TASK_ADV_BY_ID","name":"Get Merchant Google Product Info Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Result type (typically 'product_info')"},"items":{"type":"array","items":{"type":"object","title":"ProductInfoItem","properties":{"gid":{"type":"string","title":"Gid","description":"Google internal identifier"},"url":{"type":"string","title":"Url","description":"Product page URL"},"type":{"type":"string","title":"Type","description":"Element type (typically 'product_info_element')"},"title":{"type":"string","title":"Title","description":"Product title"},"images":{"type":"array","items":{"type":"string","properties":{}},"title":"Images","description":"Array of product image URLs"},"rating":{"type":"object","title":"RatingInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of rating element"},"value":{"type":"number","title":"Value","description":"Rating value"},"position":{"type":"string","title":"Position","description":"Alignment of the element"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for products or sellers.","additionalProperties":false},"sellers":{"type":"array","items":{"type":"object","title":"SellerInfo","properties":{"url":{"type":"string","title":"Url","description":"Seller profile URL"},"type":{"type":"string","title":"Type","description":"Type of seller element"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price"},"regular":{"type":"number","title":"Regular","description":"Regular price"},"currency":{"type":"string","title":"Currency","description":"ISO 4217 currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price value"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Indicates if the price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for a product.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Seller name"},"delivery_info":{"type":"object","title":"DeliveryInfo","properties":{"delivery_price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price"},"regular":{"type":"number","title":"Regular","description":"Regular price"},"currency":{"type":"string","title":"Currency","description":"ISO 4217 currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price value"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Indicates if the price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for a product.","additionalProperties":false},"delivery_message":{"type":"string","title":"Delivery Message","description":"Delivery status or timing message"}},"description":"Delivery information for a product.","additionalProperties":false},"seller_rating":{"type":"object","title":"RatingInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of rating element"},"value":{"type":"number","title":"Value","description":"Rating value"},"position":{"type":"string","title":"Position","description":"Alignment of the element"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for products or sellers.","additionalProperties":false},"product_availability":{"type":"string","title":"Product Availability","description":"Product availability status (e.g., in_stock, limited_stock, out_of_stock)"}},"description":"Seller information within product listings."},"title":"Sellers","description":"Array of sellers offering the product"},"features":{"type":"array","items":{"type":"string","properties":{}},"title":"Features","description":"Array of product feature descriptions"},"position":{"type":"string","title":"Position","description":"Alignment of the element"},"data_docid":{"type":"string","title":"Data Docid","description":"Unique document identifier for product"},"product_id":{"type":"string","title":"Product Id","description":"Product identifier"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of elements with identical type"},"variations":{"type":"array","items":{"type":"object","title":"ProductVariation","properties":{"url":{"type":"string","title":"Url","description":"Variation product URL"},"type":{"type":"string","title":"Type","description":"Type of variation element"},"title":{"type":"string","title":"Title","description":"Variation title"},"product_id":{"type":"string","title":"Product Id","description":"Variation product identifier"}},"description":"Product variation or alternative version."},"title":"Variations","description":"Array of product variations or alternatives"},"description":{"type":"string","title":"Description","description":"Product description"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute rank among all elements"},"specifications":{"type":"array","items":{"type":"object","title":"SpecificationInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of specification element"},"block_name":{"type":"string","title":"Block Name","description":"Category or group name for specification"},"specification_name":{"type":"string","title":"Specification Name","description":"Name of the specification attribute"},"specification_value":{"type":"string","title":"Specification Value","description":"Value of the specification"}},"description":"Product specification information."},"title":"Specifications","description":"Array of product specifications"},"seller_reviews_count":{"type":"integer","title":"Seller Reviews Count","description":"Total number of seller reviews"}},"description":"Detailed product information from Google Merchant."},"title":"Items","description":"Array of product information items"},"datetime":{"type":"string","title":"Datetime","description":"Date and time of data retrieval in UTC (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to view product on Google Shopping"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for retrieval"},"product_id":{"type":"string","title":"Product Id","description":"Product identifier from original request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of product items in the result"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for retrieval"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used"}},"description":"Individual task result containing Google Product Info data."},"title":"Result","description":"Array of task result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Status code specific to this task"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about task status"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to DataForSEO error documentation for details)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","Merchant Data"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_DUPLICATE_CONTENT","name":"Get On Page Duplicate Content","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"tag":{"type":"string","description":"User-defined identifier for task tracking. Maximum 255 characters. This tag is returned in the response to help match requests with results","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"url":{"type":"string","description":"Initial page URL to analyze for duplicate content. Must be a valid URL that was crawled in the task","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"limit":{"type":"integer","description":"Maximum number of pages to return in the results. Defaults to 100 if not specified. Maximum allowed value is 1000","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"offset":{"type":"integer","description":"Offset for results pagination. Use this to skip the first N results. Defaults to 0","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"similarity":{"type":"integer","description":"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","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier used in the request"},"tag":{"type":"string","title":"Tag","description":"User-defined tag from the request"},"url":{"type":"string","title":"Url","description":"URL analyzed in the request"},"limit":{"type":"integer","title":"Limit","description":"Result limit used in the request"},"offset":{"type":"integer","title":"Offset","description":"Result offset used in the request"},"similarity":{"type":"integer","title":"Similarity","description":"Similarity threshold used in the request"}},"description":"Echo of the original request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"DuplicateContentResult","properties":{"url":{"type":"string","title":"Url","description":"Original page URL that was analyzed for duplicate content"},"pages":{"type":"array","items":{"type":"object","title":"PageMetrics","properties":{"url":{"type":"string","title":"Url","description":"URL of the duplicate page"},"size":{"type":"integer","title":"Size","description":"Page size in bytes"},"server":{"type":"string","title":"Server","description":"Web server software used to serve the page"},"location":{"type":"string","title":"Location","description":"Redirect location if the page returned a redirect status code"},"fetch_time":{"type":"string","title":"Fetch Time","description":"Timestamp when the page was fetched during the crawl"},"media_type":{"type":"string","title":"Media Type","description":"Media type of the page content (e.g., text/html)"},"meta_title":{"type":"string","title":"Meta Title","description":"Page title from meta tags"},"page_title":{"type":"string","title":"Page Title","description":"Page title extracted from the title tag"},"similarity":{"type":"integer","title":"Similarity","description":"Similarity score from 0-10 indicating how similar this page is to the original page. Higher scores indicate greater similarity"},"is_redirect":{"type":"boolean","title":"Is Redirect","description":"Whether this URL is a redirect"},"status_code":{"type":"integer","title":"Status Code","description":"HTTP status code returned when fetching the page"},"encoded_size":{"type":"integer","title":"Encoded Size","description":"Encoded (compressed) size of the page in bytes"},"onpage_score":{"type":"number","title":"Onpage Score","description":"Overall on-page optimization score"},"meta_keywords":{"type":"string","title":"Meta Keywords","description":"Keywords from meta keywords tag"},"resource_type":{"type":"string","title":"Resource Type","description":"Type of resource (e.g., html, script, stylesheet)"},"content_encoding":{"type":"string","title":"Content Encoding","description":"Content encoding type (e.g., gzip, deflate)"},"meta_description":{"type":"string","title":"Meta Description","description":"Page description from meta description tag"},"page_description":{"type":"string","title":"Page Description","description":"Page description extracted from meta description tag"}},"description":"Detailed metrics for a page identified as having duplicate content."},"title":"Pages","description":"Array of pages with duplicate content including similarity scores and detailed page metrics"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of duplicate pages found matching the similarity threshold"}},"description":"Result data for duplicate content analysis."},"title":"Result","description":"Array containing duplicate content analysis results with pages and similarity scores"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Individual task information with duplicate content results."},"title":"Tasks","description":"Array of tasks containing duplicate content analysis results including similarity scores and page metrics"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (e.g., 20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_DUPLICATE_TAGS","name":"Get On Page Duplicate Tags","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items for retrieving duplicate tags. Each task requires an On Page task ID and duplicate type. Maximum 100 tasks per request.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"GetOnPageDuplicateTagsRequestItem","required":["id","type"],"properties":{"id":{"type":"string","title":"Id","examples":["07281559-0695-0216-0000-c269be8b7592"],"description":"Unique task identifier from a previously created On Page task (obtained via /v3/on_page/task_post). This ID is required to retrieve duplicate tag results."},"tag":{"type":"string","title":"Tag","description":"Custom tag identifier for filtering results. Must match the tag used when creating the original On Page task. Maximum 255 characters."},"type":{"enum":["duplicate_title","duplicate_description"],"type":"string","title":"Type","description":"Type of duplicate tag to retrieve. Either 'duplicate_title' for pages with duplicate title tags or 'duplicate_description' for pages with duplicate meta description tags."},"limit":{"type":"integer","title":"Limit","examples":[10,50,100],"description":"Maximum number of results to return per request. Default varies by endpoint. Use with offset for pagination."},"offset":{"type":"integer","title":"Offset","examples":[0,10,50],"description":"Number of results to skip before returning data. Use with limit for pagination through large result sets."},"accumulator":{"type":"string","title":"Accumulator","description":"Custom accumulator identifier for grouping results. Maximum 255 characters."}},"description":"Individual request item for fetching duplicate tags from an On Page task.","requiredFields":"$17:props:tools:113:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD for all tasks"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format matching the requested On Page task ID"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Task ID from request"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Tag parameter from request"},"type":{"type":"string","title":"Type","description":"Duplicate type from request"},"limit":{"type":"integer","title":"Limit","description":"Limit parameter from request"},"offset":{"type":"integer","title":"Offset","description":"Offset parameter from request"},"function":{"type":"string","title":"Function","description":"API function called"},"accumulator":{"type":"string","title":"Accumulator","description":"Accumulator parameter from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"ResultItem","properties":{"type":{"type":"string","title":"Type","description":"Type of duplicate tag result (e.g., 'duplicate_title' or 'duplicate_description')"},"count":{"type":"integer","title":"Count","description":"Number of pages sharing this duplicate value"},"pages":{"type":"array","items":{"type":"object","title":"PageItem","properties":{"url":{"type":"string","title":"Url","description":"Full URL of the page"},"title":{"type":"string","title":"Title","description":"Page title tag content"},"url_length":{"type":"integer","title":"Url Length","description":"Length of the URL in characters"},"description":{"type":"string","title":"Description","description":"Meta description tag content"},"main_domain":{"type":"string","title":"Main Domain","description":"Main domain of the page URL"},"page_metrics":{"type":"object","title":"PageMetrics","properties":{"broken_links":{"type":"integer","title":"Broken Links","description":"Number of broken links found on the page"},"links_external":{"type":"integer","title":"Links External","description":"Number of external links on the page"},"duplicate_title":{"type":"integer","title":"Duplicate Title","description":"Count of pages with identical title tag"},"broken_resources":{"type":"integer","title":"Broken Resources","description":"Number of broken resources (images, scripts, etc.)"},"duplicate_content":{"type":"integer","title":"Duplicate Content","description":"Count of pages with identical content"},"duplicate_description":{"type":"integer","title":"Duplicate Description","description":"Count of pages with identical meta description"}},"description":"Performance metrics for a page with duplicate tags.","additionalProperties":false},"relative_url_length":{"type":"integer","title":"Relative Url Length","description":"Length of the relative URL path"}},"description":"Represents a single page containing duplicate tags."},"title":"Pages","description":"List of pages containing the duplicate tag value"},"duplicate_value":{"type":"string","title":"Duplicate Value","description":"The duplicate title or description value shared by multiple pages"}},"description":"Result data for duplicate tags including the duplicate value and affected pages."},"title":"Result","description":"Array of duplicate tag results. Each item contains the duplicate value and list of affected pages."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success, 40403 indicates results expired or not found, codes 40000+ indicate errors."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects containing duplicate tag data and affected pages with their performance metrics."},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the request"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_KEYWORD_DENSITY","name":"Get On Page Keyword Density","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Task identifier from a previous On Page task in UUID format. You must have a completed On Page task to use this endpoint.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"tag":{"type":"string","description":"Custom identifier for matching results with your tasks. Maximum 255 characters. Useful for tracking and organizing requests.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"url":{"type":"string","description":"Specific page URL to analyze for keyword density. Omit this parameter to analyze the entire website from the original On Page task.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"limit":{"type":"integer","description":"Maximum number of keywords to return in results. Default is 100, maximum is 1000. Use to control response size.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"filters":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]},"properties":{}}},"order_by":{"type":"array","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"keyword_length":{"type":"integer","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier from the original request"},"tag":{"type":"string","title":"Tag","description":"Tag from the original request"},"url":{"type":"string","title":"Url","description":"URL from the original request"},"limit":{"type":"integer","title":"Limit","description":"Limit from the original request"},"filters":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}},{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}}}],"title":"Filters","description":"Filters from the original request (can be flat array or nested array depending on API response)"},"order_by":{"type":"array","items":{"type":"string","properties":{}},"title":"Order By","description":"Order by rules from the original request"},"keyword_length":{"type":"integer","title":"Keyword Length","description":"Keyword length from the original request"}},"description":"Echo of the original POST request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API endpoint path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"KeywordDensityResult","properties":{"items":{"type":"array","items":{"type":"object","title":"KeywordDensityItem","properties":{"density":{"type":"number","title":"Density","description":"Keyword density as a percentage of total words on the page"},"keyword":{"type":"string","title":"Keyword","description":"The keyword or phrase found on the page"},"frequency":{"type":"integer","title":"Frequency","description":"Number of times the keyword appears on the page"}},"description":"Individual keyword density result item."},"title":"Items","description":"Array of keyword density items with frequency and density metrics for each keyword found"},"items_count":{"type":"integer","title":"Items Count","description":"Number of keyword density items returned in this result"},"crawl_progress":{"type":"string","title":"Crawl Progress","description":"Crawl progress status from the original On Page task"}},"description":"Result data containing keyword density metrics for analyzed page or website."},"title":"Result","description":"Array of result objects containing keyword density data with frequency and density metrics for each keyword"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success, 40000+ indicates error"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable status message for the task"}},"description":"Individual task object containing keyword density results and metadata."},"title":"Tasks","description":"Array of task objects containing keyword density results"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code. 20000 indicates success"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_LIGHTHOUSE_AUDITS","name":"Get On Page Lighthouse Audits","description":"Tool 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.","input_parameters":"$undefined","output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD (typically 0 for this endpoint)"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD (typically 0 for this endpoint)"},"data":{"type":"object","title":"Data","description":"Echo of POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"AuditResult","properties":{"audits":{"type":"array","items":{"type":"string","properties":{}},"title":"Audits","description":"List of available Lighthouse audit titles as strings. May contain markdown formatting and can vary based on pass/fail status."}},"description":"Represents the result containing available Lighthouse audit titles."},"title":"Result","description":"Array containing available Lighthouse audit information"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Represents a single task result within the response."},"title":"Tasks","description":"Array of task objects containing Lighthouse audit information"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_LIGHTHOUSE_TASK_GET_JSON","name":"Get On Page Lighthouse Task Get Json","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"target":{"type":"string","title":"Target","description":"Target URL that was audited"},"load_resources":{"type":"boolean","title":"Load Resources","description":"Whether to load resources during audit"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum number of pages to crawl"},"enable_javascript":{"type":"boolean","title":"Enable Javascript","description":"Whether JavaScript was enabled"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"LighthouseResult","properties":{"audits":{"type":"object","title":"Audits","description":"Dictionary of audit results keyed by audit ID","additionalProperties":{"type":"object","title":"AuditResult","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null,"description":"Unique audit identifier (e.g., 'first-contentful-paint', 'interactive')"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score","default":null,"description":"Performance score from 0 to 1, or null for informative audits"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Human-readable audit name"},"details":{"anyOf":[{"type":"object","title":"AuditDetails","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of details (e.g., 'opportunity', 'table', 'filmstrip', 'screenshot', 'criticalrequestchain')"},"items":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"null"}],"title":"Items","default":null,"description":"Array of detail items specific to the audit type"},"headings":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"null"}],"title":"Headings","default":null,"description":"Column headers for table-type details"},"overallSavingsMs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overallsavingsms","default":null,"description":"Potential time savings in milliseconds for opportunity audits"},"overallSavingsBytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Overallsavingsbytes","default":null,"description":"Potential byte savings for opportunity audits"}},"description":"Structured audit findings with details about the audit result."},{"type":"null"}],"default":null,"description":"Structured findings with additional details about the audit"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":null,"description":"Detailed explanation of the audit with learning resources"},"numericUnit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numericunit","default":null,"description":"Unit of measurement (e.g., 'millisecond', 'byte', 'unitless')"},"displayValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayvalue","default":null,"description":"Formatted display text for the audit result"},"numericValue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Numericvalue","default":null,"description":"Raw measurement value for the audit"},"scoreDisplayMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scoredisplaymode","default":null,"description":"Display type: 'numeric', 'binary', 'informative', 'error', or 'notApplicable'"}},"description":"Individual Lighthouse audit result."}},"finalUrl":{"type":"string","title":"Final Url","description":"Final URL after redirects"},"fetchTime":{"type":"string","title":"Fetch Time","description":"ISO timestamp when the audit was performed"},"userAgent":{"type":"string","title":"User Agent","description":"User agent string used during the Lighthouse audit"},"categories":{"type":"object","title":"Categories","description":"Category scores (performance, accessibility, best-practices, seo, pwa)","additionalProperties":true},"environment":{"type":"object","title":"LighthouseEnvironment","properties":{"hostUserAgent":{"type":"string","title":"Host User Agent","description":"Host user agent string"},"benchmarkIndex":{"type":"number","title":"Benchmark Index","description":"Benchmark index for the test environment"},"networkUserAgent":{"type":"string","title":"Network User Agent","description":"User agent string used for the audit"}},"description":"Environment information for the Lighthouse audit run.","additionalProperties":false},"runWarnings":{"type":"array","items":{"type":"string","properties":{}},"title":"Run Warnings","description":"Array of warnings encountered during the audit"},"requestedUrl":{"type":"string","title":"Requested Url","description":"Originally requested URL"},"categoryGroups":{"type":"object","title":"Category Groups","description":"Groupings of related audits","additionalProperties":true},"lighthouseVersion":{"type":"string","title":"Lighthouse Version","description":"Version of Lighthouse used for the audit"}},"description":"Complete Lighthouse audit result data."},"title":"Result","description":"Array of Lighthouse audit results containing detailed audit data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Lighthouse results."},"title":"Tasks","description":"Array of task objects containing Lighthouse audit results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_LINKS","name":"Get On Page Links","description":"Tool to retrieve internal and external links detected on a target website by task ID. Use when you need to analyze link structure, check for broken links, filter links by type (anchor, image, canonical, meta, alternate, redirect), or examine link attributes like dofollow/nofollow status.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"tag":{"type":"string","description":"User-defined task identifier for tracking purposes. Maximum 255 characters.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"limit":{"type":"integer","description":"Maximum number of links to return. Default is 100, maximum is 1000.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"offset":{"type":"integer","description":"Results offset for pagination. Default is 0. Use this to skip the first N results.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"filters":{"type":"array","description":"Array of filtering conditions (up to 8 filters). Supports operators: regex, not_regex, =, <>, in, not_in, like, not_like. Example: [['dofollow', '=', true], 'and', ['direction', '=', 'external']] to get external dofollow links.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"integer"},{"type":"number"}]}},{"type":"string"}],"properties":{}}},"page_to":{"type":"string","description":"Relative page URL to filter internal links pointing to a page. Use this to find all internal links that point to a specific page.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"page_from":{"type":"string","description":"Relative page URL to filter links from a specific page (e.g., '/apis/google-trends-api'). Use this to get all links originating from a particular page.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"search_after_token":{"type":"string","description":"Pagination token for fetching results beyond offset 20,000. Use the token returned in previous response to continue pagination.","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier used in the request"},"tag":{"type":"string","title":"Tag","description":"Custom tag used in the request"},"limit":{"type":"integer","title":"Limit","description":"Limit parameter used in the request"},"offset":{"type":"integer","title":"Offset","description":"Offset parameter used in the request"},"filters":{"type":"array","items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"integer"},{"type":"number"}]}},{"type":"string"}],"properties":{}},"title":"Filters","description":"Filters array used in the request"},"page_to":{"type":"string","title":"Page To","description":"Page to filter used in the request"},"page_from":{"type":"string","title":"Page From","description":"Page from filter used in the request"}},"description":"Echo of the original request parameters sent in the task request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"OnPageLinksResult","properties":{"items":{"type":"array","items":{"type":"object","title":"LinkItem","properties":{"type":{"type":"string","title":"Type","description":"Type of link: anchor, image, canonical, meta, alternate, or redirect"},"link_to":{"type":"string","title":"Link To","description":"Full URL of the destination page"},"page_to":{"type":"string","title":"Page To","description":"Relative URL of the page the link points to"},"dofollow":{"type":"boolean","title":"Dofollow","description":"Whether the link is dofollow (true) or nofollow (false)"},"hreflang":{"type":"string","title":"Hreflang","description":"Language code for alternate links (only present for type=alternate)"},"direction":{"type":"string","title":"Direction","description":"Link direction: internal or external"},"domain_to":{"type":"string","title":"Domain To","description":"Destination domain of the link"},"image_alt":{"type":"string","title":"Image Alt","description":"Alt text for image links (only present for type=image)"},"image_src":{"type":"string","title":"Image Src","description":"Source URL for image links (only present for type=image)"},"is_broken":{"type":"boolean","title":"Is Broken","description":"Whether the link is broken (returns 4xx or 5xx status)"},"link_from":{"type":"string","title":"Link From","description":"Full URL of the source page"},"page_from":{"type":"string","title":"Page From","description":"Relative URL of the page containing the link"},"domain_from":{"type":"string","title":"Domain From","description":"Source domain of the link"},"link_attribute":{"type":"array","items":{"type":"string","properties":{}},"title":"Link Attribute","description":"Array of link attributes (e.g., ['nofollow', 'ugc'])"},"page_to_scheme":{"type":"string","title":"Page To Scheme","description":"Protocol scheme of the destination page (http or https)"},"page_from_scheme":{"type":"string","title":"Page From Scheme","description":"Protocol scheme of the source page (http or https)"},"is_valid_hreflang":{"type":"boolean","title":"Is Valid Hreflang","description":"Whether hreflang is valid (only present for type=alternate)"},"page_to_status_code":{"type":"integer","title":"Page To Status Code","description":"HTTP status code of the destination page"},"is_link_relation_conflict":{"type":"boolean","title":"Is Link Relation Conflict","description":"Whether there are conflicting rel attributes on the link"}},"description":"Individual link object containing link details and attributes."},"title":"Items","description":"Array of link objects containing link details and attributes"},"items_count":{"type":"integer","title":"Items Count","description":"Number of links returned in this response"},"crawl_status":{"type":"object","title":"CrawlStatus","properties":{"pages_crawled":{"type":"integer","title":"Pages Crawled","description":"Number of pages successfully crawled"},"pages_in_queue":{"type":"integer","title":"Pages In Queue","description":"Number of pages awaiting crawl"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum number of pages set for crawling"}},"description":"Crawl status information including queue and progress metrics.","additionalProperties":false},"crawl_progress":{"type":"string","title":"Crawl Progress","description":"Progress of the crawl operation (e.g., 'finished', 'in_progress')"},"total_items_count":{"type":"integer","title":"Total Items Count","description":"Total number of links available in the task results"},"search_after_token":{"type":"string","title":"Search After Token","description":"Token for pagination beyond offset 20,000. Use this token in next request to continue pagination."}},"description":"Result object containing links data for an On Page task."},"title":"Result","description":"List of On Page Links results containing link details"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with On Page Links results."},"title":"Tasks","description":"Array of task objects containing On Page Links results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_NON_INDEXABLE","name":"Get On Page Non Indexable","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to retrieve non-indexable pages. Each task requires a task ID obtained from a previous On-Page crawl.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"GetOnPageNonIndexableRequestItem","required":["id"],"properties":{"id":{"type":"string","title":"Id","examples":["07281559-0695-0216-0000-c269be8b7592"],"description":"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."},"limit":{"type":"integer","title":"Limit","maximum":1000,"minimum":1,"examples":[10,100],"description":"Maximum number of returned pages. Default is 100, maximum is 1000."},"offset":{"type":"integer","title":"Offset","minimum":0,"examples":[0,10],"description":"Offset in the results array of returned pages. Default is 0."},"filters":{"type":"array","items":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"}],"properties":{}},"title":"Filters","examples":[[["reason","=","robots_txt"]],[["reason","=","meta_tag"],"and",["url","like","%blog%"]]],"description":"Array of results filtering parameters. Supports operators: regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like. Maximum 8 filters. Example: [['reason', '=', 'robots_txt'], 'and', ['url', 'like', '%go%']]"}},"description":"Individual request item for retrieving non-indexable pages.","requiredFields":"$17:props:tools:118:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier from the request"},"limit":{"type":"integer","title":"Limit","description":"Limit value from the request"},"offset":{"type":"integer","title":"Offset","description":"Offset value from the request"},"filters":{"type":"array","items":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"}],"properties":{}},"title":"Filters","description":"Filters array from the request"}},"description":"Echo of the original request parameters sent in the task request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"NonIndexableResult","properties":{"items":{"type":"array","items":{"type":"object","title":"NonIndexableItem","properties":{"url":{"type":"string","title":"Url","description":"URL of the non-indexable page"},"reason":{"type":"string","title":"Reason","description":"Reason why the page is non-indexable. Possible values: robots_txt, meta_tag, http_header, attribute, too_many_redirects"}},"description":"Individual non-indexable page item."},"title":"Items","description":"List of non-indexable pages with reason and URL"},"items_count":{"type":"integer","title":"Items Count","description":"Number of non-indexable pages returned in this response"},"crawl_status":{"type":"object","title":"CrawlStatus","properties":{"pages_crawled":{"type":"integer","title":"Pages Crawled","description":"Number of pages successfully crawled"},"pages_in_queue":{"type":"integer","title":"Pages In Queue","description":"Number of pages awaiting crawl"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum number of pages set for crawling"}},"description":"Crawl status information including queue and progress metrics.","additionalProperties":false},"crawl_progress":{"type":"string","title":"Crawl Progress","description":"Progress of the crawl operation (e.g., 'finished', 'in_progress')"},"total_items_count":{"type":"integer","title":"Total Items Count","description":"Total number of non-indexable pages in the database for this task"}},"description":"Result containing non-indexable pages data."},"title":"Result","description":"List of results containing non-indexable pages data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with non-indexable pages results."},"title":"Tasks","description":"Array of task objects containing non-indexable pages results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_PAGES","name":"Get On Page Pages","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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","default":"$undefined","example":"$undefined","enum":"$undefined","required":true},"tag":{"type":"string","description":"User-defined identifier for task tracking. Maximum 255 characters. This tag is returned in the response to help match requests with results","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"limit":{"type":"integer","description":"Maximum number of pages to return in the results. Defaults to 100 if not specified. Maximum allowed value is 1000","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"offset":{"type":"integer","description":"Offset for results pagination. Use this to skip the first N results. Defaults to 0","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"filters":{"type":"array","description":"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]]","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}},{"type":"string"}],"properties":{}}},"order_by":{"type":"array","description":"Array of sorting rules. Maximum 3 rules allowed. Format: ['field,asc'] or ['field,desc']. Example: ['meta.content.plain_text_word_count,desc']","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"search_after_token":{"type":"string","description":"Pagination token for fetching results beyond 20,000. Use the token returned from previous response to get the next batch of results","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution time for the request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier used in the request"},"tag":{"type":"string","title":"Tag","description":"User-defined tag from the request"},"limit":{"type":"integer","title":"Limit","description":"Result limit used in the request"},"offset":{"type":"integer","title":"Offset","description":"Result offset used in the request"},"filters":{"type":"array","items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}},{"type":"string"}],"properties":{}},"title":"Filters","description":"Filters used in the request"},"order_by":{"type":"array","items":{"type":"string","properties":{}},"title":"Order By","description":"Sorting rules used in the request"},"search_after_token":{"type":"string","title":"Search After Token","description":"Pagination token used in the request"}},"description":"Echo of the original request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components for the request"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"OnPagePagesResult","properties":{"url":{"type":"string","title":"Url","description":"Page URL"},"meta":{"type":"object","title":"MetaObject","properties":{"title":{"type":"string","title":"Title","description":"Page title from title tag"},"charset":{"type":"integer","title":"Charset","description":"Character encoding of the page"},"content":{"type":"object","title":"Content","description":"Content metrics including plain_text_size, plain_text_word_count, and readability scores","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"null"}]}},"favicon":{"type":"string","title":"Favicon","description":"Favicon URL"},"canonical":{"type":"string","title":"Canonical","description":"Canonical URL from link rel=canonical"},"description":{"type":"string","title":"Description","description":"Meta description content"},"images_size":{"type":"integer","title":"Images Size","description":"Total size of all images in bytes"},"images_count":{"type":"integer","title":"Images Count","description":"Number of images on the page"},"scripts_size":{"type":"integer","title":"Scripts Size","description":"Total size of all scripts in bytes"},"title_length":{"type":"integer","title":"Title Length","description":"Character length of the page title"},"meta_keywords":{"type":"string","title":"Meta Keywords","description":"Meta keywords content"},"scripts_count":{"type":"integer","title":"Scripts Count","description":"Number of script tags on the page"},"stylesheets_size":{"type":"integer","title":"Stylesheets Size","description":"Total size of all stylesheets in bytes"},"stylesheets_count":{"type":"integer","title":"Stylesheets Count","description":"Number of stylesheet links on the page"},"description_length":{"type":"integer","title":"Description Length","description":"Character length of the meta description"},"inbound_links_count":{"type":"integer","title":"Inbound Links Count","description":"Number of inbound links to this page"},"external_links_count":{"type":"integer","title":"External Links Count","description":"Number of external links on the page"},"internal_links_count":{"type":"integer","title":"Internal Links Count","description":"Number of internal links on the page"},"meta_refresh_redirect":{"type":"string","title":"Meta Refresh Redirect","description":"Meta refresh redirect URL if present"},"cumulative_layout_shift":{"type":"number","title":"Cumulative Layout Shift","description":"Cumulative Layout Shift (CLS) metric for visual stability"},"render_blocking_scripts_count":{"type":"integer","title":"Render Blocking Scripts Count","description":"Number of render-blocking script resources"},"render_blocking_stylesheets_count":{"type":"integer","title":"Render Blocking Stylesheets Count","description":"Number of render-blocking stylesheet resources"}},"description":"Meta information about the page including title, description, links, and resource counts.","additionalProperties":false},"size":{"type":"integer","title":"Size","description":"Page size in bytes"},"spell":{"type":"object","title":"Spell","description":"Hunspell spellcheck results with misspelled words","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"array","items":{"type":"string"}}]}},"checks":{"type":"object","title":"ChecksObject","properties":{"flash":{"type":"boolean","title":"Flash","description":"Whether the page contains Flash content"},"frame":{"type":"boolean","title":"Frame","description":"Whether the page contains frame or iframe elements"},"is_www":{"type":"boolean","title":"Is Www","description":"Whether the URL includes www subdomain"},"is_http":{"type":"boolean","title":"Is Http","description":"Whether the page uses HTTP protocol"},"is_https":{"type":"boolean","title":"Is Https","description":"Whether the page uses HTTPS protocol"},"no_title":{"type":"boolean","title":"No Title","description":"Whether the page is missing title tag"},"canonical":{"type":"boolean","title":"Canonical","description":"Whether the page has a canonical tag"},"is_broken":{"type":"boolean","title":"Is Broken","description":"Whether the page is broken (status < 200 or >= 400)"},"no_h1_tag":{"type":"boolean","title":"No H1 Tag","description":"Whether the page is missing H1 tag"},"no_doctype":{"type":"boolean","title":"No Doctype","description":"Whether the page is missing DOCTYPE declaration"},"no_favicon":{"type":"boolean","title":"No Favicon","description":"Whether the page is missing favicon"},"is_4xx_code":{"type":"boolean","title":"Is 4Xx Code","description":"Whether the page returns a 4xx status code"},"is_5xx_code":{"type":"boolean","title":"Is 5Xx Code","description":"Whether the page returns a 5xx status code"},"is_redirect":{"type":"boolean","title":"Is Redirect","description":"Whether the page returns a redirect status code"},"lorem_ipsum":{"type":"boolean","title":"Lorem Ipsum","description":"Whether the page contains lorem ipsum placeholder text"},"no_image_alt":{"type":"boolean","title":"No Image Alt","description":"Whether images on the page are missing alt attributes"},"is_orphan_page":{"type":"boolean","title":"Is Orphan Page","description":"Whether the page is unreachable via internal links"},"no_description":{"type":"boolean","title":"No Description","description":"Whether the page is missing meta description"},"no_image_title":{"type":"boolean","title":"No Image Title","description":"Whether images on the page are missing title attributes"},"redirect_chain":{"type":"boolean","title":"Redirect Chain","description":"Whether the page has multiple redirects"},"canonical_chain":{"type":"boolean","title":"Canonical Chain","description":"Whether canonical points to another canonicalized page"},"duplicate_title":{"type":"boolean","title":"Duplicate Title","description":"Whether the page has a duplicate title"},"has_micromarkup":{"type":"boolean","title":"Has Micromarkup","description":"Whether the page has structured data markup"},"has_misspelling":{"type":"boolean","title":"Has Misspelling","description":"Whether the page contains spelling mistakes"},"irrelevant_title":{"type":"boolean","title":"Irrelevant Title","description":"Whether title relevance threshold is below 0.3"},"low_content_rate":{"type":"boolean","title":"Low Content Rate","description":"Whether the page has a low plaintext-to-size ratio"},"seo_friendly_url":{"type":"boolean","title":"Seo Friendly Url","description":"Whether the URL is SEO-friendly"},"duplicate_content":{"type":"boolean","title":"Duplicate Content","description":"Whether the page has duplicate content"},"high_content_rate":{"type":"boolean","title":"High Content Rate","description":"Whether content rate exceeds 0.9"},"high_loading_time":{"type":"boolean","title":"High Loading Time","description":"Whether page load time exceeds 3 seconds"},"high_waiting_time":{"type":"boolean","title":"High Waiting Time","description":"Whether TTFB exceeds 1.5 seconds"},"canonical_to_broken":{"type":"boolean","title":"Canonical To Broken","description":"Whether canonical points to a broken page"},"https_to_http_links":{"type":"boolean","title":"Https To Http Links","description":"Whether HTTPS page has mixed security links"},"low_character_count":{"type":"boolean","title":"Low Character Count","description":"Whether the page has less than 1024 characters"},"no_content_encoding":{"type":"boolean","title":"No Content Encoding","description":"Whether the page is missing compression"},"recursive_canonical":{"type":"boolean","title":"Recursive Canonical","description":"Whether there is a canonical loop"},"high_character_count":{"type":"boolean","title":"High Character Count","description":"Whether the page has over 256,000 characters"},"low_readability_rate":{"type":"boolean","title":"Low Readability Rate","description":"Whether Flesch-Kincaid readability score is under 15"},"canonical_to_redirect":{"type":"boolean","title":"Canonical To Redirect","description":"Whether canonical points to a redirect"},"duplicate_description":{"type":"boolean","title":"Duplicate Description","description":"Whether the page has a duplicate meta description"},"has_links_to_redirects":{"type":"boolean","title":"Has Links To Redirects","description":"Whether the page has links pointing to redirects"},"irrelevant_description":{"type":"boolean","title":"Irrelevant Description","description":"Whether description relevance is below 0.2"},"irrelevant_meta_keywords":{"type":"boolean","title":"Irrelevant Meta Keywords","description":"Whether meta keywords relevance is below 0.6"},"has_meta_refresh_redirect":{"type":"boolean","title":"Has Meta Refresh Redirect","description":"Whether the page has a meta refresh redirect"},"is_link_relation_conflict":{"type":"boolean","title":"Is Link Relation Conflict","description":"Whether the page has conflicting link relations"},"has_render_blocking_resources":{"type":"boolean","title":"Has Render Blocking Resources","description":"Whether the page has render-blocking assets"}},"description":"Boolean flags indicating various page conditions and SEO checks.","additionalProperties":false},"server":{"type":"string","title":"Server","description":"Web server software and version"},"location":{"type":"string","title":"Location","description":"Redirect location URL if the page returned a redirect status"},"fetch_time":{"type":"string","title":"Fetch Time","description":"UTC timestamp when the page was fetched during crawl"},"media_type":{"type":"string","title":"Media Type","description":"Media type of the page content (e.g., text/html)"},"url_length":{"type":"integer","title":"Url Length","description":"Total character length of the URL"},"click_depth":{"type":"integer","title":"Click Depth","description":"Number of clicks needed from homepage to reach this page"},"is_resource":{"type":"boolean","title":"Is Resource","description":"Whether this is a single resource"},"page_timing":{"type":"object","title":"PageTimingObject","properties":{"fetch_end":{"type":"integer","title":"Fetch End","description":"Fetch end timestamp in milliseconds"},"fetch_start":{"type":"integer","title":"Fetch Start","description":"Fetch start timestamp in milliseconds"},"dom_complete":{"type":"integer","title":"Dom Complete","description":"Time when DOM and all resources are loaded in milliseconds"},"waiting_time":{"type":"integer","title":"Waiting Time","description":"Time waiting for server response (TTFB) in milliseconds"},"download_time":{"type":"integer","title":"Download Time","description":"Time to download response in milliseconds"},"duration_time":{"type":"integer","title":"Duration Time","description":"Total duration from start to finish in milliseconds"},"connection_time":{"type":"integer","title":"Connection Time","description":"Time to establish connection in milliseconds"},"first_input_delay":{"type":"integer","title":"First Input Delay","description":"First Input Delay (FID) responsiveness metric in milliseconds"},"request_sent_time":{"type":"integer","title":"Request Sent Time","description":"Time when request was sent in milliseconds"},"time_to_interactive":{"type":"integer","title":"Time To Interactive","description":"Time to Interactive (TTI) in milliseconds"},"largest_contentful_paint":{"type":"integer","title":"Largest Contentful Paint","description":"Largest Contentful Paint (LCP) metric in milliseconds"},"time_to_secure_connection":{"type":"integer","title":"Time To Secure Connection","description":"Time to establish secure connection (TLS) in milliseconds"}},"description":"Page timing and performance metrics.","additionalProperties":false},"status_code":{"type":"integer","title":"Status Code","description":"HTTP status code returned when fetching the page"},"broken_links":{"type":"boolean","title":"Broken Links","description":"Whether the page has broken links"},"encoded_size":{"type":"integer","title":"Encoded Size","description":"Encoded (compressed) page size in bytes"},"onpage_score":{"type":"number","title":"Onpage Score","description":"Overall on-page SEO optimization score from 0 to 100"},"cache_control":{"type":"object","title":"CacheControl","properties":{"ttl":{"type":"integer","title":"Ttl","description":"Time to live in seconds for cache"},"cachable":{"type":"boolean","title":"Cachable","description":"Whether the resource can be cached"}},"description":"Cache control information.","additionalProperties":false},"last_modified":{"type":"object","title":"LastModified","properties":{"header":{"type":"string","title":"Header","description":"Last-Modified header timestamp"},"sitemap":{"type":"string","title":"Sitemap","description":"Sitemap modification timestamp"},"meta_tag":{"type":"string","title":"Meta Tag","description":"Meta tag modification timestamp"}},"description":"Last modification timestamps from various sources.","additionalProperties":false},"resource_type":{"type":"string","title":"Resource Type","description":"Type of resource: 'html' for HTML pages or 'broken' for broken pages"},"total_dom_size":{"type":"integer","title":"Total Dom Size","description":"Total number of DOM elements on the page"},"deprecated_tags":{"type":"array","items":{"type":"string","properties":{}},"title":"Deprecated Tags","description":"Array of deprecated HTML tags found on the page"},"resource_errors":{"type":"object","title":"ResourceError","properties":{"errors":{"type":"object","title":"Errors","description":"HTML/CSS/JavaScript parsing errors","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"array","items":{"type":"string"}}]}},"warnings":{"type":"object","title":"Warnings","description":"DOM warnings and issues","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"array","items":{"type":"string"}}]}}},"description":"Resource parsing errors and warnings.","additionalProperties":false},"broken_resources":{"type":"boolean","title":"Broken Resources","description":"Whether the page has broken resources"},"content_encoding":{"type":"string","title":"Content Encoding","description":"Content encoding type (e.g., gzip, deflate)"},"social_media_tags":{"type":"object","title":"SocialMediaTags","properties":{"og_url":{"type":"string","title":"Og Url","description":"Open Graph URL"},"og_image":{"type":"string","title":"Og Image","description":"Open Graph image URL"},"og_title":{"type":"string","title":"Og Title","description":"Open Graph title"},"twitter_card":{"type":"string","title":"Twitter Card","description":"Twitter card type"},"twitter_image":{"type":"string","title":"Twitter Image","description":"Twitter card image URL"},"twitter_title":{"type":"string","title":"Twitter Title","description":"Twitter card title"},"og_description":{"type":"string","title":"Og Description","description":"Open Graph description"},"twitter_description":{"type":"string","title":"Twitter Description","description":"Twitter card description"}},"description":"Social media meta tags (Open Graph, Twitter Card).","additionalProperties":false},"custom_js_response":{"type":"object","title":"Custom Js Response","description":"Custom JavaScript execution results","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"null"}]}},"duplicate_meta_tags":{"type":"array","items":{"type":"string","properties":{}},"title":"Duplicate Meta Tags","description":"Array of duplicate meta tags found on the page"},"relative_url_length":{"type":"integer","title":"Relative Url Length","description":"Length of the relative URL path"},"total_transfer_size":{"type":"integer","title":"Total Transfer Size","description":"Total transfer size including headers in bytes"},"custom_js_client_exception":{"type":"string","title":"Custom Js Client Exception","description":"JavaScript execution errors if any"}},"description":"Individual page result with metrics and optimization data."},"title":"Result","description":"Array of page results with metrics and optimization data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code indicating success or failure (20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the task status"}},"description":"Individual task information with on-page pages results."},"title":"Tasks","description":"Array of tasks containing on-page pages results with metrics and optimization data"},"version":{"type":"string","title":"Version","description":"Current version of the DataForSEO API"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the response status"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_PAGES_BY_RESOURCE","name":"Get On Page Pages By Resource","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to retrieve pages by resource. Each task requires an id and url.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"GetOnPagePagesByResourceRequestItem","required":["id","url"],"properties":{"id":{"type":"string","title":"Id","examples":["00000000-0000-0000-0000-000000000000"],"description":"Task identifier in UUID format obtained from Task POST endpoint. The task must be completed before using this endpoint."},"tag":{"type":"string","title":"Tag","examples":["project_123","audit_2024"],"maxLength":255,"description":"User-defined identifier for task tracking. Maximum 255 characters. Useful for organizing and identifying tasks in your system."},"url":{"type":"string","title":"Url","examples":["https://example.com/resource.js","https://example.com/styles.css"],"description":"Resource URL obtained from the Resources endpoint. Must be a valid URL of a resource (e.g., JavaScript file, CSS file, image) to find pages that use it."},"limit":{"type":"integer","title":"Limit","maximum":1000,"minimum":1,"examples":[100,500],"description":"Maximum number of pages to return. Default is 100, maximum allowed is 1000."},"offset":{"type":"integer","title":"Offset","minimum":0,"examples":[0,100],"description":"Pagination offset for results. Default is 0. Use this to retrieve additional pages beyond the limit."},"filters":{"type":"array","items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}},{"type":"string"}],"properties":{}},"title":"Filters","examples":[[["status_code","=",200]],[["onpage_score",">",80],"and",["status_code","=",200]]],"maxItems":8,"description":"Array of filtering conditions to narrow results. Maximum 8 filters allowed. Each filter is an array with three elements: [field_name, operator, value]. Multiple filters must be joined with logical operators 'and' or 'or'."},"order_by":{"type":"array","items":{"type":"string","properties":{}},"title":"Order By","examples":[["onpage_score,desc"],["url,asc","status_code,desc"]],"maxItems":3,"description":"Array of sorting rules for results. Maximum 3 rules allowed. Format: 'field_name,direction' where direction is 'asc' or 'desc'."}},"description":"Individual task item for retrieving pages that use a specific resource.","requiredFields":"$17:props:tools:120:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Task ID from request"},"api":{"type":"string","title":"Api","description":"API endpoint type"},"tag":{"type":"string","title":"Tag","description":"Tag from request"},"url":{"type":"string","title":"Url","description":"Resource URL from request"},"limit":{"type":"integer","title":"Limit","description":"Limit from request"},"offset":{"type":"integer","title":"Offset","description":"Offset from request"},"filters":{"type":"array","items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}},{"type":"string"}],"properties":{}},"title":"Filters","description":"Filters from request"},"function":{"type":"string","title":"Function","description":"API function called"},"order_by":{"type":"array","items":{"type":"string","properties":{}},"title":"Order By","description":"Order by rules from request"}},"description":"Original request parameters echoed back in the response.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path components for this task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"ResultItem","properties":{"url":{"type":"string","title":"Url","description":"Page URL"},"meta":{"type":"object","title":"Meta","properties":{"htags":{"type":"object","title":"Htags","description":"Heading tags organized by level (h1, h2, h3, etc.)","additionalProperties":{"type":"array","items":{"type":"string"}}},"title":{"type":"string","title":"Title","description":"Page title from tag"},"follow":{"type":"boolean","title":"Follow","description":"Whether page allows following links (true if follow, false if nofollow)"},"charset":{"type":"integer","title":"Charset","description":"Character encoding from meta charset"},"favicon":{"type":"string","title":"Favicon","description":"Favicon URL"},"canonical":{"type":"string","title":"Canonical","description":"Canonical URL from link rel=canonical tag"},"generator":{"type":"string","title":"Generator","description":"Content management system or generator from meta generator tag"},"description":{"type":"string","title":"Description","description":"Meta description content"},"images_size":{"type":"integer","title":"Images Size","description":"Total size of all images in bytes"},"images_count":{"type":"integer","title":"Images Count","description":"Number of images on the page"},"scripts_size":{"type":"integer","title":"Scripts Size","description":"Total size of all scripts in bytes"},"meta_keywords":{"type":"string","title":"Meta Keywords","description":"Meta keywords content"},"scripts_count":{"type":"integer","title":"Scripts Count","description":"Number of script tags on the page"},"stylesheets_size":{"type":"integer","title":"Stylesheets Size","description":"Total size of all stylesheets in bytes"},"stylesheets_count":{"type":"integer","title":"Stylesheets Count","description":"Number of stylesheet references"},"external_links_count":{"type":"integer","title":"External Links Count","description":"Number of external links on the page"},"internal_links_count":{"type":"integer","title":"Internal Links Count","description":"Number of internal links on the page"}},"description":"Page metadata information including title, description, and SEO properties.","additionalProperties":false},"size":{"type":"integer","title":"Size","description":"Uncompressed resource size in bytes"},"checks":{"type":"object","title":"Checks","properties":{"flash":{"type":"boolean","title":"Flash","description":"True if page contains Flash content"},"frame":{"type":"boolean","title":"Frame","description":"True if page contains frames or iframes"},"is_www":{"type":"boolean","title":"Is Www","description":"True if URL includes www subdomain"},"is_http":{"type":"boolean","title":"Is Http","description":"True if URL uses HTTP protocol"},"is_https":{"type":"boolean","title":"Is Https","description":"True if URL uses HTTPS protocol"},"canonical":{"type":"boolean","title":"Canonical","description":"True if page has canonical tag"},"is_broken":{"type":"boolean","title":"Is Broken","description":"True if page returns 4xx or 5xx status code"},"no_h1_tag":{"type":"boolean","title":"No H1 Tag","description":"True if page has no H1 heading tag"},"no_doctype":{"type":"boolean","title":"No Doctype","description":"True if HTML lacks DOCTYPE declaration"},"no_favicon":{"type":"boolean","title":"No Favicon","description":"True if page lacks favicon"},"is_redirect":{"type":"boolean","title":"Is Redirect","description":"True if page returns a redirect status code"},"broken_links":{"type":"boolean","title":"Broken Links","description":"True if page contains broken hyperlinks"},"has_misspelling":{"type":"boolean","title":"Has Misspelling","description":"True if page content contains spelling errors"},"large_page_size":{"type":"boolean","title":"Large Page Size","description":"True if page size exceeds recommended limit"},"broken_resources":{"type":"boolean","title":"Broken Resources","description":"True if page has broken resource links (images, scripts, styles)"},"seo_friendly_url":{"type":"boolean","title":"Seo Friendly Url","description":"True if URL is SEO-friendly (readable, descriptive)"},"high_loading_time":{"type":"boolean","title":"High Loading Time","description":"True if page loading time exceeds optimal threshold"},"high_waiting_time":{"type":"boolean","title":"High Waiting Time","description":"True if server response time (TTFB) is high"},"https_to_http_links":{"type":"boolean","title":"Https To Http Links","description":"True if HTTPS page contains HTTP links"},"no_content_encoding":{"type":"boolean","title":"No Content Encoding","description":"True if page lacks content encoding (gzip/compress)"},"no_encoding_meta_tag":{"type":"boolean","title":"No Encoding Meta Tag","description":"True if page lacks charset meta tag"}},"description":"On-page SEO audit checks with boolean indicators for various optimization factors.","additionalProperties":false},"content":{"type":"object","title":"Content","properties":{"plain_text_rate":{"type":"number","title":"Plain Text Rate","description":"Ratio of plain text to total HTML size"},"plain_text_size":{"type":"integer","title":"Plain Text Size","description":"Size of plain text content in characters"},"plain_text_word_count":{"type":"integer","title":"Plain Text Word Count","description":"Number of words in plain text content"},"smog_readability_index":{"type":"number","title":"Smog Readability Index","description":"SMOG readability index score"},"automated_readability_index":{"type":"number","title":"Automated Readability Index","description":"Automated Readability Index score"},"dale_chall_readability_index":{"type":"number","title":"Dale Chall Readability Index","description":"Dale-Chall readability score"},"title_to_content_consistency":{"type":"number","title":"Title To Content Consistency","description":"Consistency score between title and page content (0-1)"},"coleman_liau_readability_index":{"type":"number","title":"Coleman Liau Readability Index","description":"Coleman-Liau readability index score"},"flesch_kincaid_readability_index":{"type":"number","title":"Flesch Kincaid Readability Index","description":"Flesch-Kincaid readability score"},"description_to_content_consistency":{"type":"number","title":"Description To Content Consistency","description":"Consistency score between meta description and page content (0-1)"}},"description":"Content analysis metrics including readability and consistency.","additionalProperties":false},"location":{"type":"string","title":"Location","description":"Redirect location if applicable"},"page_timing":{"type":"object","title":"PageTiming","properties":{"speed_index":{"type":"integer","title":"Speed Index","description":"Speed Index metric in milliseconds"},"dom_complete":{"type":"integer","title":"Dom Complete","description":"DOM Complete time in milliseconds"},"download_time":{"type":"integer","title":"Download Time","description":"Total download time in milliseconds"},"first_input_delay":{"type":"integer","title":"First Input Delay","description":"First Input Delay (FID) in milliseconds - Core Web Vital"},"time_to_interactive":{"type":"integer","title":"Time To Interactive","description":"Time to Interactive (TTI) in milliseconds"},"first_contentful_paint":{"type":"integer","title":"First Contentful Paint","description":"First Contentful Paint (FCP) in milliseconds"},"cumulative_layout_shift":{"type":"number","title":"Cumulative Layout Shift","description":"Cumulative Layout Shift (CLS) score - Core Web Vital"},"largest_contentful_paint":{"type":"integer","title":"Largest Contentful Paint","description":"Largest Contentful Paint (LCP) in milliseconds - Core Web Vital"},"time_to_secure_connection":{"type":"integer","title":"Time To Secure Connection","description":"Time to establish secure connection in milliseconds"}},"description":"Page load timing metrics and Core Web Vitals.","additionalProperties":false},"status_code":{"type":"integer","title":"Status Code","description":"HTTP response status code"},"encoded_size":{"type":"integer","title":"Encoded Size","description":"Compressed resource size in bytes"},"onpage_score":{"type":"number","title":"Onpage Score","description":"On-page optimization score from 0 to 100"},"cache_control":{"type":"object","title":"CacheControl","properties":{"ttl":{"type":"integer","title":"Ttl","description":"Time to live in seconds for cached resource"},"cachable":{"type":"boolean","title":"Cachable","description":"Whether the resource is cacheable"}},"description":"Cache control directives and settings.","additionalProperties":false},"resource_type":{"type":"string","title":"Resource Type","description":"Type of resource (e.g., 'html')"},"total_dom_size":{"type":"integer","title":"Total Dom Size","description":"Total DOM size in bytes"},"duplicate_title":{"type":"boolean","title":"Duplicate Title","description":"True if page title is duplicated across multiple pages"},"duplicate_content":{"type":"boolean","title":"Duplicate Content","description":"True if page content is duplicated"},"total_transfer_size":{"type":"integer","title":"Total Transfer Size","description":"Total transfer size including headers in bytes"},"duplicate_description":{"type":"boolean","title":"Duplicate Description","description":"True if meta description is duplicated across multiple pages"}},"description":"Individual page result containing crawl data and on-page metrics."},"title":"Result","description":"Array of page results with crawl data and metrics"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success, 40000+ indicates error."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects containing pages that use the specified resource"},"version":{"type":"string","title":"Version","description":"DataForSEO API version"},"status_code":{"type":"integer","title":"Status Code","description":"Overall response status code. 20000 indicates success, codes 40000+ indicate errors."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Total number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that resulted in errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_ON_PAGE_SUMMARY_BY_ID","name":"Get On Page Summary","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"tag":{"type":"string","title":"Tag","description":"Custom tag associated with the task"},"target":{"type":"string","title":"Target","description":"Target website URL that was crawled"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum number of pages set for crawling"}},"description":"Echo of the original request parameters sent in the task creation request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"OnPageSummaryResult","properties":{"domain_info":{"type":"object","title":"DomainInfo","properties":{"ip":{"type":"string","title":"Ip","description":"Domain IP address"},"cms":{"type":"string","title":"Cms","description":"Identified CMS platform"},"name":{"type":"string","title":"Name","description":"Domain name"},"checks":{"type":"object","title":"DomainChecks","properties":{"ssl":{"type":"boolean","title":"Ssl","description":"Whether SSL certificate is present"},"http2":{"type":"boolean","title":"Http2","description":"Whether HTTP/2 protocol is supported"},"sitemap":{"type":"boolean","title":"Sitemap","description":"Whether sitemap is detected on the domain"},"robots_txt":{"type":"boolean","title":"Robots Txt","description":"Whether robots.txt file is present"},"test_www_redirect":{"type":"boolean","title":"Test Www Redirect","description":"Whether www redirect is implemented"},"test_https_redirect":{"type":"boolean","title":"Test Https Redirect","description":"Whether HTTP redirects to HTTPS"},"test_page_not_found":{"type":"boolean","title":"Test Page Not Found","description":"Whether 404 responses work correctly"},"start_page_deny_flag":{"type":"boolean","title":"Start Page Deny Flag","description":"Whether start page returns 403 forbidden status"},"test_canonicalization":{"type":"boolean","title":"Test Canonicalization","description":"Result of canonicalization test"},"test_directory_browsing":{"type":"boolean","title":"Test Directory Browsing","description":"Whether directory browsing is blocked"},"test_hidden_server_signature":{"type":"boolean","title":"Test Hidden Server Signature","description":"Whether server signature is hidden"}},"description":"Domain-level checks for common SEO and technical requirements.","additionalProperties":false},"server":{"type":"string","title":"Server","description":"Server version and type"},"ssl_info":{"type":"object","title":"SslInfo","properties":{"certificate_hash":{"type":"string","title":"Certificate Hash","description":"Hash algorithm version used"},"valid_certificate":{"type":"boolean","title":"Valid Certificate","description":"Whether the SSL certificate is valid"},"certificate_issuer":{"type":"string","title":"Certificate Issuer","description":"Certificate issuing authority"},"certificate_subject":{"type":"string","title":"Certificate Subject","description":"Certificate subject entity"},"certificate_version":{"type":"string","title":"Certificate Version","description":"X.509 certificate version"},"certificate_expiration_date":{"type":"string","title":"Certificate Expiration Date","description":"Certificate expiration timestamp in UTC format"}},"description":"SSL certificate information for the domain.","additionalProperties":false},"crawl_end":{"type":"string","title":"Crawl End","description":"Crawl completion timestamp in UTC format"},"crawl_start":{"type":"string","title":"Crawl Start","description":"Crawl initiation timestamp in UTC format"},"main_domain":{"type":"string","title":"Main Domain","description":"Root domain name"},"total_pages":{"type":"integer","title":"Total Pages","description":"Total number of pages crawled"},"extended_crawl_status":{"type":"string","title":"Extended Crawl Status","description":"Detailed crawl status or error information"},"www_redirect_status_code":{"type":"integer","title":"Www Redirect Status Code","description":"Status code for www redirect response"},"page_not_found_status_code":{"type":"integer","title":"Page Not Found Status Code","description":"HTTP status code for 404 pages"},"canonicalization_status_code":{"type":"integer","title":"Canonicalization Status Code","description":"Status code for canonical redirect"},"directory_browsing_status_code":{"type":"integer","title":"Directory Browsing Status Code","description":"Status code for directory browsing response"}},"description":"Domain-wide information and configuration.","additionalProperties":false},"crawl_status":{"type":"object","title":"CrawlStatus","properties":{"pages_crawled":{"type":"integer","title":"Pages Crawled","description":"Number of pages successfully crawled"},"pages_in_queue":{"type":"integer","title":"Pages In Queue","description":"Number of pages awaiting crawl"},"max_crawl_pages":{"type":"integer","title":"Max Crawl Pages","description":"Maximum number of pages set for crawling"}},"description":"Crawl status information including queue and progress metrics.","additionalProperties":false},"page_metrics":{"type":"object","title":"PageMetrics","properties":{"checks":{"type":"object","title":"PageChecks","properties":{"frame":{"type":"integer","title":"Frame","description":"Pages with frame or iframe elements"},"is_www":{"type":"integer","title":"Is Www","description":"Pages on www subdomain"},"is_http":{"type":"integer","title":"Is Http","description":"Pages using HTTP protocol"},"is_https":{"type":"integer","title":"Is Https","description":"Pages using HTTPS protocol"},"no_title":{"type":"integer","title":"No Title","description":"Pages missing title tags"},"canonical":{"type":"integer","title":"Canonical","description":"Number of canonical pages"},"is_broken":{"type":"integer","title":"Is Broken","description":"Pages with status codes below 200 or above 400"},"no_h1_tag":{"type":"integer","title":"No H1 Tag","description":"Pages missing H1 tags"},"no_doctype":{"type":"integer","title":"No Doctype","description":"Pages missing DOCTYPE declaration"},"no_favicon":{"type":"integer","title":"No Favicon","description":"Pages where favicon is not detected"},"is_4xx_code":{"type":"integer","title":"Is 4Xx Code","description":"Pages with 4xx response codes"},"is_5xx_code":{"type":"integer","title":"Is 5Xx Code","description":"Pages with 5xx response codes"},"is_redirect":{"type":"integer","title":"Is Redirect","description":"Pages with 3XX redirect status codes"},"lorem_ipsum":{"type":"integer","title":"Lorem Ipsum","description":"Pages with lorem ipsum placeholder text detected"},"no_image_alt":{"type":"integer","title":"No Image Alt","description":"Pages with images missing alt attributes"},"is_orphan_page":{"type":"integer","title":"Is Orphan Page","description":"Pages unreachable via internal links"},"no_description":{"type":"integer","title":"No Description","description":"Pages missing meta description tags"},"no_image_title":{"type":"integer","title":"No Image Title","description":"Pages with images missing title attributes"},"redirect_chain":{"type":"integer","title":"Redirect Chain","description":"Pages with multiple redirect chains"},"title_too_long":{"type":"integer","title":"Title Too Long","description":"Pages with titles exceeding 65 characters"},"canonical_chain":{"type":"integer","title":"Canonical Chain","description":"Pages with canonical pointing to canonicalized page"},"has_misspelling":{"type":"integer","title":"Has Misspelling","description":"Pages with spelling mistakes found"},"large_page_size":{"type":"integer","title":"Large Page Size","description":"Pages exceeding 1 MB in size"},"small_page_size":{"type":"integer","title":"Small Page Size","description":"Pages under 1024 bytes in size"},"title_too_short":{"type":"integer","title":"Title Too Short","description":"Pages with titles under 30 characters"},"has_html_doctype":{"type":"integer","title":"Has Html Doctype","description":"Pages with valid DOCTYPE present"},"irrelevant_title":{"type":"integer","title":"Irrelevant Title","description":"Pages with title relevance threshold below 0.3"},"low_content_rate":{"type":"integer","title":"Low Content Rate","description":"Pages with low plaintext-to-size ratio"},"seo_friendly_url":{"type":"integer","title":"Seo Friendly Url","description":"Pages with SEO-compliant URLs"},"high_content_rate":{"type":"integer","title":"High Content Rate","description":"Pages with content rate exceeding 0.9"},"high_loading_time":{"type":"integer","title":"High Loading Time","description":"Pages with load time exceeding 3 seconds"},"high_waiting_time":{"type":"integer","title":"High Waiting Time","description":"Pages with TTFB exceeding 1.5 seconds"},"canonical_to_broken":{"type":"integer","title":"Canonical To Broken","description":"Pages with canonical pointing to 404s"},"duplicate_meta_tags":{"type":"integer","title":"Duplicate Meta Tags","description":"Pages with duplicate meta tags"},"https_to_http_links":{"type":"integer","title":"Https To Http Links","description":"HTTPS pages with mixed security links"},"low_character_count":{"type":"integer","title":"Low Character Count","description":"Pages with less than 1024 characters"},"no_content_encoding":{"type":"integer","title":"No Content Encoding","description":"Pages missing compression"},"recursive_canonical":{"type":"integer","title":"Recursive Canonical","description":"Pages with canonical loop detection"},"deprecated_html_tags":{"type":"integer","title":"Deprecated Html Tags","description":"Pages with deprecated HTML elements"},"high_character_count":{"type":"integer","title":"High Character Count","description":"Pages with over 256,000 characters"},"low_readability_rate":{"type":"integer","title":"Low Readability Rate","description":"Pages with Flesch-Kincaid score under 15"},"no_encoding_meta_tag":{"type":"integer","title":"No Encoding Meta Tag","description":"Pages missing charset encoding meta tag"},"canonical_to_redirect":{"type":"integer","title":"Canonical To Redirect","description":"Pages with canonical pointing to redirects"},"size_greater_than_3mb":{"type":"integer","title":"Size Greater Than 3Mb","description":"Pages over 3 MB in size"},"has_links_to_redirects":{"type":"integer","title":"Has Links To Redirects","description":"Pages linking to redirect URLs"},"irrelevant_description":{"type":"integer","title":"Irrelevant Description","description":"Pages with description relevance below 0.2"},"irrelevant_meta_keywords":{"type":"integer","title":"Irrelevant Meta Keywords","description":"Pages with meta keywords relevance below 0.6"},"meta_charset_consistency":{"type":"integer","title":"Meta Charset Consistency","description":"Pages with charset encoding mismatches"},"has_render_blocking_resources":{"type":"integer","title":"Has Render Blocking Resources","description":"Pages with render-blocking assets"},"seo_friendly_url_dynamic_check":{"type":"integer","title":"Seo Friendly Url Dynamic Check","description":"Pages with no dynamic parameters in URL"},"seo_friendly_url_keywords_check":{"type":"integer","title":"Seo Friendly Url Keywords Check","description":"Pages with URL-title keyword consistency"},"seo_friendly_url_characters_check":{"type":"integer","title":"Seo Friendly Url Characters Check","description":"Pages passing URL character validation"},"seo_friendly_url_relative_length_check":{"type":"integer","title":"Seo Friendly Url Relative Length Check","description":"Pages with URL length under 120 characters"}},"description":"Comprehensive page-level checks aggregate for on-page SEO issues.","additionalProperties":false},"broken_links":{"type":"integer","title":"Broken Links","description":"Total broken link count"},"onpage_score":{"type":"number","title":"Onpage Score","description":"Overall on-page SEO optimization score on 0-100 scale"},"non_indexable":{"type":"integer","title":"Non Indexable","description":"Number of pages blocked from indexing"},"redirect_loop":{"type":"integer","title":"Redirect Loop","description":"Number of redirect chains leading back to same URL"},"links_external":{"type":"integer","title":"Links External","description":"Total count of external links across all pages"},"links_internal":{"type":"integer","title":"Links Internal","description":"Total count of internal links across all pages"},"duplicate_title":{"type":"integer","title":"Duplicate Title","description":"Number of pages with duplicate title tags"},"broken_resources":{"type":"integer","title":"Broken Resources","description":"Total broken resource count (images, scripts, stylesheets)"},"duplicate_content":{"type":"integer","title":"Duplicate Content","description":"Number of pages with duplicate content"},"duplicate_description":{"type":"integer","title":"Duplicate Description","description":"Number of pages with duplicate meta descriptions"},"links_relation_conflict":{"type":"integer","title":"Links Relation Conflict","description":"Number of link relation conflicts"}},"description":"Aggregated page statistics and metrics.","additionalProperties":false},"crawl_progress":{"type":"string","title":"Crawl Progress","description":"Progress of the crawl operation (e.g., 'finished', 'in_progress')"},"crawl_stop_reason":{"type":"string","title":"Crawl Stop Reason","description":"Reason why crawling was halted"},"crawl_gateway_address":{"type":"string","title":"Crawl Gateway Address","description":"IP address of the crawler used"}},"description":"On Page Summary result containing overall website information and issues."},"title":"Result","description":"List of On Page Summary results containing overall website information and issues"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 indicates success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with On Page Summary results."},"title":"Tasks","description":"Array of task objects containing On Page Summary results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","On Page"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_BAIDU_LOCATIONS_BY_COUNTRY","name":"Get SERP Baidu Locations By Country","description":"Tool 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.","input_parameters":{"country":{"type":"string","description":"Country ISO code to filter the list of Baidu SERP locations. Example: 'us' for United States, 'cn' for China.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total task cost in USD."},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds."},"tasks":{"type":"array","items":{"type":"object","title":"BaiduLocationTaskResult","properties":{"id":{"type":"string","title":"Id","description":"Unique UUID task identifier."},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD."},"data":{"type":"object","title":"Data","description":"Request parameters used for this task.","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the request."},"time":{"type":"string","title":"Time","description":"Task execution time in seconds."},"result":{"type":"array","items":{"type":"object","title":"BaiduLocationResult","properties":{"location_code":{"type":"integer","title":"Location Code","description":"Unique location identifier code for Baidu SERP."},"location_name":{"type":"string","title":"Location Name","description":"Full name of the Baidu SERP location."},"location_type":{"type":"string","title":"Location Type","description":"Classification of the location (e.g., Country, State, City)."},"country_iso_code":{"type":"string","title":"Country Iso Code","description":"ISO country code for the Baidu SERP location."},"location_code_parent":{"type":"integer","title":"Location Code Parent","description":"Parent location code (null for top-level locations)."}},"description":"Represents a single Baidu SERP location entry."},"title":"Result","description":"Array of Baidu SERP location results."},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code."},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned for this task."},"status_message":{"type":"string","title":"Status Message","description":"Task-specific status message."}},"description":"Represents a single task result in the DataForSEO response."},"title":"Tasks","description":"Array of task result objects containing Baidu SERP location data."},"version":{"type":"string","title":"Version","description":"Current API version."},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range)."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the tasks array."},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors."},"status_message":{"type":"string","title":"Status Message","description":"Informational message about request status."}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_BAIDU_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Baidu Organic Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"faq":{"type":"array","items":{"type":"object","title":"FaqItem","properties":{"type":{"type":"string","title":"Type","description":"FAQ element type"},"title":{"type":"string","title":"Title","description":"Question text"},"description":{"type":"string","title":"Description","description":"Answer text"}},"description":"FAQ item in search results."},"title":"Faq","description":"FAQ section items"},"url":{"type":"string","title":"Url","description":"Result URL"},"page":{"type":"integer","title":"Page","description":"SERP page number"},"type":{"type":"string","title":"Type","description":"Element type (e.g., organic, paid, video)"},"links":{"type":"array","items":{"type":"object","title":"LinkInfo","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link information for search result items."},"title":"Links","description":"Additional links within the result"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price value"},"regular":{"type":"number","title":"Regular","description":"Regular price without discounts"},"currency":{"type":"string","title":"Currency","description":"ISO currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in a range"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether price represents a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for products in search results.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Result title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"images":{"type":"array","items":{"type":"object","title":"ImageInfo","properties":{"alt":{"type":"string","title":"Alt","description":"Alt text for the image"},"url":{"type":"string","title":"Url","description":"Image source URL"},"type":{"type":"string","title":"Type","description":"Image element type"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Image information in search results."},"title":"Images","description":"Images within the result"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum value for this rating scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for search result items.","additionalProperties":false},"position":{"type":"string","title":"Position","description":"Element position on the page (left/right)"},"cache_url":{"type":"string","title":"Cache Url","description":"Cached page URL"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate"},"y":{"type":"number","title":"Y","description":"Y coordinate"},"width":{"type":"number","title":"Width","description":"Rectangle width"},"height":{"type":"number","title":"Height","description":"Rectangle height"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the result publication"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"description":{"type":"string","title":"Description","description":"Result description snippet"},"highlighted":{"type":"array","items":{"type":"string","properties":{}},"title":"Highlighted","description":"Highlighted keywords in the result"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"}},"description":"Organic search result item from Baidu SERP."},"title":"Items","description":"Array of search result items including organic results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query used (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Baidu domain used for search"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of SERP pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code used"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results found"}},"description":"Individual task result containing Baidu Organic SERP data."},"title":"Result","description":"Array of Baidu SERP result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to API docs for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_BING_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Bing Organic Task Regular By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"OrganicItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Full URL of the search result"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":null,"description":"Page number where this result appears"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of the SERP item (e.g., 'organic', 'paid')"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Title of the search result"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Domain of the result"},"breadcrumb":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Breadcrumb","default":null,"description":"Breadcrumb navigation path shown in the result"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within a group of elements with identical type values"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":null,"description":"Description or snippet from the search result"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank in the SERP (across all types)"}},"description":"Organic search result item from Bing SERP."},{"type":"object","title":"RelatedSearchesItem","properties":{"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":null,"description":"Page number where this section appears"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type identifier (e.g., 'related_searches')"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"RelatedSearchItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL for the related search"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of related search item"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Related search query text"}},"description":"Individual related search query suggestion."}},{"type":"null"}],"title":"Items","default":null,"description":"Array of related search suggestions"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within a group of elements with identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank in the SERP"}},"description":"Related searches section in SERP results."}],"properties":{}},"title":"Items","description":"Array of SERP result items including organic results, paid results, and related searches"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of spell correction applied"},"keyword":{"type":"string","title":"Keyword","description":"Corrected keyword suggestion from the search engine"}},"description":"Autocorrection information for the search query.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the search results on Bing"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of SERP items found (e.g., 'organic', 'paid', 'related_searches')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the items array"},"language_code":{"type":"string","title":"Language Code","description":"Language code parameter used in the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code parameter used in the request"},"refinement_chips":{"type":"object","title":"RefinementChips","properties":{"type":{"type":"string","title":"Type","description":"Type of refinement chips element"},"items":{"type":"array","items":{"type":"object","title":"RefinementChipsItem","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Type of refinement chip"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"}},"description":"Individual refinement chip suggestion."},"title":"Items","description":"Array of refinement chip items"}},"description":"Search refinement chip suggestions.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results reported by the search engine"}},"description":"Complete SERP result data for a Bing Organic search task."},"title":"Result","description":"Array of SERP results containing organic and paid search results, related searches, and other SERP features"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with SERP results."},"title":"Tasks","description":"Array of task objects containing SERP results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_ADS_ADVERTISERS_TASK_ADV_BY_ID","name":"Get SERP Google Ads Advertisers Task (Advanced)","description":"Tool to retrieve Google Ads Advertisers task results by task ID. Use when you need to fetch advertiser information from Google Ads Transparency Center, including advertiser names, locations, verification status, and approximate ad counts.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (ads_advertisers)"},"items":{"type":"array","items":{"type":"object","title":"AdsAdvertiserItem","properties":{"type":{"type":"string","title":"Type","description":"Element type (ads_advertiser, ads_multi_account_advertiser, ads_domain)"},"title":{"type":"string","title":"Title","description":"Advertiser name or title"},"xpath":{"type":"string","title":"Xpath","description":"DOM location identifier"},"domain":{"type":"string","title":"Domain","description":"Domain name (for ads_domain type)"},"location":{"type":"string","title":"Location","description":"Advertiser location"},"verified":{"type":"boolean","title":"Verified","description":"Whether the advertiser is verified"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"advertisers":{"type":"array","items":{"type":"object","title":"AdvertiserDetail","properties":{"location":{"type":"string","title":"Location","description":"Advertiser location"},"verified":{"type":"boolean","title":"Verified","description":"Whether the advertiser is verified"},"advertiser_id":{"type":"string","title":"Advertiser Id","description":"Unique advertiser identifier"},"approx_ads_count":{"type":"integer","title":"Approx Ads Count","description":"Approximate number of ads for this advertiser"}},"description":"Individual advertiser account details within a multi-account group."},"title":"Advertisers","description":"List of individual advertisers (for ads_multi_account_advertiser type)"},"advertiser_id":{"type":"string","title":"Advertiser Id","description":"Unique advertiser identifier (for ads_advertiser type)"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"},"approx_ads_count":{"type":"integer","title":"Approx Ads Count","description":"Approximate number of ads"}},"description":"Base class for advertiser-related items in search results."},"title":"Items","description":"Array of advertiser items with details"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search term used in the query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to view the search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (adstransparency.google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements found in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"array","items":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Refinement chip display text"},"domain":{"type":"string","title":"Domain","description":"Domain name for the refinement"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"Additional refinement options"}},"description":"Search refinement option for narrowing results."},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found"}},"description":"Search result data for Google Ads Advertisers task."},"title":"Result","description":"Array of search result objects containing advertiser data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Ads Advertisers results."},"title":"Tasks","description":"Array of task objects containing Google Ads Advertisers results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_DATASET_SEARCH_TASK_ADV_BY_ID","name":"Get SERP Google Dataset Search Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (dataset_search)"},"items":{"type":"array","items":{"type":"object","title":"DatasetItem","properties":{"type":{"type":"string","title":"Type","description":"Element type (typically 'dataset')"},"links":{"type":"array","items":{"type":"object","title":"LinkElement","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"domain":{"type":"string","title":"Domain","description":"Link domain"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link element within dataset results."},"title":"Links","description":"Array of sitelinks within the result"},"title":{"type":"string","title":"Title","description":"Dataset name/title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"authors":{"type":"array","items":{"type":"object","title":"AuthorInfo","properties":{"url":{"type":"string","title":"Url","description":"Author profile URL"},"name":{"type":"string","title":"Name","description":"Author name"},"type":{"type":"string","title":"Type","description":"Author element type"},"domain":{"type":"string","title":"Domain","description":"Author domain"}},"description":"Dataset author/creator information."},"title":"Authors","description":"Dataset creators/authors information"},"formats":{"type":"array","items":{"type":"object","title":"FormatInfo","properties":{"size":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Size","description":"File size information"},"type":{"type":"string","title":"Type","description":"Format type identifier"},"format":{"type":"string","title":"Format","description":"File format (e.g., CSV, JSON)"}},"description":"File format information for datasets."},"title":"Formats","description":"Available file formats with size information"},"licenses":{"type":"array","items":{"type":"object","title":"LicenseInfo","properties":{"url":{"type":"string","title":"Url","description":"License details URL"},"type":{"type":"string","title":"Type","description":"License element type"},"title":{"type":"string","title":"Title","description":"License name"},"domain":{"type":"string","title":"Domain","description":"License domain"}},"description":"Dataset license information."},"title":"Licenses","description":"Dataset licensing terms"},"position":{"type":"string","title":"Position","description":"Element alignment (left/right)"},"image_url":{"type":"string","title":"Image Url","description":"Associated image URL"},"dataset_id":{"type":"string","title":"Dataset Id","description":"Unique dataset identifier"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"area_covered":{"type":"array","items":{"type":"string","properties":{}},"title":"Area Covered","description":"Geographic areas covered by the dataset"},"updated_date":{"type":"string","title":"Updated Date","description":"Last update timestamp for the dataset"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"},"period_covered":{"type":"object","title":"PeriodCovered","properties":{"end_date":{"type":"string","title":"End Date","description":"End date of coverage"},"start_date":{"type":"string","title":"Start Date","description":"Start date of coverage"},"displayed_date":{"type":"string","title":"Displayed Date","description":"Display date text"}},"description":"Temporal coverage information for datasets.","additionalProperties":false},"related_article":{"type":"string","title":"Related Article","description":"URL to related publication"},"dataset_providers":{"type":"array","items":{"type":"object","title":"DatasetProviderInfo","properties":{"url":{"type":"string","title":"Url","description":"Provider URL"},"type":{"type":"string","title":"Type","description":"Provider element type"},"title":{"type":"string","title":"Title","description":"Provider name/title"},"domain":{"type":"string","title":"Domain","description":"Provider domain"}},"description":"Dataset provider information."},"title":"Dataset Providers","description":"List of dataset provider institutions"},"unique_identifier":{"type":"string","title":"Unique Identifier","description":"Digital object identifier (DOI) or similar"},"dataset_description":{"type":"object","title":"DatasetDescription","properties":{"text":{"type":"string","title":"Text","description":"Description text"},"links":{"type":"array","items":{"type":"object","title":"DatasetDescriptionLink","properties":{"url":{"type":"string","title":"Url","description":"Link URL"},"type":{"type":"string","title":"Type","description":"Link type identifier"},"title":{"type":"string","title":"Title","description":"Link text"}},"description":"Link embedded in dataset description."},"title":"Links","description":"Embedded links in description"}},"description":"Dataset description with embedded links.","additionalProperties":false},"scholarly_articles_url":{"type":"string","title":"Scholarly Articles Url","description":"URL to related scholarly articles"},"scholarly_citations_count":{"type":"integer","title":"Scholarly Citations Count","description":"Number of scholarly citations"}},"description":"Dataset search result item."},"title":"Items","description":"Array of dataset items with details"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search term used in the query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to view the search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements found in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"array","items":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Refinement chip display text"},"domain":{"type":"string","title":"Domain","description":"Domain name for the refinement"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"Additional refinement options"}},"description":"Search refinement option for narrowing results."},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found"}},"description":"Search result data for Google Dataset Search task."},"title":"Result","description":"Array of search result objects containing dataset data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Dataset Search results."},"title":"Tasks","description":"Array of task objects containing Google Dataset Search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_FINANCE_EXPLORE_TASK_ADV_BY_ID","name":"Get SERP Google Finance Explore Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (finance_explore)"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"GoogleFinanceHeroGroupsItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_hero_groups)"},"markets":{"anyOf":[{"type":"object","title":"GoogleFinanceHeroMarkets","properties":{"us":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."}},{"type":"null"}],"title":"Us","default":null,"description":"US market indexes"},"asia":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."}},{"type":"null"}],"title":"Asia","default":null,"description":"Asian market indexes"},"crypto":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceAssetPairElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance pair link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Exchange rate value"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Movement direction"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Pair identifier (e.g., EUR-USD)"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Base asset code"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price movement"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Quote asset code"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Formatted pair name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent change"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Full base asset name"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Full quote asset name"}},"description":"Asset pair (currency, crypto) financial data element."}},{"type":"null"}],"title":"Crypto","default":null,"description":"Cryptocurrency pairs"},"europe":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."}},{"type":"null"}],"title":"Europe","default":null,"description":"European market indexes"},"futures":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."}},{"type":"null"}],"title":"Futures","default":null,"description":"Futures indexes"},"currencies":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceAssetPairElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance pair link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Exchange rate value"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Movement direction"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Pair identifier (e.g., EUR-USD)"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Base asset code"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price movement"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Quote asset code"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Formatted pair name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent change"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Full base asset name"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Full quote asset name"}},"description":"Asset pair (currency, crypto) financial data element."}},{"type":"null"}],"title":"Currencies","default":null,"description":"Currency pairs"}},"description":"Markets data within hero groups section."},{"type":"null"}],"default":null,"description":"Market data organized by region and type"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Hero groups item containing market overview across regions."},{"type":"object","title":"GoogleFinanceInterestedItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_interested)"},"items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."},{"type":"object","title":"GoogleFinanceAssetPairElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance pair link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Exchange rate value"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Movement direction"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Pair identifier (e.g., EUR-USD)"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Base asset code"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price movement"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Quote asset code"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Formatted pair name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent change"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Full base asset name"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Full quote asset name"}},"description":"Asset pair (currency, crypto) financial data element."},{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}]}},{"type":"null"}],"title":"Items","default":null,"description":"List of financial instruments"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item showing recent searches and followed securities."},{"type":"object","title":"GoogleFinanceNewsItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_news)"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceNewsElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Article link"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Article headline"},"quotes":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceNewsQuote","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance URL"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Price trend direction"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument ticker symbol"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Display name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"}},"description":"Financial instrument quote mentioned in a news article."}},{"type":"null"}],"title":"Quotes","default":null,"description":"Financial instruments mentioned"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":null,"description":"Publishing website name"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"Featured image URL"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Publication time"}},"description":"News article element from Google Finance."}},{"type":"null"}],"title":"Items","default":null,"description":"List of news articles"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item containing news articles and quoted market indexes."},{"type":"object","title":"GoogleFinanceEarningsCalendarItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_earnings_calendar)"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceEarningsCalendarElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Calendar link"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Calendar event name"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Event date/time"}},"description":"Earnings calendar event element."}},{"type":"null"}],"title":"Items","default":null,"description":"List of earnings calendar events"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item containing upcoming earnings dates."},{"type":"object","title":"GoogleFinanceMostFollowedItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_most_followed)"},"items":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"object","title":"GoogleFinanceMarketIndexElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to index on Google Finance"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction: up, down, or stable"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Index identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout time"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Combined ticker and market identifier"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current numerical value"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Human-readable name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Value change"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market code"}},"description":"Market index financial data element."},{"type":"object","title":"GoogleFinanceAssetPairElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance pair link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Exchange rate value"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Movement direction"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC readout"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Pair identifier (e.g., EUR-USD)"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Base asset code"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price movement"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Quote asset code"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Formatted pair name"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent change"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Full base asset name"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Full quote asset name"}},"description":"Asset pair (currency, crypto) financial data element."},{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}]}},{"type":"null"}],"title":"Items","default":null,"description":"List of trending financial instruments"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item showing trending financial instruments and pairs."},{"type":"object","title":"GoogleFinanceMarketTrendsItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_market_trends)"},"trends":{"anyOf":[{"type":"object","title":"GoogleFinanceMarketTrendsCategory","properties":{"losers":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}},{"type":"null"}],"title":"Losers","default":null,"description":"Top losing instruments"},"gainers":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}},{"type":"null"}],"title":"Gainers","default":null,"description":"Top gaining instruments"},"most_active":{"anyOf":[{"type":"array","items":{"type":"object","title":"GoogleFinanceMarketInstrumentElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Google Finance link"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Direction indicator"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Instrument code"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"UTC timestamp"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Full instrument identifier"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Price change"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Instrument name"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percent movement"}},"description":"Market instrument (stock, security) financial data element."}},{"type":"null"}],"title":"Most Active","default":null,"description":"Most actively traded instruments"}},"description":"Market trends category (most active, gainers, losers)."},{"type":"null"}],"default":null,"description":"Market trends organized by category"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item containing market trends categorized by performance."},{"type":"object","title":"GoogleFinancePeopleAlsoSearchItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (google_finance_people_also_search)"},"items":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Items","default":null,"description":"List of related search terms"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within group of identical type values"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position among all SERP elements"}},"description":"Item containing related search suggestions."}],"properties":{}},"title":"Items","description":"Array of Google Finance SERP elements"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection information if search query was corrected.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search term used in the query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to view the search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements found in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"array","items":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Refinement chip display text"},"domain":{"type":"string","title":"Domain","description":"Domain name for the refinement"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"Additional refinement options"}},"description":"Search refinement option for narrowing results."},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found"}},"description":"Search result data for Google Finance Explore task."},"title":"Result","description":"Array of search result objects containing finance data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Finance Explore results."},"title":"Tasks","description":"Array of task objects containing Google Finance Explore results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_FINANCE_TICKER_SEARCH_TASK_ADV_BY_ID","name":"Get SERP Google Finance Ticker Search Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier. Value: 'finance_ticker_search'"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"GoogleFinanceMarketIndex","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL to the detailed market index page"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of the item. Value: 'google_finance_market_index'"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction (e.g., 'up', 'down')"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Ticker symbol of the market index"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location of the market"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Timestamp when the data was retrieved"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Unique identifier for the market index"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within the group of elements with identical type values"},"index_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value","default":null,"description":"Current value of the market index"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank among all elements in the result"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Display name of the market index"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change in the index value"},"index_value_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Index Value Delta","default":null,"description":"Change in index value"},"market_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Identifier","default":null,"description":"Market identifier code"}},"description":"Market index item from Google Finance search results."},{"type":"object","title":"GoogleFinanceAssetPair","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL to the detailed asset pair page"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of the item. Value: 'google_finance_asset_pair'"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price of the asset pair"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction (e.g., 'up', 'down')"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location or market"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Timestamp when the data was retrieved"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Unique identifier for the asset pair"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within the group of elements with identical type values"},"base_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Symbol","default":null,"description":"Symbol of the base currency/asset in the pair"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Change in price"},"quote_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Symbol","default":null,"description":"Symbol of the quote currency/asset in the pair"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank among all elements in the result"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Display name of the asset pair"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change in price"},"base_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Display Name","default":null,"description":"Display name of the base currency/asset"},"quote_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Display Name","default":null,"description":"Display name of the quote currency/asset"}},"description":"Asset pair (currency/commodity) item from Google Finance search results."},{"type":"object","title":"GoogleFinanceMarketInstrument","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL to the detailed instrument page"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Type of the item. Value: 'google_finance_market_instrument'"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","default":null,"description":"Current price of the instrument"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend","default":null,"description":"Trend direction (e.g., 'up', 'down')"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","default":null,"description":"Ticker symbol of the instrument"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location or exchange"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Timestamp when the data was retrieved"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","default":null,"description":"Unique identifier for the market instrument"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within the group of elements with identical type values"},"price_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Delta","default":null,"description":"Change in price"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute rank among all elements in the result"},"displayed_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayed Name","default":null,"description":"Display name of the instrument"},"price_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Currency","default":null,"description":"Currency code for the price (e.g., 'USD', 'EUR')"},"percentage_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage Delta","default":null,"description":"Percentage change in price"}},"description":"Market instrument (stock/security) item from Google Finance search results."}],"properties":{}},"title":"Items","description":"Array of finance ticker search result items (market indices, asset pairs, or instruments)"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of spell correction"},"keyword":{"type":"string","title":"Keyword","description":"Autocorrected keyword"}},"description":"Spell check or autocorrection information.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword or ticker symbol used in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the search results on Google Finance"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results array"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"string","title":"Location Code","description":"Geographic location code used for the request"},"refinement_chips":{"type":"object","title":"RefinementChip","properties":{"type":{"type":"string","title":"Type","description":"Type of refinement chip"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"},"options":{"type":"array","items":{"type":"object","title":"RefinementChipOption","properties":{"url":{"type":"string","title":"Url","description":"URL for the refinement option"},"type":{"type":"string","title":"Type","description":"Type of refinement option"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"}},"description":"Individual refinement chip option."},"title":"Options","description":"Array of refinement options"}},"description":"Search refinement chip option.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found in the search engine"}},"description":"Result data containing Google Finance Ticker Search results."},"title":"Result","description":"Array of finance ticker search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Finance Ticker Search results."},"title":"Tasks","description":"Array of task objects containing Google Finance Ticker Search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_G_LOCAL_FINDER_TASK_GET_ADV_BY_ID","name":"Get SERP Google Local Finder Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Search type (e.g., local_finder)"},"items":{"type":"array","items":{"type":"object","title":"LocalPackItem","properties":{"cid":{"type":"string","title":"Cid","description":"Google client ID"},"url":{"type":"string","title":"Url","description":"Relevant URL for the business"},"type":{"type":"string","title":"Type","description":"Element type (e.g., local_pack)"},"phone":{"type":"string","title":"Phone","description":"Business phone number"},"title":{"type":"string","title":"Title","description":"Business name or title"},"xpath":{"type":"string","title":"Xpath","description":"DOM element XPath locator"},"domain":{"type":"string","title":"Domain","description":"Associated domain"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum possible rating value"},"rating_type":{"type":"string","title":"Rating Type","description":"Format type (e.g., Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of reviews or votes"}},"description":"Rating information for local business results.","additionalProperties":false},"is_paid":{"type":"boolean","title":"Is Paid","description":"Advertisement indicator"},"position":{"type":"string","title":"Position","description":"Alignment on page (left or right)"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate position"},"y":{"type":"number","title":"Y","description":"Y coordinate position"},"width":{"type":"number","title":"Width","description":"Rectangle width in pixels"},"height":{"type":"number","title":"Height","description":"Rectangle height in pixels"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"rank_group":{"type":"integer","title":"Rank Group","description":"Group position among identical types"},"description":{"type":"string","title":"Description","description":"Business description text"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in SERP"}},"description":"Individual local pack search result item."},"title":"Items","description":"Array of local pack search result items"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Correction type (e.g., did_you_mean, showing_results_for)"},"keyword":{"type":"string","title":"Keyword","description":"Autocorrected search term"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Result timestamp in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct SERP verification URL"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of search results present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Search refinement options","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of SERP results"}},"description":"Result data containing Google Local Finder search results."},"title":"Result","description":"Array of local finder search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task information with Google Local Finder search results."},"title":"Tasks","description":"Array of task objects containing Google Local Finder search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_ADVANCED","name":"Get SERP Google Ads Advertisers Advanced","description":"Tool to retrieve Google Ads Advertisers task results by task ID. Use when you need to fetch advertiser information from Google Ads Transparency Center, including advertiser names, locations, verification status, and approximate ad counts.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"AdsMultiAccountAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_multi_account_advertiser"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Advertiser location"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"advertisers":{"anyOf":[{"type":"array","items":{"type":"object","title":"Advertiser","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Country code"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Google Ads verification status"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of ads running"}},"description":"Individual advertiser account within a multi-account advertiser group."}},{"type":"null"}],"title":"Advertisers","default":null,"description":"Associated advertiser accounts"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate ads count across all platforms"}},"description":"Multi-account advertiser item with associated advertiser accounts."},{"type":"object","title":"AdsAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_advertiser"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser account name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Account location"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Verification status"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of active ads"}},"description":"Individual advertiser account item."},{"type":"object","title":"AdsDomainItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_domain"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Domain name"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"}},"description":"Domain-level advertiser item."}],"properties":{}},"title":"Items","description":"Array of advertiser result items"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp (yyyy-mm-dd hh:mm:ss +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct search engine results link"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (adstransparency.google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Result types: ads_multi_account_advertiser, ads_advertiser, ads_domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of returned items"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Search refinement options","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total SERP results count"}},"description":"Individual task result containing Google Ads Advertisers data."},"title":"Result","description":"Array of result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range, refer to error documentation)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_LIVE_ADVANCED","name":"Get SERP Google Ads Advertisers Live Advanced","description":"Tool 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.","input_parameters":{"tasks":{"type":"array","description":"Array of task items to be executed. Each task searches for advertisers running ads for the specified keyword. Maximum 100 tasks per request.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"items":{"type":"object","title":"GetSerpGoogleAdsAdvertisersLiveAdvancedRequestItem","required":["keyword"],"properties":{"tag":{"type":"string","title":"Tag","examples":["campaign_001","test_query"],"maxLength":255,"description":"User-defined identifier for task tracking. Maximum 255 characters. Useful for matching tasks to results in your system."},"keyword":{"type":"string","title":"Keyword","examples":["insurance","credit cards","web hosting"],"maxLength":700,"description":"Search term for ads advertisers search. Maximum 700 characters. Special characters like '%' must be encoded as '%25' and '+' as '%2B'."},"priority":{"enum":[1,2],"type":"integer","title":"PriorityLevel","description":"Task execution priority levels."},"location_code":{"type":"integer","title":"Location Code","examples":[2840,2826],"description":"Search engine location code (e.g., 2840 for United States). Mutually exclusive with location_name or location_coordinate. If no location is specified, advertisers will be searched across all available locations."},"location_name":{"type":"string","title":"Location Name","examples":["London,England,United Kingdom","New York,New York,United States"],"description":"Full location name (e.g., 'London,England,United Kingdom'). Mutually exclusive with location_code or location_coordinate. If no location is specified, advertisers will be searched across all available locations."},"location_coordinate":{"type":"string","title":"Location Coordinate","examples":["52.6178549,-155.352142","40.7127837,-74.0059413"],"description":"GPS coordinates in 'latitude,longitude' format (e.g., '52.6178549,-155.352142'). Mutually exclusive with location_name or location_code. If no location is specified, advertisers will be searched across all available locations."}},"description":"Individual task item for Google Ads Advertisers Live Advanced request.","requiredFields":"$17:props:tools:131:input_parameters:tasks:items:required"}}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"AdsMultiAccountAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_multi_account_advertiser"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Advertiser location"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"advertisers":{"anyOf":[{"type":"array","items":{"type":"object","title":"Advertiser","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type identifier"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Country code"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Google Ads verification status"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of ads running"}},"description":"Individual advertiser account within a multi-account advertiser group."}},{"type":"null"}],"title":"Advertisers","default":null,"description":"Associated advertiser accounts"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate ads count across all platforms"}},"description":"Multi-account advertiser item with associated advertiser accounts."},{"type":"object","title":"AdsAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_advertiser"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser account name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Account location"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Verification status"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of active ads"}},"description":"Individual advertiser account item."},{"type":"object","title":"AdsDomainItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type: ads_domain"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Domain name"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within same-type group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall SERP position"}},"description":"Domain-level advertiser item."}],"properties":{}},"title":"Items","description":"Array of advertiser result items"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp (yyyy-mm-dd hh:mm:ss +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct search engine results link"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain (adstransparency.google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Result types: ads_multi_account_advertiser, ads_advertiser, ads_domain"},"items_count":{"type":"integer","title":"Items Count","description":"Number of returned items"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Search refinement options","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total SERP results count"}},"description":"Individual task result containing Google Ads Advertisers data."},"title":"Result","description":"Array of result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range, refer to error documentation)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_ADVERTISERS_TASK_ADVANCED","name":"Get SERP Google Ads Advertisers Task Advanced","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution time in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint used"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword from the original request"},"se_type":{"type":"string","title":"Se Type","description":"Search engine type"},"function":{"type":"string","title":"Function","description":"API function called"},"priority":{"type":"integer","title":"Priority","description":"Task priority level"},"language_code":{"type":"string","title":"Language Code","description":"Language code"},"location_code":{"type":"integer","title":"Location Code","description":"Location code"}},"description":"Original task parameters from the POST request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components"},"time":{"type":"string","title":"Time","description":"Task execution time"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"AdsMultiAccountAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element classification (ads_multi_account_advertiser)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser name or company name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Geographic location of the advertiser"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within elements of the same type"},"advertisers":{"anyOf":[{"type":"array","items":{"type":"object","title":"AdvertiserInfo","properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Advertiser account location"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Google verification status of the advertiser"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier for Google Ads Search API queries"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of active ads from this advertiser"}},"description":"Information about an individual advertiser account."}},{"type":"null"}],"title":"Advertisers","default":null,"description":"List of associated advertiser accounts with details"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in overall SERP results"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate total quantity of ads across all accounts"}},"description":"Multi-account advertiser result item from ads transparency database."},{"type":"object","title":"AdsAdvertiserItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element classification (ads_advertiser)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Advertiser account name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null,"description":"Advertiser account location"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","default":null,"description":"Google verification status of the advertiser"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within elements of the same type"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","default":null,"description":"Unique advertiser account identifier for Google Ads Search API queries"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in overall SERP results"},"approx_ads_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Ads Count","default":null,"description":"Approximate number of active ads from this advertiser"}},"description":"Single advertiser account result item from ads transparency database."},{"type":"object","title":"AdsDomainItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element classification (ads_domain)"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Domain name (e.g., 'apple.com')"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within elements of the same type"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in overall SERP results"}},"description":"Domain result item from ads transparency database."}],"properties":{}},"title":"Items","description":"Array of search result elements (advertisers and domains)"},"spell":{"type":"object","title":"Spell","properties":{"type":{"type":"string","title":"Type","description":"Type of spell correction"},"keyword":{"type":"string","title":"Keyword","description":"Suggested corrected keyword"}},"description":"Autocorrection data for search query.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp when the result was retrieved"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify SERP results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain from the POST request"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result items present (ads_multi_account_advertiser, ads_advertiser, ads_domain)"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language specification used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier used for the request"},"refinement_chips":{"type":"object","title":"RefinementChips","properties":{"type":{"type":"string","title":"Type","description":"Type of refinement chip"},"title":{"type":"string","title":"Title","description":"Refinement chip title"},"options":{"type":"array","items":{"type":"object","title":"RefinementOption","properties":{"url":{"type":"string","title":"Url","description":"URL for this refinement option"},"type":{"type":"string","title":"Type","description":"Type of refinement option"},"title":{"type":"string","title":"Title","description":"Option title or label"}},"description":"Individual refinement option."},"title":"Options","description":"Available refinement options"}},"description":"Search refinement options displayed in SERP.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found in SERP"}},"description":"Result data containing Google Ads advertiser information from transparency database."},"title":"Result","description":"Array of result objects containing Google Ads advertiser data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code. 20000 indicates success, 40000+ indicates task in queue or processing."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result objects in the result array"},"status_message":{"type":"string","title":"Status Message","description":"Human-readable task status message"}},"description":"Individual task object containing results and metadata."},"title":"Tasks","description":"Array of task objects containing Google Ads advertiser results"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"General response status code (20000 indicates success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message describing the response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ADS_SEARCH_LIVE_ADVANCED","name":"Get SERP Google Ads Search Live Advanced","description":"Tool 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.","input_parameters":{"tag":{"type":"string","description":"User-defined task identifier (max 255 characters). This tag will be returned in the response for tracking purposes","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"depth":{"type":"integer","description":"Number of results to return (default: 40, max: 120). Billing applies per 40 results","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"format":{"type":"string","description":"Advertisement format types for filtering.","default":"$undefined","example":"$undefined","enum":["all","text","image","video"],"required":false},"target":{"type":"string","description":"Domain name associated with an advertiser account. Either target or advertiser_ids must be specified","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"date_to":{"type":"string","description":"Ending date of the time range in yyyy-mm-dd format. Required if date_from is specified","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"platform":{"type":"string","description":"Advertising platform types for filtering results.","default":"$undefined","example":"$undefined","enum":["all","google_play","google_maps","google_search","google_shopping","youtube"],"required":false},"priority":{"type":"string","description":"Task priority levels.","default":"$undefined","example":"$undefined","enum":["normal","high"],"required":false},"date_from":{"type":"string","description":"Starting date of the time range in yyyy-mm-dd format (minimum: 2018-05-31). Required if date_to is specified","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_code":{"type":"integer","description":"Search engine location code. Use location_code, location_name, or location_coordinate (only one at a time)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"location_name":{"type":"string","description":"Full name of search engine location (e.g., 'United States'). Use location_code, location_name, or location_coordinate (only one at a time)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"advertiser_ids":{"type":"array","description":"Array of advertiser identifiers (max 25). Either advertiser_ids or target must be specified","default":"$undefined","example":"$undefined","enum":"$undefined","required":false,"items":{"type":"string","properties":{}}},"location_coordinate":{"type":"string","description":"GPS coordinates of a location. Format: 'latitude,longitude'. Use location_code, location_name, or location_coordinate (only one at a time)","default":"$undefined","example":"$undefined","enum":"$undefined","required":false}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Individual task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type: ads_search"},"items":{"type":"array","items":{"type":"object","title":"AdsSearchItem","properties":{"url":{"type":"string","title":"Url","description":"URL pointing to the advertisement on the Ads Transparency platform"},"type":{"type":"string","title":"Type","description":"Element type: ads_search"},"title":{"type":"string","title":"Title","description":"Advertiser name"},"format":{"type":"string","title":"Format","description":"Ad format: text, image, or video"},"verified":{"type":"boolean","title":"Verified","description":"True if advertiser account is verified by Google Ads"},"last_shown":{"type":"string","title":"Last Shown","description":"Date and time when the ad was shown the last time (UTC: yyyy-mm-dd hh:mm:ss +00:00)"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of elements with identical type values"},"creative_id":{"type":"string","title":"Creative Id","description":"Unique identifier of the advertisement"},"first_shown":{"type":"string","title":"First Shown","description":"Date and time when the ad was shown for the first time (UTC: yyyy-mm-dd hh:mm:ss +00:00)"},"advertiser_id":{"type":"string","title":"Advertiser Id","description":"Unique identifier of the advertiser account"},"preview_image":{"type":"object","title":"PreviewImage","properties":{"url":{"type":"string","title":"Url","description":"Image URL"},"width":{"type":"integer","title":"Width","description":"Image width in pixels"},"height":{"type":"integer","title":"Height","description":"Image height in pixels"}},"description":"Preview image data for an advertisement.","additionalProperties":false},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position among all the elements in SERP"}},"description":"Individual advertisement search result item."},"title":"Items","description":"Array of advertisement items"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received (UTC: yyyy-mm-dd hh:mm:ss +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain: adstransparency.google.com"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of search results returned"},"items_count":{"type":"integer","title":"Items Count","description":"Number of returned items"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total SERP results count"}},"description":"Individual task result containing Google Ads Search data."},"title":"Result","description":"Array of result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (10000-60000 range, refer to error documentation)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_AI_MODE_TASK_ADVANCED_BY_ID","name":"Get SERP Google AI Mode Task Advanced Results","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Keyword used for the task"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type"},"items":{"type":"array","items":{"type":"object","title":"SerpItem","properties":{"page":{"type":"integer","title":"Page","description":"Page number in search results"},"type":{"type":"string","title":"Type","description":"Item type (e.g., 'ai_overview')"},"items":{"type":"array","items":{"type":"object","title":"AiOverviewItem","properties":{"url":{"type":"string","title":"Url","description":"URL to the item source"},"date":{"type":"string","title":"Date","description":"Publication date for video items"},"text":{"type":"string","title":"Text","description":"Text content for text/video/expanded elements"},"type":{"type":"string","title":"Type","description":"Item type (e.g., 'ai_overview_element', 'ai_overview_video_element', 'ai_overview_table_element', 'ai_overview_expanded_element', 'ai_overview_shopping')"},"links":{"type":"array","items":{"type":"object","title":"LinkElement","properties":{"url":{"type":"string","title":"Url","description":"Link URL"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'link_element')"},"title":{"type":"string","title":"Title","description":"Link title or anchor text"},"domain":{"type":"string","title":"Domain","description":"Domain of the linked URL"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link element within AI overview content."},"title":"Links","description":"List of links within the item"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price"},"regular":{"type":"number","title":"Regular","description":"Regular price before discount"},"currency":{"type":"string","title":"Currency","description":"Currency code (e.g., 'USD', 'EUR')"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in price range"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Indicates if price is a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for shopping items.","additionalProperties":false},"table":{"type":"object","title":"TableInfo","properties":{"table_header":{"type":"array","items":{"type":"string","properties":{}},"title":"Table Header","description":"List of column headers"},"table_content":{"type":"array","items":{"type":"array","items":{"type":"string"},"properties":{}},"title":"Table Content","description":"2D array of table cell values"}},"description":"Table structure within AI overview content.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Item title"},"domain":{"type":"string","title":"Domain","description":"Domain of the item URL"},"images":{"type":"array","items":{"type":"object","title":"ImageElement","properties":{"alt":{"type":"string","title":"Alt","description":"Image alt text attribute"},"url":{"type":"string","title":"Url","description":"URL to the page containing the image"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'images_element')"},"image_url":{"type":"string","title":"Image Url","description":"Direct URL to the image file"}},"description":"Image element within AI overview content."},"title":"Images","description":"List of images within the item"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum rating value for the scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"type":"integer","title":"Votes Count","description":"Total number of votes or reviews"}},"description":"Rating information for products or services.","additionalProperties":false},"seller":{"type":"string","title":"Seller","description":"Seller name for shopping items"},"source":{"type":"string","title":"Source","description":"Source name for video items"},"snippet":{"type":"string","title":"Snippet","description":"Video snippet or description"},"markdown":{"type":"string","title":"Markdown","description":"Content in markdown format for element/table/expanded types"},"position":{"type":"string","title":"Position","description":"Position in SERP (e.g., 'left', 'right')"},"image_url":{"type":"string","title":"Image Url","description":"Image URL for video or shopping items"},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp for video items"},"components":{"type":"array","items":{"type":"object","title":"AiOverviewExpandedComponent","properties":{"text":{"type":"string","title":"Text","description":"Component text content"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'ai_overview_expanded_component')"},"links":{"type":"array","items":{"type":"object","title":"LinkElement","properties":{"url":{"type":"string","title":"Url","description":"Link URL"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'link_element')"},"title":{"type":"string","title":"Title","description":"Link title or anchor text"},"domain":{"type":"string","title":"Domain","description":"Domain of the linked URL"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link element within AI overview content."},"title":"Links","description":"List of links in this component"},"title":{"type":"string","title":"Title","description":"Component title"},"images":{"type":"array","items":{"type":"object","title":"ImageElement","properties":{"alt":{"type":"string","title":"Alt","description":"Image alt text attribute"},"url":{"type":"string","title":"Url","description":"URL to the page containing the image"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'images_element')"},"image_url":{"type":"string","title":"Image Url","description":"Direct URL to the image file"}},"description":"Image element within AI overview content."},"title":"Images","description":"List of images in this component"},"markdown":{"type":"string","title":"Markdown","description":"Component content in markdown format"},"references":{"type":"array","items":{"type":"object","title":"AiOverviewReference","properties":{"url":{"type":"string","title":"Url","description":"URL of the source page"},"text":{"type":"string","title":"Text","description":"Excerpt or snippet from the source"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'ai_overview_reference')"},"title":{"type":"string","title":"Title","description":"Title of the source page"},"domain":{"type":"string","title":"Domain","description":"Domain of the source"},"source":{"type":"string","title":"Source","description":"Source name or publisher"}},"description":"Reference to source webpage used to generate AI overview."},"title":"References","description":"List of source references in this component"}},"description":"Component within expanded AI overview elements."},"title":"Components","description":"List of components for expanded elements"},"product_id":{"type":"string","title":"Product Id","description":"Product identifier for shopping items"},"references":{"type":"array","items":{"type":"object","title":"AiOverviewReference","properties":{"url":{"type":"string","title":"Url","description":"URL of the source page"},"text":{"type":"string","title":"Text","description":"Excerpt or snippet from the source"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'ai_overview_reference')"},"title":{"type":"string","title":"Title","description":"Title of the source page"},"domain":{"type":"string","title":"Domain","description":"Domain of the source"},"source":{"type":"string","title":"Source","description":"Source name or publisher"}},"description":"Reference to source webpage used to generate AI overview."},"title":"References","description":"List of source references for the item"},"marketplace":{"type":"string","title":"Marketplace","description":"Marketplace name for shopping items"},"marketplace_url":{"type":"string","title":"Marketplace Url","description":"Marketplace URL for shopping items"}},"description":"Individual item within AI overview results."},"title":"Items","description":"List of nested elements within the AI overview"},"xpath":{"type":"string","title":"Xpath","description":"XPath to the element in the page"},"markdown":{"type":"string","title":"Markdown","description":"Complete AI overview content in markdown format"},"position":{"type":"string","title":"Position","description":"Position in SERP (e.g., 'left', 'right')"},"rectangle":{"type":"object","title":"Rectangle","properties":{"x":{"type":"integer","title":"X","description":"X coordinate of the element"},"y":{"type":"integer","title":"Y","description":"Y coordinate of the element"},"width":{"type":"integer","title":"Width","description":"Width of the element in pixels"},"height":{"type":"integer","title":"Height","description":"Height of the element in pixels"}},"description":"Pixel coordinates of the element on the page.","additionalProperties":false},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within identical type group"},"references":{"type":"array","items":{"type":"object","title":"AiOverviewReference","properties":{"url":{"type":"string","title":"Url","description":"URL of the source page"},"text":{"type":"string","title":"Text","description":"Excerpt or snippet from the source"},"type":{"type":"string","title":"Type","description":"Element type (e.g., 'ai_overview_reference')"},"title":{"type":"string","title":"Title","description":"Title of the source page"},"domain":{"type":"string","title":"Domain","description":"Domain of the source"},"source":{"type":"string","title":"Source","description":"Source name or publisher"}},"description":"Reference to source webpage used to generate AI overview."},"title":"References","description":"List of webpage references used to generate the overview"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall position among all results"},"asynchronous_ai_overview":{"type":"boolean","title":"Asynchronous Ai Overview","description":"Indicates if AI overview is loaded asynchronously"}},"description":"Search engine result page item (AI overview)."},"title":"Items","description":"List of SERP items containing AI overview results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type"},"keyword":{"type":"string","title":"Keyword","description":"Original keyword"}},"description":"Spell check or autocorrection information.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword or query"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify results in SERP"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the task"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Array of result types returned (e.g., ['ai_overview'])"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language identifier used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location identifier used for the request"},"refinement_chips":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"Chip URL"},"type":{"type":"string","title":"Type","description":"Refinement chip type"},"title":{"type":"string","title":"Title","description":"Chip title"}},"description":"Refinement chip for search results.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results"}},"description":"Result data containing SERP results with AI overview."},"title":"Result","description":"List of task results containing SERP data with AI overview"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with results."},"title":"Tasks","description":"Array of task objects containing SERP results with AI overview"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_AUTOCOMPLETE_TASK_ADVANCED_BY_ID","name":"Get SERP Google Autocomplete Task (Advanced)","description":"Tool to retrieve Google Autocomplete task results by task ID. Use when you need to fetch autocomplete suggestions from a previously submitted Google Autocomplete task.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (autocomplete)"},"items":{"type":"array","items":{"type":"object","title":"AutocompleteItem","properties":{"url":{"type":"string","title":"Url","description":"URL for the suggested search query"},"type":{"type":"string","title":"Type","description":"Type of the autocomplete item"},"title":{"type":"string","title":"Title","description":"Autocomplete suggestion text"}},"description":"Individual autocomplete suggestion item."},"title":"Items","description":"Array of autocomplete suggestion items"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword or prefix used for autocomplete"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the autocomplete results"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier used for the request"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of autocomplete suggestions returned"}},"description":"Result data containing Google Autocomplete suggestions."},"title":"Result","description":"Array of autocomplete result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Autocomplete results."},"title":"Tasks","description":"Array of task objects containing Google Autocomplete results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_DATASET_INFO_TASK_ADVANCED","name":"Get SERP Google Dataset Info Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"items":{"type":"array","items":{"type":"object","title":"DatasetItem","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (typically 'dataset')"},"links":{"type":"array","items":{"type":"object","title":"SitelinkItem","properties":{"url":{"type":"string","title":"Url","description":"Sitelink URL"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Sitelink title"},"domain":{"type":"string","title":"Domain","description":"Domain of the sitelink"},"description":{"type":"string","title":"Description","description":"Sitelink description/snippet"}},"description":"Individual sitelink within dataset results."},"title":"Links","description":"Related sitelinks for the dataset"},"title":{"type":"string","title":"Title","description":"Dataset title"},"xpath":{"type":"string","title":"Xpath","description":"XPath location in DOM"},"authors":{"type":"array","items":{"type":"object","title":"Author","properties":{"url":{"type":"string","title":"Url","description":"Author URL"},"name":{"type":"string","title":"Name","description":"Author name"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"domain":{"type":"string","title":"Domain","description":"Author domain"}},"description":"Dataset author information."},"title":"Authors","description":"Dataset authors or creators"},"formats":{"type":"array","items":{"type":"object","title":"Format","properties":{"size":{"type":"integer","title":"Size","description":"File size in bytes or as integer"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"format":{"type":"string","title":"Format","description":"Format type (e.g., CSV, JSON)"}},"description":"File format information."},"title":"Formats","description":"Available file formats (e.g., csv, html, zip, pdf)"},"licenses":{"type":"array","items":{"type":"object","title":"License","properties":{"url":{"type":"string","title":"Url","description":"License URL"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"License title"},"domain":{"type":"string","title":"Domain","description":"License domain"}},"description":"Dataset license information."},"title":"Licenses","description":"Dataset licenses (e.g., CC BY 4.0)"},"position":{"type":"string","title":"Position","description":"Display position alignment (e.g., 'left', 'right')"},"image_url":{"type":"string","title":"Image Url","description":"Dataset preview image URL"},"dataset_id":{"type":"string","title":"Dataset Id","description":"Unique dataset identifier used for searches"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type result group"},"area_covered":{"type":"array","items":{"type":"string","properties":{}},"title":"Area Covered","description":"Geographic areas covered by the dataset"},"updated_date":{"type":"string","title":"Updated Date","description":"Last update timestamp for the dataset"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute SERP position"},"period_covered":{"type":"object","title":"PeriodCovered","properties":{"end_date":{"type":"string","title":"End Date","description":"End date of dataset coverage"},"start_date":{"type":"string","title":"Start Date","description":"Start date of dataset coverage"},"displayed_date":{"type":"string","title":"Displayed Date","description":"Human-readable date range display"}},"description":"Time period covered by the dataset.","additionalProperties":false},"related_article":{"type":"string","title":"Related Article","description":"Related article reference"},"dataset_providers":{"type":"array","items":{"type":"object","title":"DatasetProvider","properties":{"url":{"type":"string","title":"Url","description":"Provider URL"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Provider name"},"domain":{"type":"string","title":"Domain","description":"Provider domain"}},"description":"Dataset provider with details."},"title":"Dataset Providers","description":"Organizations or institutions providing the dataset"},"unique_identifier":{"type":"string","title":"Unique Identifier","description":"Unique identifier for the dataset"},"dataset_description":{"type":"object","title":"DatasetDescription","properties":{"text":{"type":"string","title":"Text","description":"Description text"},"links":{"type":"array","items":{"type":"object","title":"DescriptionLink","properties":{"url":{"type":"string","title":"Url","description":"Link URL"},"type":{"type":"string","title":"Type","description":"Link type identifier"},"title":{"type":"string","title":"Title","description":"Link text"},"domain":{"type":"string","title":"Domain","description":"Link domain"},"description":{"type":"string","title":"Description","description":"Link description/snippet"}},"description":"Embedded link within dataset description."},"title":"Links","description":"Embedded links in the description"}},"description":"Dataset description with embedded links.","additionalProperties":false},"scholarly_articles_url":{"type":"string","title":"Scholarly Articles Url","description":"URL to scholarly articles citing this dataset"},"scholarly_citations_count":{"type":"integer","title":"Scholarly Citations Count","description":"Number of scholarly citations for this dataset"}},"description":"Individual dataset item from search results."},"title":"Items","description":"Array of dataset items with details"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of spell suggestion (e.g., 'did_you_mean')"},"keyword":{"type":"string","title":"Keyword","description":"Suggested keyword"}},"description":"Spell check information for the query.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword used in the query"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to view the search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used (e.g., google.com)"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Array of item types present in the results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of dataset items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found in the SERP"}},"description":"Search result data for Google Dataset Info task."},"title":"Result","description":"Array of search result objects containing dataset data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Dataset Info results."},"title":"Tasks","description":"Array of task objects containing Google Dataset Info results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_MARKETS_TASK_HTML_BY_ID","name":"Get SERP Google Finance Markets Task HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"SerpTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of SERP result (e.g., 'finance_markets')"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Finance Markets SERP page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or query specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the SERP HTML task containing the HTML content."},"title":"Result","description":"Array of SERP task results containing the Google Finance Markets HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Finance Markets SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_QUOTE_TASK_ADVANCED_BY_ID","name":"Get SERP Google Finance Quote Task (Advanced)","description":"Tool to retrieve Google Finance Quote task results by task ID. Use when you need real-time financial data from Google Finance Quote tab for a specific ticker symbol, including current price, market data, news, and financial metrics.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (finance_quote)"},"items":{"type":"array","items":{"type":"object","title":"GoogleFinanceItem","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"}},"description":"Base item type for Google Finance elements - can be any of the specific finance element types."},"title":"Items","description":"Array of Google Finance elements with various types (quote, news, financials, details, etc.)"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search term used in the query (ticker symbol)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of data retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct link to view the search results on Google Finance"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements found in results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in this response"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the search"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"array","items":{"type":"object","title":"RefinementChip","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Element type identifier"},"title":{"type":"string","title":"Title","description":"Refinement chip display text"},"domain":{"type":"string","title":"Domain","description":"Domain name for the refinement"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"Additional refinement options"}},"description":"Search refinement option for narrowing results."},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results found"}},"description":"Search result data for Google Finance Quote task."},"title":"Result","description":"Array of search result objects containing Google Finance Quote data"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Finance Quote results."},"title":"Tasks","description":"Array of task objects containing Google Finance Quote results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_FINANCE_QUOTE_TASK_HTML_BY_ID","name":"Get SERP Google Finance Quote HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"Unique task identifier in UUID format, obtained from task_post endpoint. Valid for 7 days after task creation.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in DataForSEO credits"},"data":{"type":"object","title":"TaskData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or stock ticker used for the task"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Task data containing the original request parameters.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"FinanceQuoteHtmlResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Finance quote page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"Individual HTML result item containing raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Stock ticker or keyword specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the Google Finance Quote HTML task."},"title":"Result","description":"Array of HTML results containing Google Finance quote page content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Individual task information with HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Finance quote pages"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_IMAGES_TASK_GET_ADVANCED_BY_ID","name":"Get SERP Google Images Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Result type identifier (images)"},"items":{"type":"array","items":{"type":"object","title":"ImageItem","properties":{"url":{"type":"string","title":"Url","description":"URL to the source page containing the image"},"type":{"type":"string","title":"Type","description":"Type of the image item"},"title":{"type":"string","title":"Title","description":"Image title or alt text"},"xpath":{"type":"string","title":"Xpath","description":"XPath to the element on the page"},"subtitle":{"type":"string","title":"Subtitle","description":"Image subtitle or description"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type group"},"source_url":{"type":"string","title":"Source Url","description":"Direct URL to the image file"},"encoded_url":{"type":"string","title":"Encoded Url","description":"Encoded image URL"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Overall SERP position"}},"description":"Individual image search result item."},"title":"Items","description":"Array of image search result items"},"spell":{"type":"object","title":"Spell","description":"Autocorrection details if the query was corrected","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword used for the images query"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the image search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier used for the request"},"refinement_chips":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of image results returned by the search engine"}},"description":"Result data containing Google Images search results."},"title":"Result","description":"Array of image search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Images search results."},"title":"Tasks","description":"Array of task objects containing Google Images search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_IMAGES_TASK_HTML_BY_ID","name":"Get SERP Google Images Task HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"SerpTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of SERP result (e.g., 'images')"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Images SERP page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or query specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the SERP HTML task containing the HTML content."},"title":"Result","description":"Array of SERP task results containing the Google Images HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Images SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_JOBS_TASK_ADVANCED","name":"Get SERP Google Jobs Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters (keyword, language_code, location_code, etc.)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Search result type identifier (e.g., 'jobs')"},"items":{"type":"array","items":{"type":"object","title":"JobItem","properties":{"type":{"type":"string","title":"Type","description":"Element type identifier (e.g., 'google_jobs_item')"},"title":{"type":"string","title":"Title","description":"Job position title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator to the element on the page"},"job_id":{"type":"string","title":"Job Id","description":"Unique Google Jobs identifier for the job listing"},"salary":{"type":"string","title":"Salary","description":"Compensation details if available (null if not specified)"},"location":{"type":"string","title":"Location","description":"Geographic location of the job posting"},"position":{"type":"string","title":"Position","description":"Alignment position on the page (e.g., 'left' or 'right')"},"time_ago":{"type":"string","title":"Time Ago","description":"Relative time since posting (e.g., '2 days ago')"},"rectangle":{"type":"object","title":"Rectangle","description":"Pixel coordinates of the element (null for jobs)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]}},"timestamp":{"type":"string","title":"Timestamp","description":"Publication timestamp in UTC format"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within results of the same type"},"source_url":{"type":"string","title":"Source Url","description":"Direct URL to the original job posting"},"source_name":{"type":"string","title":"Source Name","description":"Name of the original source platform (e.g., LinkedIn, Indeed)"},"employer_url":{"type":"string","title":"Employer Url","description":"URL to the employer's website"},"contract_type":{"type":"string","title":"Contract Type","description":"Employment classification (e.g., Full-time, Part-time, Contract)"},"employer_name":{"type":"string","title":"Employer Name","description":"Name of the employer organization"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position in all SERP results"},"employer_image_url":{"type":"string","title":"Employer Image Url","description":"URL to the employer's logo image"}},"description":"Individual job listing result item."},"title":"Items","description":"Array of job listing result items with employer, location, and employment details"},"spell":{"type":"object","title":"Spell","description":"Autocorrection details if the search query was corrected (null if none)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword used for the jobs query (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the job search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results (e.g., ['google_jobs_item'])"},"items_count":{"type":"integer","title":"Items Count","description":"Number of job listing items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Available search refinement options","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of job results returned by the search engine"}},"description":"Result data containing Google Jobs search results."},"title":"Result","description":"Array of job search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google Jobs search results."},"title":"Tasks","description":"Array of task objects containing Google Jobs search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_MAPS_TASK_GET_ADVANCED_BY_ID","name":"Get SERP Google Maps Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Search type (e.g., 'maps')"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"MapsSearchItem","properties":{"cid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cid","default":null,"description":"Google client ID for the business"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to business website"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (e.g., 'maps_search')"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","default":null,"description":"Business contact phone number"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Business name displayed in search results"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Associated website domain"},"rating":{"anyOf":[{"type":"object","title":"RatingInfo","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","default":null,"description":"Average rating score value"},"rating_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating Max","default":null,"description":"Maximum rating value for the scale"},"rating_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rating Type","default":null,"description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes Count","default":null,"description":"Total number of reviews or votes"}},"description":"Rating information for business results."},{"type":"null"}],"default":null,"description":"Aggregated business rating information"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null,"description":"Full business address as a single string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","default":null,"description":"Primary business category"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","default":null,"description":"Geographic latitude coordinate"},"place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Id","default":null,"description":"Unique Google Places identifier"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","default":null,"description":"Geographic longitude coordinate"},"is_claimed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Claimed","default":null,"description":"Indicates if business ownership is verified on Google"},"main_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Main Image","default":null,"description":"URL to the main business profile image"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within identical type group"},"work_hours":{"anyOf":[{"type":"object","title":"WorkHours","properties":{"timetable":{"anyOf":[{"type":"object","title":"WorkHoursTimetable","properties":{"friday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Friday","default":null,"description":"Operating hours for Friday"},"monday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Monday","default":null,"description":"Operating hours for Monday"},"sunday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Sunday","default":null,"description":"Operating hours for Sunday"},"tuesday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Tuesday","default":null,"description":"Operating hours for Tuesday"},"saturday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Saturday","default":null,"description":"Operating hours for Saturday"},"thursday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Thursday","default":null,"description":"Operating hours for Thursday"},"wednesday":{"anyOf":[{"type":"array","items":{"type":"object","title":"WorkHoursPeriod","properties":{"open":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Opening time"},"close":{"anyOf":[{"type":"object","title":"TimeInfo","properties":{"hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hour","default":null,"description":"Hour in 24-hour format (0-23)"},"minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minute","default":null,"description":"Minute (0-59)"}},"description":"Time information for business hours."},{"type":"null"}],"default":null,"description":"Closing time"}},"description":"Operating hours period with open and close times."}},{"type":"null"}],"title":"Wednesday","default":null,"description":"Operating hours for Wednesday"}},"description":"Weekly timetable for business operating hours."},{"type":"null"}],"default":null,"description":"Weekly schedule with open/close times"},"current_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Status","default":null,"description":"Current operational status (e.g., 'open', 'close')"}},"description":"Business operating hours with timetable and current status."},{"type":"null"}],"default":null,"description":"Business operating hours and current status"},"price_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Level","default":null,"description":"Price range indicator (e.g., 'inexpensive' to 'very_expensive')"},"address_info":{"anyOf":[{"type":"object","title":"AddressInfo","properties":{"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip","default":null,"description":"Postal code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","default":null,"description":"City name"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region","default":null,"description":"State or province"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null,"description":"Street address"},"borough":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Borough","default":null,"description":"Borough or district name"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","default":null,"description":"ISO country code"}},"description":"Detailed address information for a business location."},{"type":"null"}],"default":null,"description":"Structured address information with granular components"},"hotel_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hotel Rating","default":null,"description":"Hotel star rating from 1 to 5 (only for hotels)"},"total_photos":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Photos","default":null,"description":"Total number of photos available for the business"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall position in SERP results"},"original_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Title","default":null,"description":"Original business name (untranslated)"},"rating_distribution":{"anyOf":[{"type":"object","title":"RatingDistribution","properties":{"1":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"1","default":null,"description":"Count of 1-star ratings"},"2":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"2","default":null,"description":"Count of 2-star ratings"},"3":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"3","default":null,"description":"Count of 3-star ratings"},"4":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"4","default":null,"description":"Count of 4-star ratings"},"5":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"5","default":null,"description":"Count of 5-star ratings"}},"description":"Breakdown of star ratings for a business."},{"type":"null"}],"default":null,"description":"Distribution of star ratings"},"additional_categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Additional Categories","default":null,"description":"Additional business classifications"}},"description":"Google Maps search result item for a business location."},{"type":"object","title":"MapsPaidItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Link to business website"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type (e.g., 'maps_paid_item')"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","default":null,"description":"Business contact phone number"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Business name displayed in sponsored listing"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Associated website domain"},"rating":{"anyOf":[{"type":"object","title":"RatingInfo","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","default":null,"description":"Average rating score value"},"rating_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating Max","default":null,"description":"Maximum rating value for the scale"},"rating_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rating Type","default":null,"description":"Rating scale type (e.g., 'Max5', 'Percents', 'CustomMax')"},"votes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes Count","default":null,"description":"Total number of reviews or votes"}},"description":"Rating information for business results."},{"type":"null"}],"default":null,"description":"Business rating information"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","default":null,"description":"Geographic latitude coordinate"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","default":null,"description":"Geographic longitude coordinate"},"main_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Main Image","default":null,"description":"URL to the main business profile image"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within identical type group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Overall position in SERP results"}},"description":"Sponsored Google Maps listing item."}],"properties":{}},"title":"Items","description":"Array of Google Maps search result items including both organic and sponsored listings"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Correction type (e.g., did_you_mean, showing_results_for)"},"keyword":{"type":"string","title":"Keyword","description":"Autocorrected search term"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search keyword (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Result retrieval timestamp in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify results in SERP"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of search results present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items returned in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code identifier"},"refinement_chips":{"type":"object","title":"Refinement Chips","description":"Search refinement options available","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results available from search engine"}},"description":"Result data containing Google Maps search results."},"title":"Result","description":"Array of Google Maps search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task information with Google Maps search results."},"title":"Tasks","description":"Array of task objects containing Google Maps search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_NEWS_TASK_GET_ADVANCED","name":"Get SERP Google News Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"TaskData","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"Data","description":"Echo of original POST request parameters (keyword, language_code, location_code, etc.)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResultData","properties":{"type":{"type":"string","title":"Type","description":"Search result type identifier (e.g., 'news')"},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"NewsSearchItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Direct URL to the news article"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type identifier (e.g., 'news_search')"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"News article headline or title"},"xpath":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xpath","default":null,"description":"XPath locator to the element on the page"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"Source domain of the news article"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null,"description":"Preview text or excerpt from the article"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"URL to the associated image for the news article"},"rectangle":{"anyOf":[{"type":"object","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"}]}},{"type":"null"}],"title":"Rectangle","default":null,"description":"Pixel coordinates of the element on SERP (x, y, width, height)"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Publication date and time of the article"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within results of the same type"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in all SERP results"}},"description":"Individual news search result item."},{"type":"object","title":"TopStoriesItem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Element type identifier (e.g., 'top_stories')"},"items":{"anyOf":[{"type":"array","items":{"type":"object","title":"TopStoriesElement","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Direct link to the article"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","default":null,"description":"Relative publication time (e.g., '2 hours ago')"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Article headline"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","default":null,"description":"News site domain"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":null,"description":"News outlet or source name"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"Article image URL"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"ISO format publication datetime"},"amp_version":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Amp Version","default":null,"description":"Whether AMP version is available"}},"description":"Individual story within top stories section."}},{"type":"null"}],"title":"Items","default":null,"description":"Array of nested story elements within top stories section"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Section heading for top stories"},"xpath":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xpath","default":null,"description":"XPath locator to the element on the page"},"position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position","default":null,"description":"Alignment position on the page (e.g., 'left')"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group","default":null,"description":"Position within results of the same type"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute","default":null,"description":"Absolute position in all SERP results"}},"description":"Top stories carousel/section result item."}],"properties":{}},"title":"Items","description":"Array of news search result items including news articles and top stories sections"},"spell":{"type":"object","title":"Spell","description":"Autocorrection details if the search query was corrected (null if none)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword used for the news query (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was retrieved in UTC format"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the news search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of elements present in the results (e.g., ['news_search', 'top_stories'])"},"items_count":{"type":"integer","title":"Items Count","description":"Number of news items in the results array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location code used for the request"},"refinement_chips":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"title":"Refinement Chips","description":"Available search refinement options"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of news results returned by the search engine"}},"description":"Result data containing Google News search results."},"title":"Result","description":"Array of news search result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with Google News search results."},"title":"Tasks","description":"Array of task objects containing Google News search results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (20000 for success)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Google Organic Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"faq":{"type":"array","items":{"type":"object","title":"FaqItem","properties":{"type":{"type":"string","title":"Type","description":"FAQ element type"},"title":{"type":"string","title":"Title","description":"Question text"},"description":{"type":"string","title":"Description","description":"Answer text"}},"description":"FAQ item in search results."},"title":"Faq","description":"FAQ section items"},"url":{"type":"string","title":"Url","description":"Result URL"},"page":{"type":"integer","title":"Page","description":"SERP page number"},"type":{"type":"string","title":"Type","description":"Element type (e.g., organic, paid, video)"},"links":{"type":"array","items":{"type":"object","title":"LinkInfo","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link information for search result items."},"title":"Links","description":"Additional links within the result"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price value"},"regular":{"type":"number","title":"Regular","description":"Regular price without discounts"},"currency":{"type":"string","title":"Currency","description":"ISO currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in a range"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether price represents a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for products in search results.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Result title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"images":{"type":"array","items":{"type":"object","title":"ImageInfo","properties":{"alt":{"type":"string","title":"Alt","description":"Alt text for the image"},"url":{"type":"string","title":"Url","description":"Image source URL"},"type":{"type":"string","title":"Type","description":"Image element type"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Image information in search results."},"title":"Images","description":"Images within the result"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum value for this rating scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for search result items.","additionalProperties":false},"is_image":{"type":"boolean","title":"Is Image","description":"Whether result contains an image"},"is_video":{"type":"boolean","title":"Is Video","description":"Whether result contains a video"},"position":{"type":"string","title":"Position","description":"Element position on the page (left/right)"},"cache_url":{"type":"string","title":"Cache Url","description":"Cached page URL"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate"},"y":{"type":"number","title":"Y","description":"Y coordinate"},"width":{"type":"number","title":"Width","description":"Rectangle width"},"height":{"type":"number","title":"Height","description":"Rectangle height"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the result publication"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"amp_version":{"type":"boolean","title":"Amp Version","description":"Whether result has an AMP version"},"description":{"type":"string","title":"Description","description":"Result description snippet"},"highlighted":{"type":"array","items":{"type":"string","properties":{}},"title":"Highlighted","description":"Highlighted keywords in the result"},"pre_snippet":{"type":"string","title":"Pre Snippet","description":"Information displayed before description"},"is_malicious":{"type":"boolean","title":"Is Malicious","description":"Whether result is marked as malicious"},"is_web_story":{"type":"boolean","title":"Is Web Story","description":"Whether result is a web story"},"website_name":{"type":"string","title":"Website Name","description":"Website name"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"},"extended_snippet":{"type":"string","title":"Extended Snippet","description":"Information displayed after description"},"about_this_result":{"type":"object","title":"AboutThisResultInfo","properties":{"url":{"type":"string","title":"Url","description":"Source information URL"},"type":{"type":"string","title":"Type","description":"Element type"},"source":{"type":"string","title":"Source","description":"Source name"},"language":{"type":"string","title":"Language","description":"Content language"},"location":{"type":"string","title":"Location","description":"Geographic location"},"source_url":{"type":"string","title":"Source Url","description":"Source URL"},"source_info":{"type":"string","title":"Source Info","description":"Additional source details"},"search_terms":{"type":"array","items":{"type":"string","properties":{}},"title":"Search Terms","description":"Search terms used"},"related_terms":{"type":"array","items":{"type":"string","properties":{}},"title":"Related Terms","description":"Related terms"}},"description":"About this result context information.","additionalProperties":false},"related_search_url":{"type":"string","title":"Related Search Url","description":"URL for related searches"},"is_featured_snippet":{"type":"boolean","title":"Is Featured Snippet","description":"Whether result is a featured snippet"}},"description":"Organic search result item from Google SERP."},"title":"Items","description":"Array of search result items including organic results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query used (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Google domain used for search"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of SERP pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code used"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"refinement_chips":{"type":"object","title":"RefinementChips","properties":{"type":{"type":"string","title":"Type","description":"Refinement chips type"},"items":{"type":"array","items":{"type":"object","title":"RefinementChipElement","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Type of refinement chip element"},"title":{"type":"string","title":"Title","description":"Refinement chip title text"},"domain":{"type":"string","title":"Domain","description":"Domain of the refinement chip"},"options":{"type":"array","items":{"type":"string","properties":{}},"title":"Options","description":"List of refinement options"}},"description":"Individual refinement chip for search refinement."},"title":"Items","description":"Array of refinement chip elements"}},"description":"Search refinement chip options.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results found"}},"description":"Individual task result containing Google Organic SERP data."},"title":"Result","description":"Array of Google SERP result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to API docs for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","important","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_GET_HTML_BY_ID","name":"Get SERP Google Organic Task HTML By ID","description":"Tool 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 Organic search results page after creating an organic task. Task results are available within 7 days of creation.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"SerpTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of SERP result (e.g., 'organic')"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Organic SERP page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or query specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the SERP HTML task containing the HTML content."},"title":"Result","description":"Array of SERP task results containing the Google Organic HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Organic SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_HTML_BY_ID","name":"Get SERP Google Organic Task HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"HtmlTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"HtmlTaskResult","properties":{"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google search results page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Search keyword specified in the original request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the HTML task containing the HTML content."},"title":"Result","description":"Array of HTML task results containing the Google SERP HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Organic SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Google Organic Task Regular By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"os":{"type":"string","title":"Os","description":"Operating system used for the search"},"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"tag":{"type":"string","title":"Tag","description":"Custom tag for task identification"},"device":{"type":"string","title":"Device","description":"Device type used for the search (e.g., 'desktop', 'mobile')"},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"priority":{"type":"integer","title":"Priority","description":"Priority level of the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{"type":"string","title":"Time","description":"Task execution duration in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"url":{"type":"string","title":"Url","description":"Full URL of the search result"},"page":{"type":"integer","title":"Page","description":"Page number where this result appears"},"type":{"type":"string","title":"Type","description":"Type of the SERP item (e.g., 'organic', 'paid', 'featured_snippet')"},"title":{"type":"string","title":"Title","description":"Title of the search result"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path shown in the result"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within a group of elements with identical type values"},"description":{"type":"string","title":"Description","description":"Description or snippet from the search result"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute rank in the SERP (across all types)"}},"description":"Organic search result item from Google SERP."},"title":"Items","description":"Array of SERP result items including organic results, paid results, and featured snippets"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Type of spell correction applied (e.g., 'did_you_mean', 'showing_results_for', 'no_results_found_for', 'including_results_for')"},"keyword":{"type":"string","title":"Keyword","description":"Corrected keyword suggestion from the search engine"}},"description":"Autocorrection information for the search query.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword (URL-decoded)"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify the search results on Google"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the query"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of SERP items found (e.g., 'organic', 'paid', 'featured_snippet')"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the items array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code parameter used in the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code parameter used in the request"},"refinement_chips":{"type":"object","title":"RefinementChips","properties":{"type":{"type":"string","title":"Type","description":"Type of refinement chips element"},"items":{"type":"array","items":{"type":"object","title":"RefinementChipsItem","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Type of refinement chip"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"},"domain":{"type":"string","title":"Domain","description":"Domain of the refinement URL"},"options":{"type":"array","items":{"type":"object","title":"RefinementChipOption","properties":{"url":{"type":"string","title":"Url","description":"URL for the refined search"},"type":{"type":"string","title":"Type","description":"Type of refinement chip option"},"title":{"type":"string","title":"Title","description":"Title of the refinement option"},"domain":{"type":"string","title":"Domain","description":"Domain of the refinement URL"}},"description":"Individual refinement chip option."},"title":"Options","description":"Array of refinement chip options"}},"description":"Individual refinement chip suggestion."},"title":"Items","description":"Array of refinement chip items"},"xpath":{"type":"string","title":"Xpath","description":"XPath location of the element on the page"}},"description":"Search refinement chip suggestions.","additionalProperties":false},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of results reported by the search engine"}},"description":"Complete SERP result data for a Google Organic search task."},"title":"Result","description":"Array of SERP results containing organic and paid search results, featured snippets, and other SERP features"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (e.g., 20000 for success, 10000-60000 range)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of result elements returned"},"status_message":{"type":"string","title":"Status Message","description":"Task execution message describing the outcome"}},"description":"Individual task information with SERP results."},"title":"Tasks","description":"Array of task objects containing SERP results"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code for the API response (10000-60000 range)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks that returned errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message about the request outcome"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_SEARCH_BY_IMAGE_HTML","name":"Get SERP Google Search By Image HTML","description":"Tool to retrieve raw HTML results for a Google Search By Image SERP task by ID. Use when you need to get the unprocessed HTML content of a Google reverse image search results page after creating a search by image task. Task results are available within 7 days of creation.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"SerpTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":{"type":"string"}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"SerpTaskResult","properties":{"type":{"type":"string","title":"Type","description":"Type of SERP result (e.g., 'search_by_image')"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Raw HTML content of the Google Search By Image SERP page"},"page":{"type":"integer","title":"Page","description":"Page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Keyword or query specified in the request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the task was completed in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the SERP HTML task containing the HTML content."},"title":"Result","description":"Array of SERP task results containing the Google Search By Image HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Search By Image SERP"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_GOOGLE_SEARCH_BY_IMAGE_HTML_BY_ID","name":"Get SERP Google Search By Image HTML By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the API request in DataForSEO credits"},"time":{"type":"string","title":"Time","description":"Total time taken for the API request in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"HtmlTaskData","properties":{"id":{"type":"string","title":"Id","description":"Task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task in DataForSEO credits"},"data":{"type":"object","title":"Data","description":"Original data sent in the task_post request","additionalProperties":true},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"API path segments used for the task"},"time":{"type":"string","title":"Time","description":"Time taken to complete the task in seconds"},"result":{"type":"array","items":{"type":"object","title":"HtmlSearchByImageResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type (search_by_image)"},"items":{"type":"array","items":{"type":"object","title":"HtmlResultItem","properties":{"date":{"type":"string","title":"Date","description":"Date and time when the HTML was retrieved in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"html":{"type":"string","title":"Html","description":"Full HTML document content of the search results page from Google Search By Image"},"page":{"type":"integer","title":"Page","description":"Serial page number of the returned HTML result"}},"description":"HTML result item containing the raw HTML page content."},"title":"Items","description":"Array of HTML result items containing the raw HTML page content"},"keyword":{"type":"string","title":"Keyword","description":"Decoded keyword from the original request"},"datetime":{"type":"string","title":"Datetime","description":"Date and time when the result was received in UTC format (YYYY-MM-DD HH:MM:SS +00:00)"},"se_domain":{"type":"string","title":"Se Domain","description":"Search engine domain used for the request (e.g., google.com)"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the result array"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the request (e.g., en)"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the request"}},"description":"Result data for the HTML task containing search by image results and HTML content."},"title":"Result","description":"Array of HTML search by image results containing the HTML content"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the task. 20000 indicates successful completion."},"result_count":{"type":"integer","title":"Result Count","description":"Number of result items returned"},"status_message":{"type":"string","title":"Status Message","description":"Status message providing information about the task execution"}},"description":"Task data containing the request parameters and HTML results."},"title":"Tasks","description":"Array of task data containing HTML results for Google Search By Image queries"},"version":{"type":"string","title":"Version","description":"API version"},"status_code":{"type":"integer","title":"Status Code","description":"Status code of the API response. 20000 indicates successful operation."},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in the response"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Number of tasks that encountered errors"},"status_message":{"type":"string","title":"Status Message","description":"Status message of the API response"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_ADVANCED_BY_ID","name":"Get SERP Naver Organic Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"cid":{"type":"string","title":"Cid","description":"Client ID for local results"},"faq":{"type":"array","items":{"type":"object","title":"FaqItem","properties":{"type":{"type":"string","title":"Type","description":"FAQ element type"},"title":{"type":"string","title":"Title","description":"Question text"},"description":{"type":"string","title":"Description","description":"Answer text"}},"description":"FAQ item in search results."},"title":"Faq","description":"FAQ section items"},"url":{"type":"string","title":"Url","description":"Result URL"},"page":{"type":"integer","title":"Page","description":"SERP page number"},"type":{"type":"string","title":"Type","description":"Element type (e.g., organic, paid, video, map, local_pack, related_searches, images)"},"extra":{"type":"object","title":"Extra","description":"Additional metadata (e.g., ad_aclk for paid results)","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]}},"items":{"type":"array","items":{"anyOf":[{"type":"object","title":"VideoElementInfo","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Video URL"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Video element type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Video title"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":null,"description":"Video source platform"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","default":null,"description":"Video duration or timestamp"}},"description":"Video element information in search results."},{"type":"object","title":"ImageInfo","properties":{"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt","default":null,"description":"Alt text for the image"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"Image source URL"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Image element type"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null,"description":"Direct image URL"}},"description":"Image information in search results."},{"type":"object","title":"RelatedSearchItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","default":null,"description":"URL for the related search"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null,"description":"Related search element type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null,"description":"Related search query text"}},"description":"Related search suggestion item."}],"properties":{}},"title":"Items","description":"Nested items for video, image, or related search types"},"links":{"type":"array","items":{"type":"object","title":"LinkInfo","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"ad_aclk":{"type":"string","title":"Ad Aclk","description":"Ad click identifier"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link information for search result items."},"title":"Links","description":"Additional links within the result"},"phone":{"type":"string","title":"Phone","description":"Phone number for local results"},"title":{"type":"string","title":"Title","description":"Result title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"images":{"type":"array","items":{"type":"object","title":"ImageInfo","properties":{"alt":{"type":"string","title":"Alt","description":"Alt text for the image"},"url":{"type":"string","title":"Url","description":"Image source URL"},"type":{"type":"string","title":"Type","description":"Image element type"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Image information in search results."},"title":"Images","description":"Images within the result"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum value for this rating scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents, CustomMax)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for search result items.","additionalProperties":false},"is_paid":{"type":"boolean","title":"Is Paid","description":"Whether result is a paid ad"},"is_image":{"type":"boolean","title":"Is Image","description":"Whether result contains images"},"is_video":{"type":"boolean","title":"Is Video","description":"Whether result is a video"},"position":{"type":"string","title":"Position","description":"Element position on the page (left/right)"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate"},"y":{"type":"number","title":"Y","description":"Y coordinate"},"width":{"type":"number","title":"Width","description":"Rectangle width"},"height":{"type":"number","title":"Height","description":"Rectangle height"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the result publication"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"description":{"type":"string","title":"Description","description":"Result description snippet"},"is_malicious":{"type":"boolean","title":"Is Malicious","description":"Whether result is marked as malicious"},"is_web_story":{"type":"boolean","title":"Is Web Story","description":"Whether result is a web story"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"},"description_rows":{"type":"array","items":{"type":"string","properties":{}},"title":"Description Rows","description":"Description text split into rows"},"is_featured_snippet":{"type":"boolean","title":"Is Featured Snippet","description":"Whether result is a featured snippet"}},"description":"Organic search result item from Naver SERP."},"title":"Items","description":"Array of search result items including organic results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query used (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Naver domain used for search"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of SERP pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code used"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results found"}},"description":"Individual task result containing Naver Organic SERP data."},"title":"Result","description":"Array of Naver SERP result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to API docs for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_GET_ADVANCED","name":"Get SERP Naver Organic Task (Advanced)","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier (UUID)"},"cost":{"type":"number","title":"Cost","description":"Task cost in USD"},"data":{"type":"object","title":"Data","description":"Original POST request parameters","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{}},{"type":"object","additionalProperties":true}]}},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path segments"},"time":{"type":"string","title":"Time","description":"Task execution time in seconds"},"result":{"type":"array","items":{"type":"object","title":"TaskResult","properties":{"type":{"type":"string","title":"Type","description":"Search engine type identifier"},"items":{"type":"array","items":{"type":"object","title":"OrganicItem","properties":{"faq":{"type":"array","items":{"type":"object","title":"FaqItem","properties":{"type":{"type":"string","title":"Type","description":"FAQ element type"},"title":{"type":"string","title":"Title","description":"Question text"},"description":{"type":"string","title":"Description","description":"Answer text"}},"description":"FAQ item in search results."},"title":"Faq","description":"FAQ section items"},"url":{"type":"string","title":"Url","description":"Result URL"},"page":{"type":"integer","title":"Page","description":"SERP page number"},"type":{"type":"string","title":"Type","description":"Element type (e.g., organic, paid, video)"},"links":{"type":"array","items":{"type":"object","title":"LinkInfo","properties":{"url":{"type":"string","title":"Url","description":"Link target URL"},"type":{"type":"string","title":"Type","description":"Link element type"},"title":{"type":"string","title":"Title","description":"Link display text"},"description":{"type":"string","title":"Description","description":"Link description"}},"description":"Link information for search result items."},"title":"Links","description":"Additional links within the result"},"price":{"type":"object","title":"PriceInfo","properties":{"current":{"type":"number","title":"Current","description":"Current price value"},"regular":{"type":"number","title":"Regular","description":"Regular price without discounts"},"currency":{"type":"string","title":"Currency","description":"ISO currency code"},"max_value":{"type":"number","title":"Max Value","description":"Maximum price in a range"},"is_price_range":{"type":"boolean","title":"Is Price Range","description":"Whether price represents a range"},"displayed_price":{"type":"string","title":"Displayed Price","description":"Price as displayed to users"}},"description":"Price information for products in search results.","additionalProperties":false},"title":{"type":"string","title":"Title","description":"Result title"},"xpath":{"type":"string","title":"Xpath","description":"XPath locator in DOM"},"domain":{"type":"string","title":"Domain","description":"Domain of the result"},"images":{"type":"array","items":{"type":"object","title":"ImageInfo","properties":{"alt":{"type":"string","title":"Alt","description":"Alt text for the image"},"url":{"type":"string","title":"Url","description":"Image source URL"},"type":{"type":"string","title":"Type","description":"Image element type"},"image_url":{"type":"string","title":"Image Url","description":"Direct image URL"}},"description":"Image information in search results."},"title":"Images","description":"Images within the result"},"rating":{"type":"object","title":"RatingInfo","properties":{"value":{"type":"number","title":"Value","description":"Numeric rating value"},"rating_max":{"type":"integer","title":"Rating Max","description":"Maximum value for this rating scale"},"rating_type":{"type":"string","title":"Rating Type","description":"Type of rating scale (e.g., Max5, Percents)"},"votes_count":{"type":"integer","title":"Votes Count","description":"Number of votes or reviews"}},"description":"Rating information for search result items.","additionalProperties":false},"position":{"type":"string","title":"Position","description":"Element position on the page (left/right)"},"cache_url":{"type":"string","title":"Cache Url","description":"Cached page URL"},"rectangle":{"type":"object","title":"RectangleInfo","properties":{"x":{"type":"number","title":"X","description":"X coordinate"},"y":{"type":"number","title":"Y","description":"Y coordinate"},"width":{"type":"number","title":"Width","description":"Rectangle width"},"height":{"type":"number","title":"Height","description":"Rectangle height"}},"description":"Positioning rectangle information for elements.","additionalProperties":false},"timestamp":{"type":"string","title":"Timestamp","description":"Timestamp of the result publication"},"breadcrumb":{"type":"string","title":"Breadcrumb","description":"Breadcrumb navigation path"},"rank_group":{"type":"integer","title":"Rank Group","description":"Position within same-type element group"},"description":{"type":"string","title":"Description","description":"Result description snippet"},"highlighted":{"type":"array","items":{"type":"string","properties":{}},"title":"Highlighted","description":"Highlighted keywords in the result"},"rank_absolute":{"type":"integer","title":"Rank Absolute","description":"Absolute position on the SERP"}},"description":"Organic search result item from Naver SERP."},"title":"Items","description":"Array of search result items including organic results"},"spell":{"type":"object","title":"SpellInfo","properties":{"type":{"type":"string","title":"Type","description":"Spell check type identifier"},"keyword":{"type":"string","title":"Keyword","description":"Original search keyword"}},"description":"Autocorrection details for search queries.","additionalProperties":false},"keyword":{"type":"string","title":"Keyword","description":"Search query used (decoded)"},"datetime":{"type":"string","title":"Datetime","description":"UTC timestamp of retrieval (YYYY-MM-DD HH:MM:SS +00:00)"},"check_url":{"type":"string","title":"Check Url","description":"Direct URL to verify search results"},"se_domain":{"type":"string","title":"Se Domain","description":"Naver domain used for search"},"item_types":{"type":"array","items":{"type":"string","properties":{}},"title":"Item Types","description":"Types of result elements present in SERP"},"items_count":{"type":"integer","title":"Items Count","description":"Number of items in the results array"},"pages_count":{"type":"integer","title":"Pages Count","description":"Number of SERP pages retrieved"},"language_code":{"type":"string","title":"Language Code","description":"Language code used"},"location_code":{"type":"integer","title":"Location Code","description":"Geographic location identifier"},"se_results_count":{"type":"integer","title":"Se Results Count","description":"Total number of search results found"}},"description":"Individual task result containing Naver Organic SERP data."},"title":"Result","description":"Array of Naver SERP result objects"},"status_code":{"type":"integer","title":"Status Code","description":"Task-specific status code (20000 = success)"},"result_count":{"type":"integer","title":"Result Count","description":"Number of elements in result array"},"status_message":{"type":"string","title":"Status Message","description":"Task informational message"}},"description":"Individual task object in the response."},"title":"Tasks","description":"Array of task objects"},"version":{"type":"string","title":"Version","description":"Current API version"},"status_code":{"type":"integer","title":"Status Code","description":"General status code (refer to API docs for full list)"},"tasks_count":{"type":"integer","title":"Tasks Count","description":"Number of tasks in array"},"tasks_error":{"type":"integer","title":"Tasks Error","description":"Count of tasks with errors"},"status_message":{"type":"string","title":"Status Message","description":"Informational message corresponding to status code"}}},"error":{"type":"string","description":"Error if any occurred during the execution of the action","default":"$undefined","example":"$undefined","enum":"$undefined","required":false},"successful":{"type":"boolean","description":"Whether or not the action execution was successful or not","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"scopes":[],"tags":["openWorldHint","readOnlyHint","idempotentHint","SERP"],"is_deprecated":false},{"slug":"DATAFORSEO_GET_SERP_NAVER_ORGANIC_TASK_REGULAR_BY_ID","name":"Get SERP Naver Organic Task Regular By ID","description":"Tool 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.","input_parameters":{"id":{"type":"string","description":"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.","default":"$undefined","example":"$undefined","enum":"$undefined","required":true}},"output_parameters":{"data":{"type":"object","description":"Data from the action execution","default":"$undefined","example":"$undefined","enum":"$undefined","required":true,"properties":{"cost":{"type":"number","title":"Cost","description":"Total cost of the request in USD"},"time":{"type":"string","title":"Time","description":"Total execution duration in seconds"},"tasks":{"type":"array","items":{"type":"object","title":"Task","properties":{"id":{"type":"string","title":"Id","description":"Unique task identifier in UUID format"},"cost":{"type":"number","title":"Cost","description":"Cost of the task execution in USD"},"data":{"type":"object","title":"TaskRequestData","properties":{"se":{"type":"string","title":"Se","description":"Search engine identifier"},"api":{"type":"string","title":"Api","description":"API endpoint identifier"},"keyword":{"type":"string","title":"Keyword","description":"Search query keyword"},"function":{"type":"string","title":"Function","description":"Function name used in the task"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the task"},"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the task"}},"description":"Echo of the original request parameters sent in the task_post request.","additionalProperties":false},"path":{"type":"array","items":{"type":"string","properties":{}},"title":"Path","description":"URL path components used for the task"},"time":{</article></body></html>

Dataforseo

Authentication Details

BASIC