Search Tunisia's biggest classifieds site, then read any advert and its seller in full
Tayara.tn is where Tunisia buys and sells cars, flats, phones and almost everything else, and this API reads it as JSON.
5 active endpoints, on 1 and 2 credit tiers.
- POST/tayara/v1/search
- POST/tayara/v1/listing
- POST/tayara/v1/seller_listings
- POST/tayara/v1/categories
- POST/tayara/v1/locations
What Tayara endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Tayara API
6 of 5 endpoints, ready to run
Search cars, flats, phones and more across Tunisia
// 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 Tayara API works
Tayara 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 car model to a priced Tunisian market feed with dealers
Filter the car market to one model, read the adverts that matter in full, then follow the dealers behind them.
128 Volkswagen Golf adverts on 2026-10-07, newest first, with TND price, governorate, delegation, images and the seller's display name. total is Tayara's own count.
The full advert: description, every image, the contact phone, year, mileage, fuel, gearbox and colour as structured attributes, and the seller block with seller.id.
Everything that seller is publishing. For shops the listing also gives the shop link and address.
A dated feed of Tunisian car adverts in TND with make, model, year and mileage, the contact phone per advert, and the dealers behind them with their full stock.
curl -X POST https://api.reefapi.com/tayara/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"golf","subcategory":"cars","sort":"newest","limit":30}'{
"ok": true,
"data": { … },
"meta": {
"api": "tayara",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Tayara field actually contains
Fields that read differently from how they look. Every row was measured against live Tayara responses on 2026-10-07.
| Field | What it holds |
|---|---|
| price_tnd vs price_raw | price_raw is exactly what the seller typed, in Tunisian dinars. price_tnd is the same number, or null when it is 0 or 1, because Tayara itself shows those adverts as 'Sans prix'. Across 150 search rows, cars carried a price 20/30 times, apartments 28/30, phones 28/30, home 22/30, jobs 15/30. |
| Seller-typed prices | Tayara does not check prices. We measured a 2024 Hyundai i30 at 76 (meaning 76,000), a land plot at 180 (meaning 180,000), a shop advert at 1234 and car prices above one trillion at the top of the price-descending sort. We publish what the seller typed and never rescale it. |
| phone vs seller.phone | phone is the contact number written on the advert. seller.phone is the number on the seller's account. They can differ: one apartment advert showed +21627256257 while the account behind it showed +21692030071. |
| Search price vs listing price | Search rows come from Tayara's search index; listing reads the advert page. After a price edit they can disagree for a while: one advert read 600 in search and 650 on its page and in the page's own product data. listing also returns price_ld_json and price_mismatch so you can see it. |
| seller.id | Only listing carries it; Tayara leaves the seller id empty on search rows. Pass it to seller_listings: for one shop the page said 39 live adverts and seller_listings returned exactly 39. |
| attributes | The advert's structured facts as Tayara labels them, in French: Marque, Modèle, Année, Kilométrage, Carburant, Boite for cars; Type de transaction, Chambres, Salles de bains, Superficie for property. 8 of 10 sampled adverts carried some; jobs and home adverts often carry none. |
| total and last_page | total is Tayara's own count. Tayara serves only the first 10,000 results of any query, so last_page stops there; narrow with filters to reach the rest. |
Attribute filters such as brand and model match Tayara's spelling exactly: Volkswagen returned 753 cars, volkswagen returned 0. Copy the value from a listing's attributes.
Tunisia coverage, measured
Every number below was read from live Tayara responses on 2026-10-07; two consecutive runs of 49 calls each gave the same filter counts (the site-wide total moved by 2 adverts between them).
Tunisia only, all 24 governorates and 404 delegations, prices in Tunisian dinars as the seller typed them. 10 top-level categories and 55 subcategories, from cars and apartments to jobs and pets.
45,891 live adverts; vehicles 9,001 of which cars 6,293; apartments 4,836; home and garden 5,634; jobs and services 2,159. Tunis governorate 12,787, Sfax 3,061.
Volkswagen 753 of 6,293 cars, Golf 128, diesel 1,841, automatic 2,138, 2020 or newer 2,091; flats for rent 2,836 of 4,836; minimum price 50,000 TND 5,686 of 45,891.
On 150 search rows across cars, flats, phones, home and jobs: id, title, description, governorate, delegation, date, image and category 150/150, seller name 149/150, price 113/150. On 10 full adverts: contact phone 10/10, seller id and name 10/10, attributes 8/10.
Search to listing round-trips on the same id and title 10/10. Listing price matched the advert page's own product data 10/10; search matched the page 9/10, the tenth was a price edited minutes earlier.
Tayara serves the first 10,000 results of any query. No map coordinates, no view count and no seller rating are published. Prices are not checked by Tayara: some are typed in thousands.
What people build with Tayara
The jobs this data is most often used for.
endpoints
credits per call
Track the Tunisian used-car market: page subcategory=cars newest first and keep make, model, year, mileage and price from each advert's attributes.
Build a rent index for Greater Tunis: filter apartments for rent by governorate and delegation and group TND prices by bedrooms and surface.
Watch resale prices of one phone model across Tunisia with a query plus subcategory=phones, then read each listing for the full description.
Find dealers and real-estate agencies: shop adverts carry a shop flag, address and link, and seller_listings lists everything they publish.
What Tayara data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,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/tayara/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"golf","subcategory":"cars","sort":"newest","limit":30}'import requests
r = requests.post(
"https://api.reefapi.com/tayara/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "golf",
"subcategory": "cars",
"sort": "newest",
"limit": 30
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Tayara.
Get a free key →Do I need a Tayara account or a Tunisian IP?▾
No. Every endpoint is read without an account or a login, and you call reefapi.com from anywhere.
Which Tunisian regions can I filter by?▾
All 24 governorates (Tunis, Ariana, Ben Arous, Sfax, Sousse, Nabeul and the rest) and the 404 delegations inside them, spelled the way Tayara files adverts. The locations endpoint lists them. Accents and capitals are optional on our side. Measured on 2026-10-07: Tunis held 12,787 adverts, La Marsa inside it 1,094, Sfax 3,061.
How do I search only cars of one make, year and mileage?▾
Use subcategory=cars with brand, model, year_min/year_max and mileage_min/mileage_max. Measured on 2026-10-07 out of 6,293 cars: Volkswagen 753, Volkswagen Golf 128, diesel 1,841, automatic 2,138, 2020 or newer 2,091, at most 50,000 km 2,100. Make and model must match Tayara's spelling exactly.
Can I separate flats for rent from flats for sale?▾
Yes. transaction=rent or transaction=sale on subcategory=appartments. Out of 4,836 apartments, 2,836 were for rent and 1,577 for sale; rooms_min=3 left 1,335 and a 100-150 m² surface range 1,505.
Why is the price null on some adverts?▾
Because the seller published none: Tayara shows those adverts as 'Sans prix' when the price is 0 or 1. We return null in price_tnd and keep the raw number in price_raw, so you can tell 'no price' from a real price.
Do you return the seller's phone number and name?▾
Yes, exactly as the advert page publishes them: the advert's contact phone, the seller's display name and account phone, and for shops the shop flag, address and link. In our sample every one of 10 adverts carried a contact phone.
How deep can I page?▾
Up to the 10,000th result of any query, which is where Tayara itself stops. The whole site held 45,891 adverts, so an unfiltered walk reaches about a fifth of it; filtered queries (one subcategory, one governorate) usually fit entirely. Asking past the real end returns an empty page with the true total, never a repeat.
Can I get every advert of one dealer or agency?▾
Yes. Read any of their adverts with listing, take seller.id, and page seller_listings with it. The count matches the number Tayara shows on the advert page.
What is the Tayara API?▾
Tayara API is a ReefAPI endpoint group for tunisia's biggest classifieds: cars, property, phones, home and jobs in tnd, with the seller's phone and every attribute. It returns live JSON through POST requests under /tayara/v1.
Is the Tayara API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Tayara calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Tayara login or account?▾
No login to Tayara 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 Tayara 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 Tayara API use?▾
Tayara actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Tayara from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call tayara actions with the same key, credit pool and JSON envelope used by normal REST requests.
99 Classifieds & Second-hand APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Tayara, 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.