{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"based-seo DataForSEO Gateway","version":"1.0.0","description":"Pay-per-call SEO/GEO API. Each billable operation is paid per request in USDC via x402 on Base - no account required. Send the request; on a 402, read the PAYMENT-REQUIRED header and retry with PAYMENT-SIGNATURE. Network: set via X402_NETWORK. Prices are exposed per operation as x-price-usd / x-price-confidence."},"servers":[{"url":"https://based-seo.com"}],"tags":[{"name":"AI Optimization API"},{"name":"App Data API"},{"name":"Appendix"},{"name":"Backlinks API"},{"name":"Business Data API"},{"name":"Content Analysis API"},{"name":"Content Generation API"},{"name":"DataForSEO Labs API"},{"name":"Domain Analytics API"},{"name":"Keywords Data API"},{"name":"Merchant API"},{"name":"OnPage API"},{"name":"SERP API"}],"paths":{"/api/v3/ai_optimization/ai_keyword_data/keywords_search_volume/live":{"post":{"operationId":"ai_optimization_ai_keyword_data_keywords_search_volume_live","summary":"Returns AI-tool search volume for last month plus 12-month trend for up to 1000 keywords ($0.01/task + $0.0001/keyword).","description":"Returns AI-tool search volume for last month plus 12-month trend for up to 1000 keywords ($0.01/task + $0.0001/keyword).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/ai_optimization/ai_keyword_data/locations_and_languages":{"get":{"operationId":"ai_optimization_ai_keyword_data_locations_and_languages","summary":"Reference list of supported locations and languages for AI Keyword Data.","description":"Reference list of supported locations and languages for AI Keyword Data.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/chat_gpt/llm_responses/live":{"post":{"operationId":"ai_optimization_chat_gpt_llm_responses_live","summary":"Returns a real-time structured ChatGPT response (base $0.0006 + underlying model token/web-search cost).","description":"Returns a real-time structured ChatGPT response (base $0.0006 + underlying model token/web-search cost).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"user_prompt":{"type":"string"},"model_name":{"type":"string"},"max_output_tokens":{"type":"string"},"web_search":{"type":"string"},"temperature":{"type":"string"},"system_message":{"type":"string"},"message_chain":{"type":"string"}},"required":["user_prompt","model_name"]}}}}}}},"/api/v3/ai_optimization/chat_gpt/llm_responses/models":{"get":{"operationId":"ai_optimization_chat_gpt_llm_responses_models","summary":"Reference list of available ChatGPT models for the LLM Responses endpoints.","description":"Reference list of available ChatGPT models for the LLM Responses endpoints.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/chat_gpt/llm_responses/task_post":{"post":{"operationId":"ai_optimization_chat_gpt_llm_responses_task_post","summary":"Queues a ChatGPT LLM response task ($0.01 prepayment, refunded to actual cost).","description":"Queues a ChatGPT LLM response task ($0.01 prepayment, refunded to actual cost).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"user_prompt":{"type":"string"},"model_name":{"type":"string"},"web_search":{"type":"string"},"max_output_tokens":{"type":"string"},"tag":{"type":"string"},"pingback_url":{"type":"string"},"postback_url":{"type":"string"}},"required":["user_prompt","model_name"]}}}}}}},"/api/v3/ai_optimization/chat_gpt/llm_scraper/languages":{"get":{"operationId":"ai_optimization_chat_gpt_llm_scraper_languages","summary":"Reference list of supported languages for the ChatGPT LLM Scraper.","description":"Reference list of supported languages for the ChatGPT LLM Scraper.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced":{"post":{"operationId":"ai_optimization_chat_gpt_llm_scraper_live_advanced","summary":"Returns real-time structured ChatGPT search results for a keyword (price varies by method/priority).","description":"Returns real-time structured ChatGPT search results for a keyword (price varies by method/priority).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"},"web_search":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/chat_gpt/llm_scraper/live/html":{"post":{"operationId":"ai_optimization_chat_gpt_llm_scraper_live_html","summary":"Returns real-time raw HTML of ChatGPT search results for a keyword (price varies by method/priority).","description":"Returns real-time raw HTML of ChatGPT search results for a keyword (price varies by method/priority).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/chat_gpt/llm_scraper/locations":{"get":{"operationId":"ai_optimization_chat_gpt_llm_scraper_locations","summary":"Reference list of supported locations for the ChatGPT LLM Scraper.","description":"Reference list of supported locations for the ChatGPT LLM Scraper.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/chat_gpt/llm_scraper/task_post":{"post":{"operationId":"ai_optimization_chat_gpt_llm_scraper_task_post","summary":"Queues a task to scrape ChatGPT search results for a keyword (price varies by method/priority).","description":"Queues a task to scrape ChatGPT search results for a keyword (price varies by method/priority).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"},"web_search":{"type":"string"},"priority":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/claude/llm_responses/live":{"post":{"operationId":"ai_optimization_claude_llm_responses_live","summary":"Returns a real-time structured Claude response (base $0.0006 + underlying model token/web-search cost).","description":"Returns a real-time structured Claude response (base $0.0006 + underlying model token/web-search cost).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"user_prompt":{"type":"string"},"model_name":{"type":"string"},"max_output_tokens":{"type":"string"},"web_search":{"type":"string"},"temperature":{"type":"string"},"system_message":{"type":"string"},"message_chain":{"type":"string"}},"required":["user_prompt","model_name"]}}}}}}},"/api/v3/ai_optimization/claude/llm_responses/models":{"get":{"operationId":"ai_optimization_claude_llm_responses_models","summary":"Reference list of available Claude models for the LLM Responses endpoints.","description":"Reference list of available Claude models for the LLM Responses endpoints.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/claude/llm_responses/task_post":{"post":{"operationId":"ai_optimization_claude_llm_responses_task_post","summary":"Queues a Claude LLM response task ($0.01 prepayment, refunded to actual cost).","description":"Queues a Claude LLM response task ($0.01 prepayment, refunded to actual cost).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"user_prompt":{"type":"string"},"model_name":{"type":"string"},"web_search":{"type":"string"},"max_output_tokens":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"}},"required":["user_prompt","model_name"]}}}}}}},"/api/v3/ai_optimization/gemini/llm_responses/live":{"post":{"operationId":"ai_optimization_gemini_llm_responses_live","summary":"Returns a real-time structured Gemini response (base $0.0006 + underlying model token/web-search cost).","description":"Returns a real-time structured Gemini response (base $0.0006 + underlying model token/web-search cost).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"user_prompt":{"type":"string"},"model_name":{"type":"string"},"max_output_tokens":{"type":"string"},"web_search":{"type":"string"},"temperature":{"type":"string"},"system_message":{"type":"string"},"message_chain":{"type":"string"}},"required":["user_prompt","model_name"]}}}}}}},"/api/v3/ai_optimization/gemini/llm_responses/models":{"get":{"operationId":"ai_optimization_gemini_llm_responses_models","summary":"Reference list of available Gemini models for the LLM Responses endpoints.","description":"Reference list of available Gemini models for the LLM Responses endpoints.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/gemini/llm_responses/task_post":{"post":{"operationId":"ai_optimization_gemini_llm_responses_task_post","summary":"Queues a Gemini LLM response task ($0.01 prepayment, refunded to actual cost).","description":"Queues a Gemini LLM response task ($0.01 prepayment, refunded to actual cost).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"user_prompt":{"type":"string"},"model_name":{"type":"string"},"web_search":{"type":"string"},"max_output_tokens":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"}},"required":["user_prompt","model_name"]}}}}}}},"/api/v3/ai_optimization/gemini/llm_scraper/languages":{"get":{"operationId":"ai_optimization_gemini_llm_scraper_languages","summary":"Reference list of supported languages for the Gemini LLM Scraper.","description":"Reference list of supported languages for the Gemini LLM Scraper.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/gemini/llm_scraper/live/advanced":{"post":{"operationId":"ai_optimization_gemini_llm_scraper_live_advanced","summary":"Returns real-time structured Gemini search results for a keyword (price varies by method/priority).","description":"Returns real-time structured Gemini search results for a keyword (price varies by method/priority).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"},"web_search":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/gemini/llm_scraper/live/html":{"post":{"operationId":"ai_optimization_gemini_llm_scraper_live_html","summary":"Returns real-time raw HTML of Gemini search results for a keyword (price varies by method/priority).","description":"Returns real-time raw HTML of Gemini search results for a keyword (price varies by method/priority).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/gemini/llm_scraper/locations":{"get":{"operationId":"ai_optimization_gemini_llm_scraper_locations","summary":"Reference list of supported locations for the Gemini LLM Scraper.","description":"Reference list of supported locations for the Gemini LLM Scraper.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/gemini/llm_scraper/task_post":{"post":{"operationId":"ai_optimization_gemini_llm_scraper_task_post","summary":"Queues a task to scrape Gemini search results for a keyword (price varies by method/priority).","description":"Queues a task to scrape Gemini search results for a keyword (price varies by method/priority).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"},"web_search":{"type":"string"},"priority":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/available_filters":{"get":{"operationId":"ai_optimization_llm_mentions_available_filters","summary":"Reference list of fields available for filtering LLM Mentions endpoints.","description":"Reference list of fields available for filtering LLM Mentions endpoints.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/llm_mentions/historical/live":{"post":{"operationId":"ai_optimization_llm_mentions_historical_live","summary":"Returns historical mention data over time for a target or keyword ($0.10/request + $0.001/row).","description":"Returns historical mention data over time for a target or keyword ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"keyword":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"llm_models":{"type":"string"}},"allOf":[{"anyOf":[{"required":["target"]},{"required":["keyword"]}]}]}}}}}}},"/api/v3/ai_optimization/llm_mentions/locations_and_languages":{"get":{"operationId":"ai_optimization_llm_mentions_locations_and_languages","summary":"Reference list of supported locations and languages for LLM Mentions.","description":"Reference list of supported locations and languages for LLM Mentions.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/ai_optimization/llm_mentions/multi_target_metrics/live":{"post":{"operationId":"ai_optimization_llm_mentions_multi_target_metrics_live","summary":"Returns and compares aggregated mention metrics for multiple targets across LLMs ($0.10/request + $0.001/row).","description":"Returns and compares aggregated mention metrics for multiple targets across LLMs ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"llm_models":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/search_mentions/live":{"post":{"operationId":"ai_optimization_llm_mentions_search_mentions_live","summary":"Returns individual keyword/brand/website mentions found in LLM answers ($0.10/request + $0.001/row; pay-as-you-go, no monthly commitment).","description":"Returns individual keyword/brand/website mentions found in LLM answers ($0.10/request + $0.001/row; pay-as-you-go, no monthly commitment).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"filters":{"type":"array"},"location_name":{"type":"string"},"language_name":{"type":"string"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/target_metrics_lite/live":{"post":{"operationId":"ai_optimization_llm_mentions_target_metrics_lite_live","summary":"Reduced-cost variant of target_metrics returning core mention metrics for a target.","description":"Reduced-cost variant of target_metrics returning core mention metrics for a target.","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"llm_models":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/target_metrics/live":{"post":{"operationId":"ai_optimization_llm_mentions_target_metrics_live","summary":"Returns aggregated mention metrics for a single target brand/domain across LLMs ($0.10/request + $0.001/row).","description":"Returns aggregated mention metrics for a single target brand/domain across LLMs ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"llm_models":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/timeseries_delta/live":{"post":{"operationId":"ai_optimization_llm_mentions_timeseries_delta_live","summary":"Returns the change (delta) in mention metrics between two periods ($0.10/request + $0.001/row).","description":"Returns the change (delta) in mention metrics between two periods ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"keyword":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"llm_models":{"type":"string"}},"allOf":[{"anyOf":[{"required":["target"]},{"required":["keyword"]}]}]}}}}}}},"/api/v3/ai_optimization/llm_mentions/timeseries_new_lost/live":{"post":{"operationId":"ai_optimization_llm_mentions_timeseries_new_lost_live","summary":"Returns newly gained and lost mentions between two periods ($0.10/request + $0.001/row).","description":"Returns newly gained and lost mentions between two periods ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"keyword":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"llm_models":{"type":"string"}},"allOf":[{"anyOf":[{"required":["target"]},{"required":["keyword"]}]}]}}}}}}},"/api/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories_lite/live":{"post":{"operationId":"ai_optimization_llm_mentions_top_mentioned_brand_categories_lite_live","summary":"Reduced-cost variant returning top mentioned brand categories for a keyword.","description":"Reduced-cost variant returning top mentioned brand categories for a keyword.","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories/live":{"post":{"operationId":"ai_optimization_llm_mentions_top_mentioned_brand_categories_live","summary":"Returns the brand categories most frequently mentioned by LLMs for a keyword ($0.10/request + $0.001/row).","description":"Returns the brand categories most frequently mentioned by LLMs for a keyword ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"filters":{"type":"array"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/top_mentioned_brands_lite/live":{"post":{"operationId":"ai_optimization_llm_mentions_top_mentioned_brands_lite_live","summary":"Reduced-cost variant returning top mentioned brands for a keyword.","description":"Reduced-cost variant returning top mentioned brands for a keyword.","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/top_mentioned_brands/live":{"post":{"operationId":"ai_optimization_llm_mentions_top_mentioned_brands_live","summary":"Returns the brands most frequently mentioned by LLMs for a keyword ($0.10/request + $0.001/row).","description":"Returns the brands most frequently mentioned by LLMs for a keyword ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"filters":{"type":"array"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/top_mentioned_domains_lite/live":{"post":{"operationId":"ai_optimization_llm_mentions_top_mentioned_domains_lite_live","summary":"Reduced-cost variant returning top mentioned domains for a keyword.","description":"Reduced-cost variant returning top mentioned domains for a keyword.","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/top_mentioned_domains/live":{"post":{"operationId":"ai_optimization_llm_mentions_top_mentioned_domains_live","summary":"Returns the domains most frequently cited/mentioned by LLMs for a keyword ($0.10/request + $0.001/row).","description":"Returns the domains most frequently cited/mentioned by LLMs for a keyword ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"filters":{"type":"array"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/top_mentioned_pages_lite/live":{"post":{"operationId":"ai_optimization_llm_mentions_top_mentioned_pages_lite_live","summary":"Reduced-cost variant returning top mentioned pages for a keyword.","description":"Reduced-cost variant returning top mentioned pages for a keyword.","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/llm_mentions/top_mentioned_pages/live":{"post":{"operationId":"ai_optimization_llm_mentions_top_mentioned_pages_live","summary":"Returns the pages most frequently cited/mentioned by LLMs for a keyword ($0.10/request + $0.001/row).","description":"Returns the pages most frequently cited/mentioned by LLMs for a keyword ($0.10/request + $0.001/row).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"llm_models":{"type":"string"},"filters":{"type":"array"},"limit":{"type":"integer"}},"required":["keyword"]}}}}}}},"/api/v3/ai_optimization/perplexity/llm_responses/live":{"post":{"operationId":"ai_optimization_perplexity_llm_responses_live","summary":"Returns a real-time structured Perplexity response (live only; base $0.0006 + underlying model token/web-search cost).","description":"Returns a real-time structured Perplexity response (live only; base $0.0006 + underlying model token/web-search cost).","tags":["AI Optimization API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"user_prompt":{"type":"string"},"model_name":{"type":"string"},"max_output_tokens":{"type":"string"},"web_search":{"type":"string"},"temperature":{"type":"string"},"system_message":{"type":"string"},"message_chain":{"type":"string"}},"required":["user_prompt","model_name"]}}}}}}},"/api/v3/ai_optimization/perplexity/llm_responses/models":{"get":{"operationId":"ai_optimization_perplexity_llm_responses_models","summary":"Reference list of available Perplexity models for the LLM Responses endpoint.","description":"Reference list of available Perplexity models for the LLM Responses endpoint.","tags":["AI Optimization API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/app_data/apple/app_info/task_post":{"post":{"operationId":"app_data_apple_app_info_task_post","summary":"Queue a task to retrieve detailed Apple App Store app info by app_id.","description":"Queue a task to retrieve detailed Apple App Store app info by app_id.","tags":["App Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["app_id","location_code","language_code"]}}}}}}},"/api/v3/app_data/apple/app_list/task_post":{"post":{"operationId":"app_data_apple_app_list_task_post","summary":"Queue a task to retrieve Apple App Store top-chart app rankings by category.","description":"Queue a task to retrieve Apple App Store top-chart app rankings by category.","tags":["App Data API"],"x-billable":true,"x-price-usd":0.0012,"x-price-formatted":"$0.0012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"category":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"app_collection":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["category","location_code","language_code"]}}}}}}},"/api/v3/app_data/apple/app_listings/categories":{"get":{"operationId":"app_data_apple_app_listings_categories","summary":"List available Apple App Store app listing categories.","description":"List available Apple App Store app listing categories.","tags":["App Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/app_data/apple/app_listings/search/live":{"post":{"operationId":"app_data_apple_app_listings_search_live","summary":"Search DataForSEO's Apple App Store app database in real time by title/description/category with filters ($0.1/task + $0.001/item).","description":"Search DataForSEO's Apple App Store app database in real time by title/description/category with filters ($0.1/task + $0.001/item).","tags":["App Data API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"title":{"type":"string"},"description":{"type":"string"},"categories":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"},"tag":{"type":"string"}}}}}}}}},"/api/v3/app_data/apple/app_reviews/task_post":{"post":{"operationId":"app_data_apple_app_reviews_task_post","summary":"Queue a task to retrieve Apple App Store user reviews by app_id.","description":"Queue a task to retrieve Apple App Store user reviews by app_id.","tags":["App Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["app_id","location_code","language_code"]}}}}}}},"/api/v3/app_data/apple/app_searches/task_post":{"post":{"operationId":"app_data_apple_app_searches_task_post","summary":"Queue a task to search Apple App Store apps by keyword.","description":"Queue a task to search Apple App Store apps by keyword.","tags":["App Data API"],"x-billable":true,"x-price-usd":0.0012,"x-price-formatted":"$0.0012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code"]}}}}}}},"/api/v3/app_data/apple/categories":{"get":{"operationId":"app_data_apple_categories","summary":"List Apple App Store categories supported by the App Data endpoints.","description":"List Apple App Store categories supported by the App Data endpoints.","tags":["App Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/app_data/apple/languages":{"get":{"operationId":"app_data_apple_languages","summary":"List languages supported by the Apple App Store App Data endpoints.","description":"List languages supported by the Apple App Store App Data endpoints.","tags":["App Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/app_data/apple/locations":{"get":{"operationId":"app_data_apple_locations","summary":"List locations supported by the Apple App Store App Data endpoints.","description":"List locations supported by the Apple App Store App Data endpoints.","tags":["App Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/app_data/google/app_info/task_post":{"post":{"operationId":"app_data_google_app_info_task_post","summary":"Queue a task to retrieve detailed Google Play app info by app_id.","description":"Queue a task to retrieve detailed Google Play app info by app_id.","tags":["App Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["app_id","location_code","language_code"]}}}}}}},"/api/v3/app_data/google/app_list/task_post":{"post":{"operationId":"app_data_google_app_list_task_post","summary":"Queue a task to retrieve Google Play top-chart app rankings for a category.","description":"Queue a task to retrieve Google Play top-chart app rankings for a category.","tags":["App Data API"],"x-billable":true,"x-price-usd":0.0012,"x-price-formatted":"$0.0012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"category":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"app_collection":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["category","location_code","language_code"]}}}}}}},"/api/v3/app_data/google/app_listings/categories":{"get":{"operationId":"app_data_google_app_listings_categories","summary":"List available Google Play app listing categories.","description":"List available Google Play app listing categories.","tags":["App Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/app_data/google/app_listings/search/live":{"post":{"operationId":"app_data_google_app_listings_search_live","summary":"Search DataForSEO's Google Play app database in real time by title/description/category with filters ($0.1/task + $0.001/item).","description":"Search DataForSEO's Google Play app database in real time by title/description/category with filters ($0.1/task + $0.001/item).","tags":["App Data API"],"x-billable":true,"x-price-usd":0.1,"x-price-formatted":"$0.1","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"title":{"type":"string"},"description":{"type":"string"},"categories":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"},"tag":{"type":"string"}}}}}}}}},"/api/v3/app_data/google/app_reviews/task_post":{"post":{"operationId":"app_data_google_app_reviews_task_post","summary":"Queue a task to retrieve Google Play user reviews by app_id.","description":"Queue a task to retrieve Google Play user reviews by app_id.","tags":["App Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"rating":{"type":"string"},"sort_by":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["app_id","location_code","language_code"]}}}}}}},"/api/v3/app_data/google/app_searches/task_post":{"post":{"operationId":"app_data_google_app_searches_task_post","summary":"Queue a task to search Google Play apps by keyword.","description":"Queue a task to search Google Play apps by keyword.","tags":["App Data API"],"x-billable":true,"x-price-usd":0.0012,"x-price-formatted":"$0.0012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code"]}}}}}}},"/api/v3/app_data/google/categories":{"get":{"operationId":"app_data_google_categories","summary":"List Google Play app categories supported by the App Data endpoints.","description":"List Google Play app categories supported by the App Data endpoints.","tags":["App Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/app_data/google/languages":{"get":{"operationId":"app_data_google_languages","summary":"List languages supported by the Google Play App Data endpoints.","description":"List languages supported by the Google Play App Data endpoints.","tags":["App Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/app_data/google/locations":{"get":{"operationId":"app_data_google_locations","summary":"List locations supported by the Google Play App Data endpoints.","description":"List locations supported by the Google Play App Data endpoints.","tags":["App Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/appendix/errors":{"get":{"operationId":"appendix_errors","summary":"Returns a JSON array of all possible DataForSEO status/error codes and messages (~51 codes).","description":"Returns a JSON array of all possible DataForSEO status/error codes and messages (~51 codes). Free.","tags":["Appendix"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/appendix/status":{"get":{"operationId":"appendix_status","summary":"Returns real-time operational status of all APIs and sub-endpoints (ok, major_outage, partial_outage, long_response_time, etc.).","description":"Returns real-time operational status of all APIs and sub-endpoints (ok, major_outage, partial_outage, long_response_time, etc.). Free; self rate-limited to ~10 calls/min.","tags":["Appendix"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/appendix/user_data":{"get":{"operationId":"appendix_user_data","summary":"Returns account data: money (deposited, balance, limits), rates (per-day/per-minute call limits & usage), price (cost per function), plus login, timezone and subscription expiry dates.","description":"Returns account data: money (deposited, balance, limits), rates (per-day/per-minute call limits & usage), price (cost per function), plus login, timezone and subscription expiry dates. Free; self rate-limited to ~6 calls/min.","tags":["Appendix"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/backlinks/anchors/live":{"post":{"operationId":"backlinks_anchors_live","summary":"Anchor texts pointing to a target with associated backlink and referring domain statistics.","description":"Anchor texts pointing to a target with associated backlink and referring domain statistics.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"internal_list_limit":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"backlinks_status_type":{"type":"string"},"backlinks_filters":{"type":"array"},"include_subdomains":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/available_filters":{"get":{"operationId":"backlinks_available_filters","summary":"Free full list of available filtering and sorting parameters supported across Backlinks endpoints.","description":"Free full list of available filtering and sorting parameters supported across Backlinks endpoints.","tags":["Backlinks API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/backlinks/backlinks/live":{"post":{"operationId":"backlinks_backlinks_live","summary":"Detailed list of backlinks pointing to a target with filtering, sorting and pagination.","description":"Detailed list of backlinks pointing to a target with filtering, sorting and pagination.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"mode":{"type":"string"},"custom_mode":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"offset":{"type":"integer"},"search_after_token":{"type":"string"},"limit":{"type":"integer"},"backlinks_status_type":{"type":"string"},"include_subdomains":{"type":"boolean"},"include_indirect_links":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/bulk_backlinks/live":{"post":{"operationId":"backlinks_bulk_backlinks_live","summary":"Total number of live backlinks pointing to up to 1,000 targets.","description":"Total number of live backlinks pointing to up to 1,000 targets.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/bulk_new_lost_backlinks/live":{"post":{"operationId":"backlinks_bulk_new_lost_backlinks_live","summary":"Counts of new and lost backlinks for up to 1,000 targets over a period (up to 365 days).","description":"Counts of new and lost backlinks for up to 1,000 targets over a period (up to 365 days).","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"date_from":{"type":"string"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/bulk_new_lost_referring_domains/live":{"post":{"operationId":"backlinks_bulk_new_lost_referring_domains_live","summary":"Counts of new and lost referring domains for up to 1,000 targets over a period (up to 365 days).","description":"Counts of new and lost referring domains for up to 1,000 targets over a period (up to 365 days).","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"date_from":{"type":"string"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/bulk_pages_summary/live":{"post":{"operationId":"backlinks_bulk_pages_summary_live","summary":"Summary backlink metrics for up to 1,000 pages/domains (max 100 distinct domains) in one request.","description":"Summary backlink metrics for up to 1,000 pages/domains (max 100 distinct domains) in one request.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"include_subdomains":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/bulk_ranks/live":{"post":{"operationId":"backlinks_bulk_ranks_live","summary":"Backlink rank scores (0-1000 or 0-100) for up to 1,000 domains, subdomains or pages in one request.","description":"Backlink rank scores (0-1000 or 0-100) for up to 1,000 domains, subdomains or pages in one request.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/bulk_referring_domains/live":{"post":{"operationId":"backlinks_bulk_referring_domains_live","summary":"Count of referring domains pointing to up to 1,000 targets.","description":"Count of referring domains pointing to up to 1,000 targets.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/bulk_spam_score/live":{"post":{"operationId":"backlinks_bulk_spam_score_live","summary":"Spam scores (0-100) for up to 1,000 domains, subdomains or pages.","description":"Spam scores (0-100) for up to 1,000 domains, subdomains or pages.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/competitors/live":{"post":{"operationId":"backlinks_competitors_live","summary":"Competitor domains that share a similar backlink profile with the target, ranked by intersection.","description":"Competitor domains that share a similar backlink profile with the target, ranked by intersection.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"main_domain":{"type":"string"},"exclude_large_domains":{"type":"string"},"exclude_internal_backlinks":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/domain_intersection/live":{"post":{"operationId":"backlinks_domain_intersection_live","summary":"Referring domains that link to multiple specified targets (up to 20), with optional exclusions.","description":"Referring domains that link to multiple specified targets (up to 20), with optional exclusions.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"exclude_targets":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"internal_list_limit":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"backlinks_status_type":{"type":"string"},"include_subdomains":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"intersection_mode":{"type":"string"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/domain_pages_summary/live":{"post":{"operationId":"backlinks_domain_pages_summary_live","summary":"Summary backlink metrics (backlinks, referring domains, spam score, link types) for each page of a target.","description":"Summary backlink metrics (backlinks, referring domains, spam score, link types) for each page of a target.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"internal_list_limit":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"backlinks_status_type":{"type":"string"},"backlinks_filters":{"type":"array"},"include_subdomains":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/domain_pages/live":{"post":{"operationId":"backlinks_domain_pages_live","summary":"Pages of a target domain with the highest and lowest number of backlinks and related page metrics.","description":"Pages of a target domain with the highest and lowest number of backlinks and related page metrics.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"internal_list_limit":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"backlinks_status_type":{"type":"string"},"backlinks_filters":{"type":"array"},"include_subdomains":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/errors":{"post":{"operationId":"backlinks_errors","summary":"Free list of Backlinks API tasks that returned errors within the past 7 days.","description":"Free list of Backlinks API tasks that returned errors within the past 7 days.","tags":["Backlinks API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}},"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"filtered_function":{"type":"string"},"datetime_from":{"type":"string"},"datetime_to":{"type":"string"}}}}}}}}},"/api/v3/backlinks/history/live":{"post":{"operationId":"backlinks_history_live","summary":"Month-by-month historical backlink and referring domain metrics for a domain from January 2019 onward.","description":"Month-by-month historical backlink and referring domain metrics for a domain from January 2019 onward.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/id_list":{"post":{"operationId":"backlinks_id_list","summary":"Free list of task IDs and metadata for previously set Backlinks API tasks within a datetime range.","description":"Free list of task IDs and metadata for previously set Backlinks API tasks within a datetime range.","tags":["Backlinks API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}},"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"datetime_from":{"type":"string"},"datetime_to":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"sort":{"type":"string"},"include_metadata":{"type":"string"}},"required":["datetime_from","datetime_to"]}}}}}}},"/api/v3/backlinks/index":{"get":{"operationId":"backlinks_index","summary":"Free current volume of the backlinks database (backlinks, domains, pages) with 12-month history.","description":"Free current volume of the backlinks database (backlinks, domains, pages) with 12-month history.","tags":["Backlinks API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/backlinks/page_intersection/live":{"post":{"operationId":"backlinks_page_intersection_live","summary":"Referring pages that link to multiple specified targets (up to 20), useful for link-gap analysis.","description":"Referring pages that link to multiple specified targets (up to 20), useful for link-gap analysis.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"exclude_targets":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"internal_list_limit":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"backlinks_status_type":{"type":"string"},"include_subdomains":{"type":"boolean"},"include_indirect_links":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"intersection_mode":{"type":"string"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/backlinks/referring_domains/live":{"post":{"operationId":"backlinks_referring_domains_live","summary":"Backlink data aggregated by referring domain, with per-domain rank, counts, spam score and first-seen dates.","description":"Backlink data aggregated by referring domain, with per-domain rank, counts, spam score and first-seen dates.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"internal_list_limit":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"backlinks_status_type":{"type":"string"},"backlinks_filters":{"type":"array"},"include_subdomains":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/referring_networks/live":{"post":{"operationId":"backlinks_referring_networks_live","summary":"Referring IP addresses or subnets pointing to a target with per-network backlink statistics.","description":"Referring IP addresses or subnets pointing to a target with per-network backlink statistics.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"network_address_type":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"internal_list_limit":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"backlinks_status_type":{"type":"string"},"backlinks_filters":{"type":"array"},"include_subdomains":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/summary/live":{"post":{"operationId":"backlinks_summary_live","summary":"Complete overview of a target's backlink profile including rank, referring domains, link types and platform metrics.","description":"Complete overview of a target's backlink profile including rank, referring domains, link types and platform metrics.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"include_subdomains":{"type":"boolean"},"include_indirect_links":{"type":"boolean"},"exclude_internal_backlinks":{"type":"boolean"},"internal_list_limit":{"type":"integer"},"backlinks_status_type":{"type":"string"},"backlinks_filters":{"type":"array"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/timeseries_new_lost_summary/live":{"post":{"operationId":"backlinks_timeseries_new_lost_summary_live","summary":"Counts of new and lost backlinks and referring domains for a target grouped over a chosen time range.","description":"Counts of new and lost backlinks and referring domains for a target grouped over a chosen time range.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"group_range":{"type":"string"},"include_subdomains":{"type":"boolean"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/backlinks/timeseries_summary/live":{"post":{"operationId":"backlinks_timeseries_summary_live","summary":"Historical backlink overview metrics for a target grouped by day, week, month or year from 2019 onward.","description":"Historical backlink overview metrics for a target grouped by day, week, month or year from 2019 onward.","tags":["Backlinks API"],"x-billable":true,"x-price-usd":0.02,"x-price-formatted":"$0.02","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"group_range":{"type":"string"},"include_subdomains":{"type":"boolean"},"rank_scale":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/business_data/business_listings/categories":{"get":{"operationId":"business_data_business_listings_categories","summary":"Reference endpoint returning the list of available Google Maps business categories.","description":"Reference endpoint returning the list of available Google Maps business categories.","tags":["Business Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/business_data/business_listings/categories_aggregation/live":{"post":{"operationId":"business_data_business_listings_categories_aggregation_live","summary":"Returns aggregated counts of related business categories/attributes; $0.012 task + $0.00036/item.","description":"Returns aggregated counts of related business categories/attributes; $0.012 task + $0.00036/item.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"categories":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"is_claimed":{"type":"string"},"location_coordinate":{"type":"string"},"initial_dataset_filters":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"internal_list_limit":{"type":"integer"},"tag":{"type":"string"}}}}}}}}},"/api/v3/business_data/business_listings/locations":{"get":{"operationId":"business_data_business_listings_locations","summary":"Reference endpoint returning locations supported by the Business Listings database.","description":"Reference endpoint returning locations supported by the Business Listings database.","tags":["Business Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/business_data/business_listings/search/live":{"post":{"operationId":"business_data_business_listings_search_live","summary":"Returns business entities listed on Google Maps filtered by category/location; $0.012 task + $0.00036/item.","description":"Returns business entities listed on Google Maps filtered by category/location; $0.012 task + $0.00036/item.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"categories":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"is_claimed":{"type":"string"},"location_coordinate":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"},"tag":{"type":"string"}}}}}}}}},"/api/v3/business_data/google/extended_reviews/task_post":{"post":{"operationId":"business_data_google_extended_reviews_task_post","summary":"Sets a task to collect Google reviews plus third-party reviews (Tripadvisor, Yelp); billed per 20 reviews.","description":"Sets a task to collect Google reviews plus third-party reviews (Tripadvisor, Yelp); billed per 20 reviews.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"allOf":[{"anyOf":[{"required":["keyword"]},{"required":["cid"]},{"required":["place_id"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/hotel_info/live/advanced":{"post":{"operationId":"business_data_google_hotel_info_live_advanced","summary":"Returns structured (advanced) Google Hotels entity info immediately.","description":"Returns structured (advanced) Google Hotels entity info immediately.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.004,"x-price-formatted":"$0.004","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"hotel_identifier":{"type":"string"},"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"check_in":{"type":"string"},"check_out":{"type":"string"},"currency":{"type":"string"},"adults":{"type":"string"},"children":{"type":"string"},"load_prices_by_dates":{"type":"string"},"prices_start_date":{"type":"string"},"prices_end_date":{"type":"string"},"prices_date_range":{"type":"string"},"tag":{"type":"string"}},"allOf":[{"anyOf":[{"required":["hotel_identifier"]},{"required":["keyword"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/hotel_info/live/html":{"post":{"operationId":"business_data_google_hotel_info_live_html","summary":"Returns raw HTML of a Google Hotels entity page immediately.","description":"Returns raw HTML of a Google Hotels entity page immediately.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.004,"x-price-formatted":"$0.004","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"hotel_identifier":{"type":"string"},"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"check_in":{"type":"string"},"check_out":{"type":"string"},"currency":{"type":"string"},"adults":{"type":"string"},"children":{"type":"string"},"tag":{"type":"string"}},"allOf":[{"anyOf":[{"required":["hotel_identifier"]},{"required":["keyword"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/hotel_info/task_post":{"post":{"operationId":"business_data_google_hotel_info_task_post","summary":"Sets a task to fetch detailed info and pricing for a single Google Hotels entity.","description":"Sets a task to fetch detailed info and pricing for a single Google Hotels entity.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"hotel_identifier":{"type":"string"},"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"priority":{"type":"integer"},"check_in":{"type":"string"},"check_out":{"type":"string"},"currency":{"type":"string"},"adults":{"type":"string"},"children":{"type":"string"},"load_prices_by_dates":{"type":"string"},"prices_start_date":{"type":"string"},"prices_end_date":{"type":"string"},"prices_date_range":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"allOf":[{"anyOf":[{"required":["hotel_identifier"]},{"required":["keyword"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/hotel_searches/live":{"post":{"operationId":"business_data_google_hotel_searches_live","summary":"Returns a Google Hotels SERP immediately for a location/dates.","description":"Returns a Google Hotels SERP immediately for a location/dates.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.004,"x-price-formatted":"$0.004","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"keyword":{"type":"string"},"check_in":{"type":"string"},"check_out":{"type":"string"},"currency":{"type":"string"},"adults":{"type":"string"},"children":{"type":"string"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"stars":{"type":"string"},"min_rating":{"type":"string"},"amenities":{"type":"string"},"free_cancellation":{"type":"string"},"tag":{"type":"string"}},"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/hotel_searches/task_post":{"post":{"operationId":"business_data_google_hotel_searches_task_post","summary":"Sets a task to fetch a Google Hotels SERP of hotel entities for a location/dates.","description":"Sets a task to fetch a Google Hotels SERP of hotel entities for a location/dates.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"keyword":{"type":"string"},"check_in":{"type":"string"},"check_out":{"type":"string"},"currency":{"type":"string"},"adults":{"type":"string"},"children":{"type":"string"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"stars":{"type":"string"},"min_rating":{"type":"string"},"amenities":{"type":"string"},"free_cancellation":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/languages":{"get":{"operationId":"business_data_google_languages","summary":"Reference endpoint returning languages supported by the Google business data endpoints.","description":"Reference endpoint returning languages supported by the Google business data endpoints.","tags":["Business Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/business_data/google/locations":{"get":{"operationId":"business_data_google_locations","summary":"Reference endpoint returning locations supported by the Google business data endpoints.","description":"Reference endpoint returning locations supported by the Google business data endpoints.","tags":["Business Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/business_data/google/my_business_info/live":{"post":{"operationId":"business_data_google_my_business_info_live","summary":"Returns Google Business Profile info immediately without separate POST/GET.","description":"Returns Google Business Profile info immediately without separate POST/GET.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.0054,"x-price-formatted":"$0.0054","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"allOf":[{"anyOf":[{"required":["keyword"]},{"required":["cid"]},{"required":["place_id"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/my_business_info/task_post":{"post":{"operationId":"business_data_google_my_business_info_task_post","summary":"Sets a task to retrieve Google Business Profile info (rating, address, hours, attributes) for a business.","description":"Sets a task to retrieve Google Business Profile info (rating, address, hours, attributes) for a business.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.0015,"x-price-formatted":"$0.0015","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"allOf":[{"anyOf":[{"required":["keyword"]},{"required":["cid"]},{"required":["place_id"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/my_business_updates/task_post":{"post":{"operationId":"business_data_google_my_business_updates_task_post","summary":"Sets a task to fetch posts/updates published on a Google Business Profile.","description":"Sets a task to fetch posts/updates published on a Google Business Profile.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.0015,"x-price-formatted":"$0.0015","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"priority":{"type":"integer"},"depth":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"allOf":[{"anyOf":[{"required":["keyword"]},{"required":["cid"]},{"required":["place_id"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/questions_and_answers/live":{"post":{"operationId":"business_data_google_questions_and_answers_live","summary":"Returns questions and answers for a Google Business Profile immediately.","description":"Returns questions and answers for a Google Business Profile immediately.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"depth":{"type":"integer"},"tag":{"type":"string"}},"allOf":[{"anyOf":[{"required":["keyword"]},{"required":["cid"]},{"required":["place_id"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/questions_and_answers/task_post":{"post":{"operationId":"business_data_google_questions_and_answers_task_post","summary":"Sets a task to collect questions and answers from a Google Business Profile; billed per SERP of 20.","description":"Sets a task to collect questions and answers from a Google Business Profile; billed per SERP of 20.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"allOf":[{"anyOf":[{"required":["keyword"]},{"required":["cid"]},{"required":["place_id"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/google/reviews/task_post":{"post":{"operationId":"business_data_google_reviews_task_post","summary":"Sets a task to collect Google reviews (up to depth 4490) for a business; billed per 10 reviews.","description":"Sets a task to collect Google reviews (up to depth 4490) for a business; billed per 10 reviews.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"location_coordinate":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"allOf":[{"anyOf":[{"required":["keyword"]},{"required":["cid"]},{"required":["place_id"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]},{"required":["location_coordinate"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/business_data/social_media/facebook/live":{"post":{"operationId":"business_data_social_media_facebook_live","summary":"Returns Facebook like/share counts for target page URLs (deprecated; no longer listed in current docs).","description":"Returns Facebook like/share counts for target page URLs (deprecated; no longer listed in current docs).","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/business_data/social_media/pinterest/live":{"post":{"operationId":"business_data_social_media_pinterest_live","summary":"Returns Pinterest pin (save) counts for up to 10 target page URLs; billed per URL.","description":"Returns Pinterest pin (save) counts for up to 10 target page URLs; billed per URL.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/business_data/social_media/reddit/live":{"post":{"operationId":"business_data_social_media_reddit_live","summary":"Returns Reddit share/interaction counts for target page URLs (deprecated; no longer listed in current docs).","description":"Returns Reddit share/interaction counts for target page URLs (deprecated; no longer listed in current docs).","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/business_data/tripadvisor/reviews/task_post":{"post":{"operationId":"business_data_tripadvisor_reviews_task_post","summary":"Sets a task to collect Tripadvisor reviews for a business page; billed per 10 reviews.","description":"Sets a task to collect Tripadvisor reviews for a business page; billed per 10 reviews.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"url_path":{"type":"string"},"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"priority":{"type":"integer"},"ratings":{"type":"string"},"visit_type":{"type":"string"},"months":{"type":"string"},"search_reviews_keyword":{"type":"string"},"translate_reviews":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"allOf":[{"anyOf":[{"required":["url_path"]},{"required":["keyword"]}]},{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]}]}}}}}}},"/api/v3/business_data/tripadvisor/search/task_post":{"post":{"operationId":"business_data_tripadvisor_search_task_post","summary":"Sets a task to search Tripadvisor for businesses/places by keyword; billed per 30 results.","description":"Sets a task to search Tripadvisor for businesses/places by keyword; billed per 30 results.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"priority":{"type":"integer"},"depth":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]}]}}}}}}},"/api/v3/business_data/trustpilot/reviews/task_post":{"post":{"operationId":"business_data_trustpilot_reviews_task_post","summary":"Sets a task to collect Trustpilot reviews for a business domain; billed per 20 reviews.","description":"Sets a task to collect Trustpilot reviews for a business domain; billed per 20 reviews.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"domain":{"type":"string"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["domain"]}}}}}}},"/api/v3/business_data/trustpilot/search/task_post":{"post":{"operationId":"business_data_trustpilot_search_task_post","summary":"Sets a task to search Trustpilot for business profiles by name/category; billed per 10 results.","description":"Sets a task to search Trustpilot for business profiles by name/category; billed per 10 results.","tags":["Business Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"priority":{"type":"integer"},"depth":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/content_analysis/available_filters":{"get":{"operationId":"content_analysis_available_filters","summary":"Returns the list of filters usable with Content Analysis endpoints (free helper).","description":"Returns the list of filters usable with Content Analysis endpoints (free helper).","tags":["Content Analysis API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/content_analysis/categories":{"get":{"operationId":"content_analysis_categories","summary":"Returns the list of available content categories and their codes (free helper).","description":"Returns the list of available content categories and their codes (free helper).","tags":["Content Analysis API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/content_analysis/category_trends/live":{"post":{"operationId":"content_analysis_category_trends_live","summary":"Citation trends by date within a target content category; $0.024/request + $0.000036/row.","description":"Citation trends by date within a target content category; $0.024/request + $0.000036/row.","tags":["Content Analysis API"],"x-billable":true,"x-price-usd":0.024,"x-price-formatted":"$0.024","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"category_code":{"type":"integer"},"date_from":{"type":"string"},"date_to":{"type":"string"},"date_group":{"type":"string"},"positive_connotation_threshold":{"type":"string"},"internal_list_limit":{"type":"integer"},"initial_dataset_filters":{"type":"string"}},"required":["category_code"]}}}}}}},"/api/v3/content_analysis/errors":{"post":{"operationId":"content_analysis_errors","summary":"Returns the list of errors that occurred during Content Analysis task processing (free helper).","description":"Returns the list of errors that occurred during Content Analysis task processing (free helper).","tags":["Content Analysis API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}},"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}}}}},"/api/v3/content_analysis/id_list":{"post":{"operationId":"content_analysis_id_list","summary":"Returns task IDs and metadata for Content Analysis tasks created in a time range (free helper).","description":"Returns task IDs and metadata for Content Analysis tasks created in a time range (free helper).","tags":["Content Analysis API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}},"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"datetime_from":{"type":"string"},"datetime_to":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"include_metadata":{"type":"string"}},"required":["datetime_from","datetime_to"]}}}}}}},"/api/v3/content_analysis/languages":{"get":{"operationId":"content_analysis_languages","summary":"Returns the list of supported languages for Content Analysis (free helper).","description":"Returns the list of supported languages for Content Analysis (free helper).","tags":["Content Analysis API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/content_analysis/locations":{"get":{"operationId":"content_analysis_locations","summary":"Returns the list of supported locations for Content Analysis (free helper).","description":"Returns the list of supported locations for Content Analysis (free helper).","tags":["Content Analysis API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/content_analysis/phrase_trends/live":{"post":{"operationId":"content_analysis_phrase_trends_live","summary":"Detailed citation statistics by date for the target keyword over a time range; $0.024/request + $0.000036/row.","description":"Detailed citation statistics by date for the target keyword over a time range; $0.024/request + $0.000036/row.","tags":["Content Analysis API"],"x-billable":true,"x-price-usd":0.024,"x-price-formatted":"$0.024","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"date_group":{"type":"string"},"page_type":{"type":"string"},"positive_connotation_threshold":{"type":"string"},"internal_list_limit":{"type":"integer"},"initial_dataset_filters":{"type":"string"}},"required":["keyword","date_from"]}}}}}}},"/api/v3/content_analysis/rating_distribution/live":{"post":{"operationId":"content_analysis_rating_distribution_live","summary":"Returns the distribution of citation statistics by content rating value; $0.024/request + $0.000036/row.","description":"Returns the distribution of citation statistics by content rating value; $0.024/request + $0.000036/row.","tags":["Content Analysis API"],"x-billable":true,"x-price-usd":0.024,"x-price-formatted":"$0.024","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"page_type":{"type":"string"},"rating_type":{"type":"string"},"positive_connotation_threshold":{"type":"string"},"initial_dataset_filters":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/content_analysis/search/live":{"post":{"operationId":"content_analysis_search_live","summary":"Returns detailed citation data (mentions) available for the target keyword; $0.024/request + $0.000036/row.","description":"Returns detailed citation data (mentions) available for the target keyword; $0.024/request + $0.000036/row.","tags":["Content Analysis API"],"x-billable":true,"x-price-usd":0.024,"x-price-formatted":"$0.024","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"keyword_fields":{"type":"string"},"page_type":{"type":"string"},"search_mode":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"search_after_token":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/content_analysis/sentiment_analysis/live":{"post":{"operationId":"content_analysis_sentiment_analysis_live","summary":"Returns citation statistics broken down by sentiment polarity and emotional connotations; $0.024/request + $0.000036/row.","description":"Returns citation statistics broken down by sentiment polarity and emotional connotations; $0.024/request + $0.000036/row.","tags":["Content Analysis API"],"x-billable":true,"x-price-usd":0.024,"x-price-formatted":"$0.024","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"page_type":{"type":"string"},"positive_connotation_threshold":{"type":"string"},"internal_list_limit":{"type":"integer"},"initial_dataset_filters":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/content_analysis/summary/live":{"post":{"operationId":"content_analysis_summary_live","summary":"Complete overview of citation data (domains, sentiment, categories, distribution) for the target keyword; $0.024/request + $0.000036/row.","description":"Complete overview of citation data (domains, sentiment, categories, distribution) for the target keyword; $0.024/request + $0.000036/row.","tags":["Content Analysis API"],"x-billable":true,"x-price-usd":0.024,"x-price-formatted":"$0.024","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"page_type":{"type":"string"},"internal_list_limit":{"type":"integer"},"positive_connotation_threshold":{"type":"string"},"initial_dataset_filters":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/content_generation/check_grammar/languages":{"get":{"operationId":"content_generation_check_grammar_languages","summary":"Returns languages supported by Check Grammar (free helper).","description":"Returns languages supported by Check Grammar (free helper). DEPRECATED/removed from current docs.","tags":["Content Generation API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/content_generation/check_grammar/live":{"post":{"operationId":"content_generation_check_grammar_live","summary":"Provides grammar and spelling corrections for the text (1-10000 tokens); $0.00001 per request token.","description":"Provides grammar and spelling corrections for the text (1-10000 tokens); $0.00001 per request token. DEPRECATED/removed from current docs.","tags":["Content Generation API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"text":{"type":"string"},"language_code":{"type":"string"},"language_name":{"type":"string"},"tag":{"type":"string"}},"required":["text"],"allOf":[{"anyOf":[{"required":["language_code"]},{"required":["language_name"]}]}]}}}}}}},"/api/v3/content_generation/generate_meta_tags/live":{"post":{"operationId":"content_generation_generate_meta_tags_live","summary":"Generates title and description meta tags for a text (1-500 tokens); $0.001 per task.","description":"Generates title and description meta tags for a text (1-500 tokens); $0.001 per task. DEPRECATED/removed from current docs.","tags":["Content Generation API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"text":{"type":"string"},"creativity_index":{"type":"number"},"tag":{"type":"string"}},"required":["text"]}}}}}}},"/api/v3/content_generation/generate_sub_topics/live":{"post":{"operationId":"content_generation_generate_sub_topics_live","summary":"Generates 10 subtopics for a specified topic (1-50 tokens); $0.0001 per task.","description":"Generates 10 subtopics for a specified topic (1-50 tokens); $0.0001 per task. DEPRECATED/removed from current docs.","tags":["Content Generation API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"topic":{"type":"string"},"creativity_index":{"type":"number"},"tag":{"type":"string"}},"required":["topic"]}}}}}}},"/api/v3/content_generation/generate_text/live":{"post":{"operationId":"content_generation_generate_text_live","summary":"Generates text based on a specified topic; $0.00005 per new token.","description":"Generates text based on a specified topic; $0.00005 per new token. DEPRECATED/removed from current docs.","tags":["Content Generation API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"topic":{"type":"string"},"word_count":{"type":"integer"},"sub_topics":{"type":"string"},"description":{"type":"string"},"meta_keywords":{"type":"string"},"creativity_index":{"type":"number"},"include_conclusion":{"type":"string"},"supplement_token":{"type":"string"},"tag":{"type":"string"}},"required":["topic","word_count"]}}}}}}},"/api/v3/content_generation/generate/live":{"post":{"operationId":"content_generation_generate_live","summary":"Generates a continuation of the provided text (1-500 tokens input); $0.00005 per new token.","description":"Generates a continuation of the provided text (1-500 tokens input); $0.00005 per new token. DEPRECATED/removed from current docs.","tags":["Content Generation API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"text":{"type":"string"},"max_new_tokens":{"type":"string"},"max_tokens":{"type":"string"},"creativity_index":{"type":"number"},"token_repetition_penalty":{"type":"string"},"top_k":{"type":"string"},"top_p":{"type":"string"},"temperature":{"type":"string"},"stop_words":{"type":"string"},"avoid_starting_words":{"type":"string"},"tag":{"type":"string"}},"required":["text"],"allOf":[{"anyOf":[{"required":["max_new_tokens"]},{"required":["max_tokens"]}]}]}}}}}}},"/api/v3/content_generation/paraphrase/live":{"post":{"operationId":"content_generation_paraphrase_live","summary":"Rewrites (paraphrases) the specified text (1-500 tokens); $0.00015 per request token.","description":"Rewrites (paraphrases) the specified text (1-500 tokens); $0.00015 per request token. DEPRECATED/removed from current docs.","tags":["Content Generation API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"text":{"type":"string"},"creativity_index":{"type":"number"},"tag":{"type":"string"}},"required":["text","creativity_index"]}}}}}}},"/api/v3/content_generation/text_summary/languages":{"get":{"operationId":"content_generation_text_summary_languages","summary":"Returns languages supported by Text Summary (free helper); still present in current docs.","description":"Returns languages supported by Text Summary (free helper); still present in current docs.","tags":["Content Generation API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/content_generation/text_summary/live":{"post":{"operationId":"content_generation_text_summary_live","summary":"Analyzes text (1-10000 tokens) returning word/sentence counts, vocabulary density, readability and keyword-density metrics; $0.001 per task.","description":"Analyzes text (1-10000 tokens) returning word/sentence counts, vocabulary density, readability and keyword-density metrics; $0.001 per task. Only Content Generation endpoint still in current docs.","tags":["Content Generation API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"text":{"type":"string"},"language_name":{"type":"string"},"language_code":{"type":"string"},"internal_list_limit":{"type":"integer"},"tag":{"type":"string"}},"required":["text"],"allOf":[{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/amazon/bulk_search_volume/live":{"post":{"operationId":"dataforseo_labs_amazon_bulk_search_volume_live","summary":"Returns approximate monthly Amazon search volume for up to 1000 keywords.","description":"Returns approximate monthly Amazon search volume for up to 1000 keywords.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/amazon/product_competitors/live":{"post":{"operationId":"dataforseo_labs_amazon_product_competitors_live","summary":"Returns competitor Amazon products ranking for the same keywords as the target ASIN, with intersection metrics.","description":"Returns competitor Amazon products ranking for the same keywords as the target ASIN, with intersection metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"limit":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["asin"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/amazon/product_keyword_intersections/live":{"post":{"operationId":"dataforseo_labs_amazon_product_keyword_intersections_live","summary":"Returns keywords for which the specified Amazon products intersect (rank together) in Amazon SERPs.","description":"Returns keywords for which the specified Amazon products intersect (rank together) in Amazon SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asins":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"limit":{"type":"integer"},"intersection_mode":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["asins"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/amazon/product_rank_overview/live":{"post":{"operationId":"dataforseo_labs_amazon_product_rank_overview_live","summary":"Returns rank distribution and keyword/search-volume overview for up to 1000 Amazon products (ASINs).","description":"Returns rank distribution and keyword/search-volume overview for up to 1000 Amazon products (ASINs).","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asins":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["asins"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/amazon/ranked_keywords/live":{"post":{"operationId":"dataforseo_labs_amazon_ranked_keywords_live","summary":"Returns keywords that a specified Amazon product (ASIN) ranks for, with search metrics.","description":"Returns keywords that a specified Amazon product (ASIN) ranks for, with search metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"limit":{"type":"integer"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["asin"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/amazon/related_keywords/live":{"post":{"operationId":"dataforseo_labs_amazon_related_keywords_live","summary":"Returns keywords from Amazon's 'related searches' block via depth-first search with search volume.","description":"Returns keywords from Amazon's 'related searches' block via depth-first search with search volume.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"depth":{"type":"integer"},"include_seed_keyword":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["keyword"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/apple/app_competitors/live":{"post":{"operationId":"dataforseo_labs_apple_app_competitors_live","summary":"Returns App Store apps competing with the target app for the same keywords, with intersection metrics.","description":"Returns App Store apps competing with the target app for the same keywords, with intersection metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["app_id"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/apple/app_intersection/live":{"post":{"operationId":"dataforseo_labs_apple_app_intersection_live","summary":"Returns keywords for which the specified App Store apps intersect (rank together) in SERPs.","description":"Returns keywords for which the specified App Store apps intersect (rank together) in SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_ids":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["app_ids"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/apple/bulk_app_metrics/live":{"post":{"operationId":"dataforseo_labs_apple_bulk_app_metrics_live","summary":"Returns aggregated ranking metrics for up to 1000 Apple App Store apps.","description":"Returns aggregated ranking metrics for up to 1000 Apple App Store apps.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_ids":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["app_ids"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/apple/keywords_for_app/live":{"post":{"operationId":"dataforseo_labs_apple_keywords_for_app_live","summary":"Returns keywords that a specified Apple App Store app ranks for, with search metrics.","description":"Returns keywords that a specified Apple App Store app ranks for, with search metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["app_id"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/available_filters":{"get":{"operationId":"dataforseo_labs_available_filters","summary":"Returns the list of all available filtering parameters grouped by endpoint and search engine; free.","description":"Returns the list of all available filtering parameters grouped by endpoint and search engine; free.","tags":["DataForSEO Labs API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/dataforseo_labs/bing/bulk_keyword_difficulty/live":{"post":{"operationId":"dataforseo_labs_bing_bulk_keyword_difficulty_live","summary":"Returns the keyword difficulty score for the specified keywords based on Bing SERPs.","description":"Returns the keyword difficulty score for the specified keywords based on Bing SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/bing/bulk_traffic_estimation/live":{"post":{"operationId":"dataforseo_labs_bing_bulk_traffic_estimation_live","summary":"Returns estimated Bing organic/paid traffic volume for up to 1000 domains, subdomains or pages.","description":"Returns estimated Bing organic/paid traffic volume for up to 1000 domains, subdomains or pages.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/dataforseo_labs/bing/competitors_domain/live":{"post":{"operationId":"dataforseo_labs_bing_competitors_domain_live","summary":"Returns competitor domains ranking for the same keywords as the target in Bing SERPs.","description":"Returns competitor domains ranking for the same keywords as the target in Bing SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"max_rank_group":{"type":"string"},"exclude_top_domains":{"type":"string"},"exclude_domains":{"type":"string"},"intersecting_domains":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"tag":{"type":"string"}},"required":["target"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/bing/domain_intersection/live":{"post":{"operationId":"dataforseo_labs_bing_domain_intersection_live","summary":"Returns keywords for which two target domains both rank in Bing SERPs.","description":"Returns keywords for which two target domains both rank in Bing SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target1":{"type":"string"},"target2":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"intersections":{"type":"string"},"item_types":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["target1","target2"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/bing/domain_rank_overview/live":{"post":{"operationId":"dataforseo_labs_bing_domain_rank_overview_live","summary":"Returns rank/traffic overview metrics for a domain in Bing SERPs.","description":"Returns rank/traffic overview metrics for a domain in Bing SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/dataforseo_labs/bing/page_intersection/live":{"post":{"operationId":"dataforseo_labs_bing_page_intersection_live","summary":"Returns keywords for which the specified target pages intersect in Bing SERPs.","description":"Returns keywords for which the specified target pages intersect in Bing SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"pages":{"type":"object"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"exclude_pages":{"type":"string"},"item_types":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"include_subdomains":{"type":"boolean"},"intersection_mode":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["pages"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/bing/ranked_keywords/live":{"post":{"operationId":"dataforseo_labs_bing_ranked_keywords_live","summary":"Returns keywords that a domain, subdomain or webpage ranks for in Bing SERPs.","description":"Returns keywords that a domain, subdomain or webpage ranks for in Bing SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"item_types":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"load_rank_absolute":{"type":"boolean"},"historical_serp_mode":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/dataforseo_labs/bing/related_keywords/live":{"post":{"operationId":"dataforseo_labs_bing_related_keywords_live","summary":"Returns related keywords from the Bing 'related searches' block via depth-first search with search metrics.","description":"Returns related keywords from the Bing 'related searches' block via depth-first search with search metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"depth":{"type":"integer"},"include_seed_keyword":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"ignore_synonyms":{"type":"boolean"},"replace_with_core_keyword":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["keyword"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/bing/relevant_pages/live":{"post":{"operationId":"dataforseo_labs_bing_relevant_pages_live","summary":"Returns the pages of the target domain ranking in Bing SERPs, sorted by keyword count/traffic.","description":"Returns the pages of the target domain ranking in Bing SERPs, sorted by keyword count/traffic.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"historical_serp_mode":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/dataforseo_labs/bing/serp_competitors/live":{"post":{"operationId":"dataforseo_labs_bing_serp_competitors_live","summary":"Returns domains ranking for the specified keywords in Bing, with rank distribution metrics.","description":"Returns domains ranking for the specified keywords in Bing, with rank distribution metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"include_subdomains":{"type":"boolean"},"item_types":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/bing/subdomains/live":{"post":{"operationId":"dataforseo_labs_bing_subdomains_live","summary":"Returns subdomains of the target domain with aggregated Bing ranking metrics.","description":"Returns subdomains of the target domain with aggregated Bing ranking metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"historical_serp_mode":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/dataforseo_labs/categories":{"get":{"operationId":"dataforseo_labs_categories","summary":"Returns the full list of available Google product/service category codes; free.","description":"Returns the full list of available Google product/service category codes; free.","tags":["DataForSEO Labs API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/dataforseo_labs/errors":{"post":{"operationId":"dataforseo_labs_errors","summary":"Returns information about Labs tasks that returned errors within the past 7 days; free.","description":"Returns information about Labs tasks that returned errors within the past 7 days; free.","tags":["DataForSEO Labs API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}},"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"filtered_function":{"type":"string"},"datetime_from":{"type":"string"},"datetime_to":{"type":"string"}}}}}}}}},"/api/v3/dataforseo_labs/google/app_competitors/live":{"post":{"operationId":"dataforseo_labs_google_app_competitors_live","summary":"Returns Google Play apps competing with the target app for the same keywords, with intersection metrics.","description":"Returns Google Play apps competing with the target app for the same keywords, with intersection metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["app_id"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/app_intersection/live":{"post":{"operationId":"dataforseo_labs_google_app_intersection_live","summary":"Returns keywords for which the specified Google Play apps intersect (rank together) in SERPs.","description":"Returns keywords for which the specified Google Play apps intersect (rank together) in SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_ids":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["app_ids"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/bulk_app_metrics/live":{"post":{"operationId":"dataforseo_labs_google_bulk_app_metrics_live","summary":"Returns aggregated ranking metrics (rank distribution, keyword count, search volume) for up to 1000 Google Play apps.","description":"Returns aggregated ranking metrics (rank distribution, keyword count, search volume) for up to 1000 Google Play apps.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_ids":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["app_ids"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/bulk_keyword_difficulty/live":{"post":{"operationId":"dataforseo_labs_google_bulk_keyword_difficulty_live","summary":"Returns the keyword difficulty score (0-100) for up to 1000 keywords in a single request.","description":"Returns the keyword difficulty score (0-100) for up to 1000 keywords in a single request.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/bulk_traffic_estimation/live":{"post":{"operationId":"dataforseo_labs_google_bulk_traffic_estimation_live","summary":"Returns estimated monthly organic/paid traffic volume for up to 1000 domains, subdomains or pages.","description":"Returns estimated monthly organic/paid traffic volume for up to 1000 domains, subdomains or pages.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/dataforseo_labs/google/categories_for_domain/live":{"post":{"operationId":"dataforseo_labs_google_categories_for_domain_live","summary":"Returns product/service categories that a target domain ranks for, with per-category metrics.","description":"Returns product/service categories that a target domain ranks for, with per-category metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"include_subcategories":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"historical_serp_mode":{"type":"string"},"item_types":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["target"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/categories_for_keywords/live":{"post":{"operationId":"dataforseo_labs_google_categories_for_keywords_live","summary":"Returns the product/service category codes associated with the specified keywords.","description":"Returns the product/service category codes associated with the specified keywords.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/competitors_domain/live":{"post":{"operationId":"dataforseo_labs_google_competitors_domain_live","summary":"Returns competitor domains that rank for the same keywords as the target domain, with intersection metrics.","description":"Returns competitor domains that rank for the same keywords as the target domain, with intersection metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"max_rank_group":{"type":"string"},"exclude_top_domains":{"type":"string"},"exclude_domains":{"type":"string"},"intersecting_domains":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"tag":{"type":"string"}},"required":["target"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/domain_intersection/live":{"post":{"operationId":"dataforseo_labs_google_domain_intersection_live","summary":"Returns keywords for which two target domains both rank (or only one ranks) in Google SERPs.","description":"Returns keywords for which two target domains both rank (or only one ranks) in Google SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target1":{"type":"string"},"target2":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"intersections":{"type":"string"},"item_types":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["target1","target2"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/domain_metrics_by_categories/live":{"post":{"operationId":"dataforseo_labs_google_domain_metrics_by_categories_live","summary":"Returns domains ranking within specified product/service categories with metric changes between two dates.","description":"Returns domains ranking within specified product/service categories with metric changes between two dates.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.12,"x-price-formatted":"$0.12","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"category_codes":{"type":"string"},"first_date":{"type":"string"},"second_date":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"top_categories_count":{"type":"string"},"include_subdomains":{"type":"boolean"},"etv_min":{"type":"string"},"etv_max":{"type":"string"},"correlate":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["category_codes","first_date","second_date"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/domain_rank_overview/live":{"post":{"operationId":"dataforseo_labs_google_domain_rank_overview_live","summary":"Returns rank/traffic overview metrics (ETV, organic/paid keyword counts, rank distribution) for a domain.","description":"Returns rank/traffic overview metrics (ETV, organic/paid keyword counts, rank distribution) for a domain.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/dataforseo_labs/google/historical_bulk_traffic_estimation/live":{"post":{"operationId":"dataforseo_labs_google_historical_bulk_traffic_estimation_live","summary":"Returns historical estimated traffic volume for up to 1000 domains over time (from 2020-10-01).","description":"Returns historical estimated traffic volume for up to 1000 domains over time (from 2020-10-01).","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.12,"x-price-formatted":"$0.12","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"targets":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"item_types":{"type":"string"},"tag":{"type":"string"}},"required":["targets"]}}}}}}},"/api/v3/dataforseo_labs/google/historical_keyword_data/live":{"post":{"operationId":"dataforseo_labs_google_historical_keyword_data_live","summary":"Returns historical Google Ads search volume, CPC and competition trends for the specified keywords.","description":"Returns historical Google Ads search volume, CPC and competition trends for the specified keywords.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/historical_rank_overview/live":{"post":{"operationId":"dataforseo_labs_google_historical_rank_overview_live","summary":"Returns historical rank and estimated-traffic overview metrics for a domain over time (from 2020-10-01).","description":"Returns historical rank and estimated-traffic overview metrics for a domain over time (from 2020-10-01).","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.12,"x-price-formatted":"$0.12","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"correlate":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"tag":{"type":"string"}},"required":["target"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/historical_serps/live":{"post":{"operationId":"dataforseo_labs_google_historical_serps_live","summary":"Returns historical Google SERP snapshots for a keyword over a specified date range.","description":"Returns historical Google SERP snapshots for a keyword over a specified date range.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"tag":{"type":"string"}},"required":["keyword"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/keyword_ideas/live":{"post":{"operationId":"dataforseo_labs_google_keyword_ideas_live","summary":"Returns keyword ideas relevant to a group of seed keywords, grouped by the same category/topic, with search volume, CPC and competition.","description":"Returns keyword ideas relevant to a group of seed keywords, grouped by the same category/topic, with search volume, CPC and competition.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"closely_variants":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/keyword_overview/live":{"post":{"operationId":"dataforseo_labs_google_keyword_overview_live","summary":"Returns comprehensive overview metrics (search volume, difficulty, intent, SERP info) for the specified keywords.","description":"Returns comprehensive overview metrics (search volume, difficulty, intent, SERP info) for the specified keywords.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/keyword_suggestions/live":{"post":{"operationId":"dataforseo_labs_google_keyword_suggestions_live","summary":"Returns long-tail keyword suggestions that include the seed keyword phrase, with full search metrics.","description":"Returns long-tail keyword suggestions that include the seed keyword phrase, with full search metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"include_seed_keyword":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"exact_match":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"},"tag":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/dataforseo_labs/google/keywords_for_app/live":{"post":{"operationId":"dataforseo_labs_google_keywords_for_app_live","summary":"Returns keywords that a specified Google Play app ranks for, with search metrics.","description":"Returns keywords that a specified Google Play app ranks for, with search metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"app_id":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["app_id"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/keywords_for_categories/live":{"post":{"operationId":"dataforseo_labs_google_keywords_for_categories_live","summary":"Returns relevant keywords for the specified product/service categories with search metrics.","description":"Returns relevant keywords for the specified product/service categories with search metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"category_codes":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"category_intersection":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"ignore_synonyms":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["category_codes"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/keywords_for_site/live":{"post":{"operationId":"dataforseo_labs_google_keywords_for_site_live","summary":"Returns the list of keywords relevant to a specified domain, with ranking and search-volume data.","description":"Returns the list of keywords relevant to a specified domain, with ranking and search-volume data.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_subdomains":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["target"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/page_intersection/live":{"post":{"operationId":"dataforseo_labs_google_page_intersection_live","summary":"Returns keywords for which the specified target pages all rank (intersect) in Google SERPs.","description":"Returns keywords for which the specified target pages all rank (intersect) in Google SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"pages":{"type":"object"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"exclude_pages":{"type":"string"},"item_types":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"include_subdomains":{"type":"boolean"},"intersection_mode":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["pages"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/ranked_keywords/live":{"post":{"operationId":"dataforseo_labs_google_ranked_keywords_live","summary":"Returns keywords that a domain, subdomain or webpage ranks for in Google organic/paid SERPs.","description":"Returns keywords that a domain, subdomain or webpage ranks for in Google organic/paid SERPs.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"item_types":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"load_rank_absolute":{"type":"boolean"},"historical_serp_mode":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/dataforseo_labs/google/related_keywords/live":{"post":{"operationId":"dataforseo_labs_google_related_keywords_live","summary":"Returns keywords from the Google 'searches related to' block via depth-first search with search metrics.","description":"Returns keywords from the Google 'searches related to' block via depth-first search with search metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"depth":{"type":"integer"},"include_seed_keyword":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"ignore_synonyms":{"type":"boolean"},"replace_with_core_keyword":{"type":"string"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["keyword"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/relevant_pages/live":{"post":{"operationId":"dataforseo_labs_google_relevant_pages_live","summary":"Returns the pages of the target domain ranking in Google SERPs, sorted by keyword count/traffic.","description":"Returns the pages of the target domain ranking in Google SERPs, sorted by keyword count/traffic.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"historical_serp_mode":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/dataforseo_labs/google/search_intent/live":{"post":{"operationId":"dataforseo_labs_google_search_intent_live","summary":"Returns the search intent (informational, navigational, commercial, transactional) for the specified keywords.","description":"Returns the search intent (informational, navigational, commercial, transactional) for the specified keywords.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"language_name":{"type":"string"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/serp_competitors/live":{"post":{"operationId":"dataforseo_labs_google_serp_competitors_live","summary":"Returns domains ranking for the specified keywords, with rank distribution and visibility metrics.","description":"Returns domains ranking for the specified keywords, with rank distribution and visibility metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"include_subdomains":{"type":"boolean"},"item_types":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"}},"required":["keywords"],"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/google/subdomains/live":{"post":{"operationId":"dataforseo_labs_google_subdomains_live","summary":"Returns subdomains of the target domain with their aggregated ranking and traffic metrics.","description":"Returns subdomains of the target domain with their aggregated ranking and traffic metrics.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"item_types":{"type":"string"},"include_clickstream_data":{"type":"boolean"},"historical_serp_mode":{"type":"string"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/dataforseo_labs/google/top_searches/live":{"post":{"operationId":"dataforseo_labs_google_top_searches_live","summary":"Returns the most popular keywords (by search volume) from the DataForSEO keyword database for a location/language.","description":"Returns the most popular keywords (by search volume) from the DataForSEO keyword database for a location/language.","tags":["DataForSEO Labs API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"include_serp_info":{"type":"boolean"},"include_clickstream_data":{"type":"boolean"},"ignore_synonyms":{"type":"boolean"},"filters":{"type":"array"},"order_by":{"type":"array"},"tag":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"}},"allOf":[{"anyOf":[{"required":["location_name"]},{"required":["location_code"]}]},{"anyOf":[{"required":["language_name"]},{"required":["language_code"]}]}]}}}}}}},"/api/v3/dataforseo_labs/id_list":{"post":{"operationId":"dataforseo_labs_id_list","summary":"Returns IDs and metadata for all Labs tasks created within a specified time period; free.","description":"Returns IDs and metadata for all Labs tasks created within a specified time period; free.","tags":["DataForSEO Labs API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}},"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"datetime_from":{"type":"string"},"datetime_to":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"sort":{"type":"string"},"include_metadata":{"type":"string"}},"required":["datetime_from","datetime_to"]}}}}}}},"/api/v3/dataforseo_labs/locations_and_languages":{"get":{"operationId":"dataforseo_labs_locations_and_languages","summary":"Returns the full list of supported locations and languages across Labs sources (Google, Bing, Amazon); free.","description":"Returns the full list of supported locations and languages across Labs sources (Google, Bing, Amazon); free.","tags":["DataForSEO Labs API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/dataforseo_labs/status":{"get":{"operationId":"dataforseo_labs_status","summary":"Returns the last data-update dates for Google, Bing and Amazon Labs endpoints; free.","description":"Returns the last data-update dates for Google, Bing and Amazon Labs endpoints; free.","tags":["DataForSEO Labs API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/domain_analytics/technologies/aggregation_technologies/live":{"post":{"operationId":"domain_analytics_technologies_aggregation_technologies_live","summary":"Returns aggregated counts of domains grouped by technology, category, or group across the database.","description":"Returns aggregated counts of domains grouped by technology, category, or group across the database.","tags":["Domain Analytics API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"filters":{"type":"array"},"internal_list_limit":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}}}}},"/api/v3/domain_analytics/technologies/available_filters":{"get":{"operationId":"domain_analytics_technologies_available_filters","summary":"Reference list of fields available for filtering Technologies endpoints.","description":"Reference list of fields available for filtering Technologies endpoints.","tags":["Domain Analytics API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/domain_analytics/technologies/domain_technologies/live":{"post":{"operationId":"domain_analytics_technologies_domain_technologies_live","summary":"Returns the full technology stack (CMS, frameworks, servers, libraries, etc.) detected for a single domain.","description":"Returns the full technology stack (CMS, frameworks, servers, libraries, etc.) detected for a single domain.","tags":["Domain Analytics API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/domain_analytics/technologies/domains_by_html_terms/live":{"post":{"operationId":"domain_analytics_technologies_domains_by_html_terms_live","summary":"Returns domains whose HTML source contains the specified terms/snippets (+$0.001 per returned domain).","description":"Returns domains whose HTML source contains the specified terms/snippets (+$0.001 per returned domain).","tags":["Domain Analytics API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"search_terms":{"type":"array"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"}},"required":["search_terms"]}}}}}}},"/api/v3/domain_analytics/technologies/domains_by_technology/live":{"post":{"operationId":"domain_analytics_technologies_domains_by_technology_live","summary":"Returns domains using specified technologies with tech profiles, metadata, country/language, and contacts (+$0.001 per returned domain).","description":"Returns domains using specified technologies with tech profiles, metadata, country/language, and contacts (+$0.001 per returned domain).","tags":["Domain Analytics API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"technology_paths":{"type":"string"},"groups":{"type":"string"},"categories":{"type":"string"},"technologies":{"type":"string"},"keywords":{"type":"array"},"filters":{"type":"array"},"order_by":{"type":"array"},"limit":{"type":"integer"},"offset":{"type":"integer"},"offset_token":{"type":"string"}},"allOf":[{"anyOf":[{"required":["technology_paths"]},{"required":["groups"]},{"required":["categories"]},{"required":["technologies"]},{"required":["keywords"]}]}]}}}}}}},"/api/v3/domain_analytics/technologies/languages":{"get":{"operationId":"domain_analytics_technologies_languages","summary":"Reference list of supported languages for Technologies endpoints.","description":"Reference list of supported languages for Technologies endpoints.","tags":["Domain Analytics API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/domain_analytics/technologies/locations":{"get":{"operationId":"domain_analytics_technologies_locations","summary":"Reference list of supported locations for Technologies endpoints.","description":"Reference list of supported locations for Technologies endpoints.","tags":["Domain Analytics API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/domain_analytics/technologies/technologies":{"get":{"operationId":"domain_analytics_technologies_technologies","summary":"Reference catalog of all technologies, groups, and categories DataForSEO can detect.","description":"Reference catalog of all technologies, groups, and categories DataForSEO can detect.","tags":["Domain Analytics API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/domain_analytics/technologies/technologies_summary/live":{"post":{"operationId":"domain_analytics_technologies_technologies_summary_live","summary":"Returns a summary of the number of domains matching the specified technology filters.","description":"Returns a summary of the number of domains matching the specified technology filters.","tags":["Domain Analytics API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"filters":{"type":"array"},"group_by":{"type":"string"}}}}}}}}},"/api/v3/domain_analytics/technologies/technology_stats/live":{"post":{"operationId":"domain_analytics_technologies_technology_stats_live","summary":"Returns historical statistics on the spread and adoption of specified technologies over time.","description":"Returns historical statistics on the spread and adoption of specified technologies over time.","tags":["Domain Analytics API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"date_from":{"type":"string"},"date_to":{"type":"string"},"technologies":{"type":"string"},"categories":{"type":"string"}},"required":["date_from"]}}}}}}},"/api/v3/domain_analytics/whois/available_filters":{"get":{"operationId":"domain_analytics_whois_available_filters","summary":"Reference list of fields available for filtering the WHOIS Overview endpoint.","description":"Reference list of fields available for filtering the WHOIS Overview endpoint.","tags":["Domain Analytics API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/domain_analytics/whois/overview/live":{"post":{"operationId":"domain_analytics_whois_overview_live","summary":"Returns WHOIS registration data enriched with organic/paid ranking, traffic, and backlink metrics for domains matching filters (+$0.001 per returned domain).","description":"Returns WHOIS registration data enriched with organic/paid ranking, traffic, and backlink metrics for domains matching filters (+$0.001 per returned domain).","tags":["Domain Analytics API"],"x-billable":true,"x-price-usd":0.01,"x-price-formatted":"$0.01","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"filters":{"type":"array"},"order_by":{"type":"array"},"offset_token":{"type":"string"}}}}}}}}},"/api/v3/keywords_data/bing/audience_estimation/industries":{"get":{"operationId":"keywords_data_bing_audience_estimation_industries","summary":"List available industries for Bing audience estimation targeting.","description":"List available industries for Bing audience estimation targeting.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/bing/audience_estimation/job_functions":{"get":{"operationId":"keywords_data_bing_audience_estimation_job_functions","summary":"List available job functions for Bing audience estimation targeting.","description":"List available job functions for Bing audience estimation targeting.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/bing/audience_estimation/live":{"post":{"operationId":"keywords_data_bing_audience_estimation_live","summary":"Estimate Bing audience size for keywords across professional segments in real time.","description":"Estimate Bing audience size for keywords across professional segments in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"job_functions":{"type":"string"},"industries":{"type":"string"},"age":{"type":"string"},"gender":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/audience_estimation/task_post":{"post":{"operationId":"keywords_data_bing_audience_estimation_task_post","summary":"Submit a task to estimate Bing audience size for keywords across professional segments.","description":"Submit a task to estimate Bing audience size for keywords across professional segments.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"job_functions":{"type":"string"},"industries":{"type":"string"},"age":{"type":"string"},"gender":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/keyword_performance/live":{"post":{"operationId":"keywords_data_bing_keyword_performance_live","summary":"Get Bing keyword performance metrics (impressions, clicks, CTR, CPC) in real time.","description":"Get Bing keyword performance metrics (impressions, clicks, CTR, CPC) in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/keyword_performance/task_post":{"post":{"operationId":"keywords_data_bing_keyword_performance_task_post","summary":"Submit a task to get Bing keyword performance metrics (impressions, clicks, CTR, CPC).","description":"Submit a task to get Bing keyword performance metrics (impressions, clicks, CTR, CPC).","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/keyword_suggestions_for_url/live":{"post":{"operationId":"keywords_data_bing_keyword_suggestions_for_url_live","summary":"Get Bing keyword suggestions based on a target URL's content in real time.","description":"Get Bing keyword suggestions based on a target URL's content in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/keywords_data/bing/keyword_suggestions_for_url/task_post":{"post":{"operationId":"keywords_data_bing_keyword_suggestions_for_url_task_post","summary":"Submit a task to get Bing keyword suggestions based on a target URL's content.","description":"Submit a task to get Bing keyword suggestions based on a target URL's content.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/keywords_data/bing/keywords_for_keywords/live":{"post":{"operationId":"keywords_data_bing_keywords_for_keywords_live","summary":"Expand seed keywords into related keyword suggestions with Bing metrics in real time.","description":"Expand seed keywords into related keyword suggestions with Bing metrics in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/keywords_for_keywords/task_post":{"post":{"operationId":"keywords_data_bing_keywords_for_keywords_task_post","summary":"Submit a task to expand seed keywords into related keyword suggestions with Bing metrics.","description":"Submit a task to expand seed keywords into related keyword suggestions with Bing metrics.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/keywords_for_site/live":{"post":{"operationId":"keywords_data_bing_keywords_for_site_live","summary":"Get keywords relevant to a target domain with Bing metrics in real time.","description":"Get keywords relevant to a target domain with Bing metrics in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/keywords_data/bing/keywords_for_site/task_post":{"post":{"operationId":"keywords_data_bing_keywords_for_site_task_post","summary":"Submit a task to get keywords relevant to a target domain with Bing metrics.","description":"Submit a task to get keywords relevant to a target domain with Bing metrics.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/keywords_data/bing/languages":{"get":{"operationId":"keywords_data_bing_languages","summary":"List all supported languages for Bing keyword data.","description":"List all supported languages for Bing keyword data.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/bing/locations":{"get":{"operationId":"keywords_data_bing_locations","summary":"List all supported geo-locations for Bing keyword data.","description":"List all supported geo-locations for Bing keyword data.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/bing/search_volume_history/live":{"post":{"operationId":"keywords_data_bing_search_volume_history_live","summary":"Get monthly historical Bing search volume for up to 1000 keywords in real time.","description":"Get monthly historical Bing search volume for up to 1000 keywords in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/search_volume_history/task_post":{"post":{"operationId":"keywords_data_bing_search_volume_history_task_post","summary":"Submit a task to get monthly historical Bing search volume for up to 1000 keywords.","description":"Submit a task to get monthly historical Bing search volume for up to 1000 keywords.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/search_volume/live":{"post":{"operationId":"keywords_data_bing_search_volume_live","summary":"Get Bing search volume, CPC and competition for up to 1000 keywords in real time.","description":"Get Bing search volume, CPC and competition for up to 1000 keywords in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"search_partners":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/bing/search_volume/task_post":{"post":{"operationId":"keywords_data_bing_search_volume_task_post","summary":"Submit a task to get Bing search volume, CPC and competition for up to 1000 keywords.","description":"Submit a task to get Bing search volume, CPC and competition for up to 1000 keywords.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"search_partners":{"type":"string"},"device":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/clickstream_data/bulk_search_volume/live":{"post":{"operationId":"keywords_data_clickstream_data_bulk_search_volume_live","summary":"Get clickstream search volume for up to 1000 keywords with up to 12 months of history (also ~$0.00012 per keyword).","description":"Get clickstream search volume for up to 1000 keywords with up to 12 months of history (also ~$0.00012 per keyword).","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.012,"x-price-formatted":"$0.012","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"language_code":{"type":"string"},"location_code":{"type":"integer"},"use_clickstream":{"type":"string"},"tag":{"type":"string"}},"required":["keywords","language_code","location_code"]}}}}}}},"/api/v3/keywords_data/clickstream_data/dataforseo_search_volume/live":{"post":{"operationId":"keywords_data_clickstream_data_dataforseo_search_volume_live","summary":"Get clickstream-based (or Bing) search volume for up to 1000 keywords in a single location.","description":"Get clickstream-based (or Bing) search volume for up to 1000 keywords in a single location.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.18,"x-price-formatted":"$0.18","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"language_code":{"type":"string"},"location_code":{"type":"integer"},"use_clickstream":{"type":"string"},"tag":{"type":"string"}},"required":["keywords","language_code","location_code"]}}}}}}},"/api/v3/keywords_data/clickstream_data/global_search_volume/live":{"post":{"operationId":"keywords_data_clickstream_data_global_search_volume_live","summary":"Get clickstream-based worldwide search volume with per-country distribution for up to 1000 keywords.","description":"Get clickstream-based worldwide search volume with per-country distribution for up to 1000 keywords.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.18,"x-price-formatted":"$0.18","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"language_code":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/clickstream_data/locations_and_languages":{"get":{"operationId":"keywords_data_clickstream_data_locations_and_languages","summary":"List all supported locations and languages for Clickstream Data endpoints.","description":"List all supported locations and languages for Clickstream Data endpoints.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/dataforseo_trends/demography/live":{"post":{"operationId":"keywords_data_dataforseo_trends_demography_live","summary":"Get DataForSEO Trends keyword interest segmented by demographic attributes (age, gender).","description":"Get DataForSEO Trends keyword interest segmented by demographic attributes (age, gender).","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.18,"x-price-formatted":"$0.18","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"type":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"time_range":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/dataforseo_trends/explore/live":{"post":{"operationId":"keywords_data_dataforseo_trends_explore_live","summary":"Get DataForSEO Trends keyword popularity across web/news/ecommerce with historical data (up to 5 keywords).","description":"Get DataForSEO Trends keyword popularity across web/news/ecommerce with historical data (up to 5 keywords).","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.18,"x-price-formatted":"$0.18","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"type":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"time_range":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/dataforseo_trends/locations":{"get":{"operationId":"keywords_data_dataforseo_trends_locations","summary":"List all supported geo-locations for DataForSEO Trends data.","description":"List all supported geo-locations for DataForSEO Trends data.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/dataforseo_trends/merged_data/live":{"post":{"operationId":"keywords_data_dataforseo_trends_merged_data_live","summary":"Get merged DataForSEO Trends data (interest over time, subregions, demography) in one call.","description":"Get merged DataForSEO Trends data (interest over time, subregions, demography) in one call.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.18,"x-price-formatted":"$0.18","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"type":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"time_range":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/dataforseo_trends/subregion_interests/live":{"post":{"operationId":"keywords_data_dataforseo_trends_subregion_interests_live","summary":"Get DataForSEO Trends keyword interest broken down by subregions for up to 5 keywords.","description":"Get DataForSEO Trends keyword interest broken down by subregions for up to 5 keywords.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.18,"x-price-formatted":"$0.18","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"type":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"time_range":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/google_ads/ad_traffic_by_keywords/live":{"post":{"operationId":"keywords_data_google_ads_ad_traffic_by_keywords_live","summary":"Forecast impressions, clicks, CTR and cost for up to 1000 keywords at a given bid in real time.","description":"Forecast impressions, clicks, CTR and cost for up to 1000 keywords at a given bid in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"bid":{"type":"number"},"match":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"date_interval":{"type":"string"},"sort_by":{"type":"string"},"tag":{"type":"string"}},"required":["keywords","bid","match"]}}}}}}},"/api/v3/keywords_data/google_ads/ad_traffic_by_keywords/task_post":{"post":{"operationId":"keywords_data_google_ads_ad_traffic_by_keywords_task_post","summary":"Submit a task to forecast impressions, clicks, CTR and cost for up to 1000 keywords at a given bid.","description":"Submit a task to forecast impressions, clicks, CTR and cost for up to 1000 keywords at a given bid.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"bid":{"type":"number"},"match":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"date_interval":{"type":"string"},"sort_by":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords","bid","match"]}}}}}}},"/api/v3/keywords_data/google_ads/keywords_for_keywords/live":{"post":{"operationId":"keywords_data_google_ads_keywords_for_keywords_live","summary":"Expand up to 20 seed keywords into related keyword ideas with Google Ads metrics in real time.","description":"Expand up to 20 seed keywords into related keyword ideas with Google Ads metrics in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"include_seed_keyword":{"type":"string"},"sort_by":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/google_ads/keywords_for_keywords/task_post":{"post":{"operationId":"keywords_data_google_ads_keywords_for_keywords_task_post","summary":"Submit a task to expand up to 20 seed keywords into related keyword ideas with Google Ads metrics.","description":"Submit a task to expand up to 20 seed keywords into related keyword ideas with Google Ads metrics.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"include_seed_keyword":{"type":"string"},"sort_by":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/google_ads/keywords_for_site/live":{"post":{"operationId":"keywords_data_google_ads_keywords_for_site_live","summary":"Get up to 2000 keywords relevant to a target domain with Google Ads metrics in real time.","description":"Get up to 2000 keywords relevant to a target domain with Google Ads metrics in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"sort_by":{"type":"string"},"tag":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/keywords_data/google_ads/keywords_for_site/task_post":{"post":{"operationId":"keywords_data_google_ads_keywords_for_site_task_post","summary":"Submit a task to get up to 2000 keywords relevant to a target domain with Google Ads metrics.","description":"Submit a task to get up to 2000 keywords relevant to a target domain with Google Ads metrics.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"sort_by":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["target"]}}}}}}},"/api/v3/keywords_data/google_ads/languages":{"get":{"operationId":"keywords_data_google_ads_languages","summary":"List all supported languages for Google Ads keyword data.","description":"List all supported languages for Google Ads keyword data.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/google_ads/locations":{"get":{"operationId":"keywords_data_google_ads_locations","summary":"List all supported geo-locations for Google Ads keyword data.","description":"List all supported geo-locations for Google Ads keyword data.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/google_ads/search_volume/live":{"post":{"operationId":"keywords_data_google_ads_search_volume_live","summary":"Get Google Ads search volume, CPC and competition for up to 1000 keywords in real time.","description":"Get Google Ads search volume, CPC and competition for up to 1000 keywords in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.09,"x-price-formatted":"$0.09","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"include_adult_keywords":{"type":"string"},"sort_by":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/google_ads/search_volume/task_post":{"post":{"operationId":"keywords_data_google_ads_search_volume_task_post","summary":"Submit a task to get Google Ads search volume, CPC and competition for up to 1000 keywords.","description":"Submit a task to get Google Ads search volume, CPC and competition for up to 1000 keywords.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.06,"x-price-formatted":"$0.06","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_name":{"type":"string"},"location_code":{"type":"integer"},"language_name":{"type":"string"},"language_code":{"type":"string"},"search_partners":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"include_adult_keywords":{"type":"string"},"sort_by":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/google_ads/status":{"get":{"operationId":"keywords_data_google_ads_status","summary":"Check whether Google updated Google Ads keyword data for the previous month.","description":"Check whether Google updated Google Ads keyword data for the previous month.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/google_trends/categories":{"get":{"operationId":"keywords_data_google_trends_categories","summary":"List available Google Trends content categories for filtering.","description":"List available Google Trends content categories for filtering.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/google_trends/explore/live":{"post":{"operationId":"keywords_data_google_trends_explore_live","summary":"Explore Google Trends interest over time/by region for up to 5 keywords in real time.","description":"Explore Google Trends interest over time/by region for up to 5 keywords in real time.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.011,"x-price-formatted":"$0.011","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"type":{"type":"string"},"category_code":{"type":"integer"},"date_from":{"type":"string"},"date_to":{"type":"string"},"time_range":{"type":"string"},"item_types":{"type":"string"},"tag":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/google_trends/explore/task_post":{"post":{"operationId":"keywords_data_google_trends_explore_task_post","summary":"Submit a task to explore Google Trends interest over time/by region for up to 5 keywords.","description":"Submit a task to explore Google Trends interest over time/by region for up to 5 keywords.","tags":["Keywords Data API"],"x-billable":true,"x-price-usd":0.0027,"x-price-formatted":"$0.0027","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keywords":{"type":"array"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"type":{"type":"string"},"category_code":{"type":"integer"},"date_from":{"type":"string"},"date_to":{"type":"string"},"time_range":{"type":"string"},"item_types":{"type":"string"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keywords"]}}}}}}},"/api/v3/keywords_data/google_trends/languages":{"get":{"operationId":"keywords_data_google_trends_languages","summary":"List all supported languages for Google Trends data.","description":"List all supported languages for Google Trends data.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/keywords_data/google_trends/locations":{"get":{"operationId":"keywords_data_google_trends_locations","summary":"List all supported geo-locations for Google Trends data.","description":"List all supported geo-locations for Google Trends data.","tags":["Keywords Data API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/merchant/amazon/asin/live/advanced":{"post":{"operationId":"merchant_amazon_asin_live_advanced","summary":"Return advanced Amazon ASIN product details in real time.","description":"Return advanced Amazon ASIN product details in real time.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"se_domain":{"type":"string"}},"required":["asin","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/asin/live/html":{"post":{"operationId":"merchant_amazon_asin_live_html","summary":"Return raw HTML Amazon ASIN product page in real time.","description":"Return raw HTML Amazon ASIN product page in real time.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"se_domain":{"type":"string"}},"required":["asin","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/asin/task_post":{"post":{"operationId":"merchant_amazon_asin_task_post","summary":"Queue a task to retrieve Amazon product details by ASIN.","description":"Queue a task to retrieve Amazon product details by ASIN.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.0015,"x-price-formatted":"$0.0015","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"se_domain":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["asin","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/languages":{"get":{"operationId":"merchant_amazon_languages","summary":"List languages supported by the Amazon Merchant endpoints.","description":"List languages supported by the Amazon Merchant endpoints.","tags":["Merchant API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/merchant/amazon/locations":{"get":{"operationId":"merchant_amazon_locations","summary":"List locations supported by the Amazon Merchant endpoints.","description":"List locations supported by the Amazon Merchant endpoints.","tags":["Merchant API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/merchant/amazon/products/live/advanced":{"post":{"operationId":"merchant_amazon_products_live_advanced","summary":"Return advanced Amazon product results in real time.","description":"Return advanced Amazon product results in real time.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"department":{"type":"string"},"se_domain":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/products/live/html":{"post":{"operationId":"merchant_amazon_products_live_html","summary":"Return raw HTML Amazon product results in real time.","description":"Return raw HTML Amazon product results in real time.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/products/task_post":{"post":{"operationId":"merchant_amazon_products_task_post","summary":"Queue a task to retrieve Amazon product listings for a search keyword.","description":"Queue a task to retrieve Amazon product listings for a search keyword.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.0015,"x-price-formatted":"$0.0015","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"max_crawl_pages":{"type":"integer"},"sort_by":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"department":{"type":"string"},"se_domain":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/reviews/task_post":{"post":{"operationId":"merchant_amazon_reviews_task_post","summary":"Queue a task to retrieve Amazon customer reviews by ASIN (temporarily unavailable per docs).","description":"Queue a task to retrieve Amazon customer reviews by ASIN (temporarily unavailable per docs).","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.0015,"x-price-formatted":"$0.0015","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"reviewer_type":{"type":"string"},"filter_by_star":{"type":"string"},"filter_by_keyword":{"type":"string"},"media_type":{"type":"string"},"format_type":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["asin","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/sellers/live/advanced":{"post":{"operationId":"merchant_amazon_sellers_live_advanced","summary":"Return advanced Amazon sellers list in real time.","description":"Return advanced Amazon sellers list in real time.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"se_domain":{"type":"string"}},"required":["asin","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/sellers/live/html":{"post":{"operationId":"merchant_amazon_sellers_live_html","summary":"Return raw HTML Amazon sellers page in real time.","description":"Return raw HTML Amazon sellers page in real time.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"se_domain":{"type":"string"}},"required":["asin","location_code","language_code"]}}}}}}},"/api/v3/merchant/amazon/sellers/task_post":{"post":{"operationId":"merchant_amazon_sellers_task_post","summary":"Queue a task to list sellers of a specified Amazon product (by ASIN).","description":"Queue a task to list sellers of a specified Amazon product (by ASIN).","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.0015,"x-price-formatted":"$0.0015","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"asin":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"se_domain":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["asin","location_code","language_code"]}}}}}}},"/api/v3/merchant/google/languages":{"get":{"operationId":"merchant_google_languages","summary":"List languages supported by the Google Shopping Merchant endpoints.","description":"List languages supported by the Google Shopping Merchant endpoints.","tags":["Merchant API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/merchant/google/locations":{"get":{"operationId":"merchant_google_locations","summary":"List locations supported by the Google Shopping Merchant endpoints.","description":"List locations supported by the Google Shopping Merchant endpoints.","tags":["Merchant API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/merchant/google/product_info/task_post":{"post":{"operationId":"merchant_google_product_info_task_post","summary":"Queue a task to retrieve details/specifications of a Google Shopping product page.","description":"Queue a task to retrieve details/specifications of a Google Shopping product page.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"product_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"se_domain":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["product_id","location_code","language_code"]}}}}}}},"/api/v3/merchant/google/products/task_post":{"post":{"operationId":"merchant_google_products_task_post","summary":"Queue a task to retrieve Google Shopping product listings for a keyword.","description":"Queue a task to retrieve Google Shopping product listings for a keyword.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"sort_by":{"type":"string"},"search_param":{"type":"string"},"depth":{"type":"integer"},"max_crawl_pages":{"type":"integer"},"se_domain":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"},"url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/merchant/google/reviews/task_post":{"post":{"operationId":"merchant_google_reviews_task_post","summary":"Queue a task to retrieve Google Shopping product review data.","description":"Queue a task to retrieve Google Shopping product review data.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"product_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"sort_by":{"type":"string"},"se_domain":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["product_id","location_code","language_code"]}}}}}}},"/api/v3/merchant/google/sellers/ad_url/{id}":{"get":{"operationId":"merchant_google_sellers_ad_url","summary":"Resolve a Google Shopping seller ad redirect to its destination URL in real time.","description":"Resolve a Google Shopping seller ad redirect to its destination URL in real time.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/PaymentSignature"}]}},"/api/v3/merchant/google/sellers/task_post":{"post":{"operationId":"merchant_google_sellers_task_post","summary":"Queue a task to retrieve Google Shopping sellers offering specified products.","description":"Queue a task to retrieve Google Shopping sellers offering specified products.","tags":["Merchant API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"sort_by":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/on_page/content_parsing/live":{"post":{"operationId":"on_page_content_parsing_live","summary":"Synchronously parses a page and returns structured content (links, headings, text by priority).","description":"Synchronously parses a page and returns structured content (links, headings, text by priority).","tags":["OnPage API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string"},"enable_javascript":{"type":"string"},"enable_browser_rendering":{"type":"string"},"browser_preset":{"type":"string"},"custom_js":{"type":"string"},"custom_user_agent":{"type":"string"},"markdown_view":{"type":"string"},"accept_language":{"type":"string"},"store_raw_html":{"type":"string"},"switch_pool":{"type":"string"},"tag":{"type":"string"}},"required":["url"]}}}}}}},"/api/v3/on_page/instant_pages":{"post":{"operationId":"on_page_instant_pages","summary":"Synchronously returns full on-page SEO analysis for a single URL without a crawl task.","description":"Synchronously returns full on-page SEO analysis for a single URL without a crawl task.","tags":["OnPage API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string"},"custom_user_agent":{"type":"string"},"browser_preset":{"type":"string"},"store_raw_html":{"type":"string"},"accept_language":{"type":"string"},"load_resources":{"type":"string"},"enable_javascript":{"type":"string"},"enable_browser_rendering":{"type":"string"},"disable_cookie_popup":{"type":"string"},"enable_xhr":{"type":"string"},"custom_js":{"type":"string"},"validate_micromarkup":{"type":"string"},"check_spell":{"type":"string"},"switch_pool":{"type":"string"}},"required":["url"]}}}}}}},"/api/v3/on_page/lighthouse/audits":{"get":{"operationId":"on_page_lighthouse_audits","summary":"Returns the list of available Lighthouse audit titles that can be requested.","description":"Returns the list of available Lighthouse audit titles that can be requested.","tags":["OnPage API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/on_page/lighthouse/languages":{"get":{"operationId":"on_page_lighthouse_languages","summary":"Returns the list of languages supported for Lighthouse audit reports.","description":"Returns the list of languages supported for Lighthouse audit reports.","tags":["OnPage API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/on_page/lighthouse/live/json":{"post":{"operationId":"on_page_lighthouse_live_json","summary":"Synchronously runs a Google Lighthouse audit and returns full JSON results.","description":"Synchronously runs a Google Lighthouse audit and returns full JSON results.","tags":["OnPage API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string"},"for_mobile":{"type":"string"},"categories":{"type":"string"},"audits":{"type":"string"},"version":{"type":"string"},"language_code":{"type":"string"},"custom_user_agent":{"type":"string"},"browser_network_throttling":{"type":"string"},"tag":{"type":"string"}},"required":["url"]}}}}}}},"/api/v3/on_page/lighthouse/task_post":{"post":{"operationId":"on_page_lighthouse_task_post","summary":"Queues a Google Lighthouse audit of a page (performance, accessibility, SEO, best practices).","description":"Queues a Google Lighthouse audit of a page (performance, accessibility, SEO, best practices).","tags":["OnPage API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string"},"for_mobile":{"type":"string"},"categories":{"type":"string"},"audits":{"type":"string"},"version":{"type":"string"},"language_code":{"type":"string"},"custom_user_agent":{"type":"string"},"browser_network_throttling":{"type":"string"},"tag":{"type":"string"},"pingback_url":{"type":"string"}},"required":["url"]}}}}}}},"/api/v3/on_page/lighthouse/versions":{"get":{"operationId":"on_page_lighthouse_versions","summary":"Returns the list of available Google Lighthouse versions.","description":"Returns the list of available Google Lighthouse versions.","tags":["OnPage API"],"x-billable":false,"x-price-usd":0,"x-price-formatted":"$0","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/api/v3/on_page/page_screenshot":{"post":{"operationId":"on_page_page_screenshot","summary":"Synchronously captures a screenshot of a page as rendered by the DataForSEO crawler.","description":"Synchronously captures a screenshot of a page as rendered by the DataForSEO crawler.","tags":["OnPage API"],"x-billable":true,"x-price-usd":0.005,"x-price-formatted":"$0.005","x-price-confidence":"estimated","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string"},"full_page_screenshot":{"type":"string"},"browser_preset":{"type":"string"},"browser_screen_width":{"type":"string"},"browser_screen_height":{"type":"string"},"accept_language":{"type":"string"},"custom_user_agent":{"type":"string"},"disable_cookie_popup":{"type":"string"},"tag":{"type":"string"}},"required":["url"]}}}}}}},"/api/v3/on_page/task_post":{"post":{"operationId":"on_page_task_post","summary":"Sets up a website crawling task (billed per page) to check 60+ on-page SEO parameters across a domain.","description":"Sets up a website crawling task (billed per page) to check 60+ on-page SEO parameters across a domain.","tags":["OnPage API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"target":{"type":"string"},"max_crawl_pages":{"type":"integer"},"start_url":{"type":"string"},"force_sitewide_checks":{"type":"string"},"priority_urls":{"type":"string"},"max_crawl_depth":{"type":"string"},"crawl_delay":{"type":"string"},"store_raw_html":{"type":"string"},"enable_content_parsing":{"type":"string"},"calculate_keyword_density":{"type":"string"},"load_resources":{"type":"string"},"enable_javascript":{"type":"string"},"enable_browser_rendering":{"type":"string"},"enable_xhr":{"type":"string"},"custom_js":{"type":"string"},"custom_user_agent":{"type":"string"},"robots_txt_merge_mode":{"type":"string"},"custom_robots_txt":{"type":"string"},"switch_pool":{"type":"string"},"respect_sitemap":{"type":"string"},"allow_subdomains":{"type":"string"},"check_spell":{"type":"string"},"validate_micromarkup":{"type":"string"},"checks_threshold":{"type":"string"},"tag":{"type":"string"},"pingback_url":{"type":"string"}},"required":["target","max_crawl_pages"]}}}}}}},"/api/v3/serp/baidu/organic/task_post":{"post":{"operationId":"serp_baidu_organic_task_post","summary":"Queues a Baidu organic SERP task (no live mode); get_website_url multiplies cost x10.","description":"Queues a Baidu organic SERP task (no live mode); get_website_url multiplies cost x10.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"max_crawl_pages":{"type":"integer"},"get_website_url":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/bing/organic/live/advanced":{"post":{"operationId":"serp_bing_organic_live_advanced","summary":"Real-time Bing organic advanced SERP results.","description":"Real-time Bing organic advanced SERP results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"search_param":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/bing/organic/live/html":{"post":{"operationId":"serp_bing_organic_live_html","summary":"Real-time raw HTML of Bing organic SERP.","description":"Real-time raw HTML of Bing organic SERP.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/bing/organic/live/regular":{"post":{"operationId":"serp_bing_organic_live_regular","summary":"Real-time Bing organic regular results.","description":"Real-time Bing organic regular results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"search_param":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/bing/organic/task_post":{"post":{"operationId":"serp_bing_organic_task_post","summary":"Queues a Bing organic SERP task; priority=2 costs $0.0012.","description":"Queues a Bing organic SERP task; priority=2 costs $0.0012.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"search_param":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/ads_advertisers/live/advanced":{"post":{"operationId":"serp_google_ads_advertisers_live_advanced","summary":"Real-time Google Ads Transparency advertiser lookup (advanced).","description":"Real-time Google Ads Transparency advertiser lookup (advanced).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"}},"required":["keyword","location_code"]}}}}}}},"/api/v3/serp/google/ads_advertisers/task_post":{"post":{"operationId":"serp_google_ads_advertisers_task_post","summary":"Queues a Google Ads Transparency advertisers-search task (desktop/windows only).","description":"Queues a Google Ads Transparency advertisers-search task (desktop/windows only).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code"]}}}}}}},"/api/v3/serp/google/ads_search/live/advanced":{"post":{"operationId":"serp_google_ads_search_live_advanced","summary":"Real-time Google Ads Transparency ads listing (advanced).","description":"Real-time Google Ads Transparency ads listing (advanced).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"advertiser_id":{"type":"string"},"target":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","advertiser_id"]}}}}}}},"/api/v3/serp/google/ads_search/task_post":{"post":{"operationId":"serp_google_ads_search_task_post","summary":"Queues a Google Ads Transparency ads-search task by advertiser/target (desktop/windows).","description":"Queues a Google Ads Transparency ads-search task by advertiser/target (desktop/windows).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"advertiser_id":{"type":"string"},"target":{"type":"string"},"location_code":{"type":"integer"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","advertiser_id"]}}}}}}},"/api/v3/serp/google/ai_mode/live/advanced":{"post":{"operationId":"serp_google_ai_mode_live_advanced","summary":"Real-time Google AI Mode generative answer results (advanced).","description":"Real-time Google AI Mode generative answer results (advanced).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/ai_mode/live/html":{"post":{"operationId":"serp_google_ai_mode_live_html","summary":"Real-time raw HTML of Google AI Mode results.","description":"Real-time raw HTML of Google AI Mode results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/ai_mode/task_post":{"post":{"operationId":"serp_google_ai_mode_task_post","summary":"Queues a Google AI Mode SERP task.","description":"Queues a Google AI Mode SERP task.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/autocomplete/live/advanced":{"post":{"operationId":"serp_google_autocomplete_live_advanced","summary":"Real-time Google Autocomplete suggestions (advanced).","description":"Real-time Google Autocomplete suggestions (advanced).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"cursor_pointer":{"type":"string"},"client":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/serp/google/autocomplete/live/html":{"post":{"operationId":"serp_google_autocomplete_live_html","summary":"Real-time raw HTML of Google Autocomplete.","description":"Real-time raw HTML of Google Autocomplete.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"cursor_pointer":{"type":"string"},"client":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/serp/google/autocomplete/task_post":{"post":{"operationId":"serp_google_autocomplete_task_post","summary":"Queues a Google Autocomplete suggestions task.","description":"Queues a Google Autocomplete suggestions task.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"cursor_pointer":{"type":"string"},"client":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/serp/google/dataset_info/live/advanced":{"post":{"operationId":"serp_google_dataset_info_live_advanced","summary":"Real-time Google Dataset Info detailed metadata (advanced).","description":"Real-time Google Dataset Info detailed metadata (advanced).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"dataset_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"}},"required":["dataset_id"]}}}}}}},"/api/v3/serp/google/dataset_info/task_post":{"post":{"operationId":"serp_google_dataset_info_task_post","summary":"Queues a Google Dataset Info task (metadata for a dataset, desktop only).","description":"Queues a Google Dataset Info task (metadata for a dataset, desktop only).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"dataset_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["dataset_id"]}}}}}}},"/api/v3/serp/google/dataset_search/live/advanced":{"post":{"operationId":"serp_google_dataset_search_live_advanced","summary":"Real-time Google Dataset Search advanced results.","description":"Real-time Google Dataset Search advanced results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/dataset_search/task_post":{"post":{"operationId":"serp_google_dataset_search_task_post","summary":"Queues a Google Dataset Search task (top 20 datasets, desktop only).","description":"Queues a Google Dataset Search task (top 20 datasets, desktop only).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/events/live/advanced":{"post":{"operationId":"serp_google_events_live_advanced","summary":"Real-time Google Events advanced results.","description":"Real-time Google Events advanced results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/events/task_post":{"post":{"operationId":"serp_google_events_task_post","summary":"Queues a Google Events SERP task (English/desktop only, top 10).","description":"Queues a Google Events SERP task (English/desktop only, top 10).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/finance_explore/live/advanced":{"post":{"operationId":"serp_google_finance_explore_live_advanced","summary":"Real-time Google Finance Explore advanced results.","description":"Real-time Google Finance Explore advanced results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_code":{"type":"integer"},"language_code":{"type":"string"}},"required":["location_code","language_code"]}}}}}}},"/api/v3/serp/google/finance_explore/live/html":{"post":{"operationId":"serp_google_finance_explore_live_html","summary":"Real-time raw HTML of Google Finance Explore.","description":"Real-time raw HTML of Google Finance Explore.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_code":{"type":"integer"},"language_code":{"type":"string"}},"required":["location_code","language_code"]}}}}}}},"/api/v3/serp/google/finance_explore/task_post":{"post":{"operationId":"serp_google_finance_explore_task_post","summary":"Queues a Google Finance Explore task (market trends/news).","description":"Queues a Google Finance Explore task (market trends/news).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_code":{"type":"integer"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["location_code","language_code"]}}}}}}},"/api/v3/serp/google/finance_markets/live/advanced":{"post":{"operationId":"serp_google_finance_markets_live_advanced","summary":"Real-time Google Finance Markets advanced results.","description":"Real-time Google Finance Markets advanced results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_code":{"type":"integer"},"language_code":{"type":"string"},"market_type":{"type":"string"},"trend":{"type":"string"}},"required":["location_code","language_code","market_type"]}}}}}}},"/api/v3/serp/google/finance_markets/live/html":{"post":{"operationId":"serp_google_finance_markets_live_html","summary":"Real-time raw HTML of Google Finance Markets.","description":"Real-time raw HTML of Google Finance Markets.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_code":{"type":"integer"},"language_code":{"type":"string"},"market_type":{"type":"string"},"trend":{"type":"string"}},"required":["location_code","language_code","market_type"]}}}}}}},"/api/v3/serp/google/finance_markets/task_post":{"post":{"operationId":"serp_google_finance_markets_task_post","summary":"Queues a Google Finance Markets task (Markets tab data).","description":"Queues a Google Finance Markets task (Markets tab data).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"location_code":{"type":"integer"},"language_code":{"type":"string"},"market_type":{"type":"string"},"trend":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["location_code","language_code","market_type"]}}}}}}},"/api/v3/serp/google/finance_quote/live/advanced":{"post":{"operationId":"serp_google_finance_quote_live_advanced","summary":"Real-time Google Finance Quote for a ticker (advanced).","description":"Real-time Google Finance Quote for a ticker (advanced).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"window":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/finance_quote/live/html":{"post":{"operationId":"serp_google_finance_quote_live_html","summary":"Real-time raw HTML of Google Finance Quote.","description":"Real-time raw HTML of Google Finance Quote.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"window":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/finance_quote/task_post":{"post":{"operationId":"serp_google_finance_quote_task_post","summary":"Queues a Google Finance Quote task for a ticker symbol.","description":"Queues a Google Finance Quote task for a ticker symbol.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"window":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/finance_ticker_search/live/advanced":{"post":{"operationId":"serp_google_finance_ticker_search_live_advanced","summary":"Real-time Google Finance ticker/instrument lookup (advanced).","description":"Real-time Google Finance ticker/instrument lookup (advanced).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/serp/google/finance_ticker_search/task_post":{"post":{"operationId":"serp_google_finance_ticker_search_task_post","summary":"Queues a Google Finance ticker/instrument search task.","description":"Queues a Google Finance ticker/instrument search task.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/serp/google/images/live/advanced":{"post":{"operationId":"serp_google_images_live_advanced","summary":"Real-time Google Images advanced image results.","description":"Real-time Google Images advanced image results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/images/live/html":{"post":{"operationId":"serp_google_images_live_html","summary":"Real-time raw HTML of Google Images results.","description":"Real-time raw HTML of Google Images results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/images/task_post":{"post":{"operationId":"serp_google_images_task_post","summary":"Queues a Google Images SERP task (desktop only, up to 100).","description":"Queues a Google Images SERP task (desktop only, up to 100).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/jobs/live/advanced":{"post":{"operationId":"serp_google_jobs_live_advanced","summary":"Real-time Google Jobs advanced results.","description":"Real-time Google Jobs advanced results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/jobs/live/html":{"post":{"operationId":"serp_google_jobs_live_html","summary":"Real-time raw HTML of Google Jobs results.","description":"Real-time raw HTML of Google Jobs results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/jobs/task_post":{"post":{"operationId":"serp_google_jobs_task_post","summary":"Queues a Google Jobs SERP task (up to 200 job listings).","description":"Queues a Google Jobs SERP task (up to 200 job listings).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/local_finder/live/advanced":{"post":{"operationId":"serp_google_local_finder_live_advanced","summary":"Real-time Google Local Finder advanced local business results.","description":"Real-time Google Local Finder advanced local business results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"location_coordinate":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/local_finder/live/html":{"post":{"operationId":"serp_google_local_finder_live_html","summary":"Real-time raw HTML of Google Local Finder results.","description":"Real-time raw HTML of Google Local Finder results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/local_finder/task_post":{"post":{"operationId":"serp_google_local_finder_task_post","summary":"Queues a Google Local Finder SERP task.","description":"Queues a Google Local Finder SERP task.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"location_coordinate":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/maps/live/advanced":{"post":{"operationId":"serp_google_maps_live_advanced","summary":"Real-time Google Maps advanced results (map pack listings).","description":"Real-time Google Maps advanced results (map pack listings).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"location_coordinate":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/maps/task_post":{"post":{"operationId":"serp_google_maps_task_post","summary":"Queues a Google Maps SERP task (up to top 100 map results).","description":"Queues a Google Maps SERP task (up to top 100 map results).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"location_coordinate":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/news/live/advanced":{"post":{"operationId":"serp_google_news_live_advanced","summary":"Real-time Google News advanced results.","description":"Real-time Google News advanced results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/news/live/html":{"post":{"operationId":"serp_google_news_live_html","summary":"Real-time raw HTML of Google News results.","description":"Real-time raw HTML of Google News results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/news/task_post":{"post":{"operationId":"serp_google_news_task_post","summary":"Queues a Google News SERP task (up to top 100 news results).","description":"Queues a Google News SERP task (up to top 100 news results).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/organic/live/advanced":{"post":{"operationId":"serp_google_organic_live_advanced","summary":"Real-time Google organic advanced SERP with all element types.","description":"Real-time Google organic advanced SERP with all element types.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"},"search_param":{"type":"string"},"group_organic_results":{"type":"boolean"},"calculate_rectangles":{"type":"boolean"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/organic/live/html":{"post":{"operationId":"serp_google_organic_live_html","summary":"Real-time raw HTML of Google organic SERP page.","description":"Real-time raw HTML of Google organic SERP page.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"},"search_param":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/organic/live/regular":{"post":{"operationId":"serp_google_organic_live_regular","summary":"Real-time Google organic regular results (organic + paid).","description":"Real-time Google organic regular results (organic + paid).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"},"search_param":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/organic/task_post":{"post":{"operationId":"serp_google_organic_task_post","summary":"Queues a Google organic SERP task; priority=2 costs $0.0012.","description":"Queues a Google organic SERP task; priority=2 costs $0.0012.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"location_name":{"type":"string"},"language_name":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"},"search_param":{"type":"string"},"max_crawl_pages":{"type":"integer"},"group_organic_results":{"type":"boolean"},"calculate_rectangles":{"type":"boolean"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/google/search_by_image/task_post":{"post":{"operationId":"serp_google_search_by_image_task_post","summary":"Queues a Google Lens reverse-image-search task (desktop only).","description":"Queues a Google Lens reverse-image-search task (desktop only).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"image_url":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"os":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["image_url"]}}}}}}},"/api/v3/serp/naver/organic/task_post":{"post":{"operationId":"serp_naver_organic_task_post","summary":"Queues a Naver (Korean) organic SERP task (no live mode; results not location/language targeted).","description":"Queues a Naver (Korean) organic SERP task (no live mode; results not location/language targeted).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"max_crawl_pages":{"type":"integer"},"stop_crawl_on_match":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword"]}}}}}}},"/api/v3/serp/seznam/organic/task_post":{"post":{"operationId":"serp_seznam_organic_task_post","summary":"Queues a Seznam (Czech) organic SERP task (no live mode).","description":"Queues a Seznam (Czech) organic SERP task (no live mode).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"max_crawl_pages":{"type":"integer"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/yahoo/organic/live/advanced":{"post":{"operationId":"serp_yahoo_organic_live_advanced","summary":"Real-time Yahoo organic advanced SERP results.","description":"Real-time Yahoo organic advanced SERP results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"},"search_param":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/yahoo/organic/live/html":{"post":{"operationId":"serp_yahoo_organic_live_html","summary":"Real-time raw HTML of Yahoo organic SERP.","description":"Real-time raw HTML of Yahoo organic SERP.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/yahoo/organic/live/regular":{"post":{"operationId":"serp_yahoo_organic_live_regular","summary":"Real-time Yahoo organic regular results.","description":"Real-time Yahoo organic regular results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/yahoo/organic/task_post":{"post":{"operationId":"serp_yahoo_organic_task_post","summary":"Queues a Yahoo organic SERP task.","description":"Queues a Yahoo organic SERP task.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"se_domain":{"type":"string"},"search_param":{"type":"string"},"max_crawl_pages":{"type":"integer"},"stop_crawl_on_match":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/youtube/organic/live/advanced":{"post":{"operationId":"serp_youtube_organic_live_advanced","summary":"Real-time YouTube organic advanced search results.","description":"Real-time YouTube organic advanced search results.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"block_depth":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/youtube/organic/live/html":{"post":{"operationId":"serp_youtube_organic_live_html","summary":"Real-time raw HTML of YouTube organic search.","description":"Real-time raw HTML of YouTube organic search.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"block_depth":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/youtube/organic/task_post":{"post":{"operationId":"serp_youtube_organic_task_post","summary":"Queues a YouTube organic search task.","description":"Queues a YouTube organic search task.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"keyword":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"device":{"type":"string"},"os":{"type":"string"},"depth":{"type":"integer"},"block_depth":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["keyword","location_code","language_code"]}}}}}}},"/api/v3/serp/youtube/video_comments/live/advanced":{"post":{"operationId":"serp_youtube_video_comments_live_advanced","summary":"Real-time YouTube video comments (advanced).","description":"Real-time YouTube video comments (advanced).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.002,"x-price-formatted":"$0.002","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"video_id":{"type":"string"},"depth":{"type":"integer"}},"required":["video_id"]}}}}}}},"/api/v3/serp/youtube/video_comments/task_post":{"post":{"operationId":"serp_youtube_video_comments_task_post","summary":"Queues a YouTube Video Comments task (top 20 comments).","description":"Queues a YouTube Video Comments task (top 20 comments).","tags":["SERP API"],"x-billable":true,"x-price-usd":0.001,"x-price-formatted":"$0.001","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"video_id":{"type":"string"},"depth":{"type":"integer"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["video_id"]}}}}}}},"/api/v3/serp/youtube/video_info/live/advanced":{"post":{"operationId":"serp_youtube_video_info_live_advanced","summary":"Real-time YouTube Video Info advanced data; live price x3.","description":"Real-time YouTube Video Info advanced data; live price x3.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.006,"x-price-formatted":"$0.006","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"video_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"}},"required":["video_id"]}}}}}}},"/api/v3/serp/youtube/video_info/live/html":{"post":{"operationId":"serp_youtube_video_info_live_html","summary":"Real-time raw HTML of YouTube watch page.","description":"Real-time raw HTML of YouTube watch page.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.006,"x-price-formatted":"$0.006","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"video_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"}},"required":["video_id"]}}}}}}},"/api/v3/serp/youtube/video_info/task_post":{"post":{"operationId":"serp_youtube_video_info_task_post","summary":"Queues a YouTube Video Info task (video/channel metrics); base price x3.","description":"Queues a YouTube Video Info task (video/channel metrics); base price x3.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.0018,"x-price-formatted":"$0.0018","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"video_id":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["video_id"]}}}}}}},"/api/v3/serp/youtube/video_subtitles/live/advanced":{"post":{"operationId":"serp_youtube_video_subtitles_live_advanced","summary":"Real-time YouTube video subtitles text (advanced); live price x3.","description":"Real-time YouTube video subtitles text (advanced); live price x3.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.006,"x-price-formatted":"$0.006","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"video_id":{"type":"string"},"subtitles_language":{"type":"string"}},"required":["video_id"]}}}}}}},"/api/v3/serp/youtube/video_subtitles/task_post":{"post":{"operationId":"serp_youtube_video_subtitles_task_post","summary":"Queues a YouTube Video Subtitles task; base price x3.","description":"Queues a YouTube Video Subtitles task; base price x3.","tags":["SERP API"],"x-billable":true,"x-price-usd":0.0018,"x-price-formatted":"$0.0018","x-price-confidence":"published","responses":{"200":{"description":"Result from DataForSEO, proxied verbatim.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"PAYMENT-RESPONSE":{"description":"x402 v2 settlement receipt (transaction hash, network).","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"}],"requestBody":{"required":true,"description":"DataForSEO accepts an array of task objects; you are billed per task in the array.","content":{"application/json":{"schema":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"properties":{"video_id":{"type":"string"},"subtitles_language":{"type":"string"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"priority":{"type":"integer"},"tag":{"type":"string"},"postback_url":{"type":"string"},"pingback_url":{"type":"string"}},"required":["video_id"]}}}}}}}},"components":{"parameters":{"PaymentSignature":{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"x402 v2 payment signature (EIP-3009 USDC authorization). Sent on the retry after receiving a 402; omit it on the first request.","schema":{"type":"string"}}},"responses":{"PaymentRequired":{"description":"Payment required (x402 v2). Read the PAYMENT-REQUIRED header for the payment requirements, then retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"x402 payment requirements: accepts[] with scheme, network, amount, asset, payTo.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"BadRequest":{"description":"Missing or malformed required parameters. No payment is taken.","content":{"application/json":{"schema":{"type":"object"}}}}}}}