worldsdc APIworldsdc.com ↗
Access WSDC event listings, dancer point lookups, Annie Hirsch rankings, and competition rules via 7 structured API endpoints.
What is the worldsdc API?
The worldsdc.com API provides 7 endpoints covering the World Swing Dance Council registry, including event listings with geographic coordinates, dancer point lookups by name or WSDC ID, and the Annie Hirsch Award rankings. The search_dancer endpoint returns division levels, placement history, and role breakdowns for both leader and follower roles. Events are available in three formats: a flat list, a calendar-filtered view, and a map-ready format with latitude and longitude.
curl -X GET 'https://api.parse.bot/scraper/88ec8750-e26e-4c1e-a0f5-a35692633871/get_event_list?show_unconfirmed=True' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace worldsdc-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.wsdc_registry_api import WSDC, Event, MapEvent, Dancer, Ranking, SearchResult, RulesSection
wsdc = WSDC()
# List all upcoming WSDC registry events
for event in wsdc.events.list(show_unconfirmed=False):
print(event.name, event.date, event.location, event.country)
# Get map events for October 2026
for map_event in wsdc.mapevents.calendar(year=2026, month=10):
print(map_event.name, map_event.start_date, map_event.lat, map_event.lng, map_event.city, map_event.country)
# Look up a dancer by name
dancer = wsdc.dancers.search(query="Jordan Frisbee")
print(dancer.dancer_first, dancer.dancer_last, dancer.dancer_wsdcid, dancer.dominate_role)
# Fetch the Annie Hirsch Award rankings
for ranking in wsdc.rankings.list():
print(ranking.rank, ranking.name, ranking.points)
# Search the site for articles
for result in wsdc.searchresults.search(query="competition"):
print(result.title, result.url, result.excerpt)
# Get official rules documents
for section in wsdc.rulessections.list():
print(section.title, section.url)
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.
| Param | Type | Description |
|---|---|---|
| show_unconfirmed | boolean | Whether to include unconfirmed events in the list. |
{
"type": "object",
"fields": {
"total": "integer count of events returned",
"events": "array of event objects with date, name, type, location, and country fields"
},
"sample": {
"data": {
"total": 179,
"events": [
{
"date": "Jun 11 - 15, 2026",
"name": "Baltic Swing",
"type": "Registry Event",
"country": "POL",
"location": "Gdańsk, Pomorskie, Poland"
}
]
},
"status": "success"
}
}About the worldsdc API
Event Data
Three endpoints cover WSDC-registered events from different angles. get_event_list returns a flat array of events with date, name, type, location, and country fields, and accepts a show_unconfirmed boolean to include or exclude events that have not yet been confirmed. get_events_calendar filters events by year and month (1–12) and returns start_date, end_date, duration_str, name, url, url_host, and event type — useful for building month-view interfaces. get_events_map returns the same shape but for all events at once, adding lat and lng fields for geographic rendering.
Dancer Lookup and Rankings
search_dancer accepts a dancer's name or integer WSDC ID as its query parameter and returns a structured object with separate leader and follower sub-objects, each containing placement history and division level. The response also surfaces dominate_role, non_dominate_role, dancer_wsdcid, and name components. get_annie_hirsch_ranking returns the current ranked list of top West Coast Swing competitors with Rank, Name, and Points fields, plus a period string describing the ranking window.
Rules and Site Search
get_wsdc_rules returns an array of sections, each with a title and url pointing to WSDC competition rules documents and guidelines pages — suitable for linking users directly to official regulation references. search_site performs a keyword search across worldsdc.com and returns matching title, url, and excerpt fields for each result, along with an echo of the original query and a total count.
Coverage Notes
All event data is scoped to WSDC-registered events only. Dancer records reflect what the WSDC registry tracks: points, placements, and role designations. The API does not expose competitor-level heat sheets or individual competition entry lists.
The worldsdc API is a managed, monitored endpoint for worldsdc.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when worldsdc.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official worldsdc.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a West Coast Swing event finder filtered by month and year using
get_events_calendar - Render an interactive world map of upcoming WSDC events using
latandlngfromget_events_map - Look up a dancer's current division level and point totals by WSDC ID via
search_dancer - Display the Annie Hirsch Award leaderboard with ranks and points using
get_annie_hirsch_ranking - Surface competition rules and guidelines links for a dance community app via
get_wsdc_rules - Power a site-wide WSDC search feature using
search_sitewith keyword queries - Compare a dancer's leader vs. follower placement histories using the
leaderandfollowerobjects insearch_dancer
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does WSDC offer an official developer API?+
What does `search_dancer` return for a dancer who competes in both leader and follower roles?+
leader and follower objects, each with placement history and division level. It also returns dominate_role and non_dominate_role strings to indicate which role carries more points, along with dancer_wsdcid and name fields.Does `get_event_list` include unconfirmed events by default?+
show_unconfirmed: true to include events that are listed in the registry but not yet confirmed.Does the API return individual heat sheets or entry lists for specific competitions?+
Is historical ranking data available through `get_annie_hirsch_ranking`?+
period string describing the ranking window. Historical period snapshots are not currently exposed. You can fork this API on Parse and revise it to add filtering or archiving for past ranking periods.