fazaa.com APIfazaa.com ↗
Access Fazaa.ae offers, categories, cities, membership tiers, used cars, leases, daily rentals, and Amakin venues via 10 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/eabc774a-c7ce-4288-8e49-0d748c9ead62/search_offers?page=0&size=20&query=restaurant' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for offers with filters like category, city, keyword, and coordinates.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| size | integer | Results per page |
| query | string | Search keyword |
| city_id | string | City ID for filtering |
| category | string | Category slug (e.g., 'new-offers', 'dining') |
| latitude | number | Latitude for geolocation search |
| longitude | number | Longitude for geolocation search |
{
"type": "object",
"fields": {
"total": "total number of results",
"content": "array of offers"
},
"sample": {
"data": {
"total": 433,
"content": [
{
"id": "fb45ee29-b547-4138-b0fb-273d923b7767",
"slug": "smokey-woods-restaurant",
"type": "OFFER",
"title": "25% Discount ",
"imageUri": "/upload/offers/20241007071240_Untitled-1.jpeg",
"subTitle": "Smokey Woods Restaurant",
"locations": [
{
"lat": 0,
"lon": 0,
"geohash": "",
"fragment": true
}
],
"partnerName": "Smokey Woods Restaurant ",
"serviceLink": null,
"serviceType": null,
"serviceSubType": null,
"localizedServiceLink": null,
"localizedMobileServiceLink": null
},
{
"id": "9348db43-b1c8-4a4c-8073-f80786f25be9",
"slug": "beit-el-beiruty-restaurant-and-coffee-shop",
"type": "OFFER",
"title": "20% Discount ",
"imageUri": "/upload/offers/20241205095325_20241205094101_cb6dbe8f-5386-44da-9f41-b9a652388b59.jpg",
"subTitle": "BEIT EL BEIRUTY RESTAURANT AND COFFEE SHOP",
"locations": [
{
"lat": 0,
"lon": 0,
"geohash": "",
"fragment": true
}
],
"partnerName": "BEIT EL BEIRUTY RESTAURANT AND COFFEE SHOP",
"serviceLink": null,
"serviceType": null,
"serviceSubType": null,
"localizedServiceLink": null,
"localizedMobileServiceLink": null
},
{
"id": "1e2b522f-ed8b-4f42-92b8-c8c134c2a167",
"slug": "indira-indian-restaurant",
"type": "OFFER",
"title": "25% Discount",
"imageUri": "/upload/offers/indira-indian-restaurant-holiday-inn-cairo-citystars-hotel-1688462822566.jpg",
"subTitle": " Indira Indian Restaurant- Holiday Inn Cairo - Citystars, hotel",
"locations": [
{
"lat": 30.07430890277261,
"lon": 31.343801212929684,
"geohash": "",
"fragment": true
}
],
"partnerName": " Indira Indian Restaurant",
"serviceLink": null,
"serviceType": null,
"serviceSubType": null,
"localizedServiceLink": null,
"localizedMobileServiceLink": null
}
]
},
"status": "success"
}
}About the fazaa.com API
The Fazaa API exposes 10 endpoints covering the full range of content on Fazaa.ae, the UAE employee benefits platform. You can search and filter offers by keyword, city, category, or coordinates using search_offers, fetch full offer details by slug with get_offer_details, retrieve car listings across three transaction types, and look up nearby partners by latitude and longitude — all returning structured JSON with localized English and Arabic fields.
Offers and Search
search_offers accepts a combination of query, city_id, category (e.g. 'dining', 'new-offers'), and geographic coordinates (latitude, longitude) to return a paginated list of offers. Results include a total count and a content array. Pagination is 0-indexed via the page parameter with a configurable size. get_offer_details takes an offer slug and returns a full record including the id, partner object, and localData with both English and Arabic localized content — useful when building bilingual interfaces.
Taxonomy and Geography
list_categories returns all available category objects, which can be passed as slugs to search_offers. list_cities returns countries with their nested city arrays, including the city_id values needed for location-scoped offer searches. Together these two endpoints give you the complete valid parameter space for the search filter dimensions.
Automotive Services
Three dedicated endpoints cover Fazaa's vehicle services: get_used_cars returns car-sale listings, get_long_term_car_lease returns lease options, and get_daily_rental returns short-term rental offers. Each returns a content array of listings. These are separate endpoints reflecting distinct inventory pools rather than a single filterable vehicle catalog.
Membership, Venues, and Map Search
get_membership_benefits returns tier structure and benefit descriptions in localized localData fields, suitable for rendering a membership comparison page. get_amakin retrieves Fazaa Amakin venue and places listings. find_on_map accepts required latitude and longitude values and returns a results array of nearby partners and offers — the geographic complement to the coordinate filtering available in search_offers.
- Build a bilingual (EN/AR) UAE deals aggregator using
localDatafields fromget_offer_details - Populate a city-scoped offer feed by combining
list_citiescity IDs with thecity_idfilter insearch_offers - Display a membership tier comparison page using benefit data from
get_membership_benefits - Create a vehicle-finder tool covering used sales, long-term leases, and daily rentals from three dedicated car endpoints
- Show a live map of nearby Fazaa partners using
find_on_mapwith the device's GPS coordinates - Sync offer categories for a UAE employee-benefits app by polling
list_categoriesandsearch_offers - List Amakin venues alongside standard offers in a places-discovery interface using
get_amakin
| 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 Fazaa.ae have an official public developer API?+
What does `get_offer_details` return beyond what `search_offers` provides?+
search_offers returns summary-level offer data in a paginated content array. get_offer_details takes a specific slug and returns the full record, including the partner object with partner-level details and the localData block containing localized text in both English and Arabic — fields that are not necessarily included in the search listing response.Can I filter car listings by make, model, price, or year?+
get_used_cars, get_long_term_car_lease, get_daily_rental) currently accept no filter parameters and return full content arrays. Filtering by attributes like make, price range, or year is not exposed at this time. You can fork this API on Parse and revise it to add filter parameters once you've inspected the fields returned in the content array.How does pagination work in `search_offers`?+
page parameter combined with a size parameter controlling results per page. The response includes a total field indicating the full result count, so you can calculate the number of pages as ceil(total / size).