The shelf price is only half of what a Turkish shopper pays
The Boyner API returns product data from the Turkish fashion retailer Boyner as clean JSON.
2 active endpoints. Every call is 1 credit.
- POST/boyner/v1/search
- POST/boyner/v1/product/detail
What Boyner endpoints does ReefAPI ship?
2 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Boyner API
2 of 2 endpoints, ready to run
Boyner cards for a keyword — id, title, brand, current and original price with the discount, the seller behind the listing, campaign and coupon copy, category, rating and stock.
{ "ok": true, "meta": { "api": "boyner", "endpoint": "search", "mode": "live", "latency_ms": 1700.2, "record_count": 24, "cache_hit": false }, "data": { "products": [ { "product_id": "15832363", "title": "Vizon Deri Erkek Spor Ayakkabı", "brand": "Elle", "url": "https://www.boyner.com.tr/vizon-deri-erkek-spor-ayakkabi-p-15832363", "category": "Sneaker", "category_id": "2756", "breadcrumbs": null, "price": 2599.9, "original_price": 7139.9, "discount_rate": 64, "campaign": "%63", "campaign_type": "discount", "is_campaign_discount": true, "currency": "TRY", "merchant_id": "2006246297", "campaigns": [ "2. Ürüne %50 İndirim" ], "badges": null, "special_badges": null, "rating": 0, "review_count": 0, "stock": 26, "in_stock": true, "color": "Vizon", "gender": "Erkek", "variant_id": "22599375", "barcodes": [ "3569898261414", "3569898261407", "3569898261391" ], "image": "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/LUBISA-VZ_2859_0_20260225002950231.jpg?v=1772086153", "images": [ "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/LUBISA-VZ_2859_0_20260225002950231.jpg?v=1772086153", "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/LUBISA-VZ_2859_0_20260225002951630.jpg?v=1772086153", "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/LUBISA-VZ_2859_0_20260225002953343.jpg?v=1772086153" ], "is_free_cargo": true, "has_fast_delivery": false }, { "product_id": "15104378", "title": "Valmenti Noa Erkek Siyah Hakiki Deri Sneakers & Spor Ayakkabı", "brand": "Valmenti", "url": "https://www.boyner.com.tr/valmenti-siyah-erkek-deri-sneaker-p-15104378", "category": "Sneaker", "category_id": "2756", "breadcrumbs": null, "price": 4061.85, "original_price": 6249, "discount_rate": 35, "campaign": "%35 İndirim", "campaign_type": "bestOffer", "is_campaign_discount": true, "currency": "TRY", "merchant_id": "2006120014", "campaigns": [ "2000 TL ye 400 TL İndirim" ], "badges": null, "special_badges": null, "rating": 0, "review_count": 0, "stock": 6, "in_stock": true, "color": "Siyah", "gender": "Erkek", "variant_id": "20282564", "barcodes": [ "8683630849687", "8683630849649", "8683630849656" ], "image": "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/8683630849694_0.jpg?v=9721271", "images": [ "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/8683630849694_0.jpg?v=9721271", "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/8683630849694_1.jpg?v=9721256", "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/8683630849694_2.jpg?v=9721261" ], "is_free_cargo": true, "has_fast_delivery": false }, { "product_id": "15935477", "title": "Tamer Tanca Kadın Hakiki Deri Siyah Sneakers & Spor Ayakkabı", "brand": "Tamer Tanca", "url": "https://www.boyner.com.tr/tamer-tanca-kadin-hakiki-deri-siyah-sneakers-spor-ayakkabi-p-15935477", "category": "Sneaker", "category_id": "2756", "breadcrumbs": null, "price": 5599.75, "original_price": 8615, "discount_rate": 35, "campaign": "%35 İndirim", "campaign_type": "bestOffer", "is_campaign_discount": true, "currency": "TRY", "merchant_id": "2001701989", "campaigns": [ "2000 TL ye 400 TL İndirim" ], "badges": null, "special_badges": null, "rating": 0, "review_count": 0, "stock": 28, "in_stock": true, "color": "Siyah", "gender": "Kadın", "variant_id": "22943441", "barcodes": [ "8684601591703", "8684601591727", "8684601591734" ], "image": "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/1116-1868-BN-AYK-Y26_2761_0_20260518105649186.jpg?v=1781100656", "images": [ "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/1116-1868-BN-AYK-Y26_2761_0_20260518105649186.jpg?v=1781100656", "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/1116-1868-BN-AYK-Y26_2761_0_20260518105650310.jpg?v=1781100656", "https://statics-mp.boyner.com.tr/mnresize/325/451/Boynerimages/1116-1868-BN-AYK-Y26_2761_0_20260518105651635.jpg?v=1781100656" ], "is_free_cargo": true, "has_fast_delivery": false } ], "count": 24, "total": 13510, "page": 1, "total_pages": 563 } }
How the Boyner API works
Boyner is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 184 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Working out what a Turkish shopper actually pays
The number on the card is the shelf price. Boyner sells through stacked basket discounts and coupons, and both are time-boxed.
{"query": "sneaker"}Cards carry the current price, the original and the discount already worked out, plus the seller name — which is how you separate Boyner's own stock from a marketplace merchant's.
{"product_id": "15593795"}Now the rest of the offer: the campaign headline, every active campaign with its start and end timestamp, the coupons with their minimum basket and expiry, and the size matrix with stock per size.
Price, campaign and coupon in one place, each with the window it is valid in — enough to reconstruct the basket price rather than the tag price.
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ı"}'{
"ok": true,
"data": { … },
"meta": {
"api": "boyner",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
Who is selling, what a size row carries, and what the price leaves out
Measured on a keyword search, a product opened in full, a query the shop has nothing for and an id that does not exist.
The merchant behind each listing comes back on the row, so filtering for Boyner's own stock is a field comparison rather than a guess. The product page goes further and lists the other offers on the same item, which is where a price comparison across sellers actually starts.
Alongside the price and its strike-through, a product carries the active campaigns — basket discounts, loyalty-points promotions — and the coupons, each with a minimum basket, a code and an expiry timestamp. Read only the price field and you will consistently overstate what a customer pays.
Campaigns come back with a start and an end, and coupons with an expiry. A price you cached yesterday can be right about the tag and wrong about the basket, and these fields are what let you notice.
The size matrix returns one row per size with its own stock state and barcode, which is what makes this useful for catalogue matching rather than only for display.
Measured against FLO and n11 on the same afternoon, Boyner is consistently the slowest to answer, and a first call after a quiet spell is slower still. Budget for it: give the call room, and do not run a large sweep of this source on the same timeout you would use for a search API.
What people build with Boyner
The jobs this data is most often used for.
endpoints
credit per call
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.
What Boyner data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 184 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"])Have a question? We got answers.
The questions people actually ask before wiring up Boyner.
Get a free key →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.
16 More APIs APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Boyner, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 183 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-08-30.