Trendyol

Trendyol Delivery API

The delivery estimate for one Trendyol product variant from every seller listing it: the earliest and latest delivery date, the ship-by date, days to ship, tomorrow and same-day shipping cutoffs, rush delivery hours, local delivery and which listing is the buy box. On the Turkish storefront city_id and district_id narrow it to an address (Istanbul 133, Sisli 54). Costs 1 credit per request.

POST/api/v1/trendyol/delivery

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

content_idstring

A product's content id: items[].content_id, the number after -p- in a product link. Send content_id or url.

Example: 975557855

urlstring

A product link of any Trendyol storefront, alternative to content_id (a language-only path such as /en/... needs country).

Example: https://www.trendyol.com/samsung/galaxy-a17-4-128-gb-siyah-cep-telefonu-p-975557855

item_numberstring

The variant: variants[].item_number or buy_box.item_number on product. Default the buy box's.

Example: 1378939445

listing_idstring

The listing the site treats as the default (buy_box.listing_id, 32 hex characters). Default the buy box's. With item_number the product is not read first.

Example: ff1d23f6969474c32de9c4412c73db12

city_idstring

A Turkish city id (tr only): Istanbul is 133. There is no city list endpoint.

Example: 133

district_idstring

A district id of that city (tr only, needs city_id): Istanbul's Sisli is 54.

Example: 54

countrystringdefault:tr

The Trendyol storefront, as a lowercase country code. This endpoint serves all 35 Trendyol storefronts (13 languages, 16 currencies). Names come back in the storefront's language and prices in its currency, never converted; the answer echoes country, language and currency. ge, kz, kg and iq are served by Trendyol as the Turkish storefront, and ie, mt, gb, ru, us, ca, jo and lb are not sold to: they answer 400, not charged.

Example: tr

tr — Turkey, TRY, tr (Turkish) or en (English) or ar (Arabic); default tr. The default.
de — Germany, EUR, de (German).
at — Austria, EUR, de (German).
fr — France, EUR, en (English).
be — Belgium, EUR, en (English).
hr — Croatia, EUR, en (English).
dk — Denmark, EUR, en (English).
ee — Estonia, EUR, en (English).
fi — Finland, EUR, en (English).
it — Italy, EUR, en (English).
lv — Latvia, EUR, en (English).
lt — Lithuania, EUR, en (English).
nl — Netherlands, EUR, en (English).
pt — Portugal, EUR, en (English).
si — Slovenia, EUR, en (English).
es — Spain, EUR, en (English).
se — Sweden, EUR, en (English).
lu — Luxembourg, EUR, en (English).
bg — Bulgaria, EUR, bg (Bulgarian) or en (English); default bg.
gr — Greece, EUR, el (Greek) or en (English); default el.
cz — Czechia, CZK, cs (Czech) or en (English); default cs.
hu — Hungary, HUF, hu (Hungarian) or en (English); default hu.
pl — Poland, PLN, pl (Polish) or en (English); default pl.
ro — Romania, RON, ro (Romanian) or en (English); default ro.
sk — Slovakia, EUR, sk (Slovak) or en (English); default sk.
rs — Serbia, RSD, sr (Serbian (Latin)) or en (English); default sr.
ua — Ukraine, UAH, uk (Ukrainian) or en (English); default uk.
md — Moldova, MDL, ro (Romanian) or en (English); default ro.
ae — United Arab Emirates, AED, en (English) or ar (Arabic); default en.
sa — Saudi Arabia, SAR, ar (Arabic) or en (English); default ar.
qa — Qatar, QAR, ar (Arabic) or en (English); default ar.
kw — Kuwait, KWD, ar (Arabic) or en (English); default ar.
om — Oman, OMR, ar (Arabic) or en (English); default ar.
bh — Bahrain, BHD, ar (Arabic) or en (English); default ar.
az — Azerbaijan, AZN, tr (Turkish).

languagestring

The answer's language, from the storefront's own list (the first is the default): tr tr, en or ar; de and at de; the 15 English-language EU storefronts en; bg bg or en; gr el or en; cz cs or en; hu hu or en; pl pl or en; ro and md ro or en; sk sk or en; rs sr or en; ua uk or en; ae en or ar; sa, qa, kw, om and bh ar or en; az tr. Titles, categories and reviews come back in it. A language the storefront does not serve answers 400.

Example: en

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=120)

# When each seller would deliver the phone to Sisli, Istanbul.
d = client.trendyol.delivery(content_id="975557855", city_id="133", district_id="54")["data"]
for l in d["listings"]:
    if l["seller"]:
        print(l["seller"]["name"], l["buy_box"], l["delivery"]["start"], l["delivery"]["end"], l["ships_in_days"])

Response

"content_id": 975557855,

"item_number": 1378939445,

"city_id": 133,

"district_id": 54,

"time_zone": "Europe/Istanbul",

"count": 83,

"country": "tr",

"language": "tr",

"currency": "TRY"

"response_time": 2394

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) # When each seller would deliver the phone to Sisli, Istanbul. d = client.trendyol.delivery(content_id="975557855", city_id="133", district_id="54")["data"] for l in d["listings"]: if l["seller"]: print(l["seller"]["name"], l["buy_box"], l["delivery"]["start"], l["delivery"]["end"], l["ships_in_days"])