# Rcdb — 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.

> Discover and explore roller coasters and amusement parks with detailed information including coaster specifications, park details, images, and search capabilities. Find random coasters for inspiration or quickly search for specific rides to compare features and view photos from the world's largest roller coaster database.

**Category:** Entertainment | **Website:** [rcdb.com/](https://rcdb.com/) | **Docs:** [parse.bot/marketplace/daa80675-ebef-4de0-90a7-fe40ce028671/rcdb-com-api](https://parse.bot/marketplace/daa80675-ebef-4de0-90a7-fe40ce028671/rcdb-com-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-rcdb-com-api-daa80675/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_coaster_details

Returns full details for a specific roller coaster by its numeric ID, including park info, location, status, general info, and statistics such as track dimensions, train arrangement, and design details. Measurement stats (length, height, speed, etc.) are returned in the requested unit system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `coaster_id` | string | Yes | Numeric ID of the roller coaster (e.g. '15411' for Steel Vengeance). |
| `units` | string | No | Unit system for measurement stats. 'imperial' returns feet/mph; 'metric' returns meters/km/h. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rcdb-com-api-daa80675/get_coaster_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"coaster_id":"<string>","units":"<string>"}'
```

### get_coaster_pictures

Returns the photo gallery data for a specific roller coaster, including sprite information and individual picture metadata with multiple size options. Each picture includes dimensions, copyright info, and URLs for different resolution variants.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `coaster_id` | string | Yes | Numeric ID of the roller coaster (e.g. '15411' for Steel Vengeance). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rcdb-com-api-daa80675/get_coaster_pictures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"coaster_id":"<string>"}'
```

### get_park_details

Returns full details for a specific amusement park by its numeric ID, including name, location, and associated coasters grouped by status (e.g. Operating, Defunct). Coaster groups vary by park.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `park_id` | string | Yes | Numeric ID of the amusement park (e.g. '4529' for Cedar Point). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rcdb-com-api-daa80675/get_park_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"park_id":"<string>"}'
```

### get_random_coaster

Returns details of a randomly selected roller coaster from the rcdb.com homepage. Each call returns a different coaster with varying fields depending on available data. Fields like speed, height, length, layout, and manufacturer appear only when the site provides them for that coaster. Measurement stats are returned in the requested unit system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `units` | string | No | Unit system for measurement stats. 'imperial' returns feet/mph; 'metric' returns meters/km/h. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rcdb-com-api-daa80675/get_random_coaster \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"units":"<string>"}'
```

### quick_search

Performs a quick autocomplete-style search for roller coasters and parks. Returns a small set of top matching results with name, location, and link path. When a result is a park, includes the numeric park_id. Useful for fast lookups without full search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string for autocomplete results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rcdb-com-api-daa80675/quick_search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_coasters

Searches for roller coasters by keyword. Returns all matching results in a single page with a total count. Omitting query returns all roller coasters in the database.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search keyword to filter coasters by name. Omitting returns all roller coasters. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rcdb-com-api-daa80675/search_coasters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```