riyadh.platinumlist.net APIriyadh.platinumlist.net ↗
Access Riyadh events, attractions, ticket options, and category filters via 9 endpoints. Search by keyword, date, or category slug.
curl -X GET 'https://api.parse.bot/scraper/6a379569-7679-43b5-a96d-78c471cd9b7c/search_events?query=music' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for events, attractions, and artists by keyword. Returns results from across Platinumlist cities matching the query term.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'comedy', 'music', 'festival'). |
{
"type": "object",
"fields": {
"query": "string - the search term used",
"results": "array of search result objects with name, url, type, price, venue, date"
},
"sample": {
"data": {
"query": "comedy",
"results": [
{
"url": "https://riyadh.platinumlist.net/event-tickets/106037/tarab-comedy-nights-in-riyadh",
"date": null,
"name": "Tarab Comedy Nights in Riyadh",
"type": "Events & Attractions",
"price": "20.60 USD",
"venue": "ONE MIC"
}
]
},
"status": "success"
}
}About the riyadh.platinumlist.net API
The Riyadh Platinumlist API exposes 9 endpoints covering events, attractions, and ticket metadata from riyadh.platinumlist.net. You can retrieve homepage featured events, paginate through all Riyadh listings, filter by category slug or date range, and pull full event details including venue, images, description, and similar events. The get_ticket_options endpoint returns GTM data-layer fields such as best_price, event_category, and datetime for structured ticket data.
Event Discovery and Search
The search_events endpoint accepts a query string and returns matching results across Platinumlist cities, with each result carrying a name, url, type, price, venue, and date. For Riyadh-specific browsing, get_homepage_featured returns the top-events banner and carousel sections from the homepage, while list_all_events supports page pagination over the full event catalog. Both return arrays of event objects with name, url, and price.
Category and Date Filtering
list_events_by_category takes a category_slug matching the site's URL path (e.g. arabic, comedy, festival) and returns matching events with name, url, price, and date. The parallel list_attractions_by_category endpoint applies the same pattern to the attractions section, accepting slugs like themeparks, experiences, or museums. For time-based filtering, list_events_by_date accepts today, this-weekend, or this-month as the date_slug; the response may return an empty array if no events match the calendar filter at retrieval time.
Event and Attraction Details
get_event_details takes a full event_url and returns the name, venue, images array, description text, and a similar_events array with linked names and URLs. list_all_attractions fetches every attraction listed on the Riyadh attractions page without any input required. The get_ticket_options endpoint goes further, returning the ticket-page title and a gtm_info object containing event_id, datetime, event_category, best_price, and marketing_tag — useful for structured pricing signals and scheduling data.
- Build a Riyadh events calendar app filtered by category slug such as 'comedy' or 'festival'
- Track best_price signals from get_ticket_options across multiple events for price-monitoring tools
- Aggregate featured events from get_homepage_featured to surface trending Riyadh entertainment
- Populate an attractions guide by pulling all entries from list_all_attractions with names, URLs, and prices
- Send weekend event alerts by polling list_events_by_date with the 'this-weekend' slug
- Cross-reference similar_events from get_event_details to build recommendation flows
- Index Riyadh event descriptions and venues from get_event_details for local search engines
| 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.