scorecatonline.com APIscorecatonline.com ↗
Access gymnastics meet listings, session results, and athlete scores from ScoreCat Online. Filter by state and season, search meets, and retrieve team rankings.
curl -X GET 'https://api.parse.bot/scraper/2c371e5d-9ad0-4c2a-8cc5-65f126912c8f/list_meets' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve a list of gymnastics meets/competitions, optionally filtered by state and season.
| Param | Type | Description |
|---|---|---|
| state | string | Two-letter US state code filter (e.g. 'KY') |
| season | string | Season filter (e.g. '2025-2026') |
{
"type": "object",
"fields": {
"data": "array of meet objects",
"status": "string"
},
"sample": {
"data": [
{
"city": "LOUISVILLE",
"docId": "K4Z0L64Y",
"state": "KY",
"hostGym": "Champion Gymnastics",
"meet_id": "K4Z0L64Y",
"meetName": "2025 WHOVILLE JUBILATION",
"startDate": "2025-12-12T05:00:00Z",
"compSeason": "2025-2026"
}
],
"status": "success"
}
}About the scorecatonline.com API
The ScoreCat Online API provides access to gymnastics competition data across 8 endpoints, covering meet listings, session breakdowns, and individual and team scores. The get_individual_session_results endpoint returns per-athlete scores and rankings for a given session, while list_meets lets you filter the full meet calendar by US state and season string.
Meet Discovery and Filtering
The list_meets endpoint accepts an optional two-letter state code (e.g., KY) and an optional season string (e.g., 2025-2026) to narrow the returned array of meet objects. For open-ended lookup, search_meets accepts a query keyword matched against meet names and host gym names. The get_states_list and get_seasons_list endpoints return the exact state codes and season strings that list_meets accepts as filters, so you can build a valid filter UI without hardcoding values.
Meet Details and Sessions
Once you have a meet_id from list_meets or search_meets, get_meet_details returns the full detail object for that meet. get_meet_sessions returns an array of session objects for the same meet, each of which carries a session_id (also called docId or sessionId) used by the results endpoints.
Results: Individual and Team
get_individual_session_results takes a session_id and returns an array of athlete score objects including scores and rankings for that session. get_team_session_results returns team-level rankings and scores for the same session. Both endpoints are keyed to the same session_id value, so switching between individual and team views for a given session requires only changing the endpoint called.
- Build a gymnastics meet calendar filtered by state and season using
list_meets. - Display live leaderboard data for a specific session using
get_individual_session_results. - Track team standings across sessions at a meet using
get_team_session_results. - Power a meet search feature for a club or coach portal using
search_meets. - Aggregate season results across multiple meets by iterating sessions per meet.
- Generate state-level competition reports by combining
get_states_listwith filteredlist_meetsresults. - Notify athletes or parents of results for a specific meet by polling session endpoints after a scheduled meet date.
| 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 ScoreCat Online have an official developer API?+
What does `get_meet_sessions` return, and how does it relate to the results endpoints?+
get_meet_sessions returns an array of session objects for a given meet, each containing a session_id. That session_id is the required input for both get_individual_session_results and get_team_session_results, so you must call get_meet_sessions first to obtain the identifiers needed for results lookups.Does the API expose historical results beyond the current season?+
get_seasons_list endpoint returns all seasons available for filtering, and list_meets accepts any season string from that list. Coverage depends on what ScoreCat Online has indexed. You can call get_seasons_list to see exactly which past seasons are accessible before querying results.