Platinumlist APIriyadh.platinumlist.net ↗
Access Riyadh events, attractions, ticket options, and category filters via 9 endpoints. Search by keyword, date, or category slug.
What is the Platinumlist 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.
curl -X GET 'https://api.parse.bot/scraper/6a379569-7679-43b5-a96d-78c471cd9b7c/search_events?query=comedy' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace riyadh-platinumlist-net-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Platinumlist Riyadh SDK — browse events, filter by date/category, drill into details."""
from parse_apis.Platinumlist_Riyadh_API import Platinumlist, DateFilter, EventNotFound
client = Platinumlist()
# Search for comedy events across Platinumlist cities
for event in client.event_summaries.search(query="comedy", limit=5):
print(event.name, event.price, event.venue)
# List events happening today using the DateFilter enum
for event in client.event_summaries.list_by_date(date_slug=DateFilter.TODAY, limit=3):
print(event.name, event.date)
# Get featured homepage events and drill into the first one's full details
featured = client.event_summaries.featured(limit=1).first()
if featured:
try:
detail = featured.details()
print(detail.name, detail.venue, detail.description[:80])
# Access ticket metadata via sub-resource
ticket = detail.ticket_options.get()
if ticket.gtm_info:
print(ticket.gtm_info.event_category, ticket.gtm_info.marketing_tag)
except EventNotFound as exc:
print(f"Event gone: {exc.event_url}")
# Browse attractions by category
for attraction in client.attractions.list_by_category(category_slug="themeparks", limit=3):
print(attraction.name, attraction.price)
print("exercised: event_summaries.search / list_by_date / featured / details / ticket_options.get / attractions.list_by_category")
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://jeddah.platinumlist.net/event-tickets/106469/stand-up-comedy-night-in-jeddah",
"date": null,
"name": "Stand up comedy night",
"type": "Events & Attractions",
"price": "24.72 USD",
"venue": "The Storytellers"
}
]
},
"status": "success"
}
}About the Platinumlist API
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.
The Platinumlist API is a managed, monitored endpoint for riyadh.platinumlist.net — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when riyadh.platinumlist.net changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official riyadh.platinumlist.net API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.