Autocasion Spain API & Scraper
The Autocasion API searches native BMW and Audi vehicle result pages in Spain and retrieves meaningful detail for each returned canonical listing ID.
🤖 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.
Search includes used vehicles and source Km0 listings, matching totals, native paging and promoted flags. The id is the complete canonical vehicle URL returned by search; source_id separately preserves the numeric advertisement reference. Pass id unchanged to listing. Listing returns the same vehicle identity, native EUR cash amount, separately labeled financing price, published vehicle specifications, visible basic facts, equipment, primary photo and available public seller information. A seller can publish no narrative comment: description is then null while the vehicle detail remains meaningful. Only search and listing are released. Other brands, arbitrary text search, advanced filters, new-car catalog services, accounts, contact actions and exhaustive deep enumeration are excluded.
Preserve listing identity and cash-price context
Canonical IDs resolve directly, while different payment amounts remain separate.
| Field | Meaning | Limit |
|---|---|---|
| id + url | Complete canonical source vehicle URL | Pass id unchanged to listing; do not pass source_id alone |
| source_id | Numeric native advertisement reference | Retained for source identity checks and joins |
| price + currency + price_basis | Published cash asking amount in EUR, with cash basis | Not the financing amount, original new-car price or final invoice total |
| financed_price + price_details | Separate financing amount and published detail price labels | Financing conditions remain source-specific |
| vehicle + basic_details + equipment | Published vehicle metadata and visible facts | Missing auxiliary facts are not invented; visible facts remain available beside metadata |
| description | Published seller narrative when present | Null is valid when the seller publishes no comment |
| total + next_page + page_clamped | Matching count, native next window and clamp status | Promoted records may recur and native windows can vary in size |
A zero-result page can show recommendations; these are excluded from items. Published availability is not independent physical-stock verification.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/autocasion/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "bmw",
"page": 1
}
}{
"ok": true,
"meta": {
"api": "autocasion",
"endpoint": "search",
"mode": "live",
"latency_ms": 21866.4,
"record_count": 26,
"bytes": 965596,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "7b8a69fd1dcf4d8f",
"queue_ms": 1.2,
"fetched_at": "2026-10-14T18:57:38.087Z"
},
"data": {
"items": [
{
"id": "https://www.autocasion.com/coches-segunda-mano/bmw-ix-ocasion/ix-xdrive-40-ref21191902",
"source_id": "21191902",
"title": "BMW iX xDrive 40",
"url": "https://www.autocasion.com/coches-segunda-mano/bmw-ix-ocasion/ix-xdrive-40-ref21191902",
"price": 65995,
"currency": "EUR",
"price_basis": "cash",
"price_display": "Al contado 65.995 €",
"financed_price": null,
"financed_price_display": null,
"attributes": [
"2024",
"Eléctrico",
"11.018 km"
],
"photo": "https://images0.autocasion.com/unsafe/500x/filters:watermark(watermark.png,-30,-30,0):format(jpeg):quality(80)/api-car/1398483/138611154/03092026/ff7fabb7-e06e-4e61-8e58-748669c20e26.png",
"seller": {
"name": "BMW MOVILNORTE"
},
"promoted": false,
"listing_type": "used"
},
{
"id": "https://www.autocasion.com/coches-segunda-mano/bmw-x2-ocasion/x2-m35i-1-ref21327753",
"source_id": "21327753",
"title": "BMW X2 M35i",
"url": "https://www.autocasion.com/coches-segunda-mano/bmw-x2-ocasion/x2-m35i-1-ref21327753",
"price": 27790,
"currency": "EUR",
"price_basis": "cash",
"price_display": "Al contado 27.790 €",
"financed_price": 24490,
"financed_price_display": "Financiado 24.490 €",
"attributes": [
"2019",
"Gasolina",
"108.492 km"
],
"photo": "https://images0.autocasion.com/unsafe/500x/filters:watermark(watermark.png,-30,-30,0):format(jpeg):quality(80)/api-car/2038443/128563943/17092026/8352134b-efdd-4b44-b6c6-24aa9810d8a0.jpg",
"seller": {
"name": "MUY CAR SEVILLA"
},
"promoted": false,
"listing_type": "used"
},
{
"id": "https://www.autocasion.com/coches-segunda-mano/bmw-ix3-ocasion/285-80kwh-inspiring-16a0c74233e7db-ref20110192",
"source_id": "20110192",
"title": "BMW Ix3 285 80KWH INSPIRING",
"url": "https://www.autocasion.com/coches-segunda-mano/bmw-ix3-ocasion/285-80kwh-inspiring-16a0c74233e7db-ref20110192",
"price": 27850,
"currency": "EUR",
"price_basis": "cash",
"price_display": "Al contado 27.850 €",
"financed_price": 27850,
"financed_price_display": "Financiado 27.850 €",
"attributes": [
"2021",
"Eléctrico",
"108.711 km"
],
"photo": "https://images0.autocasion.com/unsafe/500x/filters:watermark(watermark.png,-30,-30,0):format(jpeg):quality(80)/api-car/1586537/102011/04102026/5e12419b-96ea-477c-a7f6-b89fc69f868b.jpg",
"seller": {
"name": "CSV MOTOR"
},
"promoted": false,
"listing_type": "used"
}
],
"total": 8597,
"page": 1,
"requested_page": 1,
"page_clamped": false,
"next_page": 2,
"last_page": 344,
"skipped_nonlisting_cards": 0
}
}What the Autocasion Spain API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search native Spanish brand result pages | Price-intelligence teams call search to search native Spanish brand result pages. | none |
| listing | Meaningful vehicle detail for canonical search ID | Classifieds aggregators call listing to get meaningful vehicle detail for canonical search ID. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/autocasion/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"bmw","page":1}'import requests
r = requests.post(
"https://api.reefapi.com/autocasion/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "bmw",
"page": 1
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/autocasion/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "bmw",
"page": 1
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.autocasion.search with {"query":"bmw","page":1}.Who uses this API and why
- Compare BMW and Audi cash asking amounts in Spain.
- Resolve canonical listing IDs to published vehicle specifications.
- Keep financing amounts separate in price comparison datasets.
- Inspect source Km0 and used vehicle facts without requiring seller comments.
- Follow shallow native pages using matching totals and promoted flags.
Questions developers ask before integrating
Which searches are supported?
The qualified native brand queries are bmw and audi. Other brands, arbitrary keywords and advanced filters are outside this release.
How do I retrieve a search result?
Pass the exact canonical URL returned in id to listing. source_id contains the separate numeric advertisement reference and is not a standalone lookup input.
Are Km0 vehicles supported?
Yes. Source Km0 advertisements returned in the native brand results resolve to meaningful vehicle detail, including when the seller publishes no narrative comment.
Which price should I compare?
price is the published cash asking amount in EUR. financed_price is separate. Original new-car prices and financing conditions do not replace the cash amount.
Can description be null?
Yes. No comment was published for a verified Km0 listing. Model, year, mileage, visible facts, equipment and cash-price information remain available.
Does paging preserve the source result window?
Yes. The API follows the native page and next_page. Window sizes can vary with promoted placements; exhaustive deep enumeration is not guaranteed.
What happens for empty or deleted listings?
A genuine zero result returns items[] and total zero, excluding recommendation cards. A missing source vehicle returns NOT_FOUND; access and transport failures remain explicit errors.
Which optional features are excluded?
GTIN, complete photo galleries and auxiliary fill, other brands, advanced filters, seller inventory, account services, transactions and new-car catalog actions are excluded.
What is the Autocasion Spain API?
Autocasion Spain API is a ReefAPI endpoint group for spanish bmw and audi listings with native eur cash prices, separate financing amounts and meaningful vehicle details. It returns live JSON through POST requests under /autocasion/v1.
Is the Autocasion Spain API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Autocasion Spain calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Autocasion Spain login or account?
No login to Autocasion Spain 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 Autocasion Spain 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 Autocasion Spain API use?
Autocasion Spain actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Autocasion Spain from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call autocasion actions with the same key, credit pool and JSON envelope used by normal REST requests.