Every new car's price and spec sheet in Tunisia, and every used-car advert with its seller
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.
7 active endpoints, on 2 and 3 credit tiers.
- POST/automobile-tn/v1/search
- POST/automobile-tn/v1/listing
- POST/automobile-tn/v1/makes
- POST/automobile-tn/v1/new_search
- POST/automobile-tn/v1/new_brands
- POST/automobile-tn/v1/new_versions
- POST/automobile-tn/v1/new_version
What Automobile.tn endpoints does ReefAPI ship?
7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Automobile.tn API
6 of 7 endpoints, ready to run
New cars by price, body and fuel
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Automobile.tn API works
Automobile.tn is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 438 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a budget to the right new car and its used alternatives
Shortlist new models under a budget, open the versions and spec sheets, then see what the same model sells for used.
71 SUV models at or under 120,000 DT on 2026-10-07, cheapest first, each with its from-price, any promo and the old price.
Every version of the model you pick with its list price, promo price and the official importer's name, address and phone.
url>
The spec sheet: horsepower, torque, engine size, gearbox, dimensions, boot, 0-100, top speed, consumption and the full equipment list.
The same model on the used market, cheapest first, with year, mileage, fuel, gearbox, governorate and the site's price rating.
A new-versus-used comparison for one Tunisian car: list price and spec sheet next to real used asking prices, with the importer and the sellers to call.
curl -X POST https://api.reefapi.com/automobile-tn/v1/new_search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"body_type":"suv","price_max":120000,"sort":"price_asc"}'{
"ok": true,
"data": { … },
"meta": {
"api": "automobile-tn",
"endpoint": "new_search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
Tunisia coverage, measured
Every number below was read from live Automobile.tn pages on 2026-10-07; two consecutive runs (91 and 90 calls, every one successful) gave the same filter counts.
59 brands and 349 models on the price list, 24 per page. Promo on 28 of 214 distinct model cards seen; a US dollar duty-free price on 13.
1,633 live adverts from 52 brands, 12 per page: 722 from dealers and 911 from private sellers; Tunis 562, Ariana 322, Ben Arous 315.
Each used filter total matched the site's own count for that value: diesel 280, SUV 730, four-wheel drive 342, manual 559, dealers 722. New cars: electric 63, diesel 80, SUV 171, seven seats or more 34, at most 80,000 DT 84.
Advert price equalled the page's own structured data on 23 of 23 adverts over two runs; version price equalled the page's structured data on 24 of 24, and the model's version table on 8 of 8.
On used adverts: price, mileage, year, fuel, gearbox, fiscal power, colours, equipment and seller phone on every advert sampled; a written description on 12 of 23. On new versions: horsepower, torque and top speed 12/12, engine size 9/12 (none on electric cars), boot 7/12.
No VIN is published. Private sellers publish a phone but no name. A promo badge's discount can differ from old minus new price; both are returned. Brand and model filters take the site's slugs.
What people build with Automobile.tn
The jobs this data is most often used for.
endpoints
credits per call
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.
What Automobile.tn data costs
The cheapest call here is 2 credits, so $15/mo (Pro) buys 5,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 438 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/automobile-tn/v1/new_search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"body_type":"suv","price_max":120000,"sort":"price_asc"}'import requests
r = requests.post(
"https://api.reefapi.com/automobile-tn/v1/new_search",
headers={"x-api-key": REEF_KEY},
json={
"body_type": "suv",
"price_max": 120000,
"sort": "price_asc"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Automobile.tn.
Get a free key →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.
99 Classifieds & Second-hand APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Automobile.tn, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 437 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-07.