Carvak API & Scraper
The Carvak API returns the used cars that Carvak (carvak.com, formerly Araba Sepeti / garajsepeti, run by Kavak) sells from its own stock in Turkey as clean JSON in three actions.
🤖 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.
Carvak is not a classifieds site: every car is bought, inspected and sold by Carvak itself from its branches in İstanbul (Vialand AVM) and Adana, so every listing has the same structure and the same seller. search filters by make, model, free text, city, fuel, gearbox, body type, colour, driven wheels, availability, price, model year and mileage, in Carvak's seven sort orders (newest listing, cheapest, most expensive, newest or oldest model year, lowest or highest mileage). Every response carries Carvak's own total for the query and 30 cars a page, each with the stock id, title, make, model, trim, model year, the price the card prints in Turkish lira, the pre-discount price and discount on cars that are on sale, mileage, gearbox, colour, city, whether another buyer has reserved the car, and its photo. detail opens one car in full: fuel, body type, driven wheels, horsepower, engine size, generation, doors, interior colour, seats, rims and sunroof, the paint report panel by panel - which of 25 body parts are original, painted, locally painted or replaced - the insurance damage records with date, type and repair amount, close-up photos of small cosmetic marks, every photo, Carvak's own description of the car, the branch with address and map coordinates, and similar cars. makes lists the makes in stock with their model slugs. On 2026-10-07 the price matched the card's own printed price on 120 of 120 cars, and 26 of 26 cars opened in detail matched their search row on id, price, pre-discount price, mileage, year and status. One ReefAPI key, the standard { ok, data, meta, error } envelope.
The price and condition fields Carvak publishes on each car
A Carvak car carries up to two prices and a full condition report. The API returns each under its own name; the examples are cars measured on 2026-10-07.
| Field | What it is | Example |
|---|---|---|
| price_try | The price the card and the car's page print big; the sale price when the car is discounted | 2,498,000 TRY (2024 Hyundai Tucson) |
| price_before_discount_try / discount_try | The struck-through price and the difference, on discounted cars only | 1,019,000 → 989,000 TRY, discount 30,000 (4 of 120 cars on sale) |
| status / reserved | available, or reserved when another buyer holds the car | 8 of 120 cars reserved |
| expertise.summary | Body parts checked and how many are original, painted, locally painted or replaced | 25 checked on 26 of 26 cars opened |
| expertise.damage_records | Insurance damage records: date, type and repair amount | 2023-04-20, collision, 22,078 TRY |
| drive / power_hp / engine_litres | Driven wheels, horsepower and engine size | 4x4, 230 hp, 1.6 l |
| seller | The Carvak branch holding the car, with address and map coordinates | Carvak Vialand AVM, Eyüpsultan/İstanbul |
Carvak's price filter and price sort work on the pre-discount price. A car listed at 1,019,000 TRY and on sale for 989,000 TRY is returned by price_min 1,000,000 and sorts as 1,019,000; price_try always carries the price the buyer pays.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/carvak/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"make": "toyota",
"sort": "price_asc"
}
}{
"ok": true,
"meta": {
"api": "carvak",
"endpoint": "search",
"mode": "live",
"latency_ms": 1002.6,
"record_count": 10,
"bytes": 38370,
"cache_hit": false,
"stop_reason": "complete",
"charged_credits": 2,
"version": "1.0.0",
"request_id": "2310f2390d8042d1",
"queue_ms": 3.5,
"fetched_at": "2026-10-07T15:52:08.307Z"
},
"data": {
"rows": [
{
"id": "519962",
"url": "https://carvak.com/tr/ikinci-el/toyota-auris-133_life-hatchback-2016?id=519962",
"title": "Toyota Auris 1.33 Life",
"make": "Toyota",
"model": "Auris",
"trim": "1.33 Life",
"year": 2016,
"price_try": 909000,
"price_before_discount_try": null,
"discount_try": null,
"on_sale": false,
"price_as_printed_try": 909000,
"price_mismatch": false,
"mileage_km": 88513,
"transmission": "Manuel",
"color": "Beyaz",
"city": "İstanbul",
"city_as_published": "İSTANBUL",
"status": "available",
"reserved": false,
"badges": [],
"seller": {
"name": "Carvak",
"type": "managed_stock"
},
"photo_url": "https://images.kavak.services/images/519962/EXTERIOR-frontSidePilotNear-1782471459874.jpeg"
},
{
"id": "512364",
"url": "https://carvak.com/tr/ikinci-el/toyota-c_hr-12_turbo_diamond-crossover-2018?id=512364",
"title": "Toyota C-HR 1.2 Turbo Diamond",
"make": "Toyota",
"model": "C-HR",
"trim": "1.2 Turbo Diamond",
"year": 2018,
"price_try": 1399000,
"price_before_discount_try": null,
"discount_try": null,
"on_sale": false,
"price_as_printed_try": 1399000,
"price_mismatch": false,
"mileage_km": 110736,
"transmission": "Otomatik",
"color": "Gri",
"city": "İstanbul",
"city_as_published": "İSTANBUL",
"status": "available",
"reserved": false,
"badges": [],
"seller": {
"name": "Carvak",
"type": "managed_stock"
},
"photo_url": "https://images.kavak.services/images/512364/EXTERIOR-frontSidePilotNear-1779719593644.jpeg"
},
{
"id": "541115",
"url": "https://carvak.com/tr/ikinci-el/toyota-corolla-15_dream-sedan-2024?id=541115",
"title": "Toyota Corolla 1.5 Dream",
"make": "Toyota",
"model": "Corolla",
"trim": "1.5 Dream",
"year": 2024,
"price_try": 1578000,
"price_before_discount_try": null,
"discount_try": null,
"on_sale": false,
"price_as_printed_try": 1578000,
"price_mismatch": false,
"mileage_km": 47825,
"transmission": "Otomatik",
"color": "Gri",
"city": "İstanbul",
"city_as_published": "İSTANBUL",
"status": "available",
"reserved": false,
"badges": [],
"seller": {
"name": "Carvak",
"type": "managed_stock"
},
"photo_url": "https://img.carvak.co/image/upload/uploads/541115-EXTERIOR-frontSidePilotNear-1790414492182.jpg"
}
],
"summary": {
"total_results": 10,
"page": 1,
"rows_per_page": 30,
"last_page": 1,
"has_more": false,
"past_last_page": false,
"reserved_on_page": 0,
"filters_applied": {
"make": [
"toyota"
],
"sort": "price_asc"
}
}
}
}What the Carvak API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search the used cars Carvak (formerly Araba Sepeti / garajsepeti) sells from its own stock in Turkey (İstanbul and Adana branches) by make, model, free text, city, fuel, gearbox, body type, colour, driven wheels, availability, price, model year and mileage, in Carvak's seven sort orders. Returns the source's own total, 30 cars per page with the price the card prints (and the pre-discount price on discounted cars), mileage, city, reservation status and photo. All parameters are optional: no parameter = the whole stock (119 cars on 2026-10-07). | Price-intelligence teams call search to search the used cars Carvak (formerly Araba Sepeti / garajsepeti) sells from its own stock in…. | make, model, query, city, fuel, ... |
| detail | One Carvak car by its `id` (from a search row) or URL: price (with the pre-discount price and the schema.org price as second witness), mileage, fuel, gearbox, body, driven wheels, power, engine size, generation, doors, colours and equipment (rims, seats, sunroof, mirrors), the expertise report (25 body panels: original, painted, locally painted or replaced), the insurance damage records with date, type and repair amount, cosmetic-detail photos, all photos, Carvak's own description, the branch with address and coordinates, and similar cars. | Classifieds aggregators call detail to get one Carvak car by its `id` (from a search row) or URL. | id, url |
| makes | The makes Carvak has in stock right now with each make's model slugs (the values `search` takes as `make` and `model`), the cities and branches, the model years, and the fuel, gearbox, body, colour, drive, status and sort vocabularies. | Resale and arbitrage tools call makes to get the makes Carvak has in stock right now with each make's model slugs (the values `search` tak…. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/carvak/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"make":"toyota","sort":"price_asc"}'import requests
r = requests.post(
"https://api.reefapi.com/carvak/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"make": "toyota",
"sort": "price_asc"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/carvak/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"make": "toyota",
"sort": "price_asc"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.carvak.search with {"make":"toyota","sort":"price_asc"}.Who uses this API and why
- Used-car dealers in Turkey price their stock against an inspected, fixed-price retailer's live prices by make, model, year and mileage.
- Insurers and valuation tools pull the 25-panel paint and replaced-part report together with the insurance damage records and their repair amounts.
- Market analysts track how much stock Carvak holds per make, city and fuel type, which cars go on sale and by how much.
- Buyer apps show a car's paint report, damage history, horsepower and the branch's address and map location next to the price.
- Lead and pricing teams that already read otoplus merge both inspected-stock retailers, since the two APIs share field names.
Questions developers ask before integrating
What does the Carvak API cover?
The used cars Carvak sells from its own stock in Turkey: 119 to 120 cars on 2026-10-07 across 22 makes, 114 at the İstanbul branch (Vialand AVM) and 6 in Adana. Carvak is the Turkish brand of Kavak and was previously called Araba Sepeti (garajsepeti.com). The stock is small and moves within the hour.
Who is the seller?
Carvak itself on every car; there are no private sellers or third-party dealers. detail names the Carvak branch that holds the car with its address and map coordinates (26 of 26 cars opened).
Does it return the paint and damage report?
Yes, on detail. All 26 cars opened on 2026-10-07 carried 25 body parts, each marked original, painted, locally painted or replaced, with a summary count; 12 of them had at least one part that was not original. 9 of the 26 also carried insurance damage records with date, type and repair amount, and most carry close-up photos of small cosmetic marks.
Which price do I get on a discounted car?
price_try is the price the card prints, which on a discounted car is the sale price; price_before_discount_try and discount_try carry the struck-through price and the difference, and on_sale flags the car. 4 of 120 cars were on sale on 2026-10-07. Note that Carvak's own price filter and price sort use the pre-discount price.
Do the filters really filter?
Each was compared with an unfiltered search in the same run (120 cars): Hyundai 6, Hyundai Tucson 3, BMW X1 3, query bmw 11, Adana 6, diesel 28, hybrid or electric 31, manual 8, SUV 52, sedan 26, white 25, 4x4 10, reserved 8, 1,000,000 to 1,500,000 TRY 32, model year 2022 to 2024 56, up to 50,000 km 52, from 100,000 km 22, and inside Toyota (10): hybrid 4, SUV 2. Every row checked matched its filter, in two runs. Values Carvak would silently ignore are refused instead.
How many results can one search return?
30 cars a page, with Carvak's own total, last_page and has_more; the whole stock of 120 cars fits in 4 pages. A page past the last one comes back empty instead of repeating a page.
How do I open one car in full?
Take id from a search row (for example 541164) and call detail with it, or pass the car's carvak.com URL. A car that is no longer on sale returns NOT_FOUND.
What does Carvak not publish?
VIN, number plate, owner count, service history, inspection (muayene) date and a per-car warranty end date are not on these pages; Carvak describes one standard warranty for all its cars. Search rows carry no fuel, body type or drive; those are on detail. Carvak's yes/no equipment list (ABS, airbags, Bluetooth and so on) reads the same for nearly every car, so it is not returned; interior colour, seats, rims, sunroof and mirrors are.
What is the Carvak API?
Carvak API is a ReefAPI endpoint group for carvak's inspected used cars in turkey as json: price and discount, mileage, the 25-panel paint report and insurance damage records. It returns live JSON through POST requests under /carvak/v1.
Is the Carvak API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Carvak calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Carvak login or account?
No login to Carvak 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 Carvak 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 Carvak API use?
Carvak actions currently cost 2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Carvak from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call carvak actions with the same key, credit pool and JSON envelope used by normal REST requests.