> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Live Dataforseo Labs Google Historical Search Volume > DataForSEO POST /v3/dataforseo_labs/google/historical_search_volume/live Usage-based billing; Default request estimate: $0.1356 USD (not a fixed price). Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/dataforseo/dataforseo\_labs/google/historical\_search\_volume/live * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/dataforseo/dataforseo\_labs/google/historical\_search\_volume/live](https://api.aisa.one/apis/v1/dataforseo/dataforseo\_labs/google/historical\_search\_volume/live) * **Runtime facts:** 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c [Complete OpenAPI definition](https://aisa.one/docs/openapi/dataforseo.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "any_dataforseo_apis_v1_dataforseo_dataforseo_labs_13ede5", "method": "POST", "path": "/apis/v1/dataforseo/dataforseo_labs/google/historical_search_volume/live", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "example": [ { "include_serp_info": true, "keywords": [ "phone", "watch" ], "language_name": "English", "location_code": 2840 } ], "items": { "oneOf": [ { "example": [ { "include_serp_info": true, "keywords": [ "phone", "watch" ], "language_name": "English", "location_code": 2840 } ], "properties": { "include_clickstream_data": { "description": "include or exclude data from clickstream-based metrics in the result\noptional field\nif the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response\ndefault value: false\nwith this parameter enabled, you will be charged double the price for the request\nlearn more about how clickstream-based metrics are calculated in this help center article", "type": [ "boolean", "null" ] }, "include_serp_info": { "description": "include data from SERP for each keyword\noptional field\nif set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response\ndefault value: false", "type": [ "boolean", "null" ] }, "keywords": { "description": "keywords\nrequired field\nThe maximum number of keywords you can specify: 700\nThe maximum number of characters for each keyword: 80\nThe maximum number of words for each keyword phrase: 10\nthe specified keywords will be converted to lowercase format, data will be provided in a separate array\nnote that if some of the keywords specified in this array are omitted in the results you receive, then our database doesn’t contain such keywords and cannot return data on them\nyou will not be charged for the keywords omitted in the results\nlearn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article", "items": { "type": "string" }, "type": "array" }, "language_code": { "description": "language code\nrequired field if you don’t specify language_name\nNote: it is required to specify either language_name or language_code\nyou can receive the list of available locations with their language_code by making a separate request to the\nhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages\nexample:\nen", "type": [ "string", "null" ] }, "language_name": { "description": "full name of the language\nrequired field if you don’t specify language_code\nNote: it is required to specify either language_name or language_code\nyou can receive the list of available locations with their language_name by making a separate request to the\nhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages\nexample:\nEnglish", "type": [ "string", "null" ] }, "location_code": { "description": "location code\nrequired field if you don’t specify location_name\nNote: it is required to specify either location_name or location_code\nyou can receive the list of available locations with their location_code by making a separate request to the\nhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages\nexample:\n2840", "type": [ "integer", "null" ] }, "location_name": { "description": "full name of the location\nrequired field if you don’t specify location_code\nNote: it is required to specify either location_name or location_code\nyou can receive the list of available locations with their location_name by making a separate request to the\nhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages\nexample:\nUnited Kingdom", "type": [ "string", "null" ] }, "tag": { "description": "user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response", "type": [ "string", "null" ] } }, "type": "object" } ], "type": [ "object", "null" ] }, "type": "array" } } } }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "response_usd", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.1356, "estimate_source": "profile_seed", "evidence_source": "response_body" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Usage-based billing; Default request estimate: \$0.1356 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.1356 * **Cost contract:** response\_usd * **Published reference multiplier:** 1.0 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml openapi/dataforseo.json POST /apis/v1/dataforseo/dataforseo_labs/google/historical_search_volume/live openapi: 3.1.0 info: description: '' title: DataForSEO version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-catalogs: dataforseo: description: '' title: DataForSEO x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-configured-paths: - >- /apis/v1/dataforseo/ai_optimization/ai_keyword_data/keywords_search_volume/live - >- /apis/v1/dataforseo/ai_optimization/ai_keyword_data/locations_and_languages - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/live - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/models - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/html - >- /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id} - >- /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id} - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_post - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/live - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/models - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/live - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/models - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/languages - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/advanced - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/html - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/locations - >- /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/advanced/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/html/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_post - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/tasks_ready - /apis/v1/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/available_filters - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/historical/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/locations_and_languages - /apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/search/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/search_mentions/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_delta/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_new_lost/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_domains/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands_lite/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_pages/live - /apis/v1/dataforseo/ai_optimization/perplexity/llm_responses/live - /apis/v1/dataforseo/ai_optimization/perplexity/llm_responses/models - /apis/v1/dataforseo/app_data/apple/app_info/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_info/task_post - /apis/v1/dataforseo/app_data/apple/app_list/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_list/task_post - /apis/v1/dataforseo/app_data/apple/app_listings/categories - /apis/v1/dataforseo/app_data/apple/app_listings/search/live - /apis/v1/dataforseo/app_data/apple/app_reviews/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_reviews/task_post - /apis/v1/dataforseo/app_data/apple/app_searches/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_searches/task_post - /apis/v1/dataforseo/app_data/apple/categories - /apis/v1/dataforseo/app_data/apple/languages - /apis/v1/dataforseo/app_data/apple/locations - /apis/v1/dataforseo/app_data/google/app_info/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_info/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_info/task_post - /apis/v1/dataforseo/app_data/google/app_list/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_list/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_list/task_post - /apis/v1/dataforseo/app_data/google/app_listings/categories - /apis/v1/dataforseo/app_data/google/app_listings/search/live - /apis/v1/dataforseo/app_data/google/app_reviews/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_reviews/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_reviews/task_post - /apis/v1/dataforseo/app_data/google/app_searches/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_searches/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_searches/task_post - /apis/v1/dataforseo/app_data/google/categories - /apis/v1/dataforseo/app_data/google/languages - /apis/v1/dataforseo/app_data/google/locations - /apis/v1/dataforseo/backlinks/anchors/live - /apis/v1/dataforseo/backlinks/backlinks/live - /apis/v1/dataforseo/backlinks/bulk_backlinks/live - /apis/v1/dataforseo/backlinks/bulk_new_lost_backlinks/live - /apis/v1/dataforseo/backlinks/bulk_new_lost_referring_domains/live - /apis/v1/dataforseo/backlinks/bulk_pages_summary/live - /apis/v1/dataforseo/backlinks/bulk_ranks/live - /apis/v1/dataforseo/backlinks/bulk_referring_domains/live - /apis/v1/dataforseo/backlinks/bulk_spam_score/live - /apis/v1/dataforseo/backlinks/competitors/live - /apis/v1/dataforseo/backlinks/domain_intersection/live - /apis/v1/dataforseo/backlinks/domain_pages/live - /apis/v1/dataforseo/backlinks/domain_pages_summary/live - /apis/v1/dataforseo/backlinks/history/live - /apis/v1/dataforseo/backlinks/index - /apis/v1/dataforseo/backlinks/page_intersection/live - /apis/v1/dataforseo/backlinks/referring_domains/live - /apis/v1/dataforseo/backlinks/referring_networks/live - /apis/v1/dataforseo/backlinks/summary/live - /apis/v1/dataforseo/backlinks/timeseries_new_lost_summary/live - /apis/v1/dataforseo/backlinks/timeseries_summary/live - /apis/v1/dataforseo/business_data/business_listings/search/live - /apis/v1/dataforseo/business_data/google/extended_reviews/task_get/{id} - /apis/v1/dataforseo/business_data/google/extended_reviews/task_post - /apis/v1/dataforseo/business_data/google/extended_reviews/tasks_ready - /apis/v1/dataforseo/business_data/google/hotel_info/live/advanced - /apis/v1/dataforseo/business_data/google/hotel_info/live/html - /apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id} - /apis/v1/dataforseo/business_data/google/hotel_info/task_get/html/{id} - /apis/v1/dataforseo/business_data/google/hotel_info/task_post - /apis/v1/dataforseo/business_data/google/hotel_info/tasks_ready - /apis/v1/dataforseo/business_data/google/hotel_searches/live - /apis/v1/dataforseo/business_data/google/hotel_searches/task_get/{id} - /apis/v1/dataforseo/business_data/google/hotel_searches/task_post - /apis/v1/dataforseo/business_data/google/hotel_searches/tasks_ready - /apis/v1/dataforseo/business_data/google/my_business_info/live - /apis/v1/dataforseo/business_data/google/my_business_info/task_get/{id} - /apis/v1/dataforseo/business_data/google/my_business_info/task_post - /apis/v1/dataforseo/business_data/google/my_business_info/tasks_ready - /apis/v1/dataforseo/business_data/google/my_business_updates/task_get/{id} - /apis/v1/dataforseo/business_data/google/my_business_updates/task_post - /apis/v1/dataforseo/business_data/google/my_business_updates/tasks_ready - /apis/v1/dataforseo/business_data/google/questions_and_answers/live - >- /apis/v1/dataforseo/business_data/google/questions_and_answers/task_get/{id} - /apis/v1/dataforseo/business_data/google/questions_and_answers/task_post - /apis/v1/dataforseo/business_data/google/questions_and_answers/tasks_ready - /apis/v1/dataforseo/business_data/google/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/google/reviews/task_post - /apis/v1/dataforseo/business_data/google/reviews/tasks_ready - /apis/v1/dataforseo/business_data/social_media/pinterest/live - /apis/v1/dataforseo/business_data/social_media/reddit/live - /apis/v1/dataforseo/business_data/tripadvisor/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post - /apis/v1/dataforseo/business_data/tripadvisor/reviews/tasks_ready - /apis/v1/dataforseo/business_data/tripadvisor/search/task_get/{id} - /apis/v1/dataforseo/business_data/tripadvisor/search/task_post - /apis/v1/dataforseo/business_data/tripadvisor/search/tasks_ready - /apis/v1/dataforseo/business_data/trustpilot/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/trustpilot/reviews/task_post - /apis/v1/dataforseo/business_data/trustpilot/reviews/tasks_ready - /apis/v1/dataforseo/business_data/trustpilot/search/task_get/{id} - /apis/v1/dataforseo/business_data/trustpilot/search/task_post - /apis/v1/dataforseo/business_data/trustpilot/search/tasks_ready - /apis/v1/dataforseo/content_analysis/available_filters - /apis/v1/dataforseo/content_analysis/categories - /apis/v1/dataforseo/content_analysis/category_trends/live - /apis/v1/dataforseo/content_analysis/languages - /apis/v1/dataforseo/content_analysis/locations - /apis/v1/dataforseo/content_analysis/phrase_trends/live - /apis/v1/dataforseo/content_analysis/rating_distribution/live - /apis/v1/dataforseo/content_analysis/search/live - /apis/v1/dataforseo/content_analysis/sentiment_analysis/live - /apis/v1/dataforseo/content_analysis/summary/live - /apis/v1/dataforseo/dataforseo_labs/amazon/bulk_search_volume/live - /apis/v1/dataforseo/dataforseo_labs/amazon/product_competitors/live - >- /apis/v1/dataforseo/dataforseo_labs/amazon/product_keyword_intersections/live - /apis/v1/dataforseo/dataforseo_labs/amazon/product_rank_overview/live - /apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live - /apis/v1/dataforseo/dataforseo_labs/amazon/related_keywords/live - /apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/live - /apis/v1/dataforseo/dataforseo_labs/apple/app_intersection/live - /apis/v1/dataforseo/dataforseo_labs/apple/bulk_app_metrics/live - /apis/v1/dataforseo/dataforseo_labs/apple/keywords_for_app/live - /apis/v1/dataforseo/dataforseo_labs/available_filters - /apis/v1/dataforseo/dataforseo_labs/google/app_competitors/live - /apis/v1/dataforseo/dataforseo_labs/google/app_intersection/live - /apis/v1/dataforseo/dataforseo_labs/google/available_history - /apis/v1/dataforseo/dataforseo_labs/google/bulk_app_metrics/live - /apis/v1/dataforseo/dataforseo_labs/google/bulk_keyword_difficulty/live - /apis/v1/dataforseo/dataforseo_labs/google/bulk_traffic_estimation/live - /apis/v1/dataforseo/dataforseo_labs/google/categories_for_domain/live - >- /apis/v1/dataforseo/dataforseo_labs/google/categories_for_keywords/languages - /apis/v1/dataforseo/dataforseo_labs/google/categories_for_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/competitors_domain/live - /apis/v1/dataforseo/dataforseo_labs/google/domain_intersection/live - >- /apis/v1/dataforseo/dataforseo_labs/google/domain_metrics_by_categories/live - /apis/v1/dataforseo/dataforseo_labs/google/domain_rank_overview/live - >- /apis/v1/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_keyword_data/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_rank_overview/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_search_volume/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_serps/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_ideas/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_overview/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_suggestions/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_app/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_categories/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_site/live - /apis/v1/dataforseo/dataforseo_labs/google/page_intersection/live - /apis/v1/dataforseo/dataforseo_labs/google/ranked_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/related_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/relevant_pages/live - /apis/v1/dataforseo/dataforseo_labs/google/search_intent/live - /apis/v1/dataforseo/dataforseo_labs/google/serp_competitors/live - /apis/v1/dataforseo/dataforseo_labs/google/subdomains/live - /apis/v1/dataforseo/dataforseo_labs/google/top_searches/live - /apis/v1/dataforseo/dataforseo_labs/status - >- /apis/v1/dataforseo/domain_analytics/technologies/aggregation_technologies/live - /apis/v1/dataforseo/domain_analytics/technologies/available_filters - /apis/v1/dataforseo/domain_analytics/technologies/domain_technologies/live - >- /apis/v1/dataforseo/domain_analytics/technologies/domains_by_html_terms/live - >- /apis/v1/dataforseo/domain_analytics/technologies/domains_by_technology/live - /apis/v1/dataforseo/domain_analytics/technologies/languages - /apis/v1/dataforseo/domain_analytics/technologies/locations - /apis/v1/dataforseo/domain_analytics/technologies/technologies - >- /apis/v1/dataforseo/domain_analytics/technologies/technologies_summary/live - /apis/v1/dataforseo/domain_analytics/technologies/technology_stats/live - /apis/v1/dataforseo/domain_analytics/whois/available_filters - /apis/v1/dataforseo/domain_analytics/whois/overview/live - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/industries - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/job_functions - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/live - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/task_post - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/tasks_ready - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/live - >- /apis/v1/dataforseo/keywords_data/bing/keyword_performance/locations_and_languages - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/task_post - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/languages - /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/live - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/task_post - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/tasks_ready - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/live - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/task_post - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/live - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/task_post - /apis/v1/dataforseo/keywords_data/bing/languages - /apis/v1/dataforseo/keywords_data/bing/locations - /apis/v1/dataforseo/keywords_data/bing/search_volume/live - /apis/v1/dataforseo/keywords_data/bing/search_volume/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/search_volume/task_post - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/live - >- /apis/v1/dataforseo/keywords_data/bing/search_volume_history/locations_and_languages - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/task_post - /apis/v1/dataforseo/keywords_data/clickstream_data/bulk_search_volume/live - >- /apis/v1/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live - >- /apis/v1/dataforseo/keywords_data/clickstream_data/global_search_volume/live - /apis/v1/dataforseo/keywords_data/clickstream_data/locations_and_languages - /apis/v1/dataforseo/keywords_data/dataforseo_trends/demography/live - /apis/v1/dataforseo/keywords_data/dataforseo_trends/explore/live - /apis/v1/dataforseo/keywords_data/dataforseo_trends/locations - /apis/v1/dataforseo/keywords_data/dataforseo_trends/merged_data/live - >- /apis/v1/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live - /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/live - >- /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/live - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_post - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/live - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/task_post - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/live - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/task_post - /apis/v1/dataforseo/keywords_data/google_ads/status - /apis/v1/dataforseo/keywords_data/google_trends/categories - /apis/v1/dataforseo/keywords_data/google_trends/explore/live - /apis/v1/dataforseo/keywords_data/google_trends/explore/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_trends/explore/task_post - /apis/v1/dataforseo/merchant/amazon/asin/live/advanced - /apis/v1/dataforseo/merchant/amazon/asin/live/html - /apis/v1/dataforseo/merchant/amazon/asin/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/asin/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/asin/task_post - /apis/v1/dataforseo/merchant/amazon/asin/tasks_ready - /apis/v1/dataforseo/merchant/amazon/languages - /apis/v1/dataforseo/merchant/amazon/locations - /apis/v1/dataforseo/merchant/amazon/products/live/advanced - /apis/v1/dataforseo/merchant/amazon/products/live/html - /apis/v1/dataforseo/merchant/amazon/products/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/products/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/products/task_post - /apis/v1/dataforseo/merchant/amazon/products/tasks_ready - /apis/v1/dataforseo/merchant/amazon/sellers/live/advanced - /apis/v1/dataforseo/merchant/amazon/sellers/live/html - /apis/v1/dataforseo/merchant/amazon/sellers/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/sellers/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/sellers/task_post - /apis/v1/dataforseo/merchant/amazon/sellers/tasks_ready - /apis/v1/dataforseo/merchant/google/languages - /apis/v1/dataforseo/merchant/google/locations - /apis/v1/dataforseo/merchant/google/product_info/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/product_info/task_post - /apis/v1/dataforseo/merchant/google/product_info/tasks_ready - /apis/v1/dataforseo/merchant/google/products/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/products/task_get/html/{id} - /apis/v1/dataforseo/merchant/google/products/task_post - /apis/v1/dataforseo/merchant/google/products/tasks_ready - /apis/v1/dataforseo/merchant/google/reviews/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/reviews/task_post - /apis/v1/dataforseo/merchant/google/reviews/tasks_ready - /apis/v1/dataforseo/merchant/google/sellers/ad_url - /apis/v1/dataforseo/merchant/google/sellers/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/sellers/task_post - /apis/v1/dataforseo/merchant/google/sellers/tasks_ready - /apis/v1/dataforseo/on_page/available_filters - /apis/v1/dataforseo/on_page/content_parsing - /apis/v1/dataforseo/on_page/content_parsing/live - /apis/v1/dataforseo/on_page/duplicate_content - /apis/v1/dataforseo/on_page/duplicate_tags - /apis/v1/dataforseo/on_page/force_stop - /apis/v1/dataforseo/on_page/instant_pages - /apis/v1/dataforseo/on_page/keyword_density - /apis/v1/dataforseo/on_page/lighthouse/audits - /apis/v1/dataforseo/on_page/lighthouse/languages - /apis/v1/dataforseo/on_page/lighthouse/live/json - /apis/v1/dataforseo/on_page/lighthouse/task_get/json/{id} - /apis/v1/dataforseo/on_page/lighthouse/task_post - /apis/v1/dataforseo/on_page/lighthouse/tasks_ready - /apis/v1/dataforseo/on_page/lighthouse/versions - /apis/v1/dataforseo/on_page/links - /apis/v1/dataforseo/on_page/microdata - /apis/v1/dataforseo/on_page/non_indexable - /apis/v1/dataforseo/on_page/page_screenshot - /apis/v1/dataforseo/on_page/pages - /apis/v1/dataforseo/on_page/pages_by_resource - /apis/v1/dataforseo/on_page/raw_html - /apis/v1/dataforseo/on_page/redirect_chains - /apis/v1/dataforseo/on_page/resources - /apis/v1/dataforseo/on_page/summary/{id} - /apis/v1/dataforseo/on_page/task_post - /apis/v1/dataforseo/on_page/tasks_ready - /apis/v1/dataforseo/on_page/uncrawlable_resources - /apis/v1/dataforseo/on_page/waterfall - /apis/v1/dataforseo/serp/ai_summary - /apis/v1/dataforseo/serp/baidu/languages - /apis/v1/dataforseo/serp/baidu/locations - /apis/v1/dataforseo/serp/baidu/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_post - /apis/v1/dataforseo/serp/baidu/organic/tasks_ready - /apis/v1/dataforseo/serp/bing/languages - /apis/v1/dataforseo/serp/bing/locations - /apis/v1/dataforseo/serp/bing/organic/live/advanced - /apis/v1/dataforseo/serp/bing/organic/live/html - /apis/v1/dataforseo/serp/bing/organic/live/regular - /apis/v1/dataforseo/serp/bing/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/bing/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/bing/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/bing/organic/task_post - /apis/v1/dataforseo/serp/bing/organic/tasks_ready - /apis/v1/dataforseo/serp/google/ads_advertisers/live/advanced - /apis/v1/dataforseo/serp/google/ads_advertisers/locations - /apis/v1/dataforseo/serp/google/ads_advertisers/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ads_advertisers/task_post - /apis/v1/dataforseo/serp/google/ads_advertisers/tasks_ready - /apis/v1/dataforseo/serp/google/ads_search/live/advanced - /apis/v1/dataforseo/serp/google/ads_search/locations - /apis/v1/dataforseo/serp/google/ads_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ads_search/task_post - /apis/v1/dataforseo/serp/google/ads_search/tasks_ready - /apis/v1/dataforseo/serp/google/ai_mode/languages - /apis/v1/dataforseo/serp/google/ai_mode/live/advanced - /apis/v1/dataforseo/serp/google/ai_mode/live/html - /apis/v1/dataforseo/serp/google/ai_mode/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ai_mode/task_get/html/{id} - /apis/v1/dataforseo/serp/google/ai_mode/task_post - /apis/v1/dataforseo/serp/google/ai_mode/tasks_ready - /apis/v1/dataforseo/serp/google/autocomplete/live/advanced - /apis/v1/dataforseo/serp/google/autocomplete/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/autocomplete/task_post - /apis/v1/dataforseo/serp/google/autocomplete/tasks_ready - /apis/v1/dataforseo/serp/google/dataset_info/live/advanced - /apis/v1/dataforseo/serp/google/dataset_info/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/dataset_info/task_post - /apis/v1/dataforseo/serp/google/dataset_info/tasks_ready - /apis/v1/dataforseo/serp/google/dataset_search/live/advanced - /apis/v1/dataforseo/serp/google/dataset_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/dataset_search/task_post - /apis/v1/dataforseo/serp/google/dataset_search/tasks_ready - /apis/v1/dataforseo/serp/google/events/live/advanced - /apis/v1/dataforseo/serp/google/events/locations - /apis/v1/dataforseo/serp/google/events/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/events/task_post - /apis/v1/dataforseo/serp/google/events/tasks_ready - /apis/v1/dataforseo/serp/google/finance_explore/live/advanced - /apis/v1/dataforseo/serp/google/finance_explore/live/html - /apis/v1/dataforseo/serp/google/finance_explore/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_explore/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_explore/task_post - /apis/v1/dataforseo/serp/google/finance_explore/tasks_ready - /apis/v1/dataforseo/serp/google/finance_markets/live/advanced - /apis/v1/dataforseo/serp/google/finance_markets/live/html - /apis/v1/dataforseo/serp/google/finance_markets/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_markets/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_markets/task_post - /apis/v1/dataforseo/serp/google/finance_markets/tasks_ready - /apis/v1/dataforseo/serp/google/finance_quote/live/advanced - /apis/v1/dataforseo/serp/google/finance_quote/live/html - /apis/v1/dataforseo/serp/google/finance_quote/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_quote/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_quote/task_post - /apis/v1/dataforseo/serp/google/finance_quote/tasks_ready - /apis/v1/dataforseo/serp/google/finance_ticker_search/live/advanced - >- /apis/v1/dataforseo/serp/google/finance_ticker_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_ticker_search/task_post - /apis/v1/dataforseo/serp/google/finance_ticker_search/tasks_ready - /apis/v1/dataforseo/serp/google/images/live/advanced - /apis/v1/dataforseo/serp/google/images/live/html - /apis/v1/dataforseo/serp/google/images/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/images/task_get/html/{id} - /apis/v1/dataforseo/serp/google/images/task_get/regular/{id} - /apis/v1/dataforseo/serp/google/images/task_post - /apis/v1/dataforseo/serp/google/images/tasks_ready - /apis/v1/dataforseo/serp/google/jobs/locations - /apis/v1/dataforseo/serp/google/jobs/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/jobs/task_get/html/{id} - /apis/v1/dataforseo/serp/google/jobs/task_post - /apis/v1/dataforseo/serp/google/jobs/tasks_ready - /apis/v1/dataforseo/serp/google/languages - /apis/v1/dataforseo/serp/google/local_finder/live/advanced - /apis/v1/dataforseo/serp/google/local_finder/live/html - /apis/v1/dataforseo/serp/google/local_finder/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/local_finder/task_get/html/{id} - /apis/v1/dataforseo/serp/google/local_finder/task_post - /apis/v1/dataforseo/serp/google/local_finder/tasks_ready - /apis/v1/dataforseo/serp/google/locations - /apis/v1/dataforseo/serp/google/maps/live/advanced - /apis/v1/dataforseo/serp/google/maps/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/maps/task_post - /apis/v1/dataforseo/serp/google/maps/tasks_ready - /apis/v1/dataforseo/serp/google/news/live/advanced - /apis/v1/dataforseo/serp/google/news/live/html - /apis/v1/dataforseo/serp/google/news/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/news/task_get/html/{id} - /apis/v1/dataforseo/serp/google/news/task_post - /apis/v1/dataforseo/serp/google/news/tasks_ready - /apis/v1/dataforseo/serp/google/organic/live/advanced - /apis/v1/dataforseo/serp/google/organic/live/html - /apis/v1/dataforseo/serp/google/organic/live/regular - /apis/v1/dataforseo/serp/google/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/google/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/google/organic/task_post - /apis/v1/dataforseo/serp/google/organic/tasks_ready - /apis/v1/dataforseo/serp/google/search_by_image/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/search_by_image/task_get/html/{id} - /apis/v1/dataforseo/serp/google/search_by_image/task_post - /apis/v1/dataforseo/serp/google/search_by_image/tasks_ready - /apis/v1/dataforseo/serp/naver/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/naver/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/naver/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/naver/organic/task_post - /apis/v1/dataforseo/serp/naver/organic/tasks_ready - /apis/v1/dataforseo/serp/screenshot - /apis/v1/dataforseo/serp/seznam/languages - /apis/v1/dataforseo/serp/seznam/locations - /apis/v1/dataforseo/serp/seznam/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_post - /apis/v1/dataforseo/serp/seznam/organic/tasks_ready - /apis/v1/dataforseo/serp/yahoo/languages - /apis/v1/dataforseo/serp/yahoo/locations - /apis/v1/dataforseo/serp/yahoo/organic/live/advanced - /apis/v1/dataforseo/serp/yahoo/organic/live/html - /apis/v1/dataforseo/serp/yahoo/organic/live/regular - /apis/v1/dataforseo/serp/yahoo/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_post - /apis/v1/dataforseo/serp/yahoo/organic/tasks_ready - /apis/v1/dataforseo/serp/youtube/languages - /apis/v1/dataforseo/serp/youtube/locations - /apis/v1/dataforseo/serp/youtube/organic/live/advanced - /apis/v1/dataforseo/serp/youtube/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/organic/task_post - /apis/v1/dataforseo/serp/youtube/organic/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_comments/live/advanced - /apis/v1/dataforseo/serp/youtube/video_comments/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_comments/task_post - /apis/v1/dataforseo/serp/youtube/video_comments/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_info/live/advanced - /apis/v1/dataforseo/serp/youtube/video_info/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_info/task_post - /apis/v1/dataforseo/serp/youtube/video_info/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_subtitles/live/advanced - /apis/v1/dataforseo/serp/youtube/video_subtitles/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_subtitles/task_post - /apis/v1/dataforseo/serp/youtube/video_subtitles/tasks_ready x-aisa-document: composer_version: '20' document_hash: sha256:247f0a53489bda2c81b4142a1275f7af13128904396e39f2485c6ba921e0d40a facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c generator_version: '3' protocol_version: '1' response_pending: [] schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: dataforseo servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/dataforseo/dataforseo_labs/google/historical_search_volume/live: post: tags: - default summary: Live Dataforseo Labs Google Historical Search Volume description: >- DataForSEO POST /v3/dataforseo_labs/google/historical_search_volume/live Usage-based billing; Default request estimate: $0.1356 USD (not a fixed price). Account-specific pricing and final settlement may differ. operationId: any_dataforseo_apis_v1_dataforseo_dataforseo_labs_13ede5 requestBody: content: application/json: schema: example: - include_serp_info: true keywords: - phone - watch language_name: English location_code: 2840 items: oneOf: - example: - include_serp_info: true keywords: - phone - watch language_name: English location_code: 2840 properties: include_clickstream_data: description: "include or exclude data from clickstream-based metrics in the result\noptional field\nif the parameter is set to\_true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response\ndefault value: false\nwith this parameter enabled, you will be charged double the price for the request\nlearn more about how clickstream-based metrics are calculated in this help center article" type: - boolean - 'null' include_serp_info: description: >- include data from SERP for each keyword optional field if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response default value: false type: - boolean - 'null' keywords: description: >- keywords required field The maximum number of keywords you can specify: 700 The maximum number of characters for each keyword: 80 The maximum number of words for each keyword phrase: 10 the specified keywords will be converted to lowercase format, data will be provided in a separate array note that if some of the keywords specified in this array are omitted in the results you receive, then our database doesn’t contain such keywords and cannot return data on them you will not be charged for the keywords omitted in the results learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article items: type: string type: array language_code: description: >- language code required field if you don’t specify language_name Note: it is required to specify either language_name or language_code you can receive the list of available locations with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: en type: - string - 'null' language_name: description: >- full name of the language required field if you don’t specify language_code Note: it is required to specify either language_name or language_code you can receive the list of available locations with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: English type: - string - 'null' location_code: description: >- location code required field if you don’t specify location_name Note: it is required to specify either location_name or location_code you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: 2840 type: - integer - 'null' location_name: description: >- full name of the location required field if you don’t specify location_code Note: it is required to specify either location_name or location_code you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: United Kingdom type: - string - 'null' tag: description: >- user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response type: - string - 'null' type: object type: - object - 'null' type: array responses: '200': content: application/json: schema: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleHistoricalSearchVolumeLiveResponseInfo type: - object - 'null' description: Successful operation default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats x-codeSamples: - label: Reference example lang: text source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request POST \ --url https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/google/historical_search_volume/live \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '[ { "keywords": [ "phone", "watch" ], "language_name": "English", "location_code": 2840, "include_serp_info": true } ]' components: schemas: Response463397119C53_DataforseoLabsGoogleHistoricalSearchVolumeLiveResponseInfo: allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseInfo' - properties: tasks: description: array of tasks items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleHistoricalSearchVolumeLiveTaskInfo type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_BaseResponseInfo: properties: cost: description: total tasks cost, USD format: double type: - number - 'null' status_code: description: |- general status code you can find the full list of the response codes here type: - integer - 'null' status_message: description: |- general informational message you can find the full list of general informational messages here type: - string - 'null' tasks_count: description: the number of tasks in the tasks array format: int64 type: - integer - 'null' tasks_error: description: the number of tasks in the tasks array returned with an error format: int64 type: - integer - 'null' time: description: total execution time, seconds type: - string - 'null' version: description: the current version of the API type: - string - 'null' Response463397119C53_DataforseoLabsGoogleHistoricalSearchVolumeLiveTaskInfo: allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseTaskInfo' - properties: result: description: array of results items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleHistoricalSearchVolumeLiveResultInfo type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_BaseResponseTaskInfo: properties: cost: description: total tasks cost, USD format: double type: - number - 'null' data: additionalProperties: type: - object - 'null' description: contains the same parameters that you specified in the POST request type: - object - 'null' id: description: |- task identifier unique task identifier in our system in the UUID format type: - string - 'null' path: description: URL path items: type: - string - 'null' type: - array - 'null' result_count: description: number of elements in the result array format: int64 type: - integer - 'null' status_code: description: >- status code of the task generated by DataForSEO, can be within the following range: 10000-60000 you can find the full list of the response codes here type: - integer - 'null' status_message: description: |- informational message of the task you can find the full list of general informational messages here type: - string - 'null' time: description: execution time, seconds type: - string - 'null' Response463397119C53_DataforseoLabsGoogleHistoricalSearchVolumeLiveResultInfo: properties: items: description: contains keywords and related data items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleHistoricalSearchVolumeLiveItem type: - object - 'null' type: - array - 'null' items_count: description: the number of results returned in the items array format: int64 type: - integer - 'null' language_code: description: language code in a POST array type: - string - 'null' location_code: description: location code in a POST array type: - integer - 'null' se_type: description: search engine type type: - string - 'null' type: object Response463397119C53_DataforseoLabsGoogleHistoricalSearchVolumeLiveItem: properties: avg_backlinks_info: description: >- backlink data for the returned keyword this object provides the average number of backlinks, referring pages and domains, as well as the average rank values among the top-10 websites ranking organically for the keyword oneOf: - $ref: '#/components/schemas/Response463397119C53_AvgBacklinksInfo' type: - object - 'null' clickstream_keyword_info: description: >- clickstream data for the returned keyword to retrieve results for this field, the parameter include_clickstream_data must be set to true oneOf: - $ref: '#/components/schemas/Response463397119C53_ClickstreamKeywordInfo' type: - object - 'null' keyword: description: >- keyword keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character) type: - string - 'null' keyword_info: description: keyword data for the returned keyword idea oneOf: - $ref: '#/components/schemas/Response463397119C53_KeywordInfo' type: - object - 'null' keyword_info_normalized_with_bing: description: contains keyword search volume normalized with Bing search volume oneOf: - $ref: >- #/components/schemas/Response463397119C53_KeywordInfoNormalizedWithInfo type: - object - 'null' keyword_info_normalized_with_clickstream: description: contains keyword search volume normalized with clickstream data oneOf: - $ref: >- #/components/schemas/Response463397119C53_KeywordInfoNormalizedWithInfo type: - object - 'null' keyword_properties: description: additional information about the keyword oneOf: - $ref: '#/components/schemas/Response463397119C53_KeywordProperties' type: - object - 'null' language_code: description: language code in a POST array type: - string - 'null' location_code: description: location code in a POST array type: - integer - 'null' se_type: description: search engine type type: - string - 'null' search_partners: description: >- indicates data for Google and partner sites if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if false, the results are returned for Google search sites only type: - boolean - 'null' serp_info: description: >- SERP data the value will be null if you didn’t set the field include_serp_info to true in the POST array or if there is no SERP data for this keyword in our database oneOf: - $ref: '#/components/schemas/Response463397119C53_SerpInfo' type: - object - 'null' type: object Response463397119C53_AvgBacklinksInfo: properties: backlinks: description: average number of backlinks type: - number - 'null' dofollow: description: average number of dofollow links type: - number - 'null' last_updated_time: description: >- date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' main_domain_rank: description: >- average main domain rank
learn more about the metric and its calculation formula in this help center article type: - number - 'null' rank: description: >- average rank
learn more about the metric and its calculation formula in this help center article type: - number - 'null' referring_domains: description: average number of referring domains type: - number - 'null' referring_main_domains: description: average number of referring main domains type: - number - 'null' referring_pages: description: average number of referring pages type: - number - 'null' se_type: description: search engine type type: - string - 'null' type: object Response463397119C53_ClickstreamKeywordInfo: properties: age_distribution: additionalProperties: format: int64 type: - integer - 'null' description: >- distribution of clickstream-based metrics by age
learn more about how the metric is calculated in this help center article type: - object - 'null' gender_distribution: additionalProperties: format: int64 type: - integer - 'null' description: >- distribution of estimated clickstream-based metrics by gender
learn more about how the metric is calculated in this help center article type: - object - 'null' last_updated_time: description: >- date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' monthly_searches: description: >- monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations items: oneOf: - $ref: '#/components/schemas/Response463397119C53_MonthlySearchesInfo' type: - object - 'null' type: - array - 'null' search_volume: description: >- average monthly search volume rate
represents the (approximate) number of searches for the given keyword idea on google.com format: int64 type: - integer - 'null' type: object Response463397119C53_KeywordInfo: properties: categories: description: >- product and service categories
you can download the full list of possible categories items: type: integer type: - array - 'null' competition: description: >- competition
represents the relative amount of competition associated with the given keyword. This value is based on Google Ads data and can be between 0 and 1 (inclusive) type: - number - 'null' competition_level: description: >- competition level
represents the relative level of competition associated with the given keyword in paid SERP only;
possible values: LOW, MEDIUM, HIGH
if competition level is unknown, the value is null;
learn more about the metric in this help center article type: - string - 'null' cpc: description: >- cost-per-click
represents the average cost per click (USD) historically paid for the keyword type: - number - 'null' high_top_of_page_bid: description: >- maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request type: - number - 'null' last_updated_time: description: >- date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' low_top_of_page_bid: description: >- minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request type: - number - 'null' monthly_searches: description: >- monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations items: oneOf: - $ref: '#/components/schemas/Response463397119C53_MonthlySearchesInfo' type: - object - 'null' type: - array - 'null' se_type: description: search engine type type: - string - 'null' search_volume: description: >- average monthly search volume rate
represents the (approximate) number of searches for the given keyword idea on google.com format: int64 type: - integer - 'null' search_volume_trend: description: >- search volume trend changes
represents search volume change in percent compared to the previous period oneOf: - $ref: '#/components/schemas/Response463397119C53_SearchVolumeTrend' type: - object - 'null' type: object Response463397119C53_KeywordInfoNormalizedWithInfo: properties: is_normalized: description: |- keyword info is normalized if true, values are normalized with Bing data type: - boolean - 'null' last_updated_time: description: |- date and time when the dataset was updated in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 type: - string - 'null' monthly_searches: description: >- monthly search volume rates array of objects with search volume rates in a certain month of a year items: oneOf: - $ref: '#/components/schemas/Response463397119C53_MonthlySearchesInfo' type: - object - 'null' type: - array - 'null' search_volume: description: current search volume rate of a keyword type: - integer - 'null' type: object Response463397119C53_KeywordProperties: properties: core_keyword: description: >- main keyword in a group
contains the main keyword in a group determined by the synonym clustering algorithm
if the value is null, our database does not contain any keywords the corresponding algorithm could identify as synonymous with keyword type: - string - 'null' detected_language: description: >- detected language of the keyword
indicates the language of the keyword as identified by our system type: - string - 'null' is_another_language: description: >- detected language of the keyword is different from the set language
if true, the language set in the request does not match the language determined by our system for a given keyword type: - boolean - 'null' keyword_difficulty: description: >- difficulty of ranking in the first top-10 organic results for a keyword
indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;
calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP;
learn more about the metric in this help center guide type: - integer - 'null' se_type: description: search engine type type: - string - 'null' synonym_clustering_algorithm: description: >- the algorithm used to identify synonyms
possible values:
keyword_metrics - indicates the algorithm based on keyword_info parameters
text_processing - indicates the text-based algorithm
if the value is null, our database does not contain any keywords the corresponding algorithm could identify as synonymous with keyword type: - string - 'null' words_count: description: >- number of words in the keyword
indicates how many words the keyword consists of format: int64 type: - integer - 'null' type: object Response463397119C53_SerpInfo: properties: check_url: description: >- direct URL to search engine results
you can use it to make sure that we provided accurate results type: - string - 'null' last_updated_time: description: >- date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' previous_updated_time: description: >- previous to the most recent date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-10-15 12:57:46 +00:00 type: - string - 'null' se_results_count: description: number of search results for the returned keyword format: int64 type: - integer - 'null' se_type: description: search engine type type: - string - 'null' serp_item_types: description: >- types of search results in SERP
contains types of search results (items) found in SERP
possible item types:
answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
note that the actual results will be returned only for organic, paid, featured_snippet, and local_pack elements items: type: - string - 'null' type: - array - 'null' type: object Response463397119C53_MonthlySearchesInfo: properties: month: description: month type: - integer - 'null' search_volume: description: monthly average search volume rate type: - integer - 'null' year: description: year type: - integer - 'null' type: object Response463397119C53_SearchVolumeTrend: properties: monthly: description: >- search volume change in percent compared to the previous month type: - integer - 'null' quarterly: description: >- search volume change in percent compared to the previous quarter type: - integer - 'null' yearly: description: >- search volume change in percent compared to the previous year type: - integer - 'null' type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.