# Riyadh Platinumlist — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/get-event-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/get-homepage-featured \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/get-ticket-options \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/list-all-attractions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/list-all-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/list-attractions-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/list-events-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/list-events-by-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/riyadh-platinumlist/search-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.