# Tfrrs — 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.

> Search athletes, view their performance history, and look up detailed results from track and field meets including event standings and team rosters. Get comprehensive information about cross country and track competitions with athlete times, placements, and meet details all in one place.

**Category:** Sports | **Website:** [tfrrs.org/](https://tfrrs.org/) | **Docs:** [parse.bot/marketplace/9bece3bf-9c0f-449e-a946-22b339070d1a/tfrrs-org-api](https://parse.bot/marketplace/9bece3bf-9c0f-449e-a946-22b339070d1a/tfrrs-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-tfrrs-org-api-9bece3bf/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_athlete_results

Get detailed performance results for a specific college athlete, including personal bests and competition history. Returns track/field and cross country performances with marks, placements, and meet information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_id` | string | Yes | Numeric athlete ID from TFRRS (e.g., '123456', obtainable from search_athlete results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tfrrs-org-api-9bece3bf/get_athlete_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"athlete_id":"<string>"}'
```

### get_event_results

Get results for a specific event within a meet. Returns individual athlete placements, marks, and team affiliations. The event_url is obtained from get_meet_results events array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_url` | string | Yes | Full URL of the event results page from get_meet_results events[].url (e.g., 'https://tfrrs.org/results/{meet_id}/{event_id}/{Meet_Name}/{Event_Name}') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tfrrs-org-api-9bece3bf/get_event_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_url":"<string>"}'
```

### get_meet_results

Get basic information and event listings for a specific college meet. Returns the meet name, list of event result page URLs, and a partial list of athletes found. Only college-level meets indexed by TFRRS will have populated event lists; high school or unindexed meets may return empty arrays.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meet_id` | string | Yes | Numeric meet ID from TFRRS (e.g., '12345') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tfrrs-org-api-9bece3bf/get_meet_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"meet_id":"<string>"}'
```

### get_team_roster

Get the roster of athletes for a specific college team. Returns the team name and list of athletes with their TFRRS IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_url` | string | Yes | Path or full URL of the team page, following the format '/teams/tf/{STATE}_college_{m\|f}_{School}.html' (e.g., '/teams/tf/MA_college_m_Harvard.html' for Harvard men's team) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tfrrs-org-api-9bece3bf/get_team_roster \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_url":"<string>"}'
```

### search_athlete

Search for college athletes by name on TFRRS. Returns matching athletes from the NCAA/NAIA/NJCAA database. Only athletes registered in TFRRS (current or recent college athletes) will return results; professional or post-collegiate athletes not in the system will return an empty array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Athlete name to search for (e.g., 'Emma Coburn') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tfrrs-org-api-9bece3bf/search_athlete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```