# Serebii — 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 for comprehensive Pokémon data including stats, abilities, and game information, and discover upcoming Pokémon events and Sleep game details all from one place. Find specific Pokémon by name or browse complete Pokédex information to plan your team and stay updated on the latest events.

**Category:** Entertainment | **Website:** [serebii.net/](https://serebii.net/) | **Docs:** [parse.bot/marketplace/46941f4b-ffe6-4289-b637-0a7b0eabaa1d/serebii-net-api](https://parse.bot/marketplace/46941f4b-ffe6-4289-b637-0a7b0eabaa1d/serebii-net-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-serebii-net-api-46941f4b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_events

Get Pokémon event distribution information for a specific year. Returns event details including description, dates, games, and associated Pokémon. Events are scraped from Serebii's event archive pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | integer | No | Year to fetch events for (e.g. 2020, 2023, 2024) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-serebii-net-api-46941f4b/get_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<integer>"}'
```

### get_pokemon_comprehensive

Get comprehensive data for a Pokémon, including stats, types, evolutions, and Pokémon Sleep data (sleep type, specialty, main skill). Fetches from the Scarlet/Violet Pokédex page and supplements with Sleep database info. Not all Pokémon have Sleep data; those fields are null when absent.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Pokémon name (e.g., 'Bulbasaur', 'Pikachu', 'Charizard') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-serebii-net-api-46941f4b/get_pokemon_comprehensive \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```

### search_pokemon

Search for Pokémon based on filters. Uses the Pokémon Sleep database (223 Pokémon) as the searchable data source. Supports filtering by name substring, type, and sleep type. Returns a list of matching Pokémon summaries. At least one filter or no filters (returns first N) is accepted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return |
| `query` | string | No | Search by Pokémon name (case-insensitive substring match) |
| `sleep_type` | string | No | Filter by Sleep Type: 'Dozing', 'Snoozing', or 'Slumbering' |
| `type` | string | No | Filter by Pokémon type (lowercase, e.g. 'fire', 'grass', 'electric', 'water', 'psychic') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-serebii-net-api-46941f4b/search_pokemon \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>","sleep_type":"<string>","type":"<string>"}'
```