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

> Find swing dance competitions, look up dancer rankings and points, and discover events on a calendar or map. Search the WSDC database to check competition rules, locate dancers, and view the Annie Hirsch rankings all in one place.

**Category:** Sports | **Website:** [worldsdc.com/](https://worldsdc.com/) | **Docs:** [parse.bot/marketplace/1f25243c-b8e7-435d-9f65-c14d0e4151cd/worldsdc-com-api](https://parse.bot/marketplace/1f25243c-b8e7-435d-9f65-c14d0e4151cd/worldsdc-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-worldsdc-com-api-1f25243c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_annie_hirsch_ranking

Fetch the current Annie Hirsch Award ranking of top West Coast Swing competitors. Returns a ranked list with names (including WSDC IDs), points totals, and role breakdowns (Leader/Follower points). Rankings are parsed from the WSDC ranking page HTML table.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldsdc-com-api-1f25243c/get_annie_hirsch_ranking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_event_list

Fetch the list of all upcoming and past events from the WSDC registry. Parses the events page HTML table and returns event names, dates, locations, countries, and types. Events are ordered chronologically. Each event includes a country code parsed from flag images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `show_unconfirmed` | boolean | No | Whether to include unconfirmed events in the list. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldsdc-com-api-1f25243c/get_event_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"show_unconfirmed":"<boolean>"}'
```

### get_events_calendar

Fetch events for a specific month and year in a calendar-friendly format. Data is sourced from the map page's embedded JSON and filtered by the provided month/year. If no month or year is provided, returns all events. Each event includes geographic coordinates, start/end dates in ISO format, event URL, and type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | integer | No | The month to filter by (1-12). |
| `year` | integer | No | The year to filter by (e.g., 2026). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldsdc-com-api-1f25243c/get_events_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<integer>","year":"<integer>"}'
```

### get_events_map

Fetch event data including geographic coordinates for map visualization. Returns all events from the WSDC map page with latitude/longitude, location details, hotel info, and event metadata. No filtering is applied.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldsdc-com-api-1f25243c/get_events_map \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_wsdc_rules

Fetch competition rules and regulations links from the WSDC site. Parses the rules page for links to rules documents, guidelines, and the official rules PDF. Returns links with titles and URLs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldsdc-com-api-1f25243c/get_wsdc_rules \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_dancer

Search for a dancer by name or WSDC ID number to retrieve their points, competition history, division levels, and placements for both leader and follower roles. Uses the WSDC points registry lookup system. Returns detailed breakdown by division (Champions, All-Stars, Advanced, etc.) with individual competition results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | The name or WSDC ID of the dancer to look up. |

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

### search_site

Perform a site-wide search on worldsdc.com using WordPress search. Returns matching page titles, URLs, and excerpt snippets. Results may include duplicates from different page sections.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword. |

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