VX Agents

API directory · Marketing & Analytics

DataForSEO Amazon Products & Sellers

v1.0.0 · 8 endpoints · 0 connections · shared by vx.ai

For Amazon sellers and brand teams: see which products rank on Amazon for a search term and where your ASIN sits, pull an ASIN's price, rating, product details and variations, and compare every seller offering it on price and condition, live from DataForSEO or queued in bulk.

Connect this API to an AI agent Browse all specs

What you can do with DataForSEO Amazon Products & Sellers via MCP

Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.

MethodPathOperationDescription
GET /v3/merchant/amazon/locations listAmazonLocations List location names and codes for Amazon tasks (free)
GET /v3/merchant/amazon/languages listAmazonLanguages List language names and codes for Amazon tasks (free)
POST /v3/merchant/amazon/products/live/advanced searchAmazonProductsLive Get the Amazon search results for a keyword right now
POST /v3/merchant/amazon/asin/live/advanced getAmazonProductDetailsLive Get an ASIN's product details (price, rating, bullets, variations) right now
POST /v3/merchant/amazon/sellers/live/advanced listAmazonSellersLive List the sellers offering an ASIN, with price and Buy Box, right now
POST /v3/merchant/amazon/products/task_post createAmazonProductsTask Queue Amazon keyword searches in bulk (cheaper than live)
GET /v3/merchant/amazon/products/tasks_ready listReadyAmazonProductsTasks List queued Amazon search tasks whose results are ready
GET /v3/merchant/amazon/products/task_get/advanced/{id} getAmazonProductsTaskResults Get the Amazon search results of a queued task

Authentication

basicAuth

HTTP Basic

DataForSEO uses HTTP basic auth with your API login and API password (not your dashboard password).

How to get a credential

  1. Sign up at https://app.dataforseo.com/register (pay-as-you-go; new accounts get trial credit).
  2. Open API Access in the dashboard (https://app.dataforseo.com/api-access).
  3. Copy the API login (your email) and the API password shown there.

Permissions used

DataForSEO has no scopes: every live call and every posted task is billed from your balance.

Access Operations
Billed live calls searchAmazonProductsLive, getAmazonProductDetailsLive, listAmazonSellersLive
Billed queued tasks createAmazonProductsTask
Results of your own tasks listReadyAmazonProductsTasks, getAmazonProductsTaskResults
Free lookups listAmazonLocations, listAmazonLanguages

Common errors

DataForSEO answers HTTP 200 and puts the real result in status_code (20000 = ok, 20100 = task created) inside the body and each task.

Code Meaning Fix
401 / 40100 Wrong login or API password Copy both again from API Access.
40200 / 40210 Balance too low Top up the account balance.
40203 Daily cost limit reached Raise the limit under API Settings in the dashboard.
40501 / 40503 Invalid field or location Use location_code from the locations list and a valid asin.
40601 / 40602 Task handed / still in queue Wait 30-60 seconds and fetch the same id again.
40202 Per-minute rate limit exceeded Slow down and retry.

Store the login and API password as a VX Agents basic-auth credential.

Usage guide

Setup

  • Credential: DataForSEO API login + API password as a basic-auth credential (see the authentication notes).
  • Worth pinning: your marketplace's location_code (e.g. 2840 United States, 2826 United Kingdom) and language_code (en_US, en_GB; take the exact value from listAmazonLanguages), and the ASINs of your own products.

Research a product on Amazon

  1. Look up codes once with listAmazonLocations and listAmazonLanguages (free).
  2. Every request body is an array with one task object, e.g. [{"keyword": "yoga mat", "location_code": 2840, "language_code": "en_US", "depth": 100}].
  3. Search ranking: searchAmazonProductsLive with keyword (optional department, price_min/price_max, sort_by such as relevance, price_low_to_high, price_high_to_low, featured, avg_customer_review, newest_arrival). Each item has rank_absolute, data_asin, title, price, rating and badges like is_amazon_choice; find where your ASIN sits.
  4. Product details: getAmazonProductDetailsLive with asin returns title, price range, rating, categories, product_information, images, description, variation ASINs (product_asins) and top reviews.
  5. Competing offers: listAmazonSellersLive with asin lists each seller with price, condition, shipping and seller rating.
  6. Many keywords at once: post them with createAmazonProductsTask (up to 100 task objects per call; cheaper than live), poll listReadyAmazonProductsTasks, then getAmazonProductsTaskResults with each task id.

Good to know

  • Live calls and posted tasks cost money from your balance; confirm with the user before large batches or a high depth.
  • Queued tasks run asynchronously: a fetch right after posting can return 40601/40602. Wait 30-60 seconds and try again; results stay available for 30 days.
  • Check status_code in the body and in each task: 20000 = ok, 20100 = task created.
  • tag labels a task (e.g. your SKU) and comes back in the results.

Source: DataForSEO Merchant API reference (https://docs.dataforseo.com/v3/merchant/amazon/overview/), checked 2026-10-25.

How to use this spec

  1. Create a free VX Agents account (sandbox tools included).
  2. Open the marketplace and connect “DataForSEO Amazon Products & Sellers” to an agent.
  3. Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.

Related APIs