# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/worldsdc/`
**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 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/credits/worldsdc/get-annie-hirsch-ranking \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldsdc/get-event-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldsdc/get-events-calendar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldsdc/get-events-map \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldsdc/get-wsdc-rules \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldsdc/search-dancer \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldsdc/search-site \
  -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://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.