results.usatf.org APIresults.usatf.org ↗
Retrieve USATF competition metadata, daily event schedules, detailed results, and World Athletics athlete profiles via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/a50746f4-55bb-4edb-8907-4da8934f2c19/get_competition_info?meet_id=8035' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns top-level metadata about a specific USATF competition including name, location, facility, dates, and configuration. Returns upstream_error for unknown meet IDs.
| Param | Type | Description |
|---|---|---|
| meet_id | string | Meet ID identifying the competition. Known values: '8035' (2025 Toyota USATF Outdoor Championships), '8036' (2025 Para Nationals). |
{
"type": "object",
"fields": {
"name": "string — competition name",
"sport": "string — sport type",
"endDate": "string — ISO datetime of competition end",
"facility": "string — venue name",
"location": "string — city and state",
"startDate": "string — ISO datetime of competition start"
},
"sample": {
"data": {
"ID": 8035,
"name": "2025 Toyota USATF Outdoor Championships",
"sport": "Outdoor Track",
"season": "2025",
"endDate": "2025-08-09T00:00:00",
"facility": "Hayward Field",
"location": "Eugene, OR",
"startDate": "2025-07-31T00:00:00"
},
"status": "success"
}
}About the results.usatf.org API
This API exposes 5 endpoints covering USATF track and field competitions on results.usatf.org, including meet metadata, day-by-day event schedules, per-event results with athlete marks and placements, and full biographical and competition history profiles from the World Athletics database. The get_event_results endpoint alone returns structured entries with athlete names, marks, placements, bib numbers, and team affiliations keyed by entry ID.
Meet Information and Schedules
The get_competition_info endpoint accepts a meet_id parameter and returns top-level metadata for a USATF competition: name, sport type, facility, location (city and state), and ISO-formatted start and end dates. Known meet IDs include 8035 for the 2025 Toyota USATF Outdoor Championships. If an unrecognized meet_id is passed, the endpoint returns an upstream_error rather than empty data.
The get_schedule_by_day endpoint returns all events scheduled for a given meet. Filtering by a specific date uses the date parameter in YYYY-MM-DD format; omitting it returns the full schedule across all days. Each event object includes N (name), RN (round name), T (start time), S (status), and an event_key used to query results. A parallel endpoint, get_para_nationals_schedule_by_day, returns the same structure for USATF Para Nationals events and accepts the same date filter.
Event Results
The get_event_results endpoint takes a meet_id and an event_key — formatted as EN-R where EN is the event number and R is the round — and returns the full result set for that event. The ED field is an object keyed by entry ID; each entry carries A (athlete info including name), M (mark or time), P (placement), BIB, and TN (team name). The top-level response also includes event name N, round name RN, and status S. If the event key is not found, the endpoint returns stale_input.
Athlete Profiles
The get_athlete_profile endpoint retrieves biographical and historical performance data for individual athletes from the World Athletics (IAAF) database. The athlete_id comes from the ED entries returned by get_event_results. The response includes basicData (given name, family name, country code, birth date, affiliation), personalBests (best marks per discipline), resultsByYear (competition results grouped by year and discipline), and honours (major competition podium finishes grouped by category such as World Championships or National Championships). Note that para-only athletes without IAAF profiles will return an upstream_error.
- Build a live results tracker for the USATF Outdoor Championships using get_event_results marks and placements
- Generate a daily schedule view for fans by filtering get_schedule_by_day with a specific date parameter
- Compare an athlete's personal bests across disciplines using the personalBests field from get_athlete_profile
- Display full competition honours histories for US track and field athletes sourced from the World Athletics database
- Monitor event status changes throughout a meet day using the S (status) field from schedule and result endpoints
- Build a para athletics schedule display using get_para_nationals_schedule_by_day filtered by competition date
- Cross-reference athlete team affiliations and marks across multiple events using TN and M fields from get_event_results
| 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.