datawebotTrendyol data: seller offers, variants & marketplace API
Separate Trendyol product groups, seller barcodes, prices and Buy Box signals. Keep international storefront codes and authorized partner API records in scope.
Keep a Trendyol product page and each seller offer distinct
Trendyol's English storefront terms say the actual seller may be Trendyol or a Trendyol Partner and is identified on the product page. Preserve that seller with the particular product and displayed offer rather than assuming the platform is always the seller.
Scroll to compare →
| Public page evidence | What to keep together | Comparison boundary |
|---|---|---|
| Product page | Exact URL; source product identifier only when shown; title, brand and category context | A seller API `contentId` or product-main ID is not automatically a public-page identifier. |
| Seller | Name shown as seller on the product page; Trendyol or named Trendyol Partner | Do not assume Trendyol is the seller unless it is expressly identified there. |
| Selected option | Visible size/color/specification and its own offer when displayed | A product group can have multiple variants and seller offers; do not use the lowest range value for all choices. |
| Dated offer | Displayed amount, currency/market, seller and observation time | A current ask is not a completed transaction or a buyer's final checkout amount. |
Model the Partner API product group and variant separately
Trendyol's V2 Partner API lists approved products from the authenticated seller's own store. Its response separates product content from variant inventory, price and status, so preserve the source field names and parent relationship.
Scroll to compare →
| Seller API record | Documented fields | Keep separate |
|---|---|---|
| Product content | `contentId`, `productMainId`, brand and category IDs/names, title, description, images and product attributes | Product content identity from a barcode-specific variant or public item ID. |
| Variant | `variantId`, `barcode`, seller `supplierId`, `stockCode` and variant attribute IDs/values | One variant barcode from the product group or another seller's barcode. |
| Stock and price | Variant quantity, `price.listPrice`, `price.salePrice` and `price.priceSeenByCustomer` when returned | Keep each source label and capture time; do not relabel a field as order revenue or a completed sale. |
| Status and change | Approved/archived/on-sale state, product URL and seller/content modification timestamps | An absent, archived or not-on-sale item is not a measured inventory history. |
Treat international storefront code as an API data boundary
Trendyol's International Marketplace API requires a `storeFrontCode` header on every request. The documentation says that omitting it processes the request as TR; an unrecognized code returns an error. That API scope must travel with each seller observation.
Scroll to compare →
| Request context | What the current docs specify | Record rule |
|---|---|---|
| Storefront code | Required region/country code for International Marketplace requests; omission defaults to TR | Storefront code is part of the query scope, not just a display currency or host label. |
| Response language | `Accept-Language` supports `tr`, `en`, `ro`, `ar` and `el`; TR storefront responses are always Turkish, while docs map `ro` to RO, `el` to GR and `ar` to SA/AE/KW | Keep market code separate from response language; preserve original labels before translation. |
| Approved-product pagination | The V2 approved-product filter adds `nextPageToken` beyond 10,000 approved content items; page × size is limited to 10,000 | Store page/size and continuation token with the query so a partial seller catalog is not reported as complete. |
| Authorization context | The integration documentation describes the API for companies participating in the Trendyol Partner Program | Keep seller ID and credential context private; the API docs do not describe an anonymous catalog endpoint. |
Keep Buy Box signals inside the seller-scoped API record
Trendyol's International Marketplace Buy Box service is keyed by the seller's product barcodes. It returns a Buy Box rank, price and whether there is more than one seller; this is not a general public competing-offer feed.
Scroll to compare →
| API action or result | Documented scope | Interpretation |
|---|---|---|
| Buy Box lookup | Seller ID plus up to ten seller product barcodes; `storeFrontCode` identifies the target marketplace | Keep returned market and lookup time with the rank and price. |
| Buy Box response | Rank, Buy Box price and multiple-seller indicator; sample response also shows second/third Buy Box prices | The sample values are documentation examples, not current offers or observed results. |
| Price/stock update | A write endpoint changes price/quantity for products transferred to and approved by Trendyol; requests can return a batch request ID | An update request or queued result is not a fresh storefront read; check the batch status separately. |
| Seller catalog boundary | Product filtering and Buy Box services are under seller-specific API paths | Do not treat seller credentials or a seller's barcodes as a public competitor data permission. |
Review Trendyol's storefront terms for the relevant territory
The reviewed English Platform Terms identify different Trendyol operators by territory. They prohibit screen-scraping, robots, crawlers, data mining and other extraction tools without prior written consent, restrict unauthorized copying or use of platform content, and disallow automated access methods to account pages. Check the terms that apply to the storefront and market in scope.
Scroll to compare →
| Terms statement | Record handling | Scope limit |
|---|---|---|
| Automated access | Attribute the restriction to the reviewed English Platform Terms and preserve its review date | Do not interpret public visibility as consent or bypass account/security controls. |
| Platform and database content | Keep product-page fields attributed to the displayed seller and separate from the API catalog | The terms describe platform/data compilation rights and seller/user content; do not treat one category as blanket permission for the others. |
| Territorial operator | Record which storefront and applicable terms govern the use | The English text describes operators by territory; do not apply it to every Trendyol market without checking the relevant terms. |
| Seller API | Use the documented Partner API only within its seller authorization and platform terms | The partner workflow is distinct from permission to extract public or third-party shop data. |
Content reviewed 2026-10-07.