otoplus API & Scraper
The otoplus API returns the used cars that otoplus 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.
otoplus is not a classifieds site: every car is bought, inspected and parked by otoplus itself at its sales centres in İstanbul, Ankara and İzmir, so every listing has the same structure and the same seller. search filters by make, model, free text, city, fuel, gearbox, body type, campaign, price, model year and mileage, in otoplus's own sort orders (recommended, cheapest first, most expensive first, longest listed). Every response carries otoplus's own total for the query and 12 cars a page, each with the vehicle id, title, make, model, trim, model year, asking price in Turkish lira, the site's 'Size Özel' special price where it is shown, the 'Kredi Fırsatı' credit offer with amount, term and monthly interest, mileage, fuel, gearbox, body type, colour, city, VIN, the sales centre that holds the car and every photo, plus the make counts for the whole result. detail opens one car in full: plate number, VIN, TSB code, otoplus warranty with its end date, inspection (muayene) validity, motor vehicle tax instalments, spare-key and LPG flags, the consultancy fee the buyer pays, credit limits and terms, the equipment list, and the expertise report panel by panel - which of the 13 body panels are original, painted or replaced - with the mechanical checks. makes lists the makes in stock with live counts. On 2026-10-07 the asking price matched the price on the site's own schema.org data and in the vehicle's own URL on 139 of 139 cars (138 of 138 in a second run), and 8 of 8 cars opened in detail matched their search row on id, price, mileage, year, make and VIN. One ReefAPI key, the standard { ok, data, meta, error } envelope.
The price and condition fields otoplus publishes on each car
An otoplus listing carries several money figures and a full expertise report. The API returns each under its own name; the examples are two cars measured on 2026-10-07.
| Field | What it is | Example |
|---|---|---|
| price_try | Asking price shown on the card and the vehicle page | 2,040,000 TRY (2025 Skoda Octavia) |
| special_price_try | The site's 'Size Özel' price, where otoplus shows one | Present on 72 of 139 cars |
| credit_offer | The 'Kredi Fırsatı' block: amount, term, monthly interest and the site's own text | 329,000 TRY, 11 months, 0.99 % |
| consultancy_fee_try | Consultancy fee the page says the buyer pays | 7,500 TRY |
| motor_vehicle_tax_try | Current and next motor vehicle tax (MTV) instalment | 647 / 647 TRY |
| expertise.summary | Body panels checked, and how many are original, painted or replaced | 13 checked: 11 original, 2 painted, 0 replaced |
| plate_number / vin | Number plate and 17-character VIN | plate as printed / 17-character VIN |
otoplus gives a valid 17-character VIN for 112 of 139 cars. For the rest its VIN field holds an internal code or a mistyped value (for example the letter O typed for a zero); vin is then null and the source's own string is kept in vin_as_published, so nobody keys a database on a value that is not a VIN.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/otoplus/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"make": "peugeot",
"sort": "price_asc"
}
}{
"ok": true,
"meta": {
"api": "otoplus",
"endpoint": "search",
"mode": "live",
"latency_ms": 1120.4,
"record_count": 12,
"bytes": 266550,
"cache_hit": false,
"stop_reason": "complete",
"charged_credits": 3,
"version": "1.0.0",
"request_id": "b1d8e7df0ef14162",
"queue_ms": 2.9,
"fetched_at": "2026-10-07T15:52:10.803Z"
},
"data": {
"rows": [
{
"id": 571433,
"url": "https://www.otoplus.com/peugeot/partner/partner-tepee-active-1.6-hdi-92/sahibinden-2016-manuel-dizel-104119km-ekspertizli-Ankara-895000tl-571433",
"title": "2016 Peugeot PARTNER TEPEE ACTIVE 1.6 HDI 92",
"make": "Peugeot",
"model": "PARTNER",
"trim": "PARTNER TEPEE ACTIVE 1.6 HDI 92",
"year": 2016,
"price_try": 895000,
"ld_price_try": 895000,
"price_mismatch": false,
"special_price_try": null,
"credit_offer": {
"amount_try": 242000,
"months": 11,
"monthly_interest_pct": 0.99,
"text": "242.000 TL, 11 Ay, %0.99 Faiz"
},
"mileage_km": 104119,
"fuel": "Dizel",
"transmission": "Manuel",
"body_type": "Kombi",
"body_type_id": 24,
"color": "Gri",
"city": "Ankara",
"status": "available",
"reserved": false,
"vin": "VF37N9HP0GJ553980",
"vin_as_published": "VF37N9HP0GJ553980",
"seller": {
"name": "otoplus",
"type": "managed_stock",
"location": "Otoplus - Nata Vega Ankara",
"address": "Akşemsettin, 2308 Cadde 1/a, 06480 -3.Kat Mamak/Ankara"
},
"photo_count": 12,
"photo_url": "https://cdn.otoplus.com/img/u/v/e4/79/db/arac-248366-e479dbcf-e197-4d0c-bec8-6643022dcd36_1280x720.jpg",
"photos": [
"https://cdn.otoplus.com/img/u/v/e4/79/db/arac-248366-e479dbcf-e197-4d0c-bec8-6643022dcd36_1280x720.jpg",
"https://cdn.otoplus.com/img/u/v/b3/da/aa/arac-248366-b3daaa2d-3bb0-43d3-a0bc-234f88b8a8e2_1280x720.jpg",
"https://cdn.otoplus.com/img/u/v/af/e3/d2/arac-248366-afe3d259-a5b1-428e-af23-2fd793106c57_1280x720.jpg"
]
},
{
"id": 574333,
"url": "https://www.otoplus.com/peugeot/rifter/rifter-gt-1.5-bluehdi-130-eat8/sahibinden-2021-otomatik-dizel-178338km-ekspertizli-%C4%B0stanbul-1175000tl-574333",
"title": "2021 Peugeot RIFTER GT 1.5 BLUEHDI 130 EAT8",
"make": "Peugeot",
"model": "RIFTER",
"trim": "RIFTER GT 1.5 BLUEHDI 130 EAT8",
"year": 2021,
"price_try": 1175000,
"ld_price_try": 1175000,
"price_mismatch": false,
"special_price_try": null,
"credit_offer": {
"amount_try": 246000,
"months": 11,
"monthly_interest_pct": 0.99,
"text": "246.000 TL, 11 Ay, %0.99 Faiz"
},
"mileage_km": 178338,
"fuel": "Dizel",
"transmission": "Otomatik",
"body_type": "Kombi",
"body_type_id": 24,
"color": "Turuncu",
"city": "İstanbul",
"status": "available",
"reserved": false,
"vin": "VR3EFYHZRMJ925982",
"vin_as_published": "vr3efyhzrmj925982",
"seller": {
"name": "otoplus",
"type": "managed_stock",
"location": "Otoplus - Vega AVM İstanbul",
"address": "Yunus Emre, Lütfi Aykaç Blv. No.81, -1. Kat 34260 Sultangazi/İstanbul"
},
"photo_count": 12,
"photo_url": "https://cdn.otoplus.com/img/u/v/3f/70/47/arac-249450-3f7047cf-2e3e-43aa-a8a3-73f330b5fd7d_1280x720.jpg",
"photos": [
"https://cdn.otoplus.com/img/u/v/3f/70/47/arac-249450-3f7047cf-2e3e-43aa-a8a3-73f330b5fd7d_1280x720.jpg",
"https://cdn.otoplus.com/img/u/v/fb/bb/b1/arac-249450-fbbbb161-af93-46d1-82c8-2e1e21f2094f_1280x720.jpg",
"https://cdn.otoplus.com/img/u/v/c0/c6/dc/arac-249450-c0c6dc7c-80c5-40f9-a173-47e5fa3cca9e_1280x720.jpg"
]
},
{
"id": 574565,
"url": "https://www.otoplus.com/peugeot/rifter/rifter-allure-1.5-bluehdi-130-6mt-e6.3/sahibinden-2023-manuel-dizel-43625km-ekspertizli-%C4%B0stanbul-1225000tl-574565",
"title": "2023 Peugeot RIFTER ALLURE 1.5 BLUEHDI 130 6MT E6.3",
"make": "Peugeot",
"model": "RIFTER",
"trim": "RIFTER ALLURE 1.5 BLUEHDI 130 6MT E6.3",
"year": 2023,
"price_try": 1225000,
"ld_price_try": 1225000,
"price_mismatch": false,
"special_price_try": null,
"credit_offer": {
"amount_try": 252000,
"months": 11,
"monthly_interest_pct": 0.99,
"text": "252.000 TL, 11 Ay, %0.99 Faiz"
},
"mileage_km": 43625,
"fuel": "Dizel",
"transmission": "Manuel",
"body_type": "Kombi",
"body_type_id": 24,
"color": "Gri (Metalik)",
"city": "İstanbul",
"status": "available",
"reserved": false,
"vin": "VR3EFYHP2PJ846450",
"vin_as_published": "VR3EFYHP2PJ846450",
"seller": {
"name": "otoplus",
"type": "managed_stock",
"location": "Otoplus - Vega AVM İstanbul",
"address": "Yunus Emre, Lütfi Aykaç Blv. No.81, -1. Kat 34260 Sultangazi/İstanbul"
},
"photo_count": 12,
"photo_url": "https://cdn.otoplus.com/img/u/v/69/42/9c/arac-249548-69429c40-18ae-4fd7-a1b2-5e4a50482367_1280x720.jpg",
"photos": [
"https://cdn.otoplus.com/img/u/v/69/42/9c/arac-249548-69429c40-18ae-4fd7-a1b2-5e4a50482367_1280x720.jpg",
"https://cdn.otoplus.com/img/u/v/3c/54/6b/arac-249548-3c546bab-b198-45d1-952e-1d6a10fbda37_1280x720.jpg",
"https://cdn.otoplus.com/img/u/v/e8/69/27/arac-249548-e8692757-64a9-490f-bfe9-ff8b15d5c5d2_1280x720.jpg"
]
}
],
"summary": {
"total_results": 19,
"page": 1,
"rows_per_page": 12,
"last_page": 2,
"has_more": true,
"past_last_page": false,
"reserved_on_page": 0,
"filters_applied": {
"make": "peugeot",
"sort": "price_asc"
},
"make_facets": [
{
"slug": "chery",
"name": "Chery",
"count": 5
},
{
"slug": "citroen",
"name": "Citroen",
"count": 3
},
{
"slug": "cupra",
"name": "Cupra",
"count": 2
}
]
}
}
}What the otoplus API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search the used cars otoplus sells from its own stock in Turkey (İstanbul, Ankara, İzmir) by make, model, free text, city, fuel, gearbox, body type, campaign, price, model year and mileage, in otoplus's five sort orders. Returns the source's own total, 12 cars per page with asking price, special price and credit offer, mileage, VIN, sales centre and photos, plus the make facets with live counts. All parameters are optional: no parameter = the whole stock (140 cars on 2026-10-07). | Price-intelligence teams call search to search the used cars otoplus sells from its own stock in Turkey (İstanbul, Ankara, İzmir) by…. | make, model, query, city, fuel, ... |
| detail | One otoplus car by its `id` (from a search row) or URL: asking price with its schema.org second witness, special price, credit offer and loan limits, consultancy fee, plate number, VIN, TSB code, warranty and its end date, inspection (muayene) validity, motor-vehicle-tax instalments, spare key / LPG flags, the full expertise report (13 body panels: original, painted or replaced, plus mechanical checks), equipment list, all photos, the sales centre with address and phone, and similar cars. | Classifieds aggregators call detail to get one otoplus car by its `id` (from a search row) or URL. | id, url |
| makes | The makes otoplus has in stock right now with live car counts (the slugs `search` takes as `make`), plus the cities, body types, fuels, gearboxes and campaigns the site filters by. | Resale and arbitrage tools call makes to get the makes otoplus has in stock right now with live car counts (the slugs `search` takes as `m…. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/otoplus/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"make":"peugeot","sort":"price_asc"}'import requests
r = requests.post(
"https://api.reefapi.com/otoplus/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"make": "peugeot",
"sort": "price_asc"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/otoplus/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"make": "peugeot",
"sort": "price_asc"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.otoplus.search with {"make":"peugeot","sort":"price_asc"}.Who uses this API and why
- Used-car dealers in Turkey price their own stock against an inspected, fixed-price retailer's live asking prices by make, model, year and mileage.
- Car-loan and leasing teams read the credit offer, credit limit and instalment options otoplus quotes for each car.
- Insurers and valuation tools pull the panel-by-panel expertise report - original, painted or replaced - together with plate number and VIN.
- Market analysts track how many cars otoplus holds per make, city and fuel type, and how its asking prices move over time.
- Buyer apps show a car's warranty end date, inspection validity, motor vehicle tax and the sales centre's address and phone next to the price.
Questions developers ask before integrating
What does the otoplus API cover?
The used cars otoplus sells from its own stock in Turkey, held at its sales centres in İstanbul, Ankara and İzmir. On 2026-10-07 that was 138 to 140 cars across 21 makes (İstanbul 57, Ankara 45, İzmir 38). The stock is small and moves: the count went from 140 to 139 to 138 within half an hour.
Who is the seller?
otoplus itself on every car. There are no private sellers or third-party dealers. Each car names the otoplus sales centre that holds it with its address; detail adds the centre's phone number.
Does it return the expertise report?
Yes, on detail. All 8 cars opened on 2026-10-07 carried 13 body panels, each marked original, painted or replaced with otoplus's Turkish label, plus a summary count; some cars also carry mechanical checks such as oil or water leaks. Of those 8 cars, 6 had at least one painted panel and none had a replaced panel.
Are reserved or sold cars included?
Sold cars disappear from otoplus and its sitemap, and opening a sold car's id returns NOT_FOUND. Every row carries status and reserved for cars on hold; none of the 139 cars was reserved on 2026-10-07.
Do the filters really filter?
Each was compared with an unfiltered search in the same run (139 cars): make peugeot 23, peugeot 3008 9, İstanbul 57, diesel 34, hybrid 16, manual 14, SUV 65, sedan 27, kombi 15, credit campaign 102, from 2,000,000 TRY 23, up to 1,200,000 TRY 22, model year 2024 or newer 63, up to 30,000 km 45, query clio 5, and inside Renault (16): İzmir 5, hybrid 1. Every returned row matched its filter. Values otoplus would silently ignore are refused instead.
How many results can one search return?
12 cars a page, with otoplus's own total, last_page and has_more. A page past the last one comes back empty instead of repeating the last page.
How do I open one car in full?
Take id from a search row (for example 575530) and call detail with it, or pass the car's otoplus URL. A car that is no longer on sale returns NOT_FOUND.
What does otoplus not publish?
Accident or insurance-claim history, service records and the number of previous owners are not on these pages. Engine power, fuel consumption and dimensions are filled in otoplus's own data on only 1 of 9 cars checked, so on most cars those specs fields come back null; segment and engine displacement were present on 9 of 9. otoplus has no model-year or mileage sort.
What is the otoplus API?
otoplus API is a ReefAPI endpoint group for turkey's inspected used cars from otoplus as json: price, credit offer, plate, vin, warranty and the full panel-by-panel expertise report. It returns live JSON through POST requests under /otoplus/v1.
Is the otoplus API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. otoplus calls use the same shared credit balance as every other ReefAPI engine.
Do I need an otoplus login or account?
No login to otoplus 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 otoplus 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 otoplus API use?
otoplus 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 otoplus from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call otoplus actions with the same key, credit pool and JSON envelope used by normal REST requests.