How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
DataForSEO

DataForSEO Merchant API

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

Documentation Provider Profile APIs.io OpenAPI GitHub

DataForSEO Merchant API is one of 12 APIs that DataForSEO publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Merchant. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 1 JSON Schema.

This API exposes 32 operations across 32 paths, and defines 124 schemas. It is described by OpenAPI 3.0.1, at version 1.0.0.

Requests are made against 2 base URLs: https://api.dataforseo.com, https://sandbox.dataforseo.com.

32 operations 32 paths 124 schemas 24 GET8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0.0
Base URL
https://api.dataforseo.com
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

DataForSEO Merchant API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth).

Paths & Operations 32

Across 32 paths, the API surfaces 32 operations — 24 GET, 8 POST. Each is listed below with its method, path, parameters, and response codes.

Merchant 32
POST
/v3/merchant/id_list
This endpoint is designed to provide you with a list of IDs and metadata for all Merchant tasks created within the specified time period, including both successful and uncompleted tasks. for more inf…
MerchantIdList body → 200
POST
/v3/merchant/errors
By calling this endpoint you will receive information about the Merchant API tasks that returned an error within the past 7 days. for more info please visit 'https://docs.dataforseo.com/v3/merchant/e…
MerchantErrors body → 200
GET
/v3/merchant/google/languages
You will receive the list of supported Google Shopping languages by calling this API. for more info please visit 'https://docs.dataforseo.com/v3/merchant/google/languages/?bash'
MerchantGoogleLanguages → 200
GET
/v3/merchant/google/locations
for more info please visit 'https://docs.dataforseo.com/v3/merchant/google/locations/?bash'
MerchantGoogleLocations → 200
GET
/v3/merchant/google/locations/{country}
for more info please visit 'https://docs.dataforseo.com/v3/merchant/google/locations/?bash'
MerchantGoogleLocationsCountry 1 param → 200
POST
/v3/merchant/google/products/task_post
Google Shopping Products endpoint will provide you with the list of products found on Google Shopping for the specified query. The results include product title, description in Google Shopping SERP,…
GoogleProductsTaskPost body → 200
GET
/v3/merchant/google/products/tasks_ready
The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postbackurl, you can re…
GoogleProductsTasksReady → 200
GET
/v3/merchant/tasks_ready
The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postbackurl, you can re…
MerchantTasksReady → 200
GET
/v3/merchant/google/products/task_get/advanced/{id}
Description of the fields for sending a request: for more info please visit 'https://docs.dataforseo.com/v3/merchant/google/products/taskget/advanced/?bash'
GoogleProductsTaskGetAdvanced 1 param → 200
GET
/v3/merchant/google/products/task_get/html/{id}
Description of the fields for sending a request: for more info please visit 'https://docs.dataforseo.com/v3/merchant/google/products/taskget/html/?bash'
GoogleProductsTaskGetHtml 1 param → 200
POST
/v3/merchant/google/sellers/task_post
Google Shopping Sellers endpoint will provide you with the list of top 10 sellers that listed the specified product on Google Shopping. The provided data for each seller includes related product base…
GoogleSellersTaskPost body → 200
GET
/v3/merchant/google/sellers/tasks_ready
The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postbackurl, you can re…
GoogleSellersTasksReady → 200
GET
/v3/merchant/google/sellers/task_get/advanced/{id}
Description of the fields for sending a request: for more info please visit 'https://docs.dataforseo.com/v3/merchant/google/sellers/taskget/advanced/?bash'
GoogleSellersTaskGetAdvanced 1 param → 200
POST
/v3/merchant/google/product_info/task_post
This endpoint provides data on a product listed on Google Shopping, including product description, images, rating, variations, specifications and sellers. In order to set a task, you have to specify…
GoogleProductInfoTaskPost body → 200
GET
/v3/merchant/google/product_info/tasks_ready
The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postbackurl, you can re…
GoogleProductInfoTasksReady → 200
GET
/v3/merchant/google/product_info/task_get/advanced/{id}
Description of the fields for sending a request: for more info please visit 'https://docs.dataforseo.com/v3/merchant/google/productinfo/taskget/advanced/?bash'
GoogleProductInfoTaskGetAdvanced 1 param → 200
GET
/v3/merchant/google/sellers/ad_url/{shop_ad_aclk}
Google Shopping Sellers Ad URL is designed to provide you with a full URL of the advertisement containing all additional parameters set by the seller. for more info please visit 'https://docs.datafor…
GoogleSellersAdUrl 1 param → 200
GET
/v3/merchant/amazon/locations
You will receive the list of supported Amazon locations by this API call. You can filter the list of locations by country when setting a task. for more info please visit 'https://docs.dataforseo.com/…
AmazonLocations → 200
GET
/v3/merchant/amazon/locations/{country}
You will receive the list of supported Amazon locations by this API call. You can filter the list of locations by country when setting a task. for more info please visit 'https://docs.dataforseo.com/…
AmazonLocationsCountry 1 param → 200
GET
/v3/merchant/amazon/languages
You will receive the list of supported Amazon languages by calling this API. for more info please visit 'https://docs.dataforseo.com/v3/merchant/amazon/languages/?bash'
AmazonLanguages → 200
POST
/v3/merchant/amazon/products/task_post
This endpoint provides results from Amazon product listings according to the specified keyword (product name), location, and language parameters. for more info please visit 'https://docs.dataforseo.c…
AmazonProductsTaskPost body → 200
GET
/v3/merchant/amazon/products/tasks_ready
The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postbackurl, you can re…
AmazonProductsTasksReady → 200
GET
/v3/merchant/amazon/products/task_get/advanced/{id}
Description of the fields for sending a request: for more info please visit 'https://docs.dataforseo.com/v3/merchant/amazon/products/taskget/advanced/?bash'
AmazonProductsTaskGetAdvanced 1 param → 200
GET
/v3/merchant/amazon/products/task_get/html/{id}
Description of the fields for sending a request: for more info please visit 'https://docs.dataforseo.com/v3/merchant/amazon/products/taskget/html/?bash'
AmazonProductsTaskGetHtml 1 param → 200
POST
/v3/merchant/amazon/asin/task_post
This endpoint will provide you with a full list of ASINs assigned to different modifications of a product. for more info please visit 'https://docs.dataforseo.com/v3/merchant/amazon/asin/taskpost/?ba…
AmazonAsinTaskPost body → 200
GET
/v3/merchant/amazon/asin/tasks_ready
The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postbackurl, you can re…
AmazonAsinTasksReady → 200
GET
/v3/merchant/amazon/asin/task_get/advanced/{id}
This endpoint will provide you with information about the product and ASINs of all its modifications listed on Amazon. for more info please visit 'https://docs.dataforseo.com/v3/merchant/amazon/asin/…
AmazonAsinTaskGetAdvanced 1 param → 200
GET
/v3/merchant/amazon/asin/task_get/html/{id}
Description of the fields for sending a request: for more info please visit 'https://docs.dataforseo.com/v3/merchant/amazon/asin/taskget/html/?bash'
AmazonAsinTaskGetHtml 1 param → 200
POST
/v3/merchant/amazon/sellers/task_post
This endpoint provides a list of sellers of the specified product on Amazon. The data provided for each seller includes related product condition, pricing, shipment, and rating details. The results a…
AmazonSellersTaskPost body → 200
GET
/v3/merchant/amazon/sellers/tasks_ready
The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postbackurl, you can re…
AmazonSellersTasksReady → 200
GET
/v3/merchant/amazon/sellers/task_get/advanced/{id}
This endpoint provides a list of sellers of the specified product on Amazon. The data provided for each seller includes related product condition, pricing, shipment, and rating details. for more info…
AmazonSellersTaskGetAdvanced 1 param → 200
GET
/v3/merchant/amazon/sellers/task_get/html/{id}
Description of the fields for sending a request: for more info please visit 'https://docs.dataforseo.com/v3/merchant/amazon/sellers/taskget/html/?bash'
AmazonSellersTaskGetHtml 1 param → 200

Schemas 124

The contract defines 124 schemas that model the data the API accepts and returns. The most detailed are AmazonProductInfo (30 properties), MerchantAmazonProductsTaskPostRequestInfo (20 properties), MerchantGoogleProductsTaskPostRequestInfo (19 properties), MerchantGoogleSellersTaskPostRequestInfo (18 properties). Each schema is shown below with its type and property counts.

BaseResponseTaskInfo
object
8 properties
MerchantAmazonSellersTaskGetAdvancedTaskInfo
object
AmazonProductNewerModelInfo
object
2 properties
MerchantAmazonLocationsCountryTaskInfo
object
VideoElement
object
6 properties
MerchantAmazonAsinTasksReadyTaskInfo
object
MerchantGoogleProductInfoTasksReadyResultInfo
object
7 properties
MerchantAmazonProductsTaskPostTaskInfo
object
MerchantAmazonAsinTaskGetAdvancedTaskInfo
object
PriceInfo
object
6 properties
MerchantGoogleProductsTaskPostResponseInfo
object
MerchantGoogleSellersTasksReadyTaskInfo
object
ProductInfoElement
object
17 properties
MerchantGoogleProductsTaskGetHtmlTaskInfo
object
MerchantAmazonSellersTaskPostTaskInfo
object
MerchantGoogleSellersAdUrlResponseInfo
object
MerchantGoogleLanguagesResponseInfo
object
ProductSeller
object
8 properties
ProductVariation
object
8 properties
MerchantAmazonProductsTaskGetHtmlTaskInfo
object
MerchantErrorsResultInfo
object
10 properties
MerchantGoogleSellersTasksReadyResultInfo
object
7 properties
MerchantAmazonSellersTasksReadyTaskInfo
object
MerchantAmazonProductsTaskPostRequestInfo
object
20 properties
MerchantAmazonAsinTaskGetAdvancedResultInfo
object
10 properties
MerchantGoogleProductsTasksReadyResultInfo
object
7 properties
MerchantGoogleSellersTaskGetAdvancedTaskInfo
object
MerchantTasksReadyResultInfo
object
7 properties
BaseMerchantAmazonProductInformationElementItem
object
2 properties
MerchantGoogleLocationsCountryTaskInfo
object
BaseMerchantAmazonElementItem
object
4 properties
MerchantAmazonAsinTaskGetHtmlTaskInfo
object
MerchantAmazonSellersTaskGetHtmlResultInfo
object
8 properties
MerchantAmazonLanguagesTaskInfo
object
MerchantIdListResponseInfo
object
MerchantGoogleProductInfoTasksReadyTaskInfo
object
MerchantAmazonProductsTaskGetAdvancedTaskInfo
object
MerchantAmazonAsinTasksReadyResponseInfo
object
MerchantAmazonSellersTasksReadyResponseInfo
object
AmazonReviewItem
object
16 properties
AmazonProductInfo
object
30 properties
MerchantAmazonAsinTaskGetHtmlResultInfo
object
8 properties
MerchantAmazonAsinTaskGetHtmlResponseInfo
object
MerchantGoogleProductsTasksReadyTaskInfo
object
MerchantAmazonProductsTaskGetAdvancedResultInfo
object
13 properties
MerchantAmazonLocationsResultInfo
object
5 properties
MerchantGoogleLanguagesTaskInfo
object
MerchantGoogleLocationsResultInfo
object
5 properties
MerchantAmazonSellersTaskGetHtmlTaskInfo
object
MerchantAmazonLocationsResponseInfo
object
MerchantGoogleLocationsCountryResponseInfo
object
MerchantGoogleProductInfoTaskGetAdvancedResponseInfo
object
MerchantIdListResultInfo
object
7 properties
MerchantErrorsResponseInfo
object
MerchantGoogleProductsTaskPostRequestInfo
object
19 properties
MerchantGoogleProductsTasksReadyResponseInfo
object
MerchantAmazonSellersTasksReadyResultInfo
object
7 properties
SpellInfo
object
2 properties
MerchantAmazonAsinTaskPostResponseInfo
object
MerchantGoogleProductsTaskGetAdvancedResultInfo
object
11 properties
MerchantAmazonLanguagesResultInfo
object
2 properties
MerchantGoogleProductInfoTaskGetAdvancedResultInfo
object
10 properties
MerchantAmazonSellersTaskGetAdvancedResultInfo
object
12 properties
MerchantGoogleProductsTaskGetHtmlResponseInfo
object
MerchantGoogleSellersAdUrlResultInfo
object
3 properties
MerchantErrorsRequestInfo
object
5 properties
BaseMerchantGoogleShoppingProductsElementItem
object
5 properties
MerchantGoogleProductInfoTaskGetAdvancedTaskInfo
object
MerchantGoogleProductInfoTaskPostRequestInfo
object
14 properties
RatingInfo
object
4 properties
MerchantAmazonProductsTasksReadyResponseInfo
object
MerchantAmazonLocationsTaskInfo
object
MerchantAmazonProductsTaskGetAdvancedResponseInfo
object
MerchantGoogleProductsTaskPostTaskInfo
object
MerchantAmazonSellersTaskGetAdvancedResponseInfo
object
AiModeImagesElementInfo
object
4 properties
MerchantAmazonLocationsCountryResultInfo
object
5 properties
MerchantGoogleProductsTaskGetAdvancedTaskInfo
object
MerchantAmazonProductsTaskGetHtmlResultInfo
object
8 properties
MerchantTasksReadyTaskInfo
object
ShoppingSpecification
object
4 properties
MerchantGoogleSellersTaskPostResponseInfo
object
ProductCategoryInfo
object
2 properties
MerchantAmazonAsinTaskPostRequestInfo
object
12 properties
BaseMerchantAmazonSellersElementItem
object
15 properties
MerchantGoogleSellersAdUrlTaskInfo
object
MerchantAmazonProductsTasksReadyTaskInfo
object
MerchantGoogleLocationsTaskInfo
object
MerchantGoogleSellersTaskGetAdvancedResponseInfo
object
MerchantAmazonProductsTaskGetHtmlResponseInfo
object
MerchantAmazonLanguagesResponseInfo
object
MerchantGoogleLanguagesResultInfo
object
2 properties
BaseMerchantGoogleShoppingSellersElementItem
object
16 properties
MerchantGoogleProductsTaskGetHtmlResultInfo
object
8 properties
MerchantGoogleProductInfoTasksReadyResponseInfo
object
MerchantGoogleSellersTaskGetAdvancedResultInfo
object
14 properties
MerchantGoogleLocationsCountryResultInfo
object
5 properties
MerchantAmazonProductsTaskPostResponseInfo
object
AmazonApplicableVouchersItem
object
6 properties
MerchantIdListTaskInfo
object
MerchantGoogleSellersTaskPostRequestInfo
object
18 properties
MerchantAmazonAsinTaskGetAdvancedResponseInfo
object
MerchantAmazonSellersTaskPostResponseInfo
object
MerchantAmazonSellersTaskPostRequestInfo
object
12 properties
UserProfileInfo
object
5 properties
MerchantGoogleProductsTaskGetAdvancedResponseInfo
object
MerchantAmazonProductsTasksReadyResultInfo
object
7 properties
MerchantAmazonSellersTaskGetHtmlResponseInfo
object
MerchantAmazonAsinTaskPostTaskInfo
object
MerchantGoogleSellersTaskPostTaskInfo
object
MerchantAmazonLocationsCountryResponseInfo
object
HtmlItemInfo
object
3 properties
RatingElement
object
6 properties
MerchantGoogleProductInfoTaskPostTaskInfo
object
MerchantGoogleSellersTasksReadyResponseInfo
object
AmazonDeliveryInfo
object
6 properties
BaseResponseInfo
object
7 properties
DeliveryInfo
object
2 properties
MerchantGoogleLocationsResponseInfo
object
MerchantErrorsTaskInfo
object
MerchantTasksReadyResponseInfo
object
MerchantGoogleProductInfoTaskPostResponseInfo
object
MerchantIdListRequestInfo
object
6 properties
MerchantAmazonAsinTasksReadyResultInfo
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

dataforseo-merchant-api-openapi.yml Raw ↑

Other APIs DataForSEO publishes across the network.

DataForSEO AiOptimization API
AE Profile APIs.io
DataForSEO AppData API
AE Profile APIs.io
DataForSEO Appendix API
AE Profile APIs.io
DataForSEO Backlinks API
AE Profile APIs.io
DataForSEO BusinessData API
AE Profile APIs.io
DataForSEO ContentAnalysis API
AE Profile APIs.io
DataForSEO DataforseoLabs API
AE Profile APIs.io
DataForSEO DomainAnalytics API
AE Profile APIs.io
DataForSEO KeywordsData API
AE Profile APIs.io
DataForSEO OnPage API
AE Profile APIs.io
DataForSEO Serp API
AE Profile APIs.io
#Merchant
← Back to D APIs
API Details
ID
dataforseo:dataforseo-merchant-api
Base URL
https://api.dataforseo.com
Docs
https://dataforseo.com/apis/merchant-api
Provider
DataForSEO
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=dataforseo-merchant-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/dataforseo-merchant-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of DataForSEO Merchant API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.