> ## 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 > ## Agent Instructions (AIsa) > > - 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`. > - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt # Live Merchant Amazon Asin Advanced > DataForSEO POST /v3/merchant/amazon/asin/live/advanced Usage-based billing; Default request estimate: $0.012 USD (not a fixed price). Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/dataforseo/merchant/amazon/asin/live/advanced * **Request URL template:** [https://api.aisa.one/apis/v1/dataforseo/merchant/amazon/asin/live/advanced](https://api.aisa.one/apis/v1/dataforseo/merchant/amazon/asin/live/advanced) * **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_merchant_amazon_bc8317", "method": "POST", "path": "/apis/v1/dataforseo/merchant/amazon/asin/live/advanced", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "asin": { "type": "string", "description": "product ID
required field
unique product identifier (ASIN) in Amazon
you can receive the asin parameter by making a separate request to the Amazon Products endpoint" }, "location_name": { "type": "string", "description": "full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with their location_name parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:
HA1,England,United Kingdom" }, "location_code": { "type": "integer", "description": "search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with their location_code parameters by making a separate request to the
https://api.dataforseo.com/v3/merchant/amazon/locations
example:
9045969" }, "location_coordinate": { "type": "string", "description": "GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_code
location_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:
53.476225,-2.243572,200" }, "language_name": { "type": "string", "description": "full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify 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/merchant/amazon/languages
example:
English (United Kingdom)" }, "language_code": { "type": "string", "description": "search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
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/merchant/amazon/languages
example:
en_GB" }, "se_domain": { "type": [ "string", "null" ], "description": "search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:
amazon.com, amazon.co.uk, amazon.fr, etc." }, "tag": { "type": [ "string", "null" ], "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" } }, "example": [ { "language_code": "en_US", "location_code": 2840, "asin": "B0756FCPPN" } ] } ] }, "example": [ { "language_code": "en_US", "location_code": 2840, "asin": "B0756FCPPN" } ] } } } }, "x-aisa-pricing": { "cost_contract": "response_usd", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.012, "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.012 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.012 * **Cost contract:** response\_usd * **Published reference multiplier:** 1.0 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml openapi/dataforseo.json POST /apis/v1/dataforseo/merchant/amazon/asin/live/advanced 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-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: facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '20' response_pending: [] document_hash: sha256:247f0a53489bda2c81b4142a1275f7af13128904396e39f2485c6ba921e0d40a x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: dataforseo x-aisa-catalogs: dataforseo: title: DataForSEO description: '' 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-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/dataforseo/merchant/amazon/asin/live/advanced: post: tags: - default summary: Live Merchant Amazon Asin Advanced description: >- DataForSEO POST /v3/merchant/amazon/asin/live/advanced Usage-based billing; Default request estimate: $0.012 USD (not a fixed price). Account-specific pricing and final settlement may differ. operationId: any_dataforseo_apis_v1_dataforseo_merchant_amazon_bc8317 requestBody: content: application/json: schema: type: array items: type: - object - 'null' oneOf: - type: object properties: asin: type: string description: >- product ID
required field
unique product identifier (ASIN) in Amazon
you can receive the asin parameter by making a separate request to the Amazon Products endpoint location_name: type: string description: >- full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with their location_name parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:
HA1,England,United Kingdom location_code: type: integer description: >- search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with their location_code parameters by making a separate request to the
https://api.dataforseo.com/v3/merchant/amazon/locations
example:
9045969 location_coordinate: type: string description: >- GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_code
location_coordinate parameter should be specified in the "latitude,longitude,radius" format
the maximum number of decimal digits for "latitude" and "longitude": 7
the minimum value for "radius": 199.9
example:
53.476225,-2.243572,200 language_name: type: string description: >- full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify 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/merchant/amazon/languages
example:
English (United Kingdom) language_code: type: string description: >- search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
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/merchant/amazon/languages
example:
en_GB se_domain: type: - string - 'null' description: >- search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:
amazon.com, amazon.co.uk, amazon.fr, etc. tag: type: - string - 'null' 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 example: - language_code: en_US location_code: 2840 asin: B0756FCPPN example: - language_code: en_US location_code: 2840 asin: B0756FCPPN responses: '200': description: Successful operation content: application/json: schema: type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_MerchantAmazonAsinLiveAdvancedResponseInfo default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats x-codeSamples: - lang: text label: Reference example source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request POST \ --url https://api.aisa.one/apis/v1/dataforseo/merchant/amazon/asin/live/advanced \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '[ { "language_code": "en_US", "location_code": 2840, "asin": "B0756FCPPN" } ]' components: schemas: Response463397119C53_MerchantAmazonAsinLiveAdvancedResponseInfo: type: object allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseInfo' - type: object properties: tasks: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_MerchantAmazonAsinLiveAdvancedTaskInfo description: array of tasks Response463397119C53_BaseResponseInfo: properties: version: type: - string - 'null' description: the current version of the API status_code: type: - integer - 'null' description: |- general status code you can find the full list of the response codes here status_message: type: - string - 'null' description: |- general informational message you can find the full list of general informational messages here time: type: - string - 'null' description: total execution time, seconds cost: type: - number - 'null' description: total tasks cost, USD format: double tasks_count: type: - integer - 'null' description: the number of tasks in the tasks array format: int64 tasks_error: type: - integer - 'null' description: the number of tasks in the tasks array returned with an error format: int64 Response463397119C53_MerchantAmazonAsinLiveAdvancedTaskInfo: type: object allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseTaskInfo' - type: object properties: result: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_MerchantAmazonAsinLiveAdvancedResultInfo description: array of results Response463397119C53_BaseResponseTaskInfo: properties: id: type: - string - 'null' description: |- task identifier unique task identifier in our system in the UUID format status_code: type: - integer - 'null' 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 status_message: type: - string - 'null' description: |- informational message of the task you can find the full list of general informational messages here time: type: - string - 'null' description: execution time, seconds cost: type: - number - 'null' description: total tasks cost, USD format: double result_count: type: - integer - 'null' description: number of elements in the result array format: int64 path: type: - array - 'null' items: type: - string - 'null' description: URL path data: type: - object - 'null' additionalProperties: type: - object - 'null' description: contains the same parameters that you specified in the POST request Response463397119C53_MerchantAmazonAsinLiveAdvancedResultInfo: type: object properties: asin: type: - string - 'null' description: >- ASIN received in a POST array
the unique product identifier in Amazon (ASIN) received in a POST array
learn more about the identified in this help center guide type: type: - string - 'null' description: type of element se_domain: type: - string - 'null' description: Amazon domain in a POST array location_code: type: - integer - 'null' description: location code in a POST array language_code: type: - string - 'null' description: language code in a POST array check_url: type: - string - 'null' description: >- direct URL to Amazon results
you can use it to make sure that we provided accurate results datetime: type: - string - 'null' 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 item_types: type: - array - 'null' items: type: - string - 'null' description: >- types of search results found on Amazon
contains types of all search results (items) found in the returned SERP
possible item types:
amazon_product_info items_count: type: - integer - 'null' description: >- the number of results returned in the items array format: int64 items: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_AmazonProductInfo' description: Amazon product info items Response463397119C53_AmazonProductInfo: type: object properties: type: type: - string - 'null' description: type of element rank_group: type: - integer - 'null' description: >- position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group rank_absolute: type: - integer - 'null' description: >- absolute rank
absolute position among all the elements in the response array position: type: - string - 'null' description: >- the alignment of the element in Amazon SERP
possible values:
left, right xpath: type: - string - 'null' description: >- the XPath of the element title: type: - string - 'null' description: product title details: type: - string - 'null' description: product specs and other details image_url: type: - string - 'null' description: the URL of the product image author: type: - string - 'null' description: product brand name data_asin: type: - string - 'null' description: ASIN of the product received in a POST array parent_asin: type: - string - 'null' description: >- parent ASIN of the product product_asins: type: - array - 'null' items: type: - string - 'null' description: ASINs of all found product modifications price_from: type: - number - 'null' description: >- the lower limit of the product price range
example:
49.98 price_to: type: - number - 'null' description: >- the upper limit of the product price range
example:
384.99 percentage_discount: type: - string - 'null' description: value of the percentage discount currency: type: - string - 'null' description: >- currency in the ISO format
example:
USD is_amazon_choice: type: - boolean - 'null' description: >- "Amazon's choice" label
if the value is true, the product is marked with the "Amazon's choice" label rating: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingElement' description: product rating info is_newer_model_available: type: - boolean - 'null' description: >- indicates whether the newer model of the product is available is_prime_video: type: - boolean - 'null' description: >- indicates whether a product has an Amazon Prime Video label
if true, specified product is a part of Amazon Prime Video service applicable_vouchers: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_AmazonApplicableVouchersItem description: >- array of objects containing information about applicable vouchers newer_model: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_NewerModel' description: information about the newer model of the product categories: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_Categories' description: contains related product categories product_information: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseMerchantAmazonProductInformationElementItem description: contains related product information product_images_list: type: - array - 'null' items: type: - string - 'null' description: >- contains URLs for all images of the product displayed on the left side of the main image product_videos_list: type: - array - 'null' items: type: - string - 'null' description: >- contains URLs for all videos of the product displayed on the right side of the main video description: type: - string - 'null' description: contains description of the product is_available: type: - boolean - 'null' description: >- indicates whether the product is available for ordering
if the value is true, the product can be ordered top_local_reviews: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_AmazonReviewItem' description: array of objects with top reviews from target location top_global_reviews: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_AmazonReviewItem' description: array of objects with top reviews from around the world Response463397119C53_RatingElement: type: object properties: type: type: - string - 'null' description: type of element position: type: - string - 'null' description: >- the alignment of the element in Google Shopping SERP
possible values:
left, right rating_type: type: - string - 'null' description: >- the type of rating
here you can find the following elements: Max5, Percents, CustomMax value: type: - number - 'null' description: value of the rating votes_count: type: - integer - 'null' description: the amount of feedback format: int64 rating_max: type: - integer - 'null' description: the maximum value for a rating_type Response463397119C53_AmazonApplicableVouchersItem: type: object properties: type: type: - string - 'null' description: type of element text: type: - string - 'null' description: text of the voucher fixed_discount: type: - number - 'null' description: value of the fixed discount fixed_discount_currency: type: - string - 'null' description: currency code of the fixed discount percentage_discount: type: - number - 'null' description: >- value of the percentage discount
if the discount is fixed, the value will be null important_details: type: - string - 'null' description: important details about the terms of discount vouchers Response463397119C53_NewerModel: type: object properties: title: type: - string - 'null' description: product title newer_model_asin: type: - string - 'null' description: ASIN of the newer product model Response463397119C53_Categories: type: object properties: category: type: - string - 'null' description: product category name url: type: - string - 'null' description: >- product category URL
indicates the browse path on Amazon with the unique browse node ID (product category ID on Amazon) Response463397119C53_BaseMerchantAmazonProductInformationElementItem: type: object properties: type: type: - string - 'null' description: type of element section_name: type: - string - 'null' description: >- name of the section related to product information specified in the contents additionalProperties: false discriminator: propertyName: type mapping: product_information_details_item: >- #/components/schemas/Response463397119C53_ProductInformationProductInformationDetailsItem product_information_text_item: >- #/components/schemas/Response463397119C53_ProductInformationProductInformationTextItem product_information_extended_item: >- #/components/schemas/Response463397119C53_ProductInformationProductInformationExtendedItem Response463397119C53_AmazonReviewItem: type: object properties: type: type: - string - 'null' description: type of element rank_group: type: - integer - 'null' description: >- position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group rank_absolute: type: - integer - 'null' description: >- absolute rank among all the listed reviews
absolute position among all reviews on the list position: type: - string - 'null' description: >- the alignment of the review in SERP
can take the following values: right xpath: type: - string - 'null' description: >- the XPath of the element verified: type: - boolean - 'null' description: >- indicates whether the review has the "Verified Purchase" mark subtitle: type: - string - 'null' description: subtitle of the review helpful_votes: type: - string - 'null' description: >- helpful votes count
number of users who clicked on the 'Helpful" button under the review text images: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_AiModeImagesElementInfo description: images of the product submitted by the reviewer videos: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_VideoElement' description: videos of the product submitted by the reviewer user_profile: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_UserProfileInfo' description: user profile of the reviewer title: type: - string - 'null' description: title of the review url: type: - string - 'null' review_text: type: - string - 'null' description: content of the review publication_date: type: - string - 'null' description: >- date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00 rating: type: - object - 'null' oneOf: - $ref: '#/components/schemas/Response463397119C53_RatingInfo' description: the rating score submitted by the reviewer Response463397119C53_ProductInformationProductInformationDetailsItem: type: object allOf: - type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseMerchantAmazonProductInformationElementItem - type: object properties: body: type: - object - 'null' additionalProperties: type: - string - 'null' description: >- contains information specified about the product within the section_name Response463397119C53_ProductInformationProductInformationTextItem: type: object allOf: - type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseMerchantAmazonProductInformationElementItem - type: object properties: text: type: - string - 'null' description: >- text specified under the given title within the section_name Response463397119C53_ProductInformationProductInformationExtendedItem: type: object allOf: - type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseMerchantAmazonProductInformationElementItem - type: object properties: contents: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_ProductInformationRows description: >- contains information specified about the product within the section_name Response463397119C53_AiModeImagesElementInfo: type: object properties: type: type: - string - 'null' description: type of element alt: type: - string - 'null' description: alt tag of the image url: type: - string - 'null' description: relevant URL image_url: type: - string - 'null' 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) Response463397119C53_VideoElement: type: object properties: type: type: - string - 'null' description: type of element source: type: - string - 'null' description: URL to the video source preview: type: - string - 'null' description: URL to the video preview image title: type: - string - 'null' description: title of a given link element timestamp: type: - string - 'null' 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 url: type: - string - 'null' description: source URL Response463397119C53_UserProfileInfo: type: object properties: name: type: - string - 'null' avatar: type: - string - 'null' url: type: - string - 'null' description: relevant url reviews_count: type: - integer - 'null' format: int64 locations: type: - string - 'null' Response463397119C53_RatingInfo: properties: rating_type: type: - string - 'null' description: |- the type of rating here you can find the following elements: Max5, Percents, CustomMax value: type: - number - 'null' description: the value of the rating format: double votes_count: type: - integer - 'null' description: the amount of feedback format: int64 rating_max: type: - integer - 'null' description: the maximum value for a rating_type Response463397119C53_ProductInformationRows: type: object properties: type: type: - string - 'null' description: type of element title: type: - string - 'null' description: >- title under which related product information appears on the Amazon product page rows: type: - array - 'null' items: type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseMerchantAmazonProductInformationRowElementItem description: rows containing related product information Response463397119C53_BaseMerchantAmazonProductInformationRowElementItem: type: object properties: type: type: - string - 'null' description: type of element additionalProperties: false discriminator: propertyName: type mapping: product_information_image_row: >- #/components/schemas/Response463397119C53_ProductInformationRowProductInformationImageRowElementItem product_information_text_row: >- #/components/schemas/Response463397119C53_ProductInformationRowProductInformationTextRowElementItem Response463397119C53_ProductInformationRowProductInformationImageRowElementItem: type: object allOf: - type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseMerchantAmazonProductInformationRowElementItem - type: object properties: alt: type: - string - 'null' description: alternative text of the related product image url: type: - string - 'null' description: URL of the image Response463397119C53_ProductInformationRowProductInformationTextRowElementItem: type: object allOf: - type: - object - 'null' oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseMerchantAmazonProductInformationRowElementItem - type: object properties: text: type: - string - 'null' description: text of the voucher securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.