> ## 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 # Historical SERPs > ‌ This endpoint will provide you with Google SERPs collected within the specified time frame. You will also receive a complete overview of featured snippets and other extra elements that were present within the specified dates. The data will allow you to analyze the dynamics of keyword rankings over time for the specified keyword and location. Usage-based billing; Default request estimate: $0.1356 USD (not a fixed price). Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/dataforseo/dataforseo\_labs/google/historical\_serps/live * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/dataforseo/dataforseo\_labs/google/historical\_serps/live](https://api.aisa.one/apis/v1/dataforseo/dataforseo\_labs/google/historical\_serps/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_e49bf5", "method": "POST", "path": "/apis/v1/dataforseo/dataforseo_labs/google/historical_serps/live", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "example": [ { "datetime_from": "2026-09-22 05:48:19", "datetime_to": "2026-10-02 05:48:19", "keyword": "albert einstein", "language_code": "en", "limit": 10, "location_code": 2840 } ], "items": { "oneOf": [ { "example": [ { "datetime_from": "2026-09-22 05:48:19", "datetime_to": "2026-10-02 05:48:19", "keyword": "albert einstein", "language_code": "en", "limit": 10, "location_code": 2840 } ], "properties": { "date_from": { "description": "starting date of the time range
optional field
if you don't specify this field, the API will return all SERPs collected for 365 days starting from the current datetime value;
minimal possible value: 365 days from the current datetime value;
date format: \"yyyy-mm-dd\"", "type": [ "string", "null" ] }, "date_to": { "description": "ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default;
date format: \"yyyy-mm-dd\";
example:
\"2021-09-01\"", "type": [ "string", "null" ] }, "keyword": { "description": "keyword
required field
you can specify up to 700 characters in the keyword field;
all %## will be decoded (plus character ‘+’ will be decoded to a space character);
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”", "type": "string" }, "language_code": { "description": "unique language identifier
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 parameters 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 parameters by making a separate request to the
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:
English", "type": "string" }, "location_code": { "description": "unique location identifier
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 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:
2840", "type": "integer" }, "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 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:
United Kingdom", "type": "string" }, "tag": { "description": "user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response", "type": [ "string", "null" ] } }, "type": "object" } ], "type": [ "object", "null" ] }, "type": "array" } } } }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "response_usd", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.1356, "estimate_source": "profile_seed", "evidence_source": "response_body" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Usage-based billing; Default request estimate: \$0.1356 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.1356 * **Cost contract:** response\_usd * **Published reference multiplier:** 1.0 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml openapi/dataforseo.json POST /apis/v1/dataforseo/dataforseo_labs/google/historical_serps/live openapi: 3.1.0 info: description: '' title: DataForSEO version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-catalogs: dataforseo: description: '' title: DataForSEO x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-configured-paths: - >- /apis/v1/dataforseo/ai_optimization/ai_keyword_data/keywords_search_volume/live - >- /apis/v1/dataforseo/ai_optimization/ai_keyword_data/locations_and_languages - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/live - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/models - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/html - >- /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id} - >- /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id} - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_post - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/live - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/models - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/live - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/models - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/languages - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/advanced - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/html - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/locations - >- /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/advanced/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/html/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_post - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/tasks_ready - /apis/v1/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/available_filters - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/historical/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/locations_and_languages - /apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/search/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/search_mentions/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_delta/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_new_lost/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_domains/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands_lite/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_pages/live - /apis/v1/dataforseo/ai_optimization/perplexity/llm_responses/live - /apis/v1/dataforseo/ai_optimization/perplexity/llm_responses/models - /apis/v1/dataforseo/app_data/apple/app_info/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_info/task_post - /apis/v1/dataforseo/app_data/apple/app_list/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_list/task_post - /apis/v1/dataforseo/app_data/apple/app_listings/categories - /apis/v1/dataforseo/app_data/apple/app_listings/search/live - /apis/v1/dataforseo/app_data/apple/app_reviews/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_reviews/task_post - /apis/v1/dataforseo/app_data/apple/app_searches/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_searches/task_post - /apis/v1/dataforseo/app_data/apple/categories - /apis/v1/dataforseo/app_data/apple/languages - /apis/v1/dataforseo/app_data/apple/locations - /apis/v1/dataforseo/app_data/google/app_info/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_info/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_info/task_post - /apis/v1/dataforseo/app_data/google/app_list/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_list/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_list/task_post - /apis/v1/dataforseo/app_data/google/app_listings/categories - /apis/v1/dataforseo/app_data/google/app_listings/search/live - /apis/v1/dataforseo/app_data/google/app_reviews/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_reviews/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_reviews/task_post - /apis/v1/dataforseo/app_data/google/app_searches/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_searches/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_searches/task_post - /apis/v1/dataforseo/app_data/google/categories - /apis/v1/dataforseo/app_data/google/languages - /apis/v1/dataforseo/app_data/google/locations - /apis/v1/dataforseo/backlinks/anchors/live - /apis/v1/dataforseo/backlinks/backlinks/live - /apis/v1/dataforseo/backlinks/bulk_backlinks/live - /apis/v1/dataforseo/backlinks/bulk_new_lost_backlinks/live - /apis/v1/dataforseo/backlinks/bulk_new_lost_referring_domains/live - /apis/v1/dataforseo/backlinks/bulk_pages_summary/live - /apis/v1/dataforseo/backlinks/bulk_ranks/live - /apis/v1/dataforseo/backlinks/bulk_referring_domains/live - /apis/v1/dataforseo/backlinks/bulk_spam_score/live - /apis/v1/dataforseo/backlinks/competitors/live - /apis/v1/dataforseo/backlinks/domain_intersection/live - /apis/v1/dataforseo/backlinks/domain_pages/live - /apis/v1/dataforseo/backlinks/domain_pages_summary/live - /apis/v1/dataforseo/backlinks/history/live - /apis/v1/dataforseo/backlinks/index - /apis/v1/dataforseo/backlinks/page_intersection/live - /apis/v1/dataforseo/backlinks/referring_domains/live - /apis/v1/dataforseo/backlinks/referring_networks/live - /apis/v1/dataforseo/backlinks/summary/live - /apis/v1/dataforseo/backlinks/timeseries_new_lost_summary/live - /apis/v1/dataforseo/backlinks/timeseries_summary/live - /apis/v1/dataforseo/business_data/business_listings/search/live - /apis/v1/dataforseo/business_data/google/extended_reviews/task_get/{id} - /apis/v1/dataforseo/business_data/google/extended_reviews/task_post - /apis/v1/dataforseo/business_data/google/extended_reviews/tasks_ready - /apis/v1/dataforseo/business_data/google/hotel_info/live/advanced - /apis/v1/dataforseo/business_data/google/hotel_info/live/html - /apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id} - /apis/v1/dataforseo/business_data/google/hotel_info/task_get/html/{id} - /apis/v1/dataforseo/business_data/google/hotel_info/task_post - /apis/v1/dataforseo/business_data/google/hotel_info/tasks_ready - /apis/v1/dataforseo/business_data/google/hotel_searches/live - /apis/v1/dataforseo/business_data/google/hotel_searches/task_get/{id} - /apis/v1/dataforseo/business_data/google/hotel_searches/task_post - /apis/v1/dataforseo/business_data/google/hotel_searches/tasks_ready - /apis/v1/dataforseo/business_data/google/my_business_info/live - /apis/v1/dataforseo/business_data/google/my_business_info/task_get/{id} - /apis/v1/dataforseo/business_data/google/my_business_info/task_post - /apis/v1/dataforseo/business_data/google/my_business_info/tasks_ready - /apis/v1/dataforseo/business_data/google/my_business_updates/task_get/{id} - /apis/v1/dataforseo/business_data/google/my_business_updates/task_post - /apis/v1/dataforseo/business_data/google/my_business_updates/tasks_ready - /apis/v1/dataforseo/business_data/google/questions_and_answers/live - >- /apis/v1/dataforseo/business_data/google/questions_and_answers/task_get/{id} - /apis/v1/dataforseo/business_data/google/questions_and_answers/task_post - /apis/v1/dataforseo/business_data/google/questions_and_answers/tasks_ready - /apis/v1/dataforseo/business_data/google/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/google/reviews/task_post - /apis/v1/dataforseo/business_data/google/reviews/tasks_ready - /apis/v1/dataforseo/business_data/social_media/pinterest/live - /apis/v1/dataforseo/business_data/social_media/reddit/live - /apis/v1/dataforseo/business_data/tripadvisor/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post - /apis/v1/dataforseo/business_data/tripadvisor/reviews/tasks_ready - /apis/v1/dataforseo/business_data/tripadvisor/search/task_get/{id} - /apis/v1/dataforseo/business_data/tripadvisor/search/task_post - /apis/v1/dataforseo/business_data/tripadvisor/search/tasks_ready - /apis/v1/dataforseo/business_data/trustpilot/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/trustpilot/reviews/task_post - /apis/v1/dataforseo/business_data/trustpilot/reviews/tasks_ready - /apis/v1/dataforseo/business_data/trustpilot/search/task_get/{id} - /apis/v1/dataforseo/business_data/trustpilot/search/task_post - /apis/v1/dataforseo/business_data/trustpilot/search/tasks_ready - /apis/v1/dataforseo/content_analysis/available_filters - /apis/v1/dataforseo/content_analysis/categories - /apis/v1/dataforseo/content_analysis/category_trends/live - /apis/v1/dataforseo/content_analysis/languages - /apis/v1/dataforseo/content_analysis/locations - /apis/v1/dataforseo/content_analysis/phrase_trends/live - /apis/v1/dataforseo/content_analysis/rating_distribution/live - /apis/v1/dataforseo/content_analysis/search/live - /apis/v1/dataforseo/content_analysis/sentiment_analysis/live - /apis/v1/dataforseo/content_analysis/summary/live - /apis/v1/dataforseo/dataforseo_labs/amazon/bulk_search_volume/live - /apis/v1/dataforseo/dataforseo_labs/amazon/product_competitors/live - >- /apis/v1/dataforseo/dataforseo_labs/amazon/product_keyword_intersections/live - /apis/v1/dataforseo/dataforseo_labs/amazon/product_rank_overview/live - /apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live - /apis/v1/dataforseo/dataforseo_labs/amazon/related_keywords/live - /apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/live - /apis/v1/dataforseo/dataforseo_labs/apple/app_intersection/live - /apis/v1/dataforseo/dataforseo_labs/apple/bulk_app_metrics/live - /apis/v1/dataforseo/dataforseo_labs/apple/keywords_for_app/live - /apis/v1/dataforseo/dataforseo_labs/available_filters - /apis/v1/dataforseo/dataforseo_labs/google/app_competitors/live - /apis/v1/dataforseo/dataforseo_labs/google/app_intersection/live - /apis/v1/dataforseo/dataforseo_labs/google/available_history - /apis/v1/dataforseo/dataforseo_labs/google/bulk_app_metrics/live - /apis/v1/dataforseo/dataforseo_labs/google/bulk_keyword_difficulty/live - /apis/v1/dataforseo/dataforseo_labs/google/bulk_traffic_estimation/live - /apis/v1/dataforseo/dataforseo_labs/google/categories_for_domain/live - >- /apis/v1/dataforseo/dataforseo_labs/google/categories_for_keywords/languages - /apis/v1/dataforseo/dataforseo_labs/google/categories_for_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/competitors_domain/live - /apis/v1/dataforseo/dataforseo_labs/google/domain_intersection/live - >- /apis/v1/dataforseo/dataforseo_labs/google/domain_metrics_by_categories/live - /apis/v1/dataforseo/dataforseo_labs/google/domain_rank_overview/live - >- /apis/v1/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_keyword_data/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_rank_overview/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_search_volume/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_serps/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_ideas/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_overview/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_suggestions/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_app/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_categories/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_site/live - /apis/v1/dataforseo/dataforseo_labs/google/page_intersection/live - /apis/v1/dataforseo/dataforseo_labs/google/ranked_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/related_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/relevant_pages/live - /apis/v1/dataforseo/dataforseo_labs/google/search_intent/live - /apis/v1/dataforseo/dataforseo_labs/google/serp_competitors/live - /apis/v1/dataforseo/dataforseo_labs/google/subdomains/live - /apis/v1/dataforseo/dataforseo_labs/google/top_searches/live - /apis/v1/dataforseo/dataforseo_labs/status - >- /apis/v1/dataforseo/domain_analytics/technologies/aggregation_technologies/live - /apis/v1/dataforseo/domain_analytics/technologies/available_filters - /apis/v1/dataforseo/domain_analytics/technologies/domain_technologies/live - >- /apis/v1/dataforseo/domain_analytics/technologies/domains_by_html_terms/live - >- /apis/v1/dataforseo/domain_analytics/technologies/domains_by_technology/live - /apis/v1/dataforseo/domain_analytics/technologies/languages - /apis/v1/dataforseo/domain_analytics/technologies/locations - /apis/v1/dataforseo/domain_analytics/technologies/technologies - >- /apis/v1/dataforseo/domain_analytics/technologies/technologies_summary/live - /apis/v1/dataforseo/domain_analytics/technologies/technology_stats/live - /apis/v1/dataforseo/domain_analytics/whois/available_filters - /apis/v1/dataforseo/domain_analytics/whois/overview/live - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/industries - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/job_functions - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/live - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/task_post - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/tasks_ready - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/live - >- /apis/v1/dataforseo/keywords_data/bing/keyword_performance/locations_and_languages - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/task_post - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/languages - /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/live - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/task_post - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/tasks_ready - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/live - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/task_post - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/live - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/task_post - /apis/v1/dataforseo/keywords_data/bing/languages - /apis/v1/dataforseo/keywords_data/bing/locations - /apis/v1/dataforseo/keywords_data/bing/search_volume/live - /apis/v1/dataforseo/keywords_data/bing/search_volume/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/search_volume/task_post - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/live - >- /apis/v1/dataforseo/keywords_data/bing/search_volume_history/locations_and_languages - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/task_post - /apis/v1/dataforseo/keywords_data/clickstream_data/bulk_search_volume/live - >- /apis/v1/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live - >- /apis/v1/dataforseo/keywords_data/clickstream_data/global_search_volume/live - /apis/v1/dataforseo/keywords_data/clickstream_data/locations_and_languages - /apis/v1/dataforseo/keywords_data/dataforseo_trends/demography/live - /apis/v1/dataforseo/keywords_data/dataforseo_trends/explore/live - /apis/v1/dataforseo/keywords_data/dataforseo_trends/locations - /apis/v1/dataforseo/keywords_data/dataforseo_trends/merged_data/live - >- /apis/v1/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live - /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/live - >- /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/live - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_post - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/live - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/task_post - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/live - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/task_post - /apis/v1/dataforseo/keywords_data/google_ads/status - /apis/v1/dataforseo/keywords_data/google_trends/categories - /apis/v1/dataforseo/keywords_data/google_trends/explore/live - /apis/v1/dataforseo/keywords_data/google_trends/explore/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_trends/explore/task_post - /apis/v1/dataforseo/merchant/amazon/asin/live/advanced - /apis/v1/dataforseo/merchant/amazon/asin/live/html - /apis/v1/dataforseo/merchant/amazon/asin/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/asin/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/asin/task_post - /apis/v1/dataforseo/merchant/amazon/asin/tasks_ready - /apis/v1/dataforseo/merchant/amazon/languages - /apis/v1/dataforseo/merchant/amazon/locations - /apis/v1/dataforseo/merchant/amazon/products/live/advanced - /apis/v1/dataforseo/merchant/amazon/products/live/html - /apis/v1/dataforseo/merchant/amazon/products/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/products/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/products/task_post - /apis/v1/dataforseo/merchant/amazon/products/tasks_ready - /apis/v1/dataforseo/merchant/amazon/sellers/live/advanced - /apis/v1/dataforseo/merchant/amazon/sellers/live/html - /apis/v1/dataforseo/merchant/amazon/sellers/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/sellers/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/sellers/task_post - /apis/v1/dataforseo/merchant/amazon/sellers/tasks_ready - /apis/v1/dataforseo/merchant/google/languages - /apis/v1/dataforseo/merchant/google/locations - /apis/v1/dataforseo/merchant/google/product_info/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/product_info/task_post - /apis/v1/dataforseo/merchant/google/product_info/tasks_ready - /apis/v1/dataforseo/merchant/google/products/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/products/task_get/html/{id} - /apis/v1/dataforseo/merchant/google/products/task_post - /apis/v1/dataforseo/merchant/google/products/tasks_ready - /apis/v1/dataforseo/merchant/google/reviews/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/reviews/task_post - /apis/v1/dataforseo/merchant/google/reviews/tasks_ready - /apis/v1/dataforseo/merchant/google/sellers/ad_url - /apis/v1/dataforseo/merchant/google/sellers/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/sellers/task_post - /apis/v1/dataforseo/merchant/google/sellers/tasks_ready - /apis/v1/dataforseo/on_page/available_filters - /apis/v1/dataforseo/on_page/content_parsing - /apis/v1/dataforseo/on_page/content_parsing/live - /apis/v1/dataforseo/on_page/duplicate_content - /apis/v1/dataforseo/on_page/duplicate_tags - /apis/v1/dataforseo/on_page/force_stop - /apis/v1/dataforseo/on_page/instant_pages - /apis/v1/dataforseo/on_page/keyword_density - /apis/v1/dataforseo/on_page/lighthouse/audits - /apis/v1/dataforseo/on_page/lighthouse/languages - /apis/v1/dataforseo/on_page/lighthouse/live/json - /apis/v1/dataforseo/on_page/lighthouse/task_get/json/{id} - /apis/v1/dataforseo/on_page/lighthouse/task_post - /apis/v1/dataforseo/on_page/lighthouse/tasks_ready - /apis/v1/dataforseo/on_page/lighthouse/versions - /apis/v1/dataforseo/on_page/links - /apis/v1/dataforseo/on_page/microdata - /apis/v1/dataforseo/on_page/non_indexable - /apis/v1/dataforseo/on_page/page_screenshot - /apis/v1/dataforseo/on_page/pages - /apis/v1/dataforseo/on_page/pages_by_resource - /apis/v1/dataforseo/on_page/raw_html - /apis/v1/dataforseo/on_page/redirect_chains - /apis/v1/dataforseo/on_page/resources - /apis/v1/dataforseo/on_page/summary/{id} - /apis/v1/dataforseo/on_page/task_post - /apis/v1/dataforseo/on_page/tasks_ready - /apis/v1/dataforseo/on_page/uncrawlable_resources - /apis/v1/dataforseo/on_page/waterfall - /apis/v1/dataforseo/serp/ai_summary - /apis/v1/dataforseo/serp/baidu/languages - /apis/v1/dataforseo/serp/baidu/locations - /apis/v1/dataforseo/serp/baidu/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_post - /apis/v1/dataforseo/serp/baidu/organic/tasks_ready - /apis/v1/dataforseo/serp/bing/languages - /apis/v1/dataforseo/serp/bing/locations - /apis/v1/dataforseo/serp/bing/organic/live/advanced - /apis/v1/dataforseo/serp/bing/organic/live/html - /apis/v1/dataforseo/serp/bing/organic/live/regular - /apis/v1/dataforseo/serp/bing/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/bing/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/bing/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/bing/organic/task_post - /apis/v1/dataforseo/serp/bing/organic/tasks_ready - /apis/v1/dataforseo/serp/google/ads_advertisers/live/advanced - /apis/v1/dataforseo/serp/google/ads_advertisers/locations - /apis/v1/dataforseo/serp/google/ads_advertisers/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ads_advertisers/task_post - /apis/v1/dataforseo/serp/google/ads_advertisers/tasks_ready - /apis/v1/dataforseo/serp/google/ads_search/live/advanced - /apis/v1/dataforseo/serp/google/ads_search/locations - /apis/v1/dataforseo/serp/google/ads_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ads_search/task_post - /apis/v1/dataforseo/serp/google/ads_search/tasks_ready - /apis/v1/dataforseo/serp/google/ai_mode/languages - /apis/v1/dataforseo/serp/google/ai_mode/live/advanced - /apis/v1/dataforseo/serp/google/ai_mode/live/html - /apis/v1/dataforseo/serp/google/ai_mode/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ai_mode/task_get/html/{id} - /apis/v1/dataforseo/serp/google/ai_mode/task_post - /apis/v1/dataforseo/serp/google/ai_mode/tasks_ready - /apis/v1/dataforseo/serp/google/autocomplete/live/advanced - /apis/v1/dataforseo/serp/google/autocomplete/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/autocomplete/task_post - /apis/v1/dataforseo/serp/google/autocomplete/tasks_ready - /apis/v1/dataforseo/serp/google/dataset_info/live/advanced - /apis/v1/dataforseo/serp/google/dataset_info/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/dataset_info/task_post - /apis/v1/dataforseo/serp/google/dataset_info/tasks_ready - /apis/v1/dataforseo/serp/google/dataset_search/live/advanced - /apis/v1/dataforseo/serp/google/dataset_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/dataset_search/task_post - /apis/v1/dataforseo/serp/google/dataset_search/tasks_ready - /apis/v1/dataforseo/serp/google/events/live/advanced - /apis/v1/dataforseo/serp/google/events/locations - /apis/v1/dataforseo/serp/google/events/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/events/task_post - /apis/v1/dataforseo/serp/google/events/tasks_ready - /apis/v1/dataforseo/serp/google/finance_explore/live/advanced - /apis/v1/dataforseo/serp/google/finance_explore/live/html - /apis/v1/dataforseo/serp/google/finance_explore/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_explore/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_explore/task_post - /apis/v1/dataforseo/serp/google/finance_explore/tasks_ready - /apis/v1/dataforseo/serp/google/finance_markets/live/advanced - /apis/v1/dataforseo/serp/google/finance_markets/live/html - /apis/v1/dataforseo/serp/google/finance_markets/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_markets/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_markets/task_post - /apis/v1/dataforseo/serp/google/finance_markets/tasks_ready - /apis/v1/dataforseo/serp/google/finance_quote/live/advanced - /apis/v1/dataforseo/serp/google/finance_quote/live/html - /apis/v1/dataforseo/serp/google/finance_quote/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_quote/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_quote/task_post - /apis/v1/dataforseo/serp/google/finance_quote/tasks_ready - /apis/v1/dataforseo/serp/google/finance_ticker_search/live/advanced - >- /apis/v1/dataforseo/serp/google/finance_ticker_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_ticker_search/task_post - /apis/v1/dataforseo/serp/google/finance_ticker_search/tasks_ready - /apis/v1/dataforseo/serp/google/images/live/advanced - /apis/v1/dataforseo/serp/google/images/live/html - /apis/v1/dataforseo/serp/google/images/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/images/task_get/html/{id} - /apis/v1/dataforseo/serp/google/images/task_get/regular/{id} - /apis/v1/dataforseo/serp/google/images/task_post - /apis/v1/dataforseo/serp/google/images/tasks_ready - /apis/v1/dataforseo/serp/google/jobs/locations - /apis/v1/dataforseo/serp/google/jobs/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/jobs/task_get/html/{id} - /apis/v1/dataforseo/serp/google/jobs/task_post - /apis/v1/dataforseo/serp/google/jobs/tasks_ready - /apis/v1/dataforseo/serp/google/languages - /apis/v1/dataforseo/serp/google/local_finder/live/advanced - /apis/v1/dataforseo/serp/google/local_finder/live/html - /apis/v1/dataforseo/serp/google/local_finder/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/local_finder/task_get/html/{id} - /apis/v1/dataforseo/serp/google/local_finder/task_post - /apis/v1/dataforseo/serp/google/local_finder/tasks_ready - /apis/v1/dataforseo/serp/google/locations - /apis/v1/dataforseo/serp/google/maps/live/advanced - /apis/v1/dataforseo/serp/google/maps/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/maps/task_post - /apis/v1/dataforseo/serp/google/maps/tasks_ready - /apis/v1/dataforseo/serp/google/news/live/advanced - /apis/v1/dataforseo/serp/google/news/live/html - /apis/v1/dataforseo/serp/google/news/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/news/task_get/html/{id} - /apis/v1/dataforseo/serp/google/news/task_post - /apis/v1/dataforseo/serp/google/news/tasks_ready - /apis/v1/dataforseo/serp/google/organic/live/advanced - /apis/v1/dataforseo/serp/google/organic/live/html - /apis/v1/dataforseo/serp/google/organic/live/regular - /apis/v1/dataforseo/serp/google/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/google/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/google/organic/task_post - /apis/v1/dataforseo/serp/google/organic/tasks_ready - /apis/v1/dataforseo/serp/google/search_by_image/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/search_by_image/task_get/html/{id} - /apis/v1/dataforseo/serp/google/search_by_image/task_post - /apis/v1/dataforseo/serp/google/search_by_image/tasks_ready - /apis/v1/dataforseo/serp/naver/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/naver/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/naver/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/naver/organic/task_post - /apis/v1/dataforseo/serp/naver/organic/tasks_ready - /apis/v1/dataforseo/serp/screenshot - /apis/v1/dataforseo/serp/seznam/languages - /apis/v1/dataforseo/serp/seznam/locations - /apis/v1/dataforseo/serp/seznam/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_post - /apis/v1/dataforseo/serp/seznam/organic/tasks_ready - /apis/v1/dataforseo/serp/yahoo/languages - /apis/v1/dataforseo/serp/yahoo/locations - /apis/v1/dataforseo/serp/yahoo/organic/live/advanced - /apis/v1/dataforseo/serp/yahoo/organic/live/html - /apis/v1/dataforseo/serp/yahoo/organic/live/regular - /apis/v1/dataforseo/serp/yahoo/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_post - /apis/v1/dataforseo/serp/yahoo/organic/tasks_ready - /apis/v1/dataforseo/serp/youtube/languages - /apis/v1/dataforseo/serp/youtube/locations - /apis/v1/dataforseo/serp/youtube/organic/live/advanced - /apis/v1/dataforseo/serp/youtube/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/organic/task_post - /apis/v1/dataforseo/serp/youtube/organic/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_comments/live/advanced - /apis/v1/dataforseo/serp/youtube/video_comments/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_comments/task_post - /apis/v1/dataforseo/serp/youtube/video_comments/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_info/live/advanced - /apis/v1/dataforseo/serp/youtube/video_info/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_info/task_post - /apis/v1/dataforseo/serp/youtube/video_info/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_subtitles/live/advanced - /apis/v1/dataforseo/serp/youtube/video_subtitles/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_subtitles/task_post - /apis/v1/dataforseo/serp/youtube/video_subtitles/tasks_ready x-aisa-document: composer_version: '20' document_hash: sha256:247f0a53489bda2c81b4142a1275f7af13128904396e39f2485c6ba921e0d40a facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c generator_version: '3' protocol_version: '1' response_pending: [] schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: dataforseo servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/dataforseo/dataforseo_labs/google/historical_serps/live: post: tags: - default summary: Historical SERPs description: >- ‌ This endpoint will provide you with Google SERPs collected within the specified time frame. You will also receive a complete overview of featured snippets and other extra elements that were present within the specified dates. The data will allow you to analyze the dynamics of keyword rankings over time for the specified keyword and location. Usage-based billing; Default request estimate: $0.1356 USD (not a fixed price). Account-specific pricing and final settlement may differ. operationId: any_dataforseo_apis_v1_dataforseo_dataforseo_labs_e49bf5 requestBody: content: application/json: schema: example: - datetime_from: '2026-09-22 05:48:19' datetime_to: '2026-10-02 05:48:19' keyword: albert einstein language_code: en limit: 10 location_code: 2840 items: oneOf: - example: - datetime_from: '2026-09-22 05:48:19' datetime_to: '2026-10-02 05:48:19' keyword: albert einstein language_code: en limit: 10 location_code: 2840 properties: date_from: description: >- starting date of the time range
optional field
if you don't specify this field, the API will return all SERPs collected for 365 days starting from the current datetime value;
minimal possible value: 365 days from the current datetime value;
date format: "yyyy-mm-dd" type: - string - 'null' date_to: description: >- ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default;
date format: "yyyy-mm-dd";
example:
"2021-09-01" type: - string - 'null' keyword: description: >- keyword
required field
you can specify up to 700 characters in the keyword field;
all %## will be decoded (plus character ‘+’ will be decoded to a space character);
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B” type: string language_code: description: >- unique language identifier
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 parameters 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 parameters by making a separate request to the
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:
English type: string location_code: description: >- unique location identifier
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 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:
2840 type: integer 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 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:
United Kingdom type: string tag: description: >- user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response type: - string - 'null' type: object type: - object - 'null' type: array responses: '200': content: application/json: schema: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleHistoricalSerpsLiveResponseInfo type: - object - 'null' description: Successful operation default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats x-codeSamples: - label: Reference example lang: text source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request POST \ --url https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/google/historical_serps/live \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '[ { "keyword": "albert einstein", "datetime_from": "2026-09-22 05:48:19", "datetime_to": "2026-10-02 05:48:19", "location_code": 2840, "language_code": "en", "limit": 10 } ]' components: schemas: Response463397119C53_DataforseoLabsGoogleHistoricalSerpsLiveResponseInfo: allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseInfo' - properties: tasks: description: array of tasks items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleHistoricalSerpsLiveTaskInfo 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_DataforseoLabsGoogleHistoricalSerpsLiveTaskInfo: allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseTaskInfo' - properties: result: description: >- array of results
the array includes objects with SERPs for each month within the specified time frame items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleHistoricalSerpsLiveResultInfo 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_DataforseoLabsGoogleHistoricalSerpsLiveResultInfo: properties: items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_DataforseoLabsGoogleHistoricalSerpsLiveItem type: - object - 'null' type: - array - 'null' items_count: description: >- the number of results returned in the items array format: int64 type: - integer - 'null' keyword: description: >- keyword received in a POST array
the keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character) type: - string - '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 in a POST array type: - string - 'null' total_count: description: >- the total amount of results in our database relevant to your request format: int64 type: - integer - 'null' type: object Response463397119C53_DataforseoLabsGoogleHistoricalSerpsLiveItem: 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' datetime: description: >- date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 type: - string - 'null' item_types: description: >- types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:
answer_box, carousel, multi_carousel, featured_snippet, google_flights, google_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, ai_overview items: type: - string - 'null' type: - array - 'null' items: description: historical SERPs and related data found in the database items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseDataforseoLabsApiElementItem type: - object - 'null' type: - array - 'null' items_count: description: >- the number of results returned in the items array format: int64 type: - integer - 'null' keyword: description: >- keyword received in a POST array
the keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character) type: - string - '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_domain: description: search engine domain in a POST array type: - string - 'null' se_results_count: description: total number of results in SERP format: int64 type: - integer - 'null' se_type: description: search engine type in a POST array type: - string - 'null' spell: description: >- autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection oneOf: - $ref: '#/components/schemas/Response463397119C53_SpellInfo' type: - object - 'null' type: description: type of element type: - string - '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_SpellInfo: properties: keyword: description: |- keyword obtained as a result of search engine autocorrection the results will be provided for the corrected keyword type: - string - 'null' type: description: |- type of autocorrection possible values: did_you_mean, showing_results_for, no_results_found_for, including_results_for note: Yahoo and Yandex support only the following autocorrection type: including_results_for type: - string - 'null' 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_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_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.