عوامی API

Endpoints

• GET /api/events — params: city (e.g. dubai), country (uae, saudi-arabia, qatar, bahrain, kuwait, oman, egypt, jordan, lebanon, morocco, tunisia, algeria), date (today, tomorrow, this-weekend, this-week, next-7-days, this-month, YYYY-MM-DD, YYYY-MM), category (concerts, comedy, nightlife, ladies, kids, theatre, sports, festivals, food, exhibitions, workshops, business, wellness, community, arabic, desi, attractions, free), q, lang (en|ar|hi|ur|ml|tl|bn|fr|ru|zh|de|es|fa|tr), limit (≤500), offset. Example
• GET /api/events.txt — same filters, plain text. Example
• GET /api/event/<id> — full details incl. official ticket URL.
• GET /api/search?q=… — text search.
• GET /api/cities — countries, cities, counts and categories.
• GET /api/places?city=dubai&type=restaurants&tag=brunch — places (type: theme-parks, zoos-aquariums, attractions, malls, souks, beaches-parks, hotels, spas, cinemas, nightlife, restaurants, cafes; tag: brunch, date, fine, family, lively, casual, roof, shisha, beach, late, free). Example
• GET /api/landings — index of city answer pages with live counts.
• /llms.txt, /llms-full.txt, /sitemap.xml

Fields

id, title, title_en, title_ar, start/end (ISO 8601 with local offset), ongoing, city, city_name (localised), country, venue, lat, lng, categories, price_usd_from, price_local_from, currency, price_text, labels (only real labels shown by the source, e.g. “Selling fast”), just_announced, sold_out, image, source, url.

Notes

Prices are “from” prices as shown by the source and converted at fixed USD currency pegs (KWD approximate). When a price is null the source did not show one. We do not sell tickets.