# Dotabuff — 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 Dota 2 hero performance metrics from Dotabuff, including win rates, pick rates, ban rates, item builds, and lane statistics. Retrieve meta trend data and detailed per-hero attributes, roles, and ability information to support hero analysis and draft research.

**Category:** Sports | **Website:** [dotabuff.com/](https://dotabuff.com/) | **Docs:** [parse.bot/marketplace/7f1a5ae0-1a48-4f7d-9e99-8b5ce1804c5b/dotabuff-com-api](https://parse.bot/marketplace/7f1a5ae0-1a48-4f7d-9e99-8b5ce1804c5b/dotabuff-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-dotabuff-com-api-7f1a5ae0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_hero_details

Retrieve detailed statistics for a specific hero including base attributes (Strength, Agility, Intelligence with growth), roles, and popular items with match counts and win rates. Items are fetched from a secondary page and include the top 15 most-used items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hero_slug` | string | Yes | The hero's URL slug (e.g., 'axe', 'storm-spirit', 'outworld-destroyer'). Obtainable from get_heroes_overview results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dotabuff-com-api-7f1a5ae0/get_hero_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hero_slug":"<string>"}'
```

### get_heroes_overview

Retrieve an overview of all heroes with statistics like win rate, pick rate, and ban rate. The view parameter selects the statistical dimension: winning (default) shows heroes sorted by win rate, played by pick rate, facets by hero facets with tier and rates, lanes by lane presence, damage by damage output, economy by gold metrics. Returns all ~127 heroes in a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `view` | string | No | The statistical view to fetch. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dotabuff-com-api-7f1a5ae0/get_heroes_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"view":"<string>"}'
```

### get_lane_stats

Retrieve hero performance statistics for a specific lane. Each hero entry includes lane presence percentage, win rate, KDA ratio, gold per minute (GPM), and experience per minute (XPM). Returns all heroes that have data for the requested lane, sorted by presence.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lane` | string | No | The lane to fetch statistics for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dotabuff-com-api-7f1a5ae0/get_lane_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lane":"<string>"}'
```

### get_meta_trends

Retrieve meta trends showing win rate and pick rate changes over the recent period for all heroes. Heroes are sorted by biggest win rate change (positive first). Each entry shows the starting value, current value, and absolute change for both win rate and pick rate.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dotabuff-com-api-7f1a5ae0/get_meta_trends \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```