Automobile.tn API & Scraper
Automobile.tn is where Tunisians check what a new car costs and where dealers and private sellers list used cars, and this API reads both sides as JSON.
🤖 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.
On the new-car side, `new_search` filters the 349 models on the price list by brand, list price, fuel, gearbox, body, drivetrain, seats and fiscal power; `new_versions` gives every version of one model with its list price, promo price and the official importer; `new_version` returns the full spec sheet: horsepower, torque, engine size, gearbox, dimensions, boot, 0-100, top speed, consumption and every equipment line. On the used side, `search` filters the 1,633 live adverts (2026-10-07) by brand, model, keyword, price, year, mileage, fiscal power, fuel, gearbox, body, drivetrain, governorate and dealer or private seller, and `listing` returns one advert in full with the seller's phone and, for dealers, the dealer's name, address and stock page. `makes` lists the brand and model slugs with their live counts.
What an Automobile.tn field actually contains
Fields that read differently from how they look. Every row was measured against live Automobile.tn pages on 2026-10-07.
| Field | What it holds |
|---|---|
| price_from_tnd vs price_tnd | price_from_tnd is the 'à partir de' price on a model card: the cheapest version. price_tnd is one version's own list price, TTC, in Tunisian dinars. On 4 of 4 models we checked, the card's from-price equalled the cheapest version in new_versions. |
| discount_tnd vs discount_computed_tnd | discount_tnd is the figure on the site's promo badge; discount_computed_tnd is old price minus new price. They disagree on 6 of 28 promo cards: the Peugeot 208 badge says 4,000 DT while 68,900 to 63,900 is 5,000. We return both and add a warning. |
| price_usd_duty_free | Some importers publish a second price in US dollars before tax, reserved for Tunisians living abroad and eligible bodies (for example 21,500 $ for the Hyundai Venue next to 90,000 DT). Present on 13 of 214 model cards; null elsewhere, never converted. |
| search price_tnd vs listing price_tnd | search returns the price printed on the result card; listing returns the advert's own price with price_ld_json beside it. They matched on 21 of 23 adverts sampled in two runs; both misses were the same advert, whose card showed 11,000 DT while its page showed 10,983. |
| seller | type is pro (a dealer or showroom) or private. Every advert carries the seller's phone. Dealers also carry their name, logo, address and stock page; private sellers publish no name. |
| spec_groups on new_version | Every line of the spec sheet grouped as the site groups it (Motorisation, Dimensions, Equipements de sécurité and so on). A line with no text means the item is fitted and comes back as true; a line with text keeps the text, for example Airbags: Frontaux | Latéraux | Rideaux. |
| total, last_page, page_clamped | total is the site's own count. Used adverts come 12 per page and new models 24 per page. Automobile.tn repeats its last page for any page number past the end; we return an empty page with page_clamped true instead of repeating rows. |
Brand and model filters take the site's slugs (audi, mercedes-benz, q5, golf-8). makes and new_brands list them, with live counts for used cars.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/automobile-tn/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"brand": "volkswagen",
"fuel": "essence",
"sort": "price_asc"
}
}{
"ok": true,
"meta": {
"api": "automobile-tn",
"endpoint": "search",
"mode": "live",
"latency_ms": 993.1,
"record_count": 12,
"bytes": 179320,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 2,
"version": "1.0.0",
"request_id": "b099af3654134689",
"queue_ms": 1.2,
"fetched_at": "2026-10-07T15:52:08.351Z"
},
"data": {
"total": 99,
"page": 1,
"page_size": 12,
"last_page": 9,
"page_clamped": false,
"has_more": true,
"sort": "price_asc",
"filters_applied": {
"brand[0]": "volkswagen",
"energie[0]": "66",
"sort": "price"
},
"listings": [
{
"id": "131029",
"url": "https://www.automobile.tn/fr/occasion/volkswagen/polo/131029",
"brand_slug": "volkswagen",
"model_slug": "polo",
"title": "Volkswagen Polo",
"version": "Populaire",
"price_tnd": 21000,
"price_label": null,
"currency": "TND",
"mileage_km": 230000,
"year": 2006,
"gearbox": "Manuelle",
"drivetrain": "Traction",
"fiscal_power_cv": 4,
"fuel": "Essence",
"governorate": "Ariana",
"summary": "ENTRETIEN PERIODIQUE A OTTOSURE ARIANA PRIX LEGEREMENT NEGOCIABLE",
"price_rating": "Bon prix",
"price_rating_code": "good",
"image": "https://catalogue.automobile.tn/max/2026/10/131029_max.jpeg?t=1791293170"
},
{
"id": "130027",
"url": "https://www.automobile.tn/fr/occasion/volkswagen/polo/130027",
"brand_slug": "volkswagen",
"model_slug": "polo",
"title": "Volkswagen Polo",
"version": null,
"price_tnd": 27000,
"price_label": null,
"currency": "TND",
"mileage_km": 227000,
"year": 2011,
"gearbox": "Manuelle",
"drivetrain": "Traction",
"fiscal_power_cv": 5,
"fuel": "Essence",
"governorate": "Ben Arous",
"summary": "Citadine, 5 cv, transmission Traction, Accoudoir avant",
"price_rating": "Aucune évaluation",
"price_rating_code": "unavailable",
"image": "https://catalogue.automobile.tn/max/2026/09/130027_max.jpeg?t=1790158819"
},
{
"id": "129622",
"url": "https://www.automobile.tn/fr/occasion/volkswagen/passat/129622",
"brand_slug": "volkswagen",
"model_slug": "passat",
"title": "Volkswagen Passat",
"version": null,
"price_tnd": 30000,
"price_label": null,
"currency": "TND",
"mileage_km": 380000,
"year": 2008,
"gearbox": "Manuelle",
"drivetrain": "Traction",
"fiscal_power_cv": 7,
"fuel": "Essence",
"governorate": "Tunis",
"summary": "Passat b6",
"price_rating": "Prix très élevé",
"price_rating_code": "far_above_market",
"image": "https://catalogue.automobile.tn/max/2026/08/129622_max.jpeg?t=1787599524"
}
],
"facets": {
"brand": [
{
"slug": "alfa-romeo",
"name": "Alfa Romeo",
"count": 6
},
{
"slug": "audi",
"name": "Audi",
"count": 49
},
{
"slug": "bmw",
"name": "BMW",
"count": 84
}
],
"model": [
{
"brand_slug": "volkswagen",
"slug": "caddy-combi",
"name": "Caddy Combi",
"count": 1
},
{
"brand_slug": "volkswagen",
"slug": "cc",
"name": "CC",
"count": 1
},
{
"brand_slug": "volkswagen",
"slug": "golf-6",
"name": "Golf 6",
"count": 6
}
],
"fuel": [
{
"label": "Diesel",
"count": 29
},
{
"label": "Hybride léger essence",
"count": 2
},
{
"label": "Hybride essence",
"count": 0
}
],
"gearbox": [
{
"label": "Manuelle",
"count": 57
},
{
"label": "Automatique",
"count": 42
}
],
"body_type": [
{
"label": "Citadine",
"count": 15
},
{
"label": "SUV",
"count": 17
},
{
"label": "Compacte",
"count": 46
}
],
"drivetrain": [
{
"label": "Traction",
"count": 89
},
{
"label": "Propulsion",
"count": 4
},
{
"label": "Intégrale",
"count": 6
}
],
"governorate": [
{
"label": "Ariana",
"count": 324
},
{
"label": "Béja",
"count": 5
},
{
"label": "Ben Arous",
"count": 313
}
],
"seller_type": [
{
"label": "Professionnel",
"count": 725
},
{
"label": "Particulier",
"count": 914
}
],
"color": [
{
"label": "Noir",
"count": 35
},
{
"label": "Gris argent",
"count": 13
},
{
"label": "Gris Shark",
"count": 7
}
],
"price_type": [
{
"label": "Prix régulier",
"count": 1610
},
{
"label": "Sous leasing",
"count": 18
},
{
"label": "Non dédouané",
"count": 11
}
]
}
}
}What the Automobile.tn API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search used-car adverts on Automobile.tn (Tunisia): brand, model, keyword, price, year, mileage, fiscal power, fuel, gearbox, body, drivetrain, governorate, dealer vs private, and the site's sort orders. 12 adverts per page; the site's own total and per-filter counts come back with every page. Nothing is required: no parameters browses every live advert. | Price-intelligence teams call search to search used-car adverts on Automobile.tn (Tunisia). | query, brand, model, price_min, price_max, ... |
| listing | One used-car advert in full: asking price (with the site's price rating), mileage, first registration, fuel, gearbox, fiscal power, drivetrain, body, condition, previous owners, colours, upholstery, seats, doors, engine size, every equipment item by group, the seller's description, all photos, and the seller block (dealer name, logo, address, stock page; phone for everyone). Pass `url` or `id`. | Classifieds aggregators call listing to get one used-car advert in full. | url, id, include_pii |
| makes | Brands that have live used-car adverts on Automobile.tn with their counts — or, with `brand`, that brand's models with counts. These are the slugs `search` takes. | Resale and arbitrage tools call makes to get brands that have live used-car adverts on Automobile.tn with their counts. | brand |
| new_search | Search Automobile.tn's NEW-car price list (every model sold new in Tunisia): brand, keyword, list-price range, fuel, gearbox, body, drivetrain, seats, fiscal power. Each card is a model with its 'from' price (cheapest version), any promo (old price + the site's discount), and a USD duty-free price where the importer publishes one. 24 models per page. | Lead-generation teams call new_search to search Automobile.tn's NEW-car price list (every model sold new in Tunisia). | query, brand, price_min, price_max, fiscal_power_min, ... |
| new_brands | Every brand in Automobile.tn's new-car price list, with slug and logo. | Price-intelligence teams call new_brands to get every brand in Automobile.tn's new-car price list, with slug and logo.. | none |
| new_versions | All versions (trims) of one new model with each version's list price, promo old price, version id and spec-sheet url, plus the official importer's name, address, phone and fax. Pass `brand`+`model` or `url`. | Classifieds aggregators call new_versions to get all versions (trims) of one new model with each version's list price, promo old price, versio…. | brand, model, url |
| new_version | Full spec sheet of one new-car version: list price TTC (and USD duty-free price where published), availability, warranty, body, seats, doors, cylinders, fuel, fiscal power, horsepower, torque, engine size, gearbox, gears, drivetrain, dimensions, boot, 0-100, top speed, consumption and every equipment line, plus the importer. Pass `url` or `brand`+`model`+`version`. | Resale and arbitrage tools call new_version to get full spec sheet of one new-car version. | url, brand, model, version |
Call search from your stack
curl -X POST https://api.reefapi.com/automobile-tn/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"brand":"volkswagen","fuel":"essence","sort":"price_asc"}'import requests
r = requests.post(
"https://api.reefapi.com/automobile-tn/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"brand": "volkswagen",
"fuel": "essence",
"sort": "price_asc"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/automobile-tn/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"brand": "volkswagen",
"fuel": "essence",
"sort": "price_asc"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.automobile-tn.search with {"brand":"volkswagen","fuel":"essence","sort":"price_asc"}.Who uses this API and why
- Keep a Tunisian new-car price list in sync: every model and version with list price, promo price and importer, refreshed whenever you call.
- Compare versions of one model on horsepower, torque, consumption, boot and equipment before quoting a customer.
- Track used-car asking prices by brand, model, year and mileage across Tunisia's 24 governorates.
- Find dealers and showrooms: dealer adverts carry the dealer's name, address, phone and stock page.
- Spot promotions as they appear: model cards carry the old price, the new price and the site's stated discount.
Questions developers ask before integrating
Can I get the official price of every new car sold in Tunisia?
Yes. new_search covers the 349 models on Automobile.tn's price list across 59 brands, new_versions gives every version of a model with its list price TTC in TND, and new_version gives one version's full spec sheet. Promo prices come with the old price next to them.
Which used-car filters actually work?
All of them were measured against the site's own counts on 2026-10-07, out of 1,633 adverts: diesel 280, electric 36, manual 559, SUV 730, four-wheel drive 342, Sousse 92, dealers 722, private sellers 911, at most 40,000 DT 285, 2022 or newer 599. Several values of one filter are combined with OR: diesel plus petrol gave 1,296 = 280 + 1,016.
Do I get the seller's phone number?
Yes, on every advert, as the page publishes it. For dealers you also get the dealer's name, logo, address and the link to their stock; private sellers publish only the phone.
Who imports each new car?
new_versions and new_version return the official importer block printed on the model page: name, address, phone and fax. For example Peugeot models list STAFIM, Hyundai lists Alpha Hyundai Motor and Skoda lists Ennakl Automobiles.
Can I look up an advert by its number only?
Yes. Pass id and we resolve it through the site's own advert index; adverts posted the same day are found among the newest adverts. Passing the url from search is faster because it skips that step.
Which technical specs are on a new-car version?
Price, availability, warranty, body, seats, doors, cylinders, fuel, fiscal power, horsepower, torque and its rpm, engine size, gearbox and gear count, drivetrain, length, width, height, boot, 0-100, top speed, mixed consumption and every equipment line. On 12 versions sampled, horsepower, torque and top speed were filled 12/12, 0-100 10/12, engine size and consumption 9/12 (electric cars have none) and boot 7/12.
How deep can I page?
To the end of any result. Used adverts come 12 per page, new models 24 per page, and last_page tells you where it stops. Asking past it returns an empty page marked page_clamped rather than a copy of the last page.
What is the Automobile.tn API?
Automobile.tn API is a ReefAPI endpoint group for tunisia's new-car price list with full spec sheets, plus used-car adverts with seller phone, in tnd. It returns live JSON through POST requests under /automobile-tn/v1.
Is the Automobile.tn API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Automobile.tn calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Automobile.tn login or account?
No login to Automobile.tn 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 Automobile.tn 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 Automobile.tn API use?
Automobile.tn 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 Automobile.tn from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call automobile-tn actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Automobile.tn API an Automobile.tn scraper?
It is the managed alternative to a DIY Automobile.tn scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same tunisia's new-car price list with full spec sheets, plus used-car adverts with seller phone, in tnd back as clean JSON.