DataForSEO

DataForSEO Merchant API

The Merchant API from DataForSEO — 32 operation(s) for merchant.

GitHub OpenAPI

Operations 32

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v3/merchant/id_list List my Merchant task IDs for a period · Merchant id list #
Ask an LLM
“Can I see the IDs of all the shopping data tasks I created in a date range?”
“Which Merchant API tasks did I submit recently, including unfinished ones?”
Tell an agent
List the IDs and metadata of my Merchant tasks from a chosen period.
Show every Google Shopping and Amazon task I created this week.
POST /v3/merchant/errors List Merchant tasks that failed · Merchant errors #
Ask an LLM
“Which of my Merchant API tasks returned errors in the last 7 days?”
“Where can I see why my Amazon or Google Shopping scrapes failed?”
Tell an agent
Show Merchant tasks that errored during the past week.
Pull the error details for my failed shopping data tasks.
GET /v3/merchant/google/languages List Google Shopping languages · Merchant google languages #
Ask an LLM
“What languages are supported for Google Shopping results?”
“Which language codes can I use for Google Shopping product searches?”
Tell an agent
List supported Google Shopping languages.
Get the Google Shopping language codes.
GET /v3/merchant/google/locations List Google Shopping locations · Merchant google locations #
Ask an LLM
“Which locations can I pull Google Shopping data for?”
“What location codes does the Google Shopping endpoint accept?”
Tell an agent
List all supported Google Shopping locations.
Get the full Google Shopping location list.
GET /v3/merchant/google/locations/{country} List Google Shopping locations in a country · Merchant google locations country #
Ask an LLM
“Which Google Shopping cities and regions are available within one country?”
“Can I filter Google Shopping locations to a single country?”
Tell an agent
List Google Shopping locations within country {country}.
Show Google Shopping regions available for {country}.
POST /v3/merchant/google/products/task_post Queue a Google Shopping product search · Google products task post #
Ask an LLM
“Can I queue a search that lists the products Google Shopping shows for a query?”
“How do I collect Google Shopping product listings for a keyword in the background?”
Tell an agent
Queue a Google Shopping products task for the query wireless earbuds.
Post a background job listing Google Shopping products for my keyword.
GET /v3/merchant/google/products/tasks_ready List finished Google Shopping product tasks · Google products tasks ready #
Ask an LLM
“Which Google Shopping product search tasks have completed but not been collected?”
“Are my queued Google Shopping product searches ready?”
Tell an agent
List completed, uncollected Google Shopping products tasks.
Check which Google Shopping product searches are ready.
GET /v3/merchant/tasks_ready List finished Merchant tasks across all types · Merchant tasks ready #
Ask an LLM
“Which Merchant tasks of any kind, Google or Amazon, are completed and waiting to be collected?”
“Is there one place to see every finished shopping task I haven't fetched yet?”
Tell an agent
List all completed, uncollected Merchant tasks across every endpoint.
Show every ready shopping data task regardless of marketplace.
GET /v3/merchant/google/products/task_get/advanced/{id} Get parsed Google Shopping product results · Google products task get advanced #
Ask an LLM
“Where do I get structured product listings from a Google Shopping task I queued?”
“Can I fetch parsed prices and titles from a Google Shopping products task?”
Tell an agent
Fetch the parsed Google Shopping product results for task {id}.
Get structured product listings with prices from task {id}.
GET /v3/merchant/google/products/task_get/html/{id} Get raw HTML of Google Shopping product results · Google products task get html #
Ask an LLM
“Can I get the raw HTML page behind a Google Shopping products task?”
“Is the unparsed Google Shopping results page available for my task?”
Tell an agent
Fetch the raw HTML of Google Shopping products task {id}.
Download the unparsed Google Shopping page for task {id}.
POST /v3/merchant/google/sellers/task_post Queue a Google Shopping sellers lookup · Google sellers task post #
Ask an LLM
“Can I find the top 10 sellers offering a product on Google Shopping?”
“Which stores list a given product on Google Shopping, and at what price?”
Tell an agent
Queue a Google Shopping sellers task for this product.
Post a job listing the top sellers of a product on Google Shopping.
GET /v3/merchant/google/sellers/tasks_ready List finished Google Shopping sellers tasks · Google sellers tasks ready #
Ask an LLM
“Which Google Shopping sellers tasks are completed and uncollected?”
“Are my Google Shopping seller lookups ready?”
Tell an agent
List completed, uncollected Google Shopping sellers tasks.
Check which Google Shopping seller lookups are ready.
GET /v3/merchant/google/sellers/task_get/advanced/{id} Get Google Shopping sellers results · Google sellers task get advanced #
Ask an LLM
“Where do I collect the seller list from a Google Shopping sellers task?”
“Can I fetch sellers and their offers for a product by task ID?”
Tell an agent
Fetch the Google Shopping sellers results for task {id}.
Get the list of stores selling the product in task {id}.
POST /v3/merchant/google/product_info/task_post Queue a Google Shopping product details lookup · Google product info task post #
Ask an LLM
“Can I get a Google Shopping product's description, images, rating, variations and specs?”
“What identifiers do I need to look up a single product on Google Shopping?”
Tell an agent
Queue a Google Shopping product info task using its Google product ID.
Post a job fetching full details for one Google Shopping product.
GET /v3/merchant/google/product_info/tasks_ready List finished Google Shopping product info tasks · Google product info tasks ready #
Ask an LLM
“Which Google Shopping product info tasks are done and uncollected?”
“Are my product details lookups on Google Shopping ready?”
Tell an agent
List completed, uncollected Google Shopping product info tasks.
Check which Google Shopping product detail jobs are ready.
GET /v3/merchant/google/product_info/task_get/advanced/{id} Get Google Shopping product details results · Google product info task get advanced #
Ask an LLM
“Where can I retrieve the specs and reviews from a Google Shopping product info task?”
“Can I fetch one product's full Google Shopping details by task ID?”
Tell an agent
Fetch the Google Shopping product info results for task {id}.
Get description, images and specifications from product task {id}.
GET /v3/merchant/google/sellers/ad_url/{shop_ad_aclk} Resolve a Google Shopping seller ad URL · Google sellers ad url #
Ask an LLM
“Can I get the full destination URL, with all seller parameters, of a Google Shopping ad?”
“Where does a Google Shopping seller's ad click actually lead?”
Tell an agent
Resolve the full ad URL for Google Shopping ad click {shop_ad_aclk}.
Get the seller's landing URL behind ad {shop_ad_aclk}.
GET /v3/merchant/amazon/locations List Amazon locations · Amazon locations #
Ask an LLM
“Which locations can I pull Amazon product data for?”
“What Amazon location codes are supported?”
Tell an agent
List all supported Amazon locations.
Get the Amazon marketplace location list.
GET /v3/merchant/amazon/locations/{country} List Amazon locations in a country · Amazon locations country #
Ask an LLM
“Which Amazon locations are available within a specific country?”
“Can I filter Amazon locations by country?”
Tell an agent
List Amazon locations within country {country}.
Show Amazon delivery locations available for {country}.
GET /v3/merchant/amazon/languages List Amazon languages · Amazon languages #
Ask an LLM
“What languages are supported for Amazon product results?”
“Which language codes can I use for Amazon searches?”
Tell an agent
List supported Amazon languages.
Get the Amazon language codes.
POST /v3/merchant/amazon/products/task_post Queue an Amazon product search · Amazon products task post #
Ask an LLM
“Can I collect the Amazon search results for a product keyword?”
“How do I get Amazon product listings for a query in a given location?”
Tell an agent
Queue an Amazon products task for the keyword standing desk.
Post a job pulling Amazon search listings for my product name.
GET /v3/merchant/amazon/products/tasks_ready List finished Amazon product search tasks · Amazon products tasks ready #
Ask an LLM
“Which Amazon product search tasks are finished and uncollected?”
“Are my Amazon keyword searches ready?”
Tell an agent
List completed, uncollected Amazon products tasks.
Check which Amazon product searches are ready.
GET /v3/merchant/amazon/products/task_get/advanced/{id} Get parsed Amazon product search results · Amazon products task get advanced #
Ask an LLM
“Where do I get structured Amazon listings from a product search task?”
“Can I fetch parsed Amazon products, prices and ratings by task ID?”
Tell an agent
Fetch the parsed Amazon products results for task {id}.
Get structured Amazon search listings from task {id}.
GET /v3/merchant/amazon/products/task_get/html/{id} Get raw HTML of Amazon product search results · Amazon products task get html #
Ask an LLM
“Can I get the raw HTML of the Amazon search page for my task?”
“Is the unparsed Amazon results page available for a product search?”
Tell an agent
Fetch the raw HTML of Amazon products task {id}.
Download the unparsed Amazon search page for task {id}.
POST /v3/merchant/amazon/asin/task_post Queue an Amazon ASIN variations lookup · Amazon asin task post #
Ask an LLM
“Can I find all the ASINs assigned to different variations of one Amazon product?”
“Which sizes and colors of an Amazon product have their own ASIN?”
Tell an agent
Queue an Amazon ASIN task for a product ASIN.
Post a job listing every variation ASIN of an Amazon product.
GET /v3/merchant/amazon/asin/tasks_ready List finished Amazon ASIN tasks · Amazon asin tasks ready #
Ask an LLM
“Which Amazon ASIN lookup tasks are complete and uncollected?”
“Are my Amazon ASIN variation jobs ready?”
Tell an agent
List completed, uncollected Amazon ASIN tasks.
Check which Amazon ASIN lookups are ready.
GET /v3/merchant/amazon/asin/task_get/advanced/{id} Get parsed Amazon ASIN product results · Amazon asin task get advanced #
Ask an LLM
“Where do I get the product info and variation ASINs from an ASIN task?”
“Can I fetch parsed Amazon product details for an ASIN task?”
Tell an agent
Fetch the parsed Amazon ASIN results for task {id}.
Get product details and variation ASINs from task {id}.
GET /v3/merchant/amazon/asin/task_get/html/{id} Get raw HTML of an Amazon ASIN page · Amazon asin task get html #
Ask an LLM
“Can I get the raw Amazon product page HTML for an ASIN task?”
“Is the unparsed product page available for my ASIN lookup?”
Tell an agent
Fetch the raw HTML of Amazon ASIN task {id}.
Download the unparsed Amazon product page for ASIN task {id}.
POST /v3/merchant/amazon/sellers/task_post Queue an Amazon sellers lookup · Amazon sellers task post #
Ask an LLM
“Who sells a given product on Amazon, and at what price and condition?”
“Can I get each Amazon seller's shipping and rating details for a product?”
Tell an agent
Queue an Amazon sellers task for this ASIN.
Post a job listing all Amazon sellers of a product in the US.
GET /v3/merchant/amazon/sellers/tasks_ready List finished Amazon sellers tasks · Amazon sellers tasks ready #
Ask an LLM
“Which Amazon sellers tasks are done and uncollected?”
“Are my Amazon seller lookups ready?”
Tell an agent
List completed, uncollected Amazon sellers tasks.
Check which Amazon seller lookups are ready.
GET /v3/merchant/amazon/sellers/task_get/advanced/{id} Get parsed Amazon sellers results · Amazon sellers task get advanced #
Ask an LLM
“Where can I retrieve the parsed seller offers from an Amazon sellers task?”
“Can I fetch Amazon seller pricing and ratings by task ID?”
Tell an agent
Fetch the parsed Amazon sellers results for task {id}.
Get seller offers, conditions and shipping from task {id}.
GET /v3/merchant/amazon/sellers/task_get/html/{id} Get raw HTML of Amazon sellers page · Amazon sellers task get html #
Ask an LLM
“Can I get the raw HTML of the Amazon offers page for a sellers task?”
“Is the unparsed Amazon seller listing page available?”
Tell an agent
Fetch the raw HTML of Amazon sellers task {id}.
Download the unparsed Amazon offers page for task {id}.

Documentation

📖
Documentation
https://docs.dataforseo.com/v3/merchant/overview/
📖
APIReference
https://docs.dataforseo.com/v3/merchant/overview/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-merchant-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/json-schema/dataforseo-merchant-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/overlays/dataforseo-merchant-overlay.yaml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/examples/dataforseo-merchant-examples.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dataforseo:dataforseo-merchant-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dataforseo-merchant-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: DataForSEO Merchant API
  description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
  version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:


# --- truncated at 32 KB (195 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-merchant-api-openapi.yml