Boyner API & Scraper
The Boyner API returns product data from the Turkish fashion retailer Boyner as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns products with id, title, brand, URL, category, price, original price and discount rate, and you can pull a product/detail. It is built for price intelligence, catalog enrichment and Turkish e-commerce analytics that need Boyner data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Boyner ids, the merchant_id that says who is selling, and the one place Turkish number formatting survives
Boyner is a department store and a marketplace on the same product page, so the field that matters most is merchant_id rather than the brand. The ids below were read off live responses on 2026-08-27, and the last two rows are the exception to an otherwise clean numeric payload: everything money-shaped is a JSON number except the coupon block, which Boyner passes through in Turkish notation.
| Field | Where it comes from | Measured shape |
|---|---|---|
| product_id | the digits after '-p-' in a boyner.com.tr URL | "15593795" - a string of 8 digits, not an integer |
| merchant_id | who actually ships the item | "1" is Boyner's own stock; marketplace sellers are 10 digits. On 'kahve makinesi' 12 of 24 rows were merchant_id 1 and the rest split across 2005134975, 2001260882, 2009607398, 2006499259 and 2002188899 |
| variant_id | sizes[].variant_id, one per size | "22711208" - the size-level key, a different id from product_id |
| category_id | search cards and detail | "2756" = Sneaker |
| barcode / gtin | sizes[].barcode, one EAN-13 per size | 5715825094299; product.gtin is the barcode of whichever size Boyner had selected |
| price, original_price | search and detail | JSON numbers, currency "TRY": 1899.0 down from 3449.0 |
| coupons[].MinBasketAmount | Boyner's coupon block, passed through raw | "7.500" - a string in Turkish notation where the dot is the thousands separator, so this is 7,500 TRY |
| other_merchants[].rating | the offer list on a detail page | "10.0" as a string, while the top-level merchant_rating for the same seller is the number 10.0001 |
seller is null on every search card measured (24 of 24 on two different queries) because Boyner stopped printing the seller name on listing tiles. merchant_id still identifies the seller there, and product/detail fills seller in as "BOYNER" or the marketplace shop name.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/boyner/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "erkek spor ayakkabı"
}
}{
"ok": true,
"meta": {
"api": "boyner",
"endpoint": "search",
"mode": "live",
"latency_ms": 878.2,
"record_count": 24,
"bytes": 319827,
"cache_hit": false,
"method": "next_data_json",
"page": 1,
"total": 9710
},
"data": {
"products": [
{
"product_id": "15572191",
"title": "IF4492 DAILY 4.0 Siyah Erkek Lifestyle Ayakkabı",
"brand": "Adidas",
"url": "https://www.boyner.com.tr/adidas-if4492-daily-40-siyah-erkek-lifestyle-ayakkabi-p-15572191",
"category": "Lifestyle Ayakkabı",
"breadcrumbs": "Spor/Ayakkabı/Lifestyle Ayakkabı",
"price": 2931.65,
"original_price": 3449,
"discount_rate": null,
"is_campaign_discount": false,
"currency": "TRY",
"seller": "BOYNER",
"merchant_id": "1",
"campaigns": [
"Hopi ile 50 Paracığını İster Birebir İster Katlayarak Kullan"
],
"badges": [
"Yeni Sezon",
"Şanslı Ürünler"
],
"special_badges": null,
"rating": 4.2,
"review_count": 13,
"stock": 35,
"in_stock": true,
"color": "Siyah",
"image": "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_001_[redacted-phone].jpg?v=[redacted-phone]",
"images": [
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_001_[redacted-phone].jpg?v=[redacted-phone]",
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_001_[redacted-phone].jpg?v=[redacted-phone]",
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_001_[redacted-phone].jpg?v=[redacted-phone]"
],
"is_free_cargo": true,
"has_fast_delivery": false
},
{
"product_id": "15665505",
"title": "JP8276 STREETTALK Siyah Erkek Lifestyle Ayakkabı",
"brand": "Adidas",
"url": "https://www.boyner.com.tr/adidas-jp8276-streettalk-siyah-erkek-lifestyle-ayakkabi-p-15665505",
"category": "Lifestyle Ayakkabı",
"breadcrumbs": "Spor/Ayakkabı/Lifestyle Ayakkabı",
"price": 2699.25,
"original_price": 3599,
"discount_rate": null,
"is_campaign_discount": false,
"currency": "TRY",
"seller": "BOYNER",
"merchant_id": "1",
"campaigns": [
"Hopi ile 50 Paracığını İster Birebir İster Katlayarak Kullan"
],
"badges": [
"Yeni Sezon",
"Şanslı Ürünler"
],
"special_badges": null,
"rating": 3.9,
"review_count": 7,
"stock": 27,
"in_stock": true,
"color": "Siyah",
"image": "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_001_[redacted-phone].jpg?v=[redacted-phone]",
"images": [
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_001_[redacted-phone].jpg?v=[redacted-phone]",
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_001_[redacted-phone].jpg?v=[redacted-phone]",
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_001_[redacted-phone].jpg?v=[redacted-phone]"
],
"is_free_cargo": true,
"has_fast_delivery": false
},
{
"product_id": "15593795",
"title": "Lacivert Erkek Sneaker TH HI VULC CORE LOW LTH II ESS",
"brand": "Tommy Hilfiger",
"url": "https://www.boyner.com.tr/tommy-hilfiger-lacivert-erkek-sneaker-th-hi-vulc-core-low-lth-ii-ess-p-15593795",
"category": "Sneaker",
"breadcrumbs": "Ayakkabı & Çanta/Ayakkabı/Sneaker",
"price": 3374.25,
"original_price": 4499,
"discount_rate": null,
"is_campaign_discount": false,
"currency": "TRY",
"seller": "BOYNER",
"merchant_id": "1",
"campaigns": [
"Hopi ile 50 Paracığını İster Birebir İster Katlayarak Kullan"
],
"badges": [
"Yeni Sezon",
"Şanslı Ürünler"
],
"special_badges": [
"En Çok Favorilenen"
],
"rating": 5,
"review_count": 10,
"stock": 14,
"in_stock": true,
"color": "Lacivert",
"image": "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_411_[redacted-phone].jpg?v=[redacted-phone]",
"images": [
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_411_[redacted-phone].jpg?v=[redacted-phone]",
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_411_[redacted-phone].jpg?v=[redacted-phone]",
"https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/[redacted-phone]_411_[redacted-phone].jpg?v=[redacted-phone]"
],
"is_free_cargo": true,
"has_fast_delivery": false
}
],
"count": 24,
"total": 9710,
"page": 1,
"total_pages": 405
}
}What the Boyner API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Boyner by keyword (`query`), paginated (`page`, 24/page). Every card carries product_id, title, brand, price (current + original + discount%), seller (merchantName — filter 'BOYNER' for Boyner-sold), campaigns/coupons (Hopi, 'Sepette %N İndirim'), image, url, category, rating, stock. | Pricing and assortment teams call search to search Boyner by keyword (`query`), paginated (`page`, 24/page). | query, page, max_rotations |
| product/detail | Full Boyner product by `url` OR `product_id`: title, brand, price (current + original + discount%), campaign headline + coupons (Hopi etc.), seller/merchantName + other offers, SIZES (Beden — EU sizes with per-size stock + barcode), all images, rating, review_count, stock, gtin/barcode, category, breadcrumbs, attributes, description and sample reviews. Parsed from Boyner's own getProductDetail JSON. | Brand-protection teams call product/detail to get full Boyner product by `url` OR `product_id`. | url, product_id, max_rotations |
Call search from your stack
curl -X POST https://api.reefapi.com/boyner/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"erkek spor ayakkabı"}'import requests
r = requests.post(
"https://api.reefapi.com/boyner/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "erkek spor ayakkabı"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/boyner/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "erkek spor ayakkabı"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.boyner.search with {"query":"erkek spor ayakkabı"}.Who uses this API and why
- Pricing teams call search to track Boyner prices and discounts.
- Catalog-enrichment tools use product/detail to fill listings with images and specs.
- Market analysts use search to size a Turkish fashion segment.
Questions developers ask before integrating
Why is the seller field null on every Boyner search result?
Boyner removed the seller name from its listing tiles, so search cards have nothing to parse and seller comes back null rather than guessed. merchant_id is still there and still identifies the seller, so filter on that. Calling product/detail on the same product_id fills in seller, merchant_rating and other_merchants with the competing offers.
Are Boyner prices Turkish-formatted strings or numbers?
Numbers. price, original_price and every price inside other_merchants come back as JSON floats with currency "TRY" - 1899.0, 3449.0, 3239.1 - so no locale parsing is needed. The one exception is the coupons block, which Boyner publishes in Turkish notation and which is passed through unchanged: MinBasketAmount "7.500" means 7,500 TRY, not seven and a half.
How do I tell Boyner's own stock from a marketplace seller?
merchant_id "1" is Boyner selling it themselves; anything else is a marketplace shop, and those ids are 10 digits long. On detail the same fact is available as is_boyner_product. Fashion queries skew heavily to Boyner's own stock (24 of 24 on 'erkek spor ayakkabi') while electronics do not (12 of 24 on 'kahve makinesi').
Why does discount_rate disagree with the campaign text?
discount_rate is computed from price against original_price and rounded, while campaign is Boyner's own marketing label. A measured row priced 1899.0 from 3449.0 is a 44.94% cut, so discount_rate reads 45 while campaign reads "%44 Indirim". campaign is often a lump-sum offer rather than a percentage at all, such as "500 TL Indirim" on a product whose derived discount_rate was 12.
What is inside sizes[] on a Boyner product?
One row per size, each with its own variant_id, its own EAN-13 barcode and a quantity. stock_variants_total is the sum of those quantities, verified on a live product where 0, 2, 1, 16, 15 and 8 added up to the reported 42. size_title tells you what the sizes mean, which is "Beden" for footwear and apparel.
What happens when a Boyner search matches nothing?
You get NOT_FOUND, not an empty 200. A nonsense query returned code NOT_FOUND with the message that the source's own result count is 0, and meta.total was 0. That distinction matters when you are monitoring a keyword: an empty list would look like a temporary parse failure, and this way it does not.
Does the Boyner detail endpoint return review text?
No. rating, review_count and favorite_count are all there - 4.8, 12 reviews and 2,854 favorites on a measured product - but sample_reviews is null, because Boyner loads review bodies client-side and does not put them in the page this endpoint reads. The field is returned as null rather than omitted so you can tell absent from empty.
How does Boyner paging work and how deep can I go?
24 products per page, 1-based, with meta.total carrying the source's own match count - 10,017 for 'erkek spor ayakkabi'. Page 2 of that query shared zero product_ids with page 1, so paging is real rather than a re-served first page. meta.total stays constant across pages, so you can size a crawl before you start it.
What is the Boyner API?
Boyner API is a ReefAPI endpoint group for boyner It returns live JSON through POST requests under /boyner/v1.
Is the Boyner API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Boyner calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Boyner login or account?
No login to Boyner is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Boyner data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Boyner API use?
Boyner actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Boyner from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call boyner actions with the same key, credit pool and JSON envelope used by normal REST requests.