auto24 APIeng.auto24.lv ↗
Search and retrieve vehicle listings from auto24.lv, Latvia's largest car classifieds. Filter by make, year, price, fuel type, and get full specs via 2 endpoints.
What is the auto24 API?
The auto24.lv API gives programmatic access to Latvia's largest vehicle classifieds platform via 2 endpoints. Use search_vehicles to query thousands of listings with filters for make, year, price range, and fuel type, returning up to 50 results per page with pagination metadata. Use get_vehicle_details to pull full specifications — engine, mileage, drivetrain, equipment list, and image URLs — for any individual listing by its numeric ID.
curl -X GET 'https://api.parse.bot/scraper/dbe7f8c9-b1f4-4974-87e0-c2a94834d40e/search_vehicles?sort=newest' \ -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 eng-auto24-lv-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.
"""Walkthrough: Auto24.lv SDK — browse Latvian vehicle listings, drill into details."""
from parse_apis.eng_auto24_lv_api import Auto24, SortOrder, VehicleNotFound
client = Auto24()
# Search for recent diesel vehicles under €10,000, cap at 5 results.
for vehicle in client.vehicle_summaries.search(
sort=SortOrder.NEWEST, fuel="2", price_to="10000", limit=5
):
print(vehicle.title, vehicle.year, vehicle.price)
# Drill into the first matching SUV listing for full details.
hit = client.vehicle_summaries.search(vehicle_type="102", limit=1).first()
if hit is not None:
detail = hit.details()
print(detail.title, detail.price, detail.mileage)
print("Equipment:", ", ".join(detail.equipment[:5]))
print("Images:", len(detail.images))
# Point lookup by a known ID discovered from search results.
if hit is not None:
try:
full = client.vehicles.get(vehicle_id=hit.id)
print(full.title, full.transmission, full.fuel)
except VehicleNotFound:
print("Listing no longer available")
print("exercised: vehicle_summaries.search / details / vehicles.get")
Search and list vehicles for sale on auto24.lv with optional filters and pagination. Returns 50 vehicles per page sorted by the chosen order. Promoted ads may appear at the top regardless of sort order. The total count and page count reflect the filtered result set.
| Param | Type | Description |
|---|---|---|
| fuel | string | Fuel type code. Values observed: 1=petrol, 2=diesel, 3=LPG, 5=electric, 6=hybrid. Passed to the upstream filter. |
| make | string | Numeric make ID to filter by brand. Examples: 4 (BMW), 2 (Audi), 7 (Ford), 14 (Fiat), 34 (Hyundai). Obtain IDs from the site's make dropdown or from returned vehicle data. |
| page | integer | Page number (1-indexed). Each page returns up to 50 vehicles. |
| sort | string | Sort order for results. Omitting defaults to newest first. |
| year_to | string | Maximum year filter (e.g. 2023). |
| price_to | string | Maximum price in EUR (e.g. 20000). |
| year_from | string | Minimum year filter (e.g. 2015). |
| price_from | string | Minimum price in EUR (e.g. 5000). |
| transmission | string | Transmission type code. Values observed: 1=manual, 2=automatic. Passed to the upstream filter. |
| vehicle_type | string | Vehicle type code. 100=all types, 101=passenger car, 102=SUV, 103=commercial vehicle, 104=bus, 107=truck, 108=trailer, 109=mototechnics, 110=water vehicle, 113=caravan and autocaravan, 120=racing vehicle, 111=special technics. Omitting defaults to all types (100). |
{
"type": "object",
"fields": {
"page": "current page number",
"total": "total number of matching vehicles",
"per_page": "vehicles per page (always 50)",
"vehicles": "array of vehicle summary objects",
"total_pages": "total number of pages"
},
"sample": {
"data": {
"page": 1,
"total": 21890,
"per_page": 50,
"vehicles": [
{
"id": "4342663",
"url": "https://eng.auto24.lv/vehicles/4342663",
"fuel": "Diesel",
"make": "Opel",
"year": "2005",
"drive": "Front-wheel drive",
"model": "Corsa",
"price": "€900",
"title": "Opel Corsa 1.3 51kW",
"engine": "1.3 51kW",
"mileage": "246 371 km",
"bodytype": "Hatchback",
"model_trim": "C",
"transmission": "Manual",
"thumbnail_url": "https://img13.img-bcg.eu/h32/6695ca/s7/v2/206512784.jpg"
}
],
"total_pages": 438
},
"status": "success"
}
}About the auto24 API
Search Vehicles
The search_vehicles endpoint accepts optional filters including make (numeric brand ID, e.g. 4 for BMW or 2 for Audi), fuel (e.g. 1 for petrol, 5 for electric), price_from/price_to in EUR, and year_from/year_to. Results are paginated at 50 vehicles per page; the response includes total, total_pages, and page fields so you can walk through full result sets. Promoted listings may appear at the top regardless of the sort parameter you pass.
Vehicle Details
The get_vehicle_details endpoint accepts a vehicle_id obtained from search_vehicles results and returns a detailed record including title, price (EUR), fuel, engine, drive (drivetrain type), color, type, images (array of full-size image URLs), and a direct url back to the listing on auto24.lv. Equipment lists and free-text descriptions are returned when present on the listing.
Coverage and Limitations
Make IDs are numeric and must be known in advance; the API does not expose a dedicated endpoint for fetching the full make-to-ID mapping. Fuel type codes follow a fixed set (1=petrol, 2=diesel, 3=LPG, 5=electric, 6=hybrid). All prices are denominated in EUR. The platform is Latvia-focused, so inventory reflects the Latvian used-car market.
The auto24 API is a managed, monitored endpoint for eng.auto24.lv — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when eng.auto24.lv 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 eng.auto24.lv 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?+
- Build a Latvia used-car price tracker by querying
search_vehicleswithmake,year_from, andyear_tofilters and recordingpriceover time. - Aggregate electric vehicle availability in Latvia by filtering
search_vehicleswithfuel=5and paginating through all results. - Populate a vehicle comparison tool by fetching
get_vehicle_detailsfor multiple listing IDs and displaying engine, drivetrain, and equipment side-by-side. - Alert system for new listings: poll
search_vehiclessorted by newest and flag listing IDs not seen in previous runs. - Market research dashboard showing average asking prices per make segment using
priceandtitlefields from bulk search results. - Image gallery scraper for auto listings: extract the
imagesarray fromget_vehicle_detailsfor any vehicle ID.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does auto24.lv have an official public developer API?+
How do I filter search results by car brand?+
make ID to the search_vehicles endpoint. For example, make=4 returns BMW listings and make=2 returns Audi listings. The API does not currently include an endpoint that returns the complete make-ID mapping, so you need to reference known IDs. You can fork the API on Parse and revise it to add a make-lookup endpoint.What vehicle detail fields does `get_vehicle_details` return beyond what the search results include?+
engine specification, drive (drivetrain), color, images (array of full-size image URLs), equipment list, and a free-text description when available on the listing. The search results object carries lighter summary data — the detail call is needed for the full specification set.Are motorcycle or commercial vehicle listings covered?+
type field in get_vehicle_details does reflect the vehicle category when returned. You can fork the API on Parse and revise it to add type-specific filtering or dedicated endpoints for other vehicle categories.Can I retrieve seller contact details or phone numbers through the API?+
price, title, images, and specifications, plus a url to the live listing. You can fork the API on Parse and revise it to add a contact-detail endpoint if that data is publicly accessible on the listing page.