> ## 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 # Domain Intersection > This endpoint will provide you with the keywords for which both specified domains rank within the same SERP. You will get search volume, competition, cost-per-click and other data on each intersecting keyword. Along with that, you will get data on the first and second domain’s SERP element discovered for this keyword, as well as the estimated traffic volume and cost of ad traffic. Domain Intersection endpoint supports organic, paid, local pack, and featured snippet results. for more info please visit 'https://docs.dataforseo.com/v3/dataforseo_labs/google/domain_intersection/live/?bash' Usage-based billing; Default request estimate: $0.0124 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/domain\_intersection/live * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/dataforseo/dataforseo\_labs/google/domain\_intersection/live](https://api.aisa.one/apis/v1/dataforseo/dataforseo\_labs/google/domain\_intersection/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_3bf2d2", "method": "POST", "path": "/apis/v1/dataforseo/dataforseo_labs/google/domain_intersection/live", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "example": [ { "include_serp_info": true, "language_code": "en", "limit": 3, "location_code": 2840, "target1": "mom.com", "target2": "quora.com" } ], "items": { "oneOf": [ { "example": [ { "include_serp_info": true, "language_code": "en", "limit": 3, "location_code": 2840, "target1": "mom.com", "target2": "quora.com" } ], "properties": { "filters": { "description": "array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters example: [\"keyword_data.keyword_info.search_volume\",\"in\",[100,1000]] [[\"first_domain_serp_element.etv\",\">\",0],\"and\",[\"first_domain_serp_element.description\",\"like\",\"%goat%\"]] [[\"keyword_data.keyword_info.search_volume\",\">\",100], \"and\", [[\"first_domain_serp_element.description\",\"like\",\"%goat%\"], \"or\", [\"second_domain_serp_element.type\",\"=\",\"organic\"]]] for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide", "items": { "type": [ "object", "null" ] }, "type": [ "array", "null" ] }, "include_clickstream_data": { "description": "include or exclude data from clickstream-based metrics in the result optional field if the parameter is set to true, you will receive clickstream_keyword_info, clickstream_etv, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response default value: false with this parameter enabled, you will be charged double the price for the request learn 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" ] }, "intersections": { "description": "domain intersections in SERP optional field if you set intersections to true, you will get the keywords for which both target domains specified as target1 and target2 have results within the same SERP; the corresponding SERP elements for both domains will be provided in the results array Note: this endpoint will not provide results if the number of intersecting keywords exceeds 10 million if you specify intersections: false, you will get the keywords for which the domain specified as target1 has results in SERP, and the domain specified as target2 doesn't; thus, the corresponding SERP elements and other data will be provided for the domain specified as target1only default value: true", "type": [ "boolean", "null" ] }, "item_types": { "description": "search results type indicates type of search results included in the response optional field possible values: [\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"] default value: [\"organic\", \"paid\"]", "items": { "type": "string" }, "type": [ "array", "null" ] }, "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 languages 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 languages 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" ] }, "limit": { "description": "the maximum number of returned keywords optional field default value: 100 maximum value: 1000", "type": [ "integer", "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" ] }, "offset": { "description": "offset in the items array of returned keywords optional field default value: 0 if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords", "type": [ "integer", "null" ] }, "order_by": { "description": "results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc - results will be sorted in the ascending order desc - results will be sorted in the descending order you should use a comma to set up a sorting parameter example: [\"keyword_data.keyword_info.competition,desc\"] default rule: [\"keyword_data.keyword_info.search_volume,desc\"] note that you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules example: [\"keyword_data.keyword_info.search_volume,desc\",\"keyword_data.keyword_info.cpc,desc\"]", "items": { "type": "string" }, "type": [ "array", "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" ] }, "target1": { "description": "domain required field the domain name of the first target website the domain should be specified without https:// and www.", "type": "string" }, "target2": { "description": "domain required field the domain name of the second target website the domain should be specified without https:// and www.", "type": "string" } }, "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.0124, "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.0124 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.0124 * **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/domain_intersection/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/domain_intersection/live: post: tags: - default summary: Domain Intersection description: >- This endpoint will provide you with the keywords for which both specified domains rank within the same SERP. You will get search volume, competition, cost-per-click and other data on each intersecting keyword. Along with that, you will get data on the first and second domain’s SERP element discovered for this keyword, as well as the estimated traffic volume and cost of ad traffic. Domain Intersection endpoint supports organic, paid, local pack, and featured snippet results. for more info please visit 'https://docs.dataforseo.com/v3/dataforseo_labs/google/domain_intersection/live/?bash' Usage-based billing; Default request estimate: $0.0124 USD (not a fixed price). Account-specific pricing and final settlement may differ. operationId: any_dataforseo_apis_v1_dataforseo_dataforseo_labs_3bf2d2 requestBody: content: application/json: schema: example: - include_serp_info: true language_code: en limit: 3 location_code: 2840 target1: mom.com target2: quora.com items: oneOf: - example: - include_serp_info: true language_code: en limit: 3 location_code: 2840 target1: mom.com target2: quora.com properties: filters: description: >- array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters example: ["keyword_data.keyword_info.search_volume","in",[100,1000]] [["first_domain_serp_element.etv",">",0],"and",["first_domain_serp_element.description","like","%goat%"]] [["keyword_data.keyword_info.search_volume",">",100], "and", [["first_domain_serp_element.description","like","%goat%"], "or", ["second_domain_serp_element.type","=","organic"]]] for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide items: type: - object - 'null' type: - array - 'null' include_clickstream_data: description: "include or exclude data from clickstream-based metrics in the result optional field if the parameter is set to\_true, you will receive clickstream_keyword_info, clickstream_etv, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response default value: false with this parameter enabled, you will be charged double the price for the request learn 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' intersections: description: >- domain intersections in SERP optional field if you set intersections to true, you will get the keywords for which both target domains specified as target1 and target2 have results within the same SERP; the corresponding SERP elements for both domains will be provided in the results array Note: this endpoint will not provide results if the number of intersecting keywords exceeds 10 million if you specify intersections: false, you will get the keywords for which the domain specified as target1 has results in SERP, and the domain specified as target2 doesn't; thus, the corresponding SERP elements and other data will be provided for the domain specified as target1only default value: true type: - boolean - 'null' item_types: description: >- search results type indicates type of search results included in the response optional field possible values: ["organic", "paid", "featured_snippet", "local_pack"] default value: ["organic", "paid"] items: type: string type: - array - 'null' 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 languages 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 languages 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' limit: description: >- the maximum number of returned keywords optional field default value: 100 maximum value: 1000 type: - integer - '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' offset: description: >- offset in the items array of returned keywords optional field default value: 0 if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords type: - integer - 'null' order_by: description: >- results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc - results will be sorted in the ascending order desc - results will be sorted in the descending order you should use a comma to set up a sorting parameter example: ["keyword_data.keyword_info.competition,desc"] default rule: ["keyword_data.keyword_info.search_volume,desc"] note that you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules example: ["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"] items: type: string type: - array - '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' target1: description: >- domain required field the domain name of the first target website the domain should be specified without https:// and www. type: string target2: description: >- domain required field the domain name of the second target website the domain should be specified without https:// and www. type: string type: object type: - object - 'null' type: array responses: '200': content: application/json: schema: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleDomainIntersectionLiveResponseInfo 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/domain_intersection/live \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '[ { "target1": "mom.com", "target2": "quora.com", "language_code": "en", "location_code": 2840, "include_serp_info": true, "limit": 3 } ]' components: schemas: Response463397119C53_DataforseoLabsGoogleDomainIntersectionLiveResponseInfo: allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseInfo' - properties: tasks: description: array of tasks items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleDomainIntersectionLiveTaskInfo 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_DataforseoLabsGoogleDomainIntersectionLiveTaskInfo: allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseTaskInfo' - properties: result: description: array of results items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleDomainIntersectionLiveResultInfo 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_DataforseoLabsGoogleDomainIntersectionLiveResultInfo: properties: items: description: contains keywords, relevant SERP elements and related data items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleDomainIntersectionLiveItem 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' target1: description: the first target domain in a POST array type: - string - 'null' target2: description: the second target domain in a POST array type: - string - 'null' total_count: description: total amount of results in our database relevant to your request format: int64 type: - integer - 'null' type: object Response463397119C53_DataforseoLabsGoogleDomainIntersectionLiveItem: properties: first_domain_serp_element: description: >- contains data on the first domain's SERP element found for the returned keyword the list of supported SERP elements can be found below oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' keyword_data: description: keyword data for the returned keyword oneOf: - $ref: '#/components/schemas/Response463397119C53_KeywordDataInfo' type: - object - 'null' se_type: description: search engine type type: - string - 'null' second_domain_serp_element: description: >- contains data on the second domain's SERP element found for the returned keyword the list of supported SERP elements can be found below oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' type: object Response463397119C53_BaseDataforseoLabsApiElementItem: additionalProperties: false discriminator: mapping: answer_box: >- #/components/schemas/Response463397119C53_DataLabsAnswerBoxSerpElementItem carousel: >- #/components/schemas/Response463397119C53_DataLabsCarouselSerpElementItem commercial_units: >- #/components/schemas/Response463397119C53_DataLabsCommercialUnitsSerpElementItem courses: >- #/components/schemas/Response463397119C53_DataLabsCoursesSerpElementItem events: >- #/components/schemas/Response463397119C53_DataLabsEventsSerpElementItem explore_brands: >- #/components/schemas/Response463397119C53_DataLabsExploreBrandsSerpElementItem featured_snippet: >- #/components/schemas/Response463397119C53_DataLabsFeaturedSnippetSerpElementItem find_results_on: >- #/components/schemas/Response463397119C53_DataLabsFindResultsOnSerpElementItem found_on_web: >- #/components/schemas/Response463397119C53_DataLabsFoundOnWebSerpElementItem google_flights: >- #/components/schemas/Response463397119C53_DataLabsGoogleFlightsSerpElementItem google_hotels: >- #/components/schemas/Response463397119C53_DataLabsGoogleHotelsSerpElementItem google_posts: >- #/components/schemas/Response463397119C53_DataLabsGooglePostsSerpElementItem google_reviews: >- #/components/schemas/Response463397119C53_DataLabsGoogleReviewsSerpElementItem hotels_pack: >- #/components/schemas/Response463397119C53_DataLabsHotelsPackSerpElementItem images: >- #/components/schemas/Response463397119C53_DataLabsImagesSerpElementItem jobs: >- #/components/schemas/Response463397119C53_DataLabsJobsSerpElementItem knowledge_graph: >- #/components/schemas/Response463397119C53_DataLabsKnowledgeGraphSerpElementItem local_pack: >- #/components/schemas/Response463397119C53_DataLabsLocalPackSerpElementItem local_services: >- #/components/schemas/Response463397119C53_DataLabsLocalServicesSerpElementItem map: '#/components/schemas/Response463397119C53_DataLabsMapSerpElementItem' math_solver: >- #/components/schemas/Response463397119C53_DataLabsMathSolverSerpElementItem mention_carousel: >- #/components/schemas/Response463397119C53_DataLabsMentionCarouselSerpElementItem multi_carousel: >- #/components/schemas/Response463397119C53_DataLabsMultiCarouselSerpElementItem organic: >- #/components/schemas/Response463397119C53_DataLabsOrganicSerpElementItem paid: >- #/components/schemas/Response463397119C53_DataLabsPaidSerpElementItem people_also_ask: >- #/components/schemas/Response463397119C53_DataLabsPeopleAlsoAskSerpElementItem people_also_search: >- #/components/schemas/Response463397119C53_DataLabsPeopleAlsoSearchSerpElementItem podcasts: >- #/components/schemas/Response463397119C53_DataLabsPodcastsSerpElementItem popular_products: >- #/components/schemas/Response463397119C53_DataLabsPopularProductsSerpElementItem questions_and_answers: >- #/components/schemas/Response463397119C53_DataLabsQuestionsAndAnswersSerpElementItem recipes: >- #/components/schemas/Response463397119C53_DataLabsRecipesSerpElementItem related_searches: >- #/components/schemas/Response463397119C53_DataLabsRelatedSearchesSerpElementItem scholarly_articles: >- #/components/schemas/Response463397119C53_DataLabsScholarlyArticlesSerpElementItem shopping: >- #/components/schemas/Response463397119C53_DataLabsShoppingSerpElementItem stocks_box: >- #/components/schemas/Response463397119C53_DataLabsStocksBoxSerpElementItem top_sights: >- #/components/schemas/Response463397119C53_DataLabsTopSightsSerpElementItem top_stories: >- #/components/schemas/Response463397119C53_DataLabsTopStoriesSerpElementItem twitter: >- #/components/schemas/Response463397119C53_DataLabsTwitterSerpElementItem video: >- #/components/schemas/Response463397119C53_DataLabsVideoSerpElementItem visual_stories: >- #/components/schemas/Response463397119C53_DataLabsVisualStoriesSerpElementItem propertyName: type properties: position: description: >- the alignment of the element in SERP
can take the following values:
left, right type: - string - 'null' rank_absolute: description: >- absolute rank in SERP
absolute position among all the elements in SERP type: - integer - 'null' rank_group: description: >- position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group type: - integer - 'null' se_type: description: search engine type type: - string - 'null' type: description: type of element type: - string - 'null' xpath: description: >- the XPath of the element type: - string - 'null' type: object Response463397119C53_KeywordDataInfo: 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 webpages 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: returned keyword idea 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_intent_info: description: >- search intent info for the returned keyword
learn about search intent in this help center article oneOf: - $ref: '#/components/schemas/Response463397119C53_SearchIntentInfo' type: - object - '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_DataLabsAnswerBoxSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: links: description: >- sitelinks
the links shown below some of Google's search results
if there are none, equals null items: oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: - array - 'null' text: description: >- text
if there is none, equals null items: type: - string - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsCarouselSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsCarouselElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsCommercialUnitsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_CommercialUnitsElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsCoursesSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: categories: description: |- array of course categories contains a list of categories relevant to courses items: type: - string - 'null' type: - array - 'null' items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_CoursesElement' type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object deprecated: true type: object Response463397119C53_DataLabsEventsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_EventsElement' type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsExploreBrandsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_ExploreBrandsElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object deprecated: true type: object Response463397119C53_DataLabsFeaturedSnippetSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: backlinks_info: description: backlinks information for the relevant page URL oneOf: - $ref: '#/components/schemas/Response463397119C53_BacklinksInfo' type: - object - 'null' clickstream_etv: description: >- estimated traffic volume based on clickstream data
calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain or webpage ranks for;
to retrieve results for this field, the parameter include_clickstream_data must be set to true;
learn more about how the metric is calculated in this help center article format: double type: - number - 'null' description: description: description of the results element in SERP type: - string - 'null' domain: description: subdomain in SERP type: - string - 'null' estimated_paid_traffic_cost: description: >- estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads for all keywords that a domain or webpage ranks for;
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search;
learn more about how the metric is calculated in this help center article type: - number - 'null' etv: description: >- estimated traffic volume
estimated organic monthly traffic to the domain or webpage;
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain or webpage rank for;
learn more about how the metric is calculated in this help center article type: - number - 'null' featured_title: description: the title of the featured snippets source page type: - string - 'null' main_domain: description: primary domain name in SERP type: - string - 'null' rank_changes: description: >- changes in rankings
contains information about the ranking changes of the SERP element since the previous_updated_time oneOf: - $ref: '#/components/schemas/Response463397119C53_RankChanges' properties: is_down: description: >- rank of this element went down if the value is true, position of the element in SERP is lower compared to the previous check type: boolean is_new: description: >- element was previously present in SERP if the value is true, previously collected SERP didn’t contain this element type: boolean is_up: description: >- rank of this element went up if the value is true, position of the element in SERP is higher compared to the previous check type: boolean previous_rank_absolute: description: |- previous absolute rank in SERP indicates previous rank of the element in Google SERP; if this element is new, the value will be null type: - number - 'null' type: - object - 'null' rank_info: description: page and domain rank information oneOf: - $ref: '#/components/schemas/Response463397119C53_RankInfo' type: - object - 'null' relative_url: description: >- URL in SERP that does not specify the HTTPs protocol and domain name type: - string - 'null' table: description: >- results table
if there are none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_Table' type: - object - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsFindResultsOnSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_FindResultsOnElement type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsFoundOnWebSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_FoundOnWebElement type: - object - 'null' type: - array - 'null' related_searches: description: search queries related to the elment items: type: - string - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object deprecated: true type: object Response463397119C53_DataLabsGoogleFlightsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_GoogleFlightsElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsGoogleHotelsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: hotel_identifier: description: >- unique hotel identifier
unique hotel identifier assigned by Google;
example: "CgoIjaeSlI6CnNpVEAE" type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsGooglePostsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: cid: description: google-defined client id type: - string - 'null' feature: description: the additional feature of the review type: - string - 'null' posts_id: description: the identifier of the google_posts feature type: - string - 'null' type: object deprecated: true type: object Response463397119C53_DataLabsGoogleReviewsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: cid: description: google-defined client id type: - string - 'null' feature: description: the additional feature of the review type: - string - 'null' place_id: description: the identifier of a place type: - string - 'null' rating: description: >- the item's rating
the popularity rate based on reviews and displayed in SERP oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' reviews_count: description: the number of reviews format: int64 type: - integer - 'null' type: object type: object Response463397119C53_DataLabsHotelsPackSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: date_from: description: >- starting date of stay
in the format “year-month-date”
example:
2019-11-15 type: - string - 'null' date_to: description: >- ending date of stay
in the format “year-month-date”
example:
2019-11-17 type: - string - 'null' items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_HotelsPackElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsImagesSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeImagesElementInfo type: - object - 'null' type: - array - 'null' related_image_searches: deprecated: true description: >- contains keywords and images related to the specified search term
if there are none, equals null oneOf: - $ref: >- #/components/schemas/Response463397119C53_RelatedImageSearchesElement type: - object - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsJobsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_JobsElement' type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsKnowledgeGraphSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: card_id: description: card id type: - string - 'null' cid: description: google-defined client id type: - string - 'null' description: description: description of the results element in SERP type: - string - 'null' image_url: description: URL of the image from knowledge graph type: - string - 'null' items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' type: - array - 'null' logo_url: description: URL of the logo from knowledge graph type: - string - 'null' sub_title: description: subtitle of the item type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsLocalPackSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: backlinks_info: description: backlinks information for the ranked website oneOf: - $ref: '#/components/schemas/Response463397119C53_BacklinksInfo' type: - object - 'null' clickstream_etv: description: >- estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article format: double type: - number - 'null' description: description: description of the results element in SERP type: - string - 'null' domain: description: subdomain in SERP type: - string - 'null' estimated_paid_traffic_cost: description: >- estimated cost of paid monthly search traffic represents the estimated cost of paid monthly traffic (USD) based on etv and cpc values learn more about how the metric is calculated in this help center article type: - number - 'null' etv: description: >- estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the returned keyword learn more about how the metric is calculated in this help center article type: - number - 'null' is_paid: description: indicates whether the element is an ad type: - boolean - 'null' main_domain: description: primary domain name in SERP type: - string - 'null' phone: description: phone number type: - string - 'null' rank_changes: description: >- changes in rankings contains information about the ranking changes of the SERP element since the previous_updated_time oneOf: - $ref: '#/components/schemas/Response463397119C53_RankChanges' properties: is_down: description: >- rank of this element went down if the value is true, position of the element in SERP is lower compared to the previous check type: boolean is_new: description: >- element was previously present in SERP if the value is true, previously collected SERP didn’t contain this element type: boolean is_up: description: >- rank of this element went up if the value is true, position of the element in SERP is higher compared to the previous check type: boolean previous_rank_absolute: description: |- previous absolute rank in SERP indicates previous rank of the element in Google SERP; if this element is new, the value will be null type: - number - 'null' type: - object - 'null' rank_info: description: page and domain rank information oneOf: - $ref: '#/components/schemas/Response463397119C53_RankInfo' type: - object - 'null' rating: description: >- the item's rating the popularity rate based on reviews and displayed in SERP oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' relative_url: description: >- URL in SERP that does not specify the HTTPs protocol and domain name type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsLocalServicesSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: domain: description: domain in SERP type: - string - 'null' items: description: historical SERPs and related data found in the database type: - object - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsMapSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsMathSolverSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_MathSolverElement type: - object - 'null' type: - array - 'null' links: description: >- sitelinks
the links shown below some of Google's search results
if there are none, equals null items: oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: - array - 'null' result: description: >- solution to the equation
solution to the mathematical equation specified in the keyword field when setting a task type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsMentionCarouselSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_MentionCarouselElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object deprecated: true type: object Response463397119C53_DataLabsMultiCarouselSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_MultiCarouselElement type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsOrganicSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: about_this_result: deprecated: true description: >- contains information from the 'About this result' panel
'About this result' panel provides additional context about why Google returned this result for the given query;
this feature appears after clicking on the three dots next to most results oneOf: - $ref: >- #/components/schemas/Response463397119C53_AboutThisResultElement type: - object - 'null' amp_version: description: >- Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
Note: this check no longer appears in SERP type: - boolean - 'null' backlinks_info: description: backlinks information for the relevant page URL oneOf: - $ref: '#/components/schemas/Response463397119C53_BacklinksInfo' type: - object - 'null' breadcrumb: description: breadcrumb in SERP type: - string - 'null' checks: description: >- array of properties detected for the SERP element
lists the properties that are true for this element
each value in the array represents a detected property
example:
if is_image is present in the array, the element contains an image
possible values in the array:
is_image, is_video, is_featured_snippet, amp_version, is_malicious, is_web_story, is_highly_cited
equals null if none of the properties are detected for the element
learn more about the checks array in this Help Center article items: type: - string - 'null' type: - array - 'null' clickstream_etv: description: >- estimated traffic volume based on clickstream data
calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain or webpage ranks for;
to retrieve results for this field, the parameter include_clickstream_data must be set to true;
learn more about how the metric is calculated in this help center article format: double type: - number - 'null' description: description: description of the results element in SERP type: - string - 'null' domain: description: subdomain in SERP type: - string - 'null' estimated_paid_traffic_cost: description: >- estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads for all keywords that a domain or webpage ranks for;
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search;
learn more about how the metric is calculated in this help center article type: - number - 'null' etv: description: >- estimated traffic volume
estimated organic monthly traffic to the domain or webpage;
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain or webpage rank for;
learn more about how the metric is calculated in this help center article type: - number - 'null' extended_snippet: description: >- includes additional information appended after the result description in SERP type: - string - 'null' highlighted: description: >- words highlighted in bold within the results description items: type: - string - 'null' type: - array - 'null' is_featured_snippet: description: >- indicates whether the element is a featured_snippet
Note: this check no longer appears in SERP type: - boolean - 'null' is_image: description: "indicates whether the element contains an\_image
Note: this check no longer appears in SERP" type: - boolean - 'null' is_malicious: description: >- indicates whether the element is marked as malicious
Note: this check no longer appears in SERP type: - boolean - 'null' is_video: description: >- indicates whether the element contains a video
Note: this check no longer appears in SERP type: - boolean - 'null' links: description: >- sitelinks
the links shown below some of Google's search results
if there are none, equals null items: oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: - array - 'null' main_domain: description: primary domain name in SERP type: - string - 'null' pre_snippet: description: >- includes additional information appended before the result description in SERP type: - string - 'null' rank_changes: description: >- changes in rankings
contains information about the ranking changes of the SERP element since the previous_updated_time oneOf: - $ref: '#/components/schemas/Response463397119C53_RankChanges' properties: is_down: description: >- rank of this element went down if the value is true, position of the element in SERP is lower compared to the previous check type: boolean is_new: description: >- element was previously present in SERP if the value is true, previously collected SERP didn’t contain this element type: boolean is_up: description: >- rank of this element went up if the value is true, position of the element in SERP is higher compared to the previous check type: boolean previous_rank_absolute: description: |- previous absolute rank in SERP indicates previous rank of the element in Google SERP; if this element is new, the value will be null type: - number - 'null' type: - object - 'null' rank_info: description: page and domain rank information oneOf: - $ref: '#/components/schemas/Response463397119C53_RankInfo' type: - object - 'null' rating: description: >- the item's rating
the popularity rate based on reviews and displayed in SERP oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' relative_url: description: >- URL in SERP that does not specify the HTTPs protocol and domain name type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' website_name: description: relevant website name in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsPaidSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: backlinks_info: description: backlinks information for the ranked website oneOf: - $ref: '#/components/schemas/Response463397119C53_BacklinksInfo' type: - object - 'null' breadcrumb: description: breadcrumb in SERP type: - string - 'null' checks: description: >- array of properties detected for the SERP elementlists the properties that are true for this elementeach value in the array represents a detected property example:if is_image is present in the array, the element contains an imagepossible values in the array:is_image, is_video, is_featured_snippet, amp_version, is_malicious, is_web_story, is_highly_citedequals null if none of the properties are detected for the elementlearn more about the checks array in this Help Center article items: type: - string - 'null' type: - array - 'null' clickstream_etv: description: >- estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article format: double type: - number - 'null' description: description: description of the results element in SERP type: - string - 'null' description_rows: description: extended description if there is none, equals null items: type: - string - 'null' type: - array - 'null' domain: description: subdomain in SERP type: - string - 'null' estimated_paid_traffic_cost: description: >- estimated cost of paid monthly search traffic represents the estimated cost of paid monthly traffic (USD) based on etv and cpc values learn more about how the metric is calculated in this help center article type: - number - 'null' etv: description: >- estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the returned keyword learn more about how the metric is calculated in this help center article type: - number - 'null' extra: additionalProperties: type: - string - 'null' type: - object - 'null' highlighted: description: words highlighted in bold within the results description items: type: - string - 'null' type: - array - 'null' links: description: >- sitelinks the links shown below some of Google's search results if there are none, equals null items: oneOf: - $ref: '#/components/schemas/Response463397119C53_AdLinkElement' type: - object - 'null' type: - array - 'null' main_domain: description: primary domain name in SERP type: - string - 'null' rank_changes: description: >- changes in rankings contains information about the ranking changes of the SERP element since the previous_updated_time oneOf: - $ref: '#/components/schemas/Response463397119C53_RankChanges' properties: is_down: description: >- rank of this element went down if the value is true, position of the element in SERP is lower compared to the previous check type: boolean is_new: description: >- element was previously present in SERP if the value is true, previously collected SERP didn’t contain this element type: boolean is_up: description: >- rank of this element went up if the value is true, position of the element in SERP is higher compared to the previous check type: boolean previous_rank_absolute: description: |- previous absolute rank in SERP indicates previous rank of the element in Google SERP; if this element is new, the value will be null type: - number - 'null' type: - object - 'null' rank_info: description: page and domain rank information oneOf: - $ref: '#/components/schemas/Response463397119C53_RankInfo' type: - object - 'null' relative_url: description: >- URL in SERP that does not specify the HTTPs protocol and domain name type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsPeopleAlsoAskSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_PeopleAlsoAskElement type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsPeopleAlsoSearchSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: type: - string - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsPodcastsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_PodcastsElement' type: - object - 'null' type: - array - 'null' type: object deprecated: true type: object Response463397119C53_DataLabsPopularProductsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_PopularProductsElement type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsQuestionsAndAnswersSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_QuestionsAndAnswersElement type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsRecipesSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_RecipesElement' type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsRelatedSearchesSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: type: - string - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsScholarlyArticlesSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_ScholarlyArticlesElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsShoppingSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_ShoppingElement' type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsStocksBoxSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: domain: description: domain in SERP type: - string - 'null' graph: description: contains data provided in the graph of the element oneOf: - $ref: '#/components/schemas/Response463397119C53_Graph' type: - object - 'null' price: description: >- price of booking a place for the specified dates of stay oneOf: - $ref: '#/components/schemas/Response463397119C53_PriceInfo' type: - object - 'null' snippet: description: text alongside the link title type: - string - 'null' source: description: source of additional information about the result type: - string - 'null' table: description: table element oneOf: - $ref: '#/components/schemas/Response463397119C53_Table' type: - object - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsTopSightsSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_TopSightsElement' type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsTopStoriesSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_TopStoriesElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsTwitterSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_TwitterElement' type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' type: object type: object Response463397119C53_DataLabsVideoSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: '#/components/schemas/Response463397119C53_VideoElement' type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_DataLabsVisualStoriesSerpElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AmazonLabelElement type: - object - 'null' type: - array - 'null' type: object deprecated: true 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_SearchIntentInfo: properties: foreign_intent: description: >- supplementary search intents
possible values: informational, navigational, commercial, transactional items: type: - string - 'null' type: - array - '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_intent: description: >- main search intent
possible values: informational, navigational, commercial, transactional type: - string - 'null' se_type: description: search engine type type: - string - '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_LinkElement: properties: description: description: description of the results element type: - string - 'null' domain: description: domain where a link points type: - string - 'null' snippet: description: text alongside the link title type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: URL type: - string - 'null' xpath: description: the XPath of the element type: - string - 'null' type: object Response463397119C53_DataforseoLabsCarouselElement: properties: sub_title: description: subtitle of the item type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' type: description: type of element type: - string - 'null' type: object Response463397119C53_CommercialUnitsElement: properties: domain: description: domain where a link points type: - string - 'null' price: description: price indicated in the element oneOf: - $ref: '#/components/schemas/Response463397119C53_PriceInfo' type: - object - 'null' rating: description: >- the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' source: description: reference source name or title type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_CoursesElement: properties: date: description: the date when the page source of the element was published type: - string - 'null' description: description: description of the results element in SERP type: - string - 'null' domain: description: domain where a link points type: - string - 'null' image_url: description: URL of the image type: - string - 'null' rating: description: |- the element’s rating the popularity rate based on reviews and displayed in SERP oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' source: description: >- source of the element indicates the source of information included in the top_stories_element type: - string - 'null' title: description: title of the row type: - string - 'null' type: description: type of element type: - string - 'null' url: description: URL of element type: - string - 'null' type: object Response463397119C53_EventsElement: properties: snippet: description: text alongside the link title type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_ExploreBrandsElement: properties: description: description: description of the results element in SERP type: - string - 'null' domain: description: domain where a link points type: - string - 'null' image_url: description: URL of the image type: - string - 'null' title: description: title of the row type: - string - 'null' type: description: type of element type: - string - 'null' url: description: URL of element type: - string - 'null' xpath: description: the XPath of the element type: - string - 'null' type: object Response463397119C53_BacklinksInfo: properties: backlinks: description: average number of backlinks format: int64 type: - integer - 'null' dofollow: description: average number of dofollow links format: int64 type: - integer - 'null' referring_domains: description: average number of referring domains format: int64 type: - integer - 'null' referring_main_domains: description: average number of referring main domains format: int64 type: - integer - 'null' referring_pages: description: average number of referring pages format: int64 type: - integer - 'null' time_update: description: >- date and time when backlink 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' type: object Response463397119C53_RankChanges: properties: is_down: description: >- rank went down
indicates how many ranked elements of this target went down in Google Search type: - boolean - 'null' is_new: description: >- number of new ranked elements
indicates how many new ranked elements were found for this domain or webpage type: - boolean - 'null' is_up: description: >- rank went up
indicates how many ranked elements of this target went up in Google Search type: - boolean - 'null' previous_rank_absolute: description: >- previous absolute rank in SERP
indicates previous rank of the element in Google SERP;
if this element is new, the value will be null type: - integer - 'null' type: object Response463397119C53_RankInfo: properties: main_domain_rank: description: >- average main domain rank
learn more about the metric and its calculation formula in this help center article type: - integer - 'null' page_rank: description: >- page rank
page_rank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm;
learn more about the metric and how it is calculated in this help center article type: - integer - 'null' type: object Response463397119C53_Table: properties: table_content: description: |- the content of the table one line of the table in this element of the array items: items: type: - string - 'null' type: - array - 'null' type: - array - 'null' table_element: description: |- name assigned to the table element possible values: table_element type: - string - 'null' table_header: description: column names items: type: - string - 'null' type: - array - 'null' type: object Response463397119C53_FindResultsOnElement: properties: domain: description: domain where a link points type: - string - 'null' source: description: reference source name or title type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_FoundOnWebElement: properties: image: description: image of the element oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeImagesElementInfo type: - object - 'null' subtitle: description: subtitle of the element type: - string - 'null' title: description: title of the row type: - string - 'null' type: description: type of element type: - string - 'null' type: object Response463397119C53_GoogleFlightsElement: properties: description: description: link description type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_RatingInfo: properties: rating_max: description: the maximum value for a rating_type type: - integer - 'null' rating_type: description: |- the type of rating here you can find the following elements: Max5, Percents, CustomMax type: - string - 'null' value: description: the value of the rating format: double type: - number - 'null' votes_count: description: the amount of feedback format: int64 type: - integer - 'null' Response463397119C53_HotelsPackElement: properties: description: description: link description type: - string - 'null' domain: description: domain where a link points type: - string - 'null' hotel_identifier: description: >- unique hotel identifier
unique hotel identifier assigned by Google;
example: "CgoIjaeSlI6CnNpVEAE" type: - string - 'null' is_paid: description: indicates whether the element is an ad type: - boolean - 'null' price: description: price indicated in the element oneOf: - $ref: '#/components/schemas/Response463397119C53_PriceInfo' type: - object - 'null' rating: description: >- the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_AiModeImagesElementInfo: properties: alt: description: alt tag of the image type: - string - 'null' image_url: description: >- URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) type: - string - 'null' type: description: type of element type: - string - 'null' url: description: relevant URL type: - string - 'null' type: object Response463397119C53_RelatedImageSearchesElement: deprecated: true properties: alt: description: alt tag of the image type: - string - 'null' image_url: description: >- URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' type: description: type of element type: - string - 'null' url: description: URL type: - string - 'null' type: object Response463397119C53_JobsElement: properties: author: description: author type: - string - 'null' contract_type: description: contract type type: - string - 'null' description: description: link description type: - string - 'null' job_posted_time: description: the time when the job was posted type: - string - 'null' location: description: location for which the job vacancy is posted type: - string - 'null' salary: description: salary type: - string - 'null' timestamp: description: >- date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem: additionalProperties: false discriminator: mapping: knowledge_graph_carousel_item: >- #/components/schemas/Response463397119C53_DataforseoLabsKnowledgeGraphCarouselItemElementItem knowledge_graph_description_item: >- #/components/schemas/Response463397119C53_DataforseoLabsKnowledgeGraphDescriptionItemElementItem knowledge_graph_expanded_item: >- #/components/schemas/Response463397119C53_DataforseoLabsKnowledgeGraphExpandedItemElementItem knowledge_graph_images_item: >- #/components/schemas/Response463397119C53_DataforseoLabsKnowledgeGraphImagesItemElementItem knowledge_graph_list_item: >- #/components/schemas/Response463397119C53_DataforseoLabsKnowledgeGraphListItemElementItem knowledge_graph_part_item: >- #/components/schemas/Response463397119C53_DataforseoLabsKnowledgeGraphPartItemElementItem knowledge_graph_row_item: >- #/components/schemas/Response463397119C53_DataforseoLabsKnowledgeGraphRowItemElementItem knowledge_graph_shopping_item: >- #/components/schemas/Response463397119C53_DataforseoLabsKnowledgeGraphShoppingItemElementItem propertyName: type properties: position: description: >- the alignment of the element in SERP
can take the following values:
left, right type: - string - 'null' rank_absolute: description: >- absolute rank in SERP
absolute position among all the elements in SERP type: - integer - 'null' rank_group: description: >- group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group type: - integer - 'null' type: description: type of element type: - string - 'null' xpath: description: >- the XPath of the element type: - string - 'null' type: object Response463397119C53_MathSolverElement: properties: expanded_element: description: expanded element items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_MathSolverExpandedElement type: - object - 'null' type: - array - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' type: object Response463397119C53_MentionCarouselElement: properties: mentioned_in: description: additional elements in the mention_carousel item items: oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: - array - 'null' price: description: price of the app element oneOf: - $ref: '#/components/schemas/Response463397119C53_PriceInfo' type: - object - 'null' rating: description: |- the element’s rating the popularity rate based on reviews and displayed in SERP oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' title: description: title of the row type: - string - 'null' type: description: type of element type: - string - 'null' type: object Response463397119C53_MultiCarouselElement: properties: multi_carousel_snippets: description: >- multi_carousel_snippet results
if there are none, equals null items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_SerpApiCarouselElement type: - object - 'null' type: - array - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' type: object Response463397119C53_AboutThisResultElement: deprecated: true properties: language: description: the language of the result type: - string - 'null' location: description: location for which the result is relevant type: - string - 'null' related_terms: description: related search terms that appear in the result items: type: - string - 'null' type: - array - 'null' search_terms: description: matching search terms that appear in the result items: type: - string - 'null' type: - array - 'null' source: description: source of additional information about the result type: - string - 'null' source_info: description: >- additional information about the result description of the website from Wikipedia or another additional context type: - string - 'null' source_url: description: URL to full information from the 'source' type: - string - 'null' type: description: type of element type: - string - 'null' url: description: result’s URL type: - string - 'null' type: object Response463397119C53_AdLinkElement: properties: ad_aclk: description: the identifier of the ad type: - string - 'null' description: description: description of the link type: - string - 'null' domain: description: domain where a link points type: - string - 'null' title: description: title of the element in SERP type: - string - 'null' type: description: type of element type: - string - 'null' url: description: reference page URL type: - string - 'null' type: object Response463397119C53_PeopleAlsoAskElement: properties: expanded_element: description: expanded element items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseSerpApiPeopleAlsoAskExpandedElementItem type: - object - 'null' type: - array - 'null' seed_question: description: question that triggered additional expanded elements type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' xpath: description: >- the XPath of the element type: - string - 'null' type: object Response463397119C53_PodcastsElement: properties: description: description: description of the results element in SERP type: - string - 'null' time_to_play: description: the total time it will take to play an episode type: - string - 'null' timestamp: description: |- date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 type: - string - 'null' title: description: title of the row type: - string - 'null' type: description: type of element type: - string - 'null' url: description: URL of element type: - string - 'null' type: object Response463397119C53_PopularProductsElement: properties: description: description: link description type: - string - 'null' domain: description: domain where a link points type: - string - 'null' image_url: description: >- URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) type: - string - 'null' more_sellers: description: indicates whether the product is sold by multiple sellers type: - boolean - 'null' price: description: price indicated in the element oneOf: - $ref: '#/components/schemas/Response463397119C53_PriceInfo' type: - object - 'null' product_identifiers: description: >- identifiers of the product
can include the following identifiers: product_id, data_docid, gid oneOf: - $ref: '#/components/schemas/Response463397119C53_ProductIdentifiers' type: - object - 'null' rating: description: >- the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' seller: description: seller of the product type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_QuestionsAndAnswersElement: properties: answer_text: description: answer included in the item type: - string - 'null' domain: description: domain where a link points type: - string - 'null' question_text: description: question included in the item type: - string - 'null' source: description: reference source name or title type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' votes: description: answer upvotes from the source type: - integer - 'null' type: object Response463397119C53_RecipesElement: properties: description: description: link description type: - string - 'null' domain: description: domain where a link points type: - string - 'null' rating: description: >- the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' source: description: reference source name or title type: - string - 'null' time: description: the total time it takes to prepare the cook the dish type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_ScholarlyArticlesElement: properties: author: description: author type: - string - 'null' description: description: link description type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_ShoppingElement: properties: description: description: link description type: - string - 'null' marketplace: description: >- merchant account provider
commerce site that hosts products or websites of individual sellers under the same merchant account
example:
by Google type: - string - 'null' marketplace_url: description: >- relevant marketplace URL
URL of the page on the marketplace website where the product is hosted type: - string - 'null' price: description: price indicated in the element oneOf: - $ref: '#/components/schemas/Response463397119C53_PriceInfo' type: - object - 'null' rating: description: >- the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' source: description: reference source name or title type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_Graph: properties: items: description: contains arrays of elements available in the list items: oneOf: - $ref: '#/components/schemas/Response463397119C53_GraphElement' type: - object - 'null' type: - array - 'null' previous_items: description: >- previous close data
contains stock price data based on the preceding time period items: oneOf: - $ref: '#/components/schemas/Response463397119C53_GraphElement' type: - object - 'null' type: - array - 'null' type: object Response463397119C53_PriceInfo: properties: currency: description: |- currency of the listed price ISO code of the currency applied to the price type: - string - 'null' current: description: >- current price indicates the current price of the product or service featured in the result format: double type: - number - 'null' displayed_price: description: |- price string in the result raw price string as provided in the result type: - string - 'null' is_price_range: description: |- price is provided as a range indicates whether a price is provided in a range type: - boolean - 'null' max_value: description: >- the maximum price the maximum price of the product or service as indicated in the result format: double type: - number - 'null' regular: description: >- regular price indicates the regular price of the product or service with no discounts applied format: double type: - number - 'null' type: object Response463397119C53_TopSightsElement: properties: description: description: link description type: - string - 'null' rating: description: >- the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' type: - object - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_TopStoriesElement: properties: amp_version: description: >- Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
Note: this check no longer appears in SERP type: - boolean - 'null' badges: description: badges relevant to the element items: type: - string - 'null' type: - array - 'null' date: description: the date when the page source of the element was published type: - string - 'null' domain: description: domain where a link points type: - string - 'null' image_url: description: >- URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) type: - string - 'null' source: description: reference source name or title type: - string - 'null' timestamp: description: >- date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_TwitterElement: properties: date: description: the date when the page source of the element was published type: - string - 'null' timestamp: description: >- date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' tweet: description: tweet message type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_VideoElement: properties: preview: description: URL to the video preview image type: - string - 'null' source: description: URL to the video source type: - string - 'null' timestamp: description: >- date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: source URL type: - string - 'null' type: object Response463397119C53_AmazonLabelElement: properties: domain: description: domain in SERP type: - string - 'null' title: description: title of the element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: search URL with refinement parameters type: - string - '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 Response463397119C53_DataforseoLabsKnowledgeGraphCarouselItemElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' - properties: data_attrid: description: >- google defined data attribute ID
example:
action:listen_artist type: - string - 'null' items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_KnowledgeGraphListElement type: - object - 'null' type: - array - 'null' link: description: link of the element oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataforseoLabsKnowledgeGraphDescriptionItemElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' - properties: links: description: >- sitelinks
the links shown below some of Google's search results
if there are none, equals null items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_KnowledgeGraphLinkElementInfo type: - object - 'null' type: - array - 'null' text: description: description content type: - string - 'null' type: object type: object Response463397119C53_DataforseoLabsKnowledgeGraphExpandedItemElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' - properties: data_attrid: description: >- google defined data attribute ID
example:
action:listen_artist type: - string - 'null' expanded_element: description: link of the element type: - object - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataforseoLabsKnowledgeGraphImagesItemElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' - properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_KnowledgeGraphImagesElement type: - object - 'null' type: - array - 'null' link: description: link of the element oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: object type: object Response463397119C53_DataforseoLabsKnowledgeGraphListItemElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' - properties: data_attrid: description: >- google defined data attribute ID
example:
action:listen_artist type: - string - 'null' items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_KnowledgeGraphListElement type: - object - 'null' type: - array - 'null' link: description: link of the element oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataforseoLabsKnowledgeGraphPartItemElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' - properties: data_attrid: description: >- google defined data attribute ID
example:
action:listen_artist type: - string - 'null' links: description: >- sitelinks
the links shown below some of Google's search results
if there are none, equals null items: oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: - array - 'null' text: description: description content type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataforseoLabsKnowledgeGraphRowItemElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' - properties: data_attrid: description: >- google defined data attribute ID
example:
action:listen_artist type: - string - 'null' links: description: >- sitelinks
the links shown below some of Google's search results
if there are none, equals null items: oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: - array - 'null' text: description: description content type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_DataforseoLabsKnowledgeGraphShoppingItemElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsKnowledgeGraphElementItem type: - object - 'null' - properties: data_attrid: description: >- google defined data attribute ID
example:
action:listen_artist type: - string - 'null' items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_KnowledgeGraphShoppingElement type: - object - 'null' type: - array - 'null' title: description: title of the result in SERP type: - string - 'null' type: object type: object Response463397119C53_MathSolverExpandedElement: properties: solution: description: >- solution of the element
displays steps to solve the mathematical equation as specified in the element items: type: - string - 'null' type: - array - 'null' title: description: title of the carousel item type: - string - 'null' type: description: type of element type: - string - 'null' type: object Response463397119C53_SerpApiCarouselElement: properties: image_url: description: >- URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) type: - string - 'null' subtitle: description: subtitle of the element type: - string - 'null' title: description: title of a given link element type: - string - 'null' type: description: type of element type: - string - 'null' type: object Response463397119C53_BaseSerpApiPeopleAlsoAskExpandedElementItem: additionalProperties: false discriminator: mapping: people_also_ask_ai_overview_expanded_element: >- #/components/schemas/Response463397119C53_SerpApiPeopleAlsoAskAiOverviewExpandedElementItem people_also_ask_expanded_element: >- #/components/schemas/Response463397119C53_SerpApiPeopleAlsoAskExpandedElementItem propertyName: type properties: type: description: type of element type: - string - 'null' type: object Response463397119C53_ProductIdentifiers: properties: data_docid: description: >- unique identifier of the SERP data element
example:
17363035694596624076 type: - string - 'null' gid: description: >- global product identifier on Google Shopping
example:
4702526954592161872
learn more about the parameter in this help center guide type: - string - 'null' product_id: description: >- unique product identifier on Google Shopping
example:
4485466949985702538
learn more about the parameter in this help center guide type: - string - 'null' type: object Response463397119C53_GraphElement: properties: date: description: >- date when the video was published or indexed
example:
Apr 26, 2024 type: - string - 'null' type: description: type of element type: - string - 'null' value: description: the value of the rating type: - number - 'null' type: object Response463397119C53_KnowledgeGraphListElement: properties: domain: description: domain in SERP type: - string - 'null' image_url: description: >- URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) type: - string - 'null' subtitle: description: subtitle of the item type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' type: description: type of element type: - string - 'null' url: description: sitelink URL type: - string - 'null' xpath: description: >- the XPath of the element type: - string - 'null' type: object Response463397119C53_KnowledgeGraphLinkElementInfo: properties: domain: description: domain in SERP type: - string - 'null' snippet: description: text alongside the link title type: - string - 'null' title: description: title of the result in SERP type: - string - 'null' type: description: type of element type: - string - 'null' url: description: relevant URL in SERP type: - string - 'null' xpath: description: >- the XPath of the element type: - string - 'null' type: object Response463397119C53_KnowledgeGraphImagesElement: properties: alt: description: alt tag of the image type: - string - 'null' domain: description: domain in SERP type: - string - 'null' image_url: description: >- URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) type: - string - 'null' type: description: type of element type: - string - 'null' url: description: relevant URL of the Ad element in SERP type: - string - 'null' xpath: description: >- the XPath of the element type: - string - 'null' type: object Response463397119C53_KnowledgeGraphShoppingElement: properties: domain: description: domain where a link points type: - string - 'null' marketplace: description: >- merchant account provider
ecommerce site that hosts products or websites of individual sellers under the same merchant account
example:
by Google type: - string - 'null' marketplace_url: description: >- URL to the merchant account provider
ecommerce site that hosts products or websites of individual sellers under the same merchant account type: - string - 'null' price: description: >- pricing details
contains the pricing details of the product or service featured in the result;
if there is none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_PriceInfo' type: - object - 'null' snippet: description: text alongside the link title type: - string - 'null' source: description: reference source name or title type: - string - 'null' title: description: title of the element type: - string - 'null' type: description: type of element type: - string - 'null' url: description: URL type: - string - 'null' type: object Response463397119C53_SerpApiPeopleAlsoAskAiOverviewExpandedElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseSerpApiPeopleAlsoAskExpandedElementItem type: - object - 'null' - properties: asynchronous_ai_overview: description: >- indicates whether the element is loaded asynchronously
if true, the people_also_ask_ai_overview_expanded_element element is loaded asynchronously;
if false, the people_also_ask_ai_overview_expanded_element element is loaded from cache type: - boolean - 'null' items: description: items present in the element items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseSerpApiAiOverviewElementItem type: - object - 'null' type: - array - 'null' references: description: >- additional references relevant to the item
includes references to webpages that may have been used to generate the ai_overview items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeAiOverviewReferenceInfo type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_SerpApiPeopleAlsoAskExpandedElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseSerpApiPeopleAlsoAskExpandedElementItem type: - object - 'null' - properties: description: description: description type: - string - 'null' domain: description: source domain type: - string - 'null' featured_title: description: the title of the featured snippets source page type: - string - 'null' images: description: images of the element items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeImagesElementInfo type: - object - 'null' type: - array - 'null' table: description: >- results table
if there are none, equals null oneOf: - $ref: '#/components/schemas/Response463397119C53_Table' type: - object - 'null' timestamp: description: >- date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' title: description: title of the carousel item type: - string - 'null' url: description: relevant URL type: - string - 'null' type: object type: object Response463397119C53_BaseSerpApiAiOverviewElementItem: additionalProperties: false discriminator: mapping: ai_overview_element: >- #/components/schemas/Response463397119C53_SerpApiAiOverviewElementItem ai_overview_expanded_element: >- #/components/schemas/Response463397119C53_SerpApiAiOverviewExpandedElementItem ai_overview_table_element: >- #/components/schemas/Response463397119C53_SerpApiAiOverviewTableElementItem ai_overview_video_element: >- #/components/schemas/Response463397119C53_SerpApiAiOverviewVideoElementItem propertyName: type properties: position: description: >- the alignment of the element in SERP
can take the following values:
left, right type: - string - 'null' type: description: type of element type: - string - 'null' type: object Response463397119C53_AiModeAiOverviewReferenceInfo: properties: domain: description: domain name of the reference type: - string - 'null' position: description: >- the alignment of the element in SERP
can take the following values:
left, right type: - string - 'null' source: description: reference source name or title type: - string - 'null' text: description: text of the component type: - string - 'null' title: description: link anchor text type: - string - 'null' type: description: type of element type: - string - 'null' url: description: link URL type: - string - 'null' type: object Response463397119C53_SerpApiAiOverviewElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseSerpApiAiOverviewElementItem type: - object - 'null' - properties: images: description: >- images of the element
if there is none, equals null items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeImagesElementInfo type: - object - 'null' type: - array - 'null' links: description: website links featured in the element items: oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: - array - 'null' markdown: description: content of the element in markdown format type: - string - 'null' references: description: >- references relevant to the element
includes references to webpages that were used to generate the ai_overview_element items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeAiOverviewReferenceInfo type: - object - 'null' type: - array - 'null' text: description: additional text of the element in SERP type: - string - 'null' title: description: title of the element type: - string - 'null' type: object type: object Response463397119C53_SerpApiAiOverviewExpandedElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseSerpApiAiOverviewElementItem type: - object - 'null' - properties: components: description: array of components of the element items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiOverviewExpandedComponent type: - object - 'null' type: - array - 'null' references: description: >- references relevant to the element
includes references to webpages that were used to generate the ai_overview_element items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeAiOverviewReferenceInfo type: - object - 'null' type: - array - 'null' text: description: additional text of the element in SERP type: - string - 'null' title: description: title of the element type: - string - 'null' type: object type: object Response463397119C53_SerpApiAiOverviewTableElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseSerpApiAiOverviewElementItem type: - object - 'null' - properties: markdown: description: content of the element in markdown format type: - string - 'null' table: description: table element oneOf: - $ref: '#/components/schemas/Response463397119C53_Table' type: - object - 'null' type: object type: object Response463397119C53_SerpApiAiOverviewVideoElementItem: allOf: - oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseSerpApiAiOverviewElementItem type: - object - 'null' - properties: date: description: >- date when the video was published or indexed
example:
Apr 26, 2024 type: - string - 'null' domain: description: domain in link type: - string - 'null' image_url: description: URL of the image type: - string - 'null' snippet: description: additional information for the video type: - string - 'null' source: description: >- web source of the shopping element
indicates the source of information included in the element type: - string - 'null' timestamp: description: >- date and time when the video was published or indexed
in the UTC format: "yyyy-mm-dd hh-mm-ss +00:00"
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' title: description: title of the element type: - string - 'null' url: description: reference page URL type: - string - 'null' type: object type: object Response463397119C53_AiOverviewExpandedComponent: properties: images: description: >- images of the element
if there is none, equals null items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeImagesElementInfo type: - object - 'null' type: - array - 'null' links: description: >- sitelinks
the links shown below some of Google's search results
if there are none, equals null items: oneOf: - $ref: '#/components/schemas/Response463397119C53_LinkElement' type: - object - 'null' type: - array - 'null' markdown: description: content of the element in markdown format type: - string - 'null' references: description: >- references relevant to the element
includes references to webpages that were used to generate the ai_overview_element items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeAiOverviewReferenceInfo type: - object - 'null' type: - array - 'null' text: description: >- reference text
text snippet from the page that was used to generate the ai_overview_element type: - string - 'null' title: description: reference page title type: - string - 'null' type: description: type of element type: - string - 'null' type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.