automobile APIautomobile.tn ↗
Search Tunisia's new-car market via the automobile.tn API. Get model listings, trim versions with TND prices, and full technical specs in structured JSON.
What is the automobile API?
The automobile.tn API provides 3 endpoints that cover Tunisia's new-car catalogue: search models with filters for brand, fuel type, drivetrain, and gearbox; list every trim (version) for a given model with prices in Tunisian dinars; and retrieve a trim's complete technical sheet via get_version_specs. All prices are returned in TND and data is scoped to new vehicles sold through automobile.tn.
curl -X GET 'https://api.parse.bot/scraper/7ea0d41b-bedc-4b4f-9173-812440986f3f/search_models?sort=price' \ -H 'X-API-Key: $PARSE_API_KEY'
Searches the new-car catalogue and returns one row per model (a brand + model line, e.g. one shape: 'Skoda Kamiq') with its starting price in Tunisian dinars, promo information and the slugs needed for get_model_versions / get_version_specs. Results come in pages of 24; `page` selects the page (omitted = 1), `total_count` and `total_pages` describe the whole filtered result space and `has_more` tells whether a next page exists; a page past the end returns an empty `models` list. Filters (brand, model, keyword, price range, energy, body type, gearbox, drive) all narrow the result set upstream; multi-valued filters are comma-separated. `version_slug` is filled only when the site links the model card straight to its single trim; otherwise call get_model_versions to list trims. Costs two upstream requests per call.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based result page (24 models per page). |
| sort | string | Result ordering. |
| brand | string | Comma-separated brand slugs as emitted in models[*].brand_slug (e.g. skoda,bmw). Lowercase letters, digits and hyphens. |
| drive | string | Comma-separated drivetrain layouts. |
| model | string | Comma-separated model slugs as emitted in models[*].model_slug (e.g. kamiq,fabia); combine with brand. |
| energy | string | Comma-separated fuel/energy types; models matching any of them are returned. |
| gearbox | string | Comma-separated gearbox types. |
| keyword | string | Free-text keyword matched by the site against model names (letters, digits, spaces, dots, hyphens). |
| body_type | string | Comma-separated body types. |
| price_max | integer | Maximum starting price in Tunisian dinars (TND). |
| price_min | integer | Minimum starting price in Tunisian dinars (TND). |
{
"type": "object",
"fields": {
"page": "integer, the page returned",
"sort": "string, the ordering applied",
"models": "array of model cards: name, brand_slug, model_slug, version_slug (null unless the card links to a single trim), url, price_from (integer TND), currency, is_promo, original_price (integer TND before discount, null when no promo), promo_note (promo wording, null when none), is_electric, image_url",
"has_more": "boolean, whether page+1 exists",
"page_size": "integer, models per page (24)",
"total_count": "integer, number of models matching the filters (site total)",
"total_pages": "integer, ceil(total_count / page_size)"
},
"sample": {
"data": {
"page": 1,
"sort": "-price",
"models": [
{
"url": "https://www.automobile.tn/fr/neuf/bmw/x5-hybride",
"name": "BMW X5 Hybride",
"currency": "TND",
"is_promo": false,
"image_url": "https://catalogue.automobile.tn/max/2026/09/47141.jpg?t=1789382997",
"brand_slug": "bmw",
"model_slug": "x5-hybride",
"price_from": 379900,
"promo_note": null,
"is_electric": false,
"version_slug": null,
"original_price": null
},
{
"url": "https://www.automobile.tn/fr/neuf/skoda/kamiq",
"name": "Skoda Kamiq",
"currency": "TND",
"is_promo": true,
"image_url": "https://catalogue.automobile.tn/max/2024/02/47105.png?t=1789137607",
"brand_slug": "skoda",
"model_slug": "kamiq",
"price_from": 88980,
"promo_note": "6000 DT de remise | Dans la limite du stock disponible",
"is_electric": false,
"version_slug": null,
"original_price": 94980
}
],
"has_more": false,
"page_size": 24,
"total_count": 6,
"total_pages": 1
},
"status": "success"
}
}About the automobile API
Searching the New-Car Catalogue
The search_models endpoint returns paginated model cards (24 per page) from automobile.tn's new-vehicle listings. Each card includes brand_slug, model_slug, price_from in Tunisian dinars, promo information, and a version_slug when the model resolves to a single trim. Filters can be stacked: pass comma-separated values to brand, model, energy, drive, or gearbox, use keyword for free-text matching, and control ordering with sort. The total_count and total_pages fields let you build pagination loops without extra requests.
Listing Trims for a Model
get_model_versions accepts the brand and model slugs surfaced by search_models and returns every trim available for that model. Each entry in versions carries a numeric version_id, a version_slug (used to call get_version_specs), the trim name, its url on automobile.tn, the current price in TND, and a promo flag with the pre-discount price when applicable. The top-level price_from field gives the cheapest trim at a glance.
Full Technical Sheets
get_version_specs accepts brand, model, and version slugs and returns a trim's complete specification. Top-level fields include power (e.g. '116 CH'), energy, drive, doors, seats, and the current price. All remaining specifications—published in French as on the source site—are available in a sections array, covering every category the site lists for that trim. The model field returns the model year when the site exposes it.
The automobile API is a managed, monitored endpoint for automobile.tn — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when automobile.tn 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 automobile.tn 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 Tunisia-focused new-car price comparison tool using price_from across brands and models.
- Track price changes and active promotions for specific trims via get_model_versions promo flags and pre-discount prices.
- Populate an automotive inventory feed filtered by energy type (electric, diesel, hybrid) using the search_models energy parameter.
- Generate spec sheets for dealership websites by pulling get_version_specs sections for each trim.
- Compare power output and drivetrain options across trims of the same model using the power and drive fields.
- Build a car configurator that narrows results progressively by brand, gearbox, and fuel type using stacked search_models filters.
- Monitor total_count changes over time to detect new model additions to the Tunisian market.
| 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.