worldsdc.com APIworldsdc.com ↗
Access WSDC event listings, dancer point lookups, Annie Hirsch rankings, and competition rules via 7 structured API endpoints.
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'
Fetch the list of all events from the WSDC registry. Returns event names, dates, locations, countries, and types parsed from the events page HTML table.
| 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": 173,
"events": [
{
"date": "May 13 - 18, 2026",
"name": "French Open WCS",
"type": "Registry Event",
"country": "FRA",
"location": "PARIS, France"
}
]
},
"status": "success"
}
}About the worldsdc.com 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.
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.
- 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 | 250 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.