Platforms, unified entities, vendor APIs, endpoints and connectors.
commerce.productUnifiedSoonThe same item across marketplaces, matched by GTIN, brand and model, image and title.
key AIsa product_idStrong matches only4 Direct endpoints today
A first cut of the schema from the Q4 entity model. Names, types and coverage can change before the Unified layer ships.
titlestringObservedbrandBrandObservedmpnstringObservedcategoryCategoryObservedimagesMedia[]ObservedlistingsListing[]ObservedOne per marketplace, each with a confidence scorematch_confidencenumberEstimatedOnly strong matches come backunits_sold_30dEstimate[]EstimatedPer linked listing, side by side; never summedgtinstring[]ObservedTaken from its variants, checked against GS1Vendor endpoints that already return this kind of object, in the vendor's own format. Your code names the vendor, so switching vendors means changing it.
4 endpoints from 1 API · from $0.012
| API | Method | Path | Endpoint | Price |
|---|---|---|---|---|
| DataForSEO | GET | dataforseo/merchant/google/product_info/task_get/advanced/{id} | Get Google Shopping Product Info Results by id | Metered |
| DataForSEO | GET | dataforseo/merchant/google/product_info/task_post | Setting Google Shopping Product Info Tasks | from $0.012 |
| DataForSEO | GET | dataforseo/merchant/google/products/task_get/advanced/{id} | Get Google Shopping Products Results by id | Metered |
| DataForSEO | GET | dataforseo/merchant/google/products/task_post | Setting Google Shopping Products Tasks | from $0.012 |
Each link is a field you can ask for in the same call.
marketplace + listing IDOne product page on one marketplace: price, rank, reviews and sales.
GTIN · platform SKUOne size or color of a product.
trademark no. + nameA brand as sold, tied to its registered trademark.
taxonomy + codeA node in the Amazon, TikTok, Google or GS1 category tree.