docs / n11

n11 API scraper

base /n11/v16 endpoints

post/n11/v1/product/detail1 credit

Full n11 product by `url` or `product_id`: title, brand, price, discount, campaign (Sepette indirim), rating, review_count, images, seller, gtin/barcode, category, description, attributes, variants, rating_breakdown and sample reviews. Parsed from n11's own window.model JSON (durable).

Parameter		Allowed / range	Description
url	optional	—	Full n11 product URL (…/urun/<slug>-<id>). Provide url OR product_id.
product_id	optional	—	n11 product id — the digits at the end of /urun/<slug>-<id>. Provide product_id OR url (url is most reliable).
max_rotations = 6	optional	1–12	Advanced: residential IP-rotation attempts (1-12, default 6).

Try in playground →

post/n11/v1/product/reviews1 credit

Customer reviews for a product by `url` or `product_id`, paginated (`page`). Returns author, text, rating, date, helpful_count.

Parameter		Allowed / range	Description
url	optional	—	Full n11 product URL (…/urun/<slug>-<id>). Provide url OR product_id.
product_id	optional	—	n11 product id — the digits at the end of /urun/<slug>-<id>. Provide product_id OR url (url is most reliable).
page = 1	optional	1–	Result page (1-based).
max_rotations = 6	optional	1–12	Advanced: residential IP-rotation attempts (1-12, default 6).

Try in playground →

post/n11/v1/search1 credit

Search n11 by keyword (`query`), paginated + sortable. Every card carries product_id, title, brand, price, rating, image, url.

Parameter		Allowed / range	Description
query	required	—	Search keyword.
page = 1	optional	1–	Result page (1-based).
sort = default	optional	default · price_asc · price_desc · best_seller · newest	Result ordering.
max_rotations = 6	optional	1–12	Advanced: residential IP-rotation attempts (1-12, default 6).

Try in playground →

post/n11/v1/category1 credit

Browse an n11 category by its `url` (…/<slug> or …-c-<id>), paginated + sortable.

Parameter		Allowed / range	Description
url	required	—	Full n11 category URL (…/<slug> or …-c-<id>).
page = 1	optional	1–	Result page (1-based).
sort = default	optional	default · price_asc · price_desc · best_seller · newest	Result ordering.
max_rotations = 6	optional	1–12	Advanced: residential IP-rotation attempts (1-12, default 6).

Try in playground →

post/n11/v1/seller1 credit

Seller (mağaza) profile + its products by nickname or store `url`.

Parameter		Allowed / range	Description
seller	required	—	Seller nickname (nickName) or full store URL (…/magaza/<nick>).
page = 1	optional	1–	Result page (1-based).
max_rotations = 6	optional	1–12	Advanced: residential IP-rotation attempts (1-12, default 6).

Try in playground →

post/n11/v1/resolve1 credit

Resolve an n11 short-link (`token` or `url`, e.g. sl.n11.com/n/<token>) to its REAL n11.com URL + type. Follows www.n11.com/n/<token> THROUGH the wall (which a plain client 403s) and captures the final URL — escaping the app-only adj.st/Play-Store dead-end that the short link otherwise hits. Classifies product/store/campaign/category; for products it embeds the full product detail (include_detail) so one call returns both. Deterministic per token → cacheable.

Parameter		Allowed / range	Description
token	optional	—	n11 short-link token — the part after /n/ in https://sl.n11.com/n/<token> or https://www.n11.com/n/<token>. Provide token OR url.
url	optional	—	Full n11 short-link (sl.n11.com/n/…, www.n11.com/n/…, or an adj.st link carrying the token). Provide url OR token.
include_detail = true	optional	—	When the token resolves to a product, also embed the full product detail under `product` (saves a second call). Default true.
max_rotations = 6	optional	1–12	Advanced: residential IP-rotation attempts (1-12, default 6).

Try in playground →

Example request · product/detail

curl -X POST https://api.reefapi.com/n11/v1/product/detail \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://www.n11.com/urun/samsung-galaxy-a07-4-gb-128-gb-samsung-turkiye-garantili-106765738"}'

Response shape

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