# 247Sports — 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.

> Access recruit rankings, team rankings, and college football message board discussions from 247Sports to track player evaluations and community insights. Search specific board topics and view detailed post content to stay updated on recruiting news and team analysis.

**Category:** Sports | **Website:** [247sports.com/](https://247sports.com/) | **Docs:** [parse.bot/marketplace/6791a230-b7ee-4e0f-954c-a7f2ae15e2a3/247sports-com-api](https://parse.bot/marketplace/6791a230-b7ee-4e0f-954c-a7f2ae15e2a3/247sports-com-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-247sports-com-api-6791a230/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_board_topics

List paginated topics from a 247Sports message board. Each page returns up to 50 topics. Invalid or restricted board IDs may return an empty topics list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_id` | string | No | Numeric ID of the message board. |
| `page` | integer | No | Page number to fetch. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-247sports-com-api-6791a230/get_board_topics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_id":"<string>","page":"<integer>"}'
```

### get_rankings

Retrieve paginated recruit rankings for a sport and recruiting class year. Each page returns approximately 50 recruits ordered by overall rank. Supports Football and Basketball sports.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to fetch. |
| `sport` | string | No | Sport name. |
| `year` | string | No | Recruiting class year (e.g. 2025, 2026). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-247sports-com-api-6791a230/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sport":"<string>","year":"<string>"}'
```

### get_team_rankings

Retrieve team recruiting rankings from the internal API. Returns teams ranked by recruiting class strength with commit statistics and star counts. Paginated server-side (10 per page by default).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport_id` | integer | No | Sport ID. |
| `year` | integer | No | Recruiting year (e.g. 2025, 2026). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-247sports-com-api-6791a230/get_team_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sport_id":"<integer>","year":"<integer>"}'
```

### get_topic_content

Retrieve all posts from a specific topic thread. VIP-only topics may return limited content. Each post includes username, content body, and VIP status. Requires the full topic URL as input.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `topic_url` | string | Yes | Full URL of the topic thread (e.g. https://247sports.com/board/30/contents/message-board-rules-128528768/). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-247sports-com-api-6791a230/get_topic_content \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic_url":"<string>"}'
```