# Riyadh Platinumlist — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover events and attractions happening in Riyadh by browsing featured listings, filtering by category or date, and viewing detailed information including ticket options. Get comprehensive event details to plan your entertainment and activities in the city.

**Category:** Entertainment | **Website:** [riyadh.platinumlist.net/](https://riyadh.platinumlist.net/) | **Docs:** [parse.bot/marketplace/1ce19010-d3aa-4a5a-9f7e-c8f78ef70c5e/riyadh-platinumlist-net-api](https://parse.bot/marketplace/1ce19010-d3aa-4a5a-9f7e-c8f78ef70c5e/riyadh-platinumlist-net-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_event_details

Retrieve full details for a specific event or attraction including description, venue, images, and similar events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_url` | string | Yes | Full URL of the event detail page (e.g., 'https://riyadh.platinumlist.net/event-tickets/<event-id>/<event-slug>'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_url":"<string>"}'
```

### get_homepage_featured

Retrieve featured and top events from the Riyadh Platinumlist homepage. Returns events from the top-events banner and carousel sections.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/get_homepage_featured \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_ticket_options

Retrieve ticket page metadata and GTM data layer information for an event, including event category, pricing signals, and scheduling details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_url` | string | Yes | Full URL of the event detail page (e.g., 'https://riyadh.platinumlist.net/event-tickets/<event-id>/<event-slug>'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/get_ticket_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_url":"<string>"}'
```

### list_all_attractions

Retrieve all attractions and experiences listed on the Riyadh Platinumlist attractions page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/list_all_attractions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_all_events

List all events in Riyadh with pagination. Returns events from the main event listing page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/list_all_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### list_attractions_by_category

List attractions filtered by sub-category slug from the Platinumlist Riyadh attractions section.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Attraction category slug as it appears in the site URL path (e.g., 'themeparks', 'experiences', 'museums'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/list_attractions_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```

### list_events_by_category

List events filtered by category slug. Returns events from the specified category page on Platinumlist Riyadh.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug as it appears in the site URL path (e.g., 'arabic', 'comedy', 'shows', 'festival'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/list_events_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```

### list_events_by_date

List events filtered by date slug from the Platinumlist calendar page. Results depend on the site's current calendar data and may return an empty array if no events match the date filter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date_slug` | string | Yes | Date filter slug. Accepted values: 'today', 'this-weekend'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/list_events_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_slug":"<string>"}'
```

### search_events

Search for events, attractions, and artists by keyword. Returns results from across Platinumlist cities matching the query term.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'comedy', 'music', 'festival'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riyadh-platinumlist-net-api-1ce19010/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```