# Namemc — 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.

> Look up Minecraft player profiles to find usernames, availability drop times, search popularity, cape holders, and detailed player information including UUIDs and skin history. Search and discover Minecraft player data across NameMC's database to track name changes and availability.

**Category:** Entertainment | **Website:** [namemc.com/](https://namemc.com/) | **Docs:** [parse.bot/marketplace/e44e16d6-6c29-4128-b147-92661e69038f/namemc-com-api](https://parse.bot/marketplace/e44e16d6-6c29-4128-b147-92661e69038f/namemc-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-namemc-com-api-e44e16d6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cape_users

List Minecraft usernames of players who own a specific cape type. Returns a paginated list of usernames. Cape types are limited to the site's known cape identifiers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cape_type` | string | Yes | Cape type to look up. |
| `page` | integer | No | Page number for pagination (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-namemc-com-api-e44e16d6/get_cape_users \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cape_type":"<string>","page":"<integer>"}'
```

### get_names

Retrieve Minecraft usernames that are about to become available (dropping). Each entry includes the username, its scheduled drop time, and the number of times it has been searched. Results are ordered by drop time ascending. Pagination is cursor-based via a time parameter in the URL. The endpoint returns one page at a time; pass the next_url from a prior response to advance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max number of results to return. Omitting returns all names on the page. |
| `url` | string | No | Full URL for pagination, obtained from next_url in a prior response. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-namemc-com-api-e44e16d6/get_names \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","url":"<string>"}'
```

### get_profile

Retrieve detailed profile information for a Minecraft player by username. Returns the player's UUID, monthly profile view count, whether the profile has been claimed by its owner, and the timestamp of the most recent skin upload. Returns input_not_found when the username does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Minecraft username to look up (case-insensitive, 3-16 characters). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-namemc-com-api-e44e16d6/get_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_raw_html

Get the raw HTML content of any page on NameMC. Accepts relative paths or full URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The URL or path to fetch (e.g. '/minecraft-names' or 'https://namemc.com/capes'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-namemc-com-api-e44e16d6/get_raw_html \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```