n11.com APIn11.com ↗
Access n11.com product listings, reviews, best sellers, and category data via 6 structured endpoints. Get prices, specs, installment plans, and seller info.
curl -X GET 'https://api.parse.bot/scraper/32a7d16d-8fb2-436e-9f3a-423816d72e1d/search_products?page=1&sort=RELEVANCE&query=iphone' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with support for pagination and sorting. Returns product listings with IDs, titles, prices, ratings, and basic seller info.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sorting option. Accepted values: 'RELEVANCE', 'PRICE_LOW', 'PRICE_HIGH', 'NEWEST', 'REVIEWS'. |
| queryrequired | string | Search keyword (e.g., 'iphone', 'laptop') |
{
"type": "object",
"fields": {
"data": "object containing productListingItems array, pagination object, seoMetaData, attributeSearchItems, and category/filter metadata"
},
"sample": {
"data": {
"data": {
"pagination": {
"pageCount": 28,
"totalCount": 545,
"currentPage": 1,
"itemsPerPage": 20
},
"productListingItems": [
{
"id": 700177242,
"brand": "Xiaomi",
"stock": 301,
"title": "Xiaomi Redmi 15C 8 + 256 GB (Xiaomi Türkiye Garantili)",
"priceStr": "8.899 TL",
"displayPrice": 10569,
"sellerNickName": "n11",
"totalReviewCount": 226
}
]
}
},
"status": "success"
}
}About the n11.com API
The n11.com API provides 6 endpoints covering product search, category browsing, product details, reviews, autocomplete suggestions, and best-seller listings from Turkey's major multi-seller marketplace. The get_product_detail endpoint alone aggregates four distinct response objects — including installment payment plans, real-time stock status, and related product recommendations — from a single product ID.
Product Search and Discovery
The search_products endpoint accepts a query string plus optional page and sort parameters (RELEVANCE, PRICE_LOW, PRICE_HIGH, NEWEST, REVIEWS). It returns a productListingItems array alongside a pagination object, seoMetaData, attributeSearchItems, and category/filter metadata — giving enough context to build faceted search UIs or feed price-monitoring pipelines. The search_suggestions endpoint complements this by returning keywords, categories, and a completeList with typed entries (KEYWORD, CATEGORY, BRAND) based on a partial query string.
Category Browsing
get_category_products takes a deep category_slug with at least two path segments, such as telefon-ve-aksesuarlari/cep-telefonu or bilgisayar/dizustu-bilgisayar. Shallow, single-segment slugs like elektronik are not supported and will return an error. The response mirrors the search endpoint structure: a productListingItems array, pagination, and filter/attribute metadata. Use this endpoint when you want to enumerate a known category tree rather than keyword-matching.
Product Details and Reviews
get_product_detail accepts a numeric product_id string and an optional category_id for more accurate pricing and stock resolution. The response bundles four objects: description (HTML specs and product information), installments (credit card and corporate card installment plans), personalized (current price, stock level, delivery estimate, and seller info), and recommendations (related product suggestions). get_product_reviews provides paginated reviews with a reviewStatistics block — including per-star counts (fiveStarCount through oneStarCount), commentCount, and satisfyScore — plus a productFeedBackReviewList array with reviewer comments, scores, dates, and masked buyer names.
Best Sellers
get_best_sellers returns 10 products per page with fields including id, title, displayPrice, priceFloat, seller info, stock status, and category details. Note the pagination offset: the input page parameter is 1-indexed, but currentPage in the response is 0-indexed, so page=1 maps to currentPage=0 in the response body.
- Track real-time price changes for specific products using
get_product_detailpersonalized.pricefields. - Build a category crawler by combining
get_category_productswith multi-segment category slugs andpaginationmetadata. - Monitor review sentiment trends using
reviewStatistics.satisfyScoreand per-star counts fromget_product_reviews. - Populate autocomplete in a price-comparison tool using the typed
completeListentries fromsearch_suggestions. - Identify trending products on the platform by paginating through
get_best_sellersand recordingpriceFloatand stock status over time. - Extract installment plan data from
get_product_detailto compare financing options across competing sellers. - Aggregate product specs and seller information from search results for catalog enrichment or competitive analysis.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does n11.com offer an official developer API?+
What does `get_product_detail` return beyond basic product fields?+
get_product_detail returns four distinct objects for a given product_id: description with HTML product specs, installments with credit and corporate card payment plans, personalized with current price, stock status, delivery estimate, and seller info, and recommendations with related product suggestions. Passing an optional category_id can improve accuracy of the pricing and stock data in the personalized object.Are there any limitations on which category slugs work with `get_category_products`?+
elektronik are not supported and will return an error. Use slugs like telefon-ve-aksesuarlari/cep-telefonu or bilgisayar/dizustu-bilgisayar instead.Does the API return seller storefront pages or seller-level product listings?+
Can I filter reviews by star rating or sort them by date?+
get_product_reviews endpoint supports page and page_size pagination parameters but does not expose a star-rating filter or sort order parameter. The reviewStatistics object provides aggregate per-star counts, and individual review objects include score, scoreAsStar, and createdDate fields for client-side filtering. You can fork this API on Parse and revise it to add server-side filtering if the source supports it.