tayara.tn APItayara.tn ↗
Access Tayara.tn classified ads via API. Search listings, filter by category/location/price, retrieve seller contacts, shops, and categories.
curl -X GET 'https://api.parse.bot/scraper/bf1aa8ba-a2d5-41be-94f8-5cd4155bf779/search_ads?limit=5&query=voiture&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for ads by keyword with pagination. Returns matching listings sorted by recency.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results per page. |
| query | string | Search keyword (e.g. 'voiture'). Omitting returns all recent ads. |
| offset | integer | Pagination offset (number of results to skip). |
{
"type": "object",
"fields": {
"count": "integer total number of listings returned",
"limit": "integer page size used",
"offset": "integer pagination offset used",
"listings": "array of ad objects with id, title, description, images, price, metadata, and location"
},
"sample": {
"data": {
"count": 5,
"limit": 5,
"offset": 0,
"listings": [
{
"id": "6a05f7e6e853e69bec020939",
"price": 34500,
"title": "Mercedes-Benz e200 kompresseur",
"images": [
"https://storage.googleapis.com/tayara-migration-yams-pro/24/24ee395f-6c15-48f8-81e5-3f88e02ab0ad"
],
"location": {
"delegation": "Sakiet Ezzit",
"governorate": "Sfax"
},
"metadata": {
"state": 2,
"publisher": {
"id": "",
"name": "yessine",
"avatar": "",
"isShop": false,
"isApproved": false
},
"publishedOn": "2026-05-14T16:27:18.000Z",
"subCategory": "60be84be50ab95b45b08a0a4"
},
"description": "A vendre Mercedes-Benz e200..."
}
]
},
"status": "success"
}
}About the tayara.tn API
The Tayara.tn API provides 5 endpoints for searching, filtering, and extracting data from Tunisia's largest classified ads platform. Use search_ads to find listings by keyword, get_ad_detail to pull a specific ad's seller phone number, publisher info, and category-specific parameters, or list_shops to enumerate all active boutiques with their contact details. Response objects include price in Tunisian Dinars, geo-coordinates, images, and structured metadata.
Search and Browse Listings
The search_ads endpoint accepts a query string (e.g. 'voiture') plus limit and offset for pagination. It returns a listings array where each object carries an id, title, description, images, price, and a location object. Omitting the query parameter returns the most recent ads across all categories. The list_ads endpoint adds more targeted filtering: pass category_id (obtained from get_categories), sub_category_id, governorate (e.g. 'Sfax'), delegation (e.g. 'Hammam Chott'), min_price, and max_price to narrow results. Both endpoints return a top-level count so you can implement pagination without a separate call.
Ad Details and Seller Contact
Once you have an ad_id from either listing endpoint, pass it to get_ad_detail to get the full record. This response includes the seller's phone number, a publisher object with fullname, phonenumber, and email, a location object with governorate, delegation, and coordinates, and a parameters array of label/value pairs covering category-specific attributes (mileage for vehicles, surface area for real estate, etc.). The currency field is always DT (Tunisian Dinar), and metadata contains publish date and category info.
Shops and Categories
list_shops returns all active boutiques on the platform with no input required. Each shop object includes id, name, address, email, phone, category, description, and URLs for avatar and background images. get_categories returns both the main_categories array (each with a name and id) and a homepage_ads array of current featured listings. Use the category id values directly as the category_id parameter in list_ads to scope your queries.
- Aggregate vehicle listings from Tayara.tn using the Véhicules category ID and filter by governorate for a regional car-search tool
- Build a price-tracking dashboard by polling
list_adswithmin_price/max_pricefilters and storing price changes over time - Extract seller phone numbers and emails from
get_ad_detailto build a Tunisia-specific B2B leads dataset for a specific product category - Enumerate all active shops via
list_shopsto compile a directory of Tunisian e-commerce boutiques with contact details - Sync real estate listings filtered by delegation and category ID into a property portal that focuses on Tunisian governorates
- Monitor keyword-based ad volume using
search_adscounts over time to analyze supply/demand trends in a given market segment - Populate a category navigation from
get_categoriesmain_categories to let users drill into Tayara.tn data without hardcoding IDs
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Tayara.tn have an official developer API?+
How do I get a seller's phone number for a specific ad?+
get_ad_detail with the ad_id from a search_ads or list_ads result. The response includes a top-level phone field and a publisher object with phonenumber and email. The ad_id is a required parameter; there is no bulk-contact endpoint.Does `list_ads` support filtering by both governorate and price range at the same time?+
list_ads accepts governorate, delegation, min_price, max_price, category_id, and sub_category_id as independent optional filters. You can combine any subset of them in a single request. Pagination is handled via limit and offset.Does the API expose seller ratings or review history for shops and ad publishers?+
Are ads outside Tunisia covered, or is coverage limited to the Tunisian market?+
governorate and delegation reference Tunisian administrative divisions. The currency field is always DT (Tunisian Dinar). Listings from other countries are not part of this API.