n11 APIn11.com ↗
Access n11.com product listings, reviews, best sellers, and search suggestions via API. Covers pricing, stock, installment plans, and seller data for Turkey's major marketplace.
What is the n11 API?
The n11.com API exposes 6 endpoints covering product search, category browsing, product details, reviews, autocomplete suggestions, and best sellers from Turkey's major e-commerce marketplace. The get_product_detail endpoint alone aggregates pricing, stock status, HTML specifications, installment payment plans, and related product recommendations into a single response, identified by a numeric product ID.
curl -X GET 'https://api.parse.bot/scraper/32a7d16d-8fb2-436e-9f3a-423816d72e1d/search_products?page=1&sort=RELEVANCE&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace n11-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""n11 Marketplace SDK — search, browse, drill into details and reviews."""
from parse_apis.n11_marketplace_api import N11, Sort, CategorySlug, ProductNotFound
client = N11()
# Search products by keyword, sorted by price low to high
for product in client.products.search(query="laptop", sort=Sort.PRICE_LOW, limit=3):
print(product.title, product.display_price, product.brand)
# Browse a category — phones
phone = client.products.by_category(
category_slug=CategorySlug.TELEFON_VE_AKSESUARLARI_CEP_TELEFONU, limit=1
).first()
if phone:
print(phone.title, phone.seller_nick_name, phone.stock)
# Drill into reviews for the found product
if phone:
for review in phone.reviews.list(page_size=10, limit=3):
print(review.score_as_star, review.masked_buyer_name, review.contents)
# Get full product details (specs, pricing, installments)
try:
detail = client.productdetails.get(product_id="735927454")
print(detail.description, detail.personalized)
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
# Autocomplete suggestions
for suggestion in client.suggestions.search(query="iphone", limit=5):
print(suggestion.keyword, suggestion.highlight_keyword)
# Best sellers
for item in client.bestsellers.list(limit=3):
print(item.title, item.price_float, item.product_brand)
print("Exercised: products.search / products.by_category / reviews.list / productdetails.get / suggestions.search / bestsellers.list")
Full-text search across n11.com product listings. Returns paginated results with product items, filter attributes, and pagination metadata. Each item includes id, title, brand, pricing, seller info, stock, and review count. Supports sorting by relevance, price, date, or reviews.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-indexed). |
| sort | string | Sorting option for results. |
| queryrequired | string | Search keyword (e.g., 'iphone', 'laptop', 'samsung'). |
{
"type": "object",
"fields": {
"query": "string search query",
"pageCount": "integer total pages",
"totalCount": "integer total results",
"currentPage": "integer current page",
"seoMetaData": "object with SEO metadata",
"itemsPerPage": "integer per page",
"productListingItems": "array of product listing objects",
"attributeSearchItems": "array of filter attributes"
},
"sample": {
"data": {
"query": "laptop",
"pageCount": 2254,
"totalCount": 45079,
"currentPage": 1,
"seoMetaData": {
"title": "Laptop - n11.com",
"canonical": "https://www.n11.com/bilgisayar/dizustu-bilgisayar"
},
"itemsPerPage": 20,
"productListingItems": [
{
"id": 735927454,
"url": "/urun/lenovo-ideapad-slim-3-120798503",
"brand": "LENOVO",
"stock": 3,
"title": "Lenovo IdeaPad Slim 3",
"priceStr": "24.429,99 TL",
"categoryId": 1000271,
"categoryName": "Dizüstü Bilgisayar",
"displayPrice": 25989.35,
"isFreeShipping": true,
"sellerNickName": "olnino",
"totalReviewCount": 4
}
],
"attributeSearchItems": [
{
"name": "Marka",
"seoName": "m",
"valueList": [
{
"name": "Asus",
"count": 9452,
"value": "Marka[-]Asus"
}
]
}
]
},
"status": "success"
}
}About the n11 API
Product Search and Category Browsing
The search_products endpoint accepts a query string and returns paginated results including productListingItems (each with id, title, brand, pricing, seller info, stock, and review count) alongside attributeSearchItems for filter facets and totalCount/pageCount for pagination. Sorting can be controlled via the sort parameter. The get_category_products endpoint works identically but requires a deep category slug of two or more path segments — for example, telefon-ve-aksesuarlari/cep-telefonu — and returns a categoryNameForSeo field in addition to the shared listing structure. Shallow single-segment slugs such as elektronik are not supported.
Product Detail and Reviews
get_product_detail takes a product_id string and an optional category_id to refine accuracy. The response is structured into four sub-objects: description (containing a productDetails array with HTML specs and tab content), personalized (real-time price, stock, delivery info, and seller data), installments (credit and corporate card installment plans), and recommendations (an array of related products). get_product_reviews returns a productFeedBackReviewList with each entry containing contents, scoreAsStar, createdDate, maskedBuyerName, and sellerNickname, plus a reviewStatistics object that breaks down star counts and provides a satisfyScore. Page size is configurable up to 100 reviews per request.
Suggestions and Best Sellers
search_suggestions accepts a partial query and returns three arrays: keywords, categories (each with categoryId and categoryUrl), and completeList where each item carries an autoCompleteType of KEYWORD, CATEGORY, BRAND, SELLER, or CAMPAIGN. get_best_sellers returns 10 products per page with fields including displayPrice, priceFloat, productBrand, and seller info. Note that the input page parameter is 1-indexed while the response's currentPage field is 0-indexed.
The n11 API is a managed, monitored endpoint for n11.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when n11.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official n11.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor competitor pricing on n11.com by polling
search_productsfor specific brands and trackingdisplayPricechanges over time. - Build a category explorer by traversing deep category slugs with
get_category_productsand surfacingattributeSearchItemsas filterable facets. - Aggregate review sentiment by fetching
productFeedBackReviewListfromget_product_reviewsand analyzingscoreAsStardistributions viareviewStatistics. - Power a typeahead search widget using
search_suggestionswith itsautoCompleteType-taggedcompleteListfor keywords, brands, and categories. - Track trending products by paginating
get_best_sellersand recordingpriceFloatandstockfields across daily snapshots. - Display installment payment options in a Turkish e-commerce price comparison tool using the
installmentsobject fromget_product_detail. - Feed a recommendation widget by extracting the
recommendations.recommendationResultarray fromget_product_detailresponses.
| 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 | 100 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 have an official public developer API?+
What does `get_product_detail` return beyond basic product info?+
description with HTML product specs and tab content, personalized with real-time price, stock, and delivery details, installments with credit and corporate card payment plans, and recommendations with related product suggestions. Supplying the optional category_id parameter can improve the accuracy of the pricing and stock data in the personalized object.Are there limitations on category browsing with `get_category_products`?+
bilgisayar/dizustu-bilgisayar. Single-segment top-level slugs like elektronik are not supported and will not return results. Category slugs and IDs can be discovered via search_suggestions, which returns categoryUrl and categoryId for each category suggestion.