# Pred — 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 all gaming assets from the Pred.gg platform including hero icons, ability icons, skin portraits, item icons, perk icons, and rank icons. Use these images to build gaming apps, guides, or community tools with official Pred.gg graphics.

**Category:** Entertainment | **Website:** [pred.gg/gql](https://pred.gg/gql) | **Docs:** [parse.bot/marketplace/7d714dfc-630c-406e-9efe-7d77a382eaac/pred-gg-api](https://parse.bot/marketplace/7d714dfc-630c-406e-9efe-7d77a382eaac/pred-gg-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-pred-gg-api-7d714dfc/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_images

Retrieve all deduplicated image URLs across heroes, items, perks, and ranks with metadata about their source category and field type. Makes multiple GraphQL calls internally to collect images from all entity types. Returns a flat list of unique image URLs with provenance metadata.

**Estimated cost:** Metered

_No parameters required._

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

### get_hero

Retrieve a single hero by slug with full ability details, skins, perks, roles, and classes. Returns the same hero shape as the list endpoint but for one specific hero identified by its URL slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Hero slug identifier as used in the URL path (e.g., 'feng-mao', 'grux', 'sparrow', 'narbash'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pred-gg-api-7d714dfc/get_hero \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_heroes

Retrieve all heroes with their abilities, default skins, perks, roles, classes, and descriptions. Icon hashes are resolved to full image URLs. Returns the complete hero roster in a single request.

**Estimated cost:** Metered

_No parameters required._

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

### get_item

Retrieve a single item by slug with full stats, effects, and build path details. Returns the same item shape as the list endpoint but for one specific item identified by its URL slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Item slug identifier as used in the URL path (e.g., 'soul-chalice', 'heroic-guard', 'demolisher'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pred-gg-api-7d714dfc/get_item \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_items

Retrieve all items with stats, effects, build paths, pricing, rarity, and slot type. Hidden items are excluded by default unless show_hidden is set to true. Returns the full item catalog in a single request.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `show_hidden` | boolean | No | Include hidden/deprecated items in the results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pred-gg-api-7d714dfc/get_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"show_hidden":"<boolean>"}'
```

### get_perks

Retrieve all hero perks with descriptions, slot info, and associated hero data. Each perk is linked to its owning hero. Returns the full perk catalog in a single request.

**Estimated cost:** Metered

_No parameters required._

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

### get_ranks

Retrieve all rating seasons and their rank tiers (Bronze through Paragon) with rating thresholds and icons. Each season contains a full set of rank tiers with min/max rating boundaries.

**Estimated cost:** Metered

_No parameters required._

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

### get_versions

Retrieve all game patch versions with release dates, patch types, and patch notes URLs. Covers the full version history from early access through the current release.

**Estimated cost:** Metered

_No parameters required._

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