# Racecenter Letour — 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.

> Track live Tour de France race updates by accessing real-time rider positions, detailed stage information, and current general classification standings. Monitor how your favorite cyclists are performing throughout each stage and their overall ranking in the competition.

**Category:** Sports | **Website:** [racecenter.letour.fr/en](https://racecenter.letour.fr/en) | **Docs:** [parse.bot/marketplace/6b367818-afc0-4257-9227-8ea9f878f34f/racecenter-letour-fr-api](https://parse.bot/marketplace/6b367818-afc0-4257-9227-8ea9f878f34f/racecenter-letour-fr-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-racecenter-letour-fr-api-6b367818/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_general_classification

Returns the general classification (overall standings) after a given stage. Each entry includes rider position, time, gap to leader, and bonuses/penalties. Available once intermediate or final timing for the stage has been published.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stage_number` | integer | Yes | Stage number (1-21) after which to retrieve the GC standings. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racecenter-letour-fr-api-6b367818/get_general_classification \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stage_number":"<integer>"}'
```

### get_live_positions

Returns live rider group positions during a stage. Each group contains its GPS coordinates, speed, distance remaining, time gap to the leader, jersey indicators, and the list of riders in that group. Data updates every few seconds during the race; returns empty groups when the stage is not active.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stage_number` | integer | Yes | Stage number (1-21) to get live positions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racecenter-letour-fr-api-6b367818/get_live_positions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stage_number":"<integer>"}'
```

### get_stage_info

Returns stage details for the current Tour de France edition. When stage_number is supplied, returns that single stage; when omitted, returns all 21 stages. Each stage includes route (departure/arrival cities), distance, scheduled times, type code, and cancellation status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stage_number` | integer | No | Stage number (1-21). Omit to retrieve all stages. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racecenter-letour-fr-api-6b367818/get_stage_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stage_number":"<integer>"}'
```