Nadirkitap API & Scraper
Nadirkitap is Turkey's marketplace for second-hand and rare books, where about 1,100 independent booksellers (sahaf) list books, old magazines and ephemera such as postcards, posters, stamps, coins and records.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API reads it as JSON. `search` takes free text or the site's advanced filters: title, author, publisher, translator, ISBN, language (Ottoman Turkish included), category, publication year range, binding, price range in Turkish lira, new only, signed, first edition, fine binding and one bookseller, with nine sort orders. Every row is one copy offered by one bookseller, with its price, struck price when the seller runs a discount, condition, stock and the seller's shop, success rate and transaction count. `listing` returns one copy in full: edition details, the seller's own description, category path, images, carrier, dispatch time and shipping price. `offers` lists every live copy of one edition by ISBN, cheapest first, and `seller` returns a bookshop's page: city, success rate, transactions, how many books and collectibles it lists and its running campaign.
What a Nadirkitap field actually contains
Fields that read differently from how they look. Every row was measured against live Nadirkitap pages on 2026-10-07.
| Field | What it holds |
|---|---|
| A row is a copy, not a book | Nadirkitap lists copies. The same edition appears once per bookseller who has it: ISBN 978-605-9350-97-6 (Gençler İçin Nutuk) had 13 copies from 11 sellers, priced 5 to 140 TL. offers groups them for you. |
| price_try and original_price_try | price_try is the price the page charges. When a bookseller runs a discount, the page strikes the old price through: that one is original_price_try. Example: a book printed as 2.312,31 TL struck and 2.081,08 TL payable. |
| ld_price_try | The price in the page's structured data. On discounted copies it is the struck price, not the one you pay (2 of 13 sampled listings). Use price_try. |
| condition and condition_stars | The bookseller's grade as the site prints it: Yeni (new), Yeni Gibi, Çok İyi, İyi and lower, with the star count shown next to it (5 to 1). New copies carry no stars. |
| type | book, magazine or ephemera, from the listing's own category. Ephemera (postcards, stamps, coins, posters) have no publisher, language, binding or ISBN on Nadirkitap, so those fields are null for them. |
| description | The bookseller's own note on the copy (damage, inscription, completeness). Null when the seller wrote none: 5 of 13 sampled listings had one. |
| seller | The bookshop's name, link, success rate (Başarı oranı, %) and transaction count as printed beside the copy. 5 of 100 book rows came from shops that publish no rate yet; those fields are null. |
| total and total_capped | Nadirkitap counts up to 10,000 results. A broader query reads 10,000 and total_capped is true: "divan" showed 10,000 while its own category counts added up to 21,457. |
| shipping | Who pays shipping, the carrier, the dispatch estimate (for example "1 günde kargoya verilir") and the bookseller's single-item and multi-item shipping price in TL. |
A plain query matches title and author together. As soon as you add a filter the query is matched against the title only, and the answer says so in meta.warnings.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/nadirkitap/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"title": "tutunamayanlar",
"author": "Oğuz Atay",
"sort": "price_asc"
}
}{
"ok": true,
"meta": {
"api": "nadirkitap",
"endpoint": "search",
"mode": "live",
"latency_ms": 1589.8,
"record_count": 24,
"bytes": 279703,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "149413d445be4d46",
"queue_ms": 1.1,
"fetched_at": "2026-10-07T15:52:11.231Z"
},
"data": {
"query": null,
"route": "advanced",
"total": 338,
"total_capped": false,
"page": 1,
"per_page": 24,
"last_page": 15,
"has_more": true,
"category_facets": [
{
"id": 77,
"name": "Edebiyat",
"count": 330
},
{
"id": 193,
"name": "Diğer & Çeşitli",
"count": 5
},
{
"id": 43,
"name": "Bilim ve Teknik",
"count": 3
}
],
"filters_applied": {
"type": "book",
"title": "tutunamayanlar",
"author": "Oğuz Atay",
"sort": "price_asc"
},
"listings": [
{
"id": 49437902,
"type": "book",
"url": "https://www.nadirkitap.com/tutunamayanlar-oguz-atay-kitap49437902.html",
"title": "Tutunamayanlar",
"author": "Oğuz Atay",
"publisher": "İletişim Yayınları",
"year": 2017,
"condition": "İyi",
"condition_stars": 3,
"price_try": 200,
"original_price_try": null,
"discounted": false,
"price_text": "200,00 TL",
"currency": "TRY",
"stock": 1,
"image": "https://static.nadirkitap.com/fotograf/2811943/49/Kitap_20261006131722281194311.jpg",
"seller": {
"id": 2811943,
"name": "Antitez Sahaf",
"url": "https://www.nadirkitap.com/antitez-sahaf-sahaf2811943.html",
"success_rate_pct": null,
"transactions": null
},
"seller_id": 2811943,
"shipping_badges": [
"1000 TL ve üzerine ücretsiz kargo",
"Aras ile anlaşmalı kargo 129 TL"
],
"seller_campaigns": []
},
{
"id": 47223777,
"type": "book",
"url": "https://www.nadirkitap.com/tutunamayanlar-butun-eserleri-1-oguz-atay-kitap47223777.html",
"title": "Tutunamayanlar | Bütün Eserleri 1",
"author": "Oğuz Atay",
"publisher": "İletişim Yayınları",
"year": 2004,
"condition": "İyi",
"condition_stars": 3,
"price_try": 215.9,
"original_price_try": 254,
"discounted": true,
"price_text": "215,90 TL",
"currency": "TRY",
"stock": 1,
"image": "https://static.nadirkitap.com/fotograf/880630/47/Kitap_2026052315180188063010.jpg",
"seller": {
"id": 880630,
"name": "İnci Sahaf",
"url": "https://www.nadirkitap.com/inci-sahaf-sahaf880630.html",
"success_rate_pct": 100,
"transactions": 64723
},
"seller_id": 880630,
"shipping_badges": [
"1750 TL ve üzerine ücretsiz kargo",
"DHL ile anlaşmalı kargo 159 TL"
],
"seller_campaigns": [
"50 TL ve üzeri alışverişlerde %15 indirim"
]
},
{
"id": 48561079,
"type": "book",
"url": "https://www.nadirkitap.com/tutunamayanlar-oguz-atay-kitap48561079.html",
"title": "Tutunamayanlar",
"author": "Oğuz Atay",
"publisher": "İletişim Yayınları",
"year": 2008,
"condition": "İyi",
"condition_stars": 3,
"price_try": 220,
"original_price_try": null,
"discounted": false,
"price_text": "220,00 TL",
"currency": "TRY",
"stock": 1,
"image": "https://static.nadirkitap.com/fotograf/2596112/48/Kitap_2026081716445425961122.jpg",
"seller": {
"id": 2596112,
"name": "49.Sayfa Kitabevi & Sahaf",
"url": "https://www.nadirkitap.com/49-sayfa-kitabevi-sahaf-sahaf2596112.html",
"success_rate_pct": 99,
"transactions": 454
},
"seller_id": 2596112,
"shipping_badges": [
"1500 TL ve üzerine ücretsiz kargo",
"HepsiJET ile anlaşmalı kargo 129 TL"
],
"seller_campaigns": []
}
]
}
}What the Nadirkitap API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Nadirkitap, Turkey's marketplace of ~1,100 second-hand and rare booksellers (sahaf): books, magazines and ephemera. Free text, or the site's advanced filters: title, author, publisher, translator, ISBN, language (incl. Ottoman Turkish), category, publication year range, binding, price range, new only, signed, first edition, fine binding, seller. Each row is ONE copy offered by one seller. Give `query` or at least one filter. | Pricing teams call search to search Nadirkitap, Turkey's marketplace of ~1,100 second-hand and rare booksellers (sahaf). | query, type, title, author, publisher, ... |
| listing | One Nadirkitap listing in full: title, author, translator, editor, publisher, year, place, language, pages, size, binding, ISBN, condition (stars + label), the seller's description, the price printed on the page (and the struck price when the seller runs a discount), stock, category path, images, shipping payer, carrier, dispatch estimate and shipping prices, and the seller: shop name, link, success rate and transaction count. | Marketplace operators call listing to get one Nadirkitap listing in full. | id, url, include_pii |
| offers | Every live copy of one edition across all sellers, by ISBN (or by a listing id, whose ISBN is read first): price, condition, stock and seller of each copy, plus the cheapest and dearest price and the number of distinct sellers on the page. Cheapest first by default. Give `isbn` or `id`. | Catalog enrichment teams call offers to get every live copy of one edition across all sellers, by ISBN (or by a listing id, whose ISBN is…. | isbn, id, sort, page, include_pii |
| seller | One sahaf (seller shop) as its page shows it: name, city, avatar, success rate, transaction count, badges (contract carrier, basket discount), how many books / ephemera it lists, the running campaign, carrier, dispatch estimate, shipping prices and its showcase listings. Its full stock is `search` with `seller_id`. | Retail analysts call seller to get one sahaf (seller shop) as its page shows it. | seller_id, seller_id, include_pii |
Call search from your stack
curl -X POST https://api.reefapi.com/nadirkitap/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"title":"tutunamayanlar","author":"Oğuz Atay","sort":"price_asc"}'import requests
r = requests.post(
"https://api.reefapi.com/nadirkitap/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"title": "tutunamayanlar",
"author": "Oğuz Atay",
"sort": "price_asc"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/nadirkitap/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"title": "tutunamayanlar",
"author": "Oğuz Atay",
"sort": "price_asc"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.nadirkitap.search with {"title":"tutunamayanlar","author":"Oğuz Atay","sort":"price_asc"}.Who uses this API and why
- Price a rare or out-of-print Turkish book: list every copy of the edition by ISBN and compare condition against price.
- Watch for first editions, signed copies or Ottoman Turkish books from a given author under a price you set.
- Build a used-book price index for Turkey by title, publisher and publication year.
- Source stock for a bookshop or library: find the booksellers with the deepest catalogue in a category and their shipping terms.
- Track old magazine runs and collectibles such as postcards, stamps and records in the ephemera categories.
Questions developers ask before integrating
Do I need a Nadirkitap account?
No. Everything is read logged out, and you call reefapi.com from anywhere.
How do I find every copy of one book?
Call offers with the ISBN, or with the id of any listing that shows one. You get each copy's price, condition, stock and seller, cheapest first, plus the lowest and highest price and how many different booksellers have it. 6 of 9 sampled book listings published an ISBN; for the rest search by title and author.
Can I search Ottoman Turkish books or first editions?
Yes. language=2 is Osmanlıca: "divan" went from 10,000 results to 875. first_edition=true narrowed Sait Faik from 5,271 copies to 233, signed=true to 4.
Are magazines and collectibles included?
Yes, with type=magazine or type=ephemera. Ephemera categories include stamps (247), postcards and photos (249), coins and medals (248), posters (252) and records (288).
How deep can I page?
Up to the 10,000th result of any search: 417 pages of 24 with filters, 358 pages of 28 for a plain query. Beyond that Nadirkitap shows nothing, so we stop and tell you the last page. Filters get you to the rest.
Is the price the price a buyer pays?
price_try is what the page charges for the copy. Shipping is extra and usually paid by the buyer: listing returns the bookseller's shipping price, for example 129 TL for one book and 139 TL for two or more.
Can I list everything one bookshop sells?
Yes. Every row carries seller_id. seller returns the shop page with its book and collectible counts (one shop: 9,870 books and 13 collectibles), and search with seller_id pages through its whole stock.
What happens with a sold copy?
Nadirkitap removes it. listing returns NOT_FOUND for a copy that is no longer for sale or never existed.
What is the Nadirkitap API?
Nadirkitap API is a ReefAPI endpoint group for turkey's second-hand and rare book marketplace: every copy with its price, condition, edition and the bookseller offering it. It returns live JSON through POST requests under /nadirkitap/v1.
Is the Nadirkitap API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Nadirkitap calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Nadirkitap login or account?
No login to Nadirkitap 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 Nadirkitap 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 Nadirkitap API use?
Nadirkitap actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Nadirkitap from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call nadirkitap actions with the same key, credit pool and JSON envelope used by normal REST requests.