docs / boyner

Boyner API scraper

base /boyner/v12 endpoints

post/boyner/v1/search1 credit

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.

Parameter		Allowed / range	Description
query	required	—	Search keyword (Turkish keywords work best, e.g. 'erkek spor ayakkabı', 'nike sneaker', a brand name).
page = 1	optional	1–	Result page — 1-based (1, 2, 3…), 24 products per page.
max_rotations = 6	optional	1–12	Advanced: datacenter IP-rotation attempts before falling back to residential (1-12, default 6).

Try in playground →

post/boyner/v1/product/detail1 credit

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.

Parameter		Allowed / range	Description
url	optional	—	Full Boyner product URL (…-p-<id>). Provide url OR product_id.
product_id	optional	—	Boyner product id — the digits after '-p-' in the product URL. Provide product_id OR url.
max_rotations = 6	optional	1–12	Advanced: datacenter IP-rotation attempts before falling back to residential (1-12, default 6).

Try in playground →

Example request · search

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ı"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}