> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clanker.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Creators

Endpoints for searching creators and retrieving their tokens and earnings.

### GET `/api/search-creator`

Search creators by Farcaster username, Twitter handle, or wallet address. Returns matching tokens with trust status.

**Authentication:** Public

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `q` | `string` | Yes | — | Username, handle, or address. |
| `trustedOnly` | `boolean` | No | false | Only return trusted deployers. |
| `sort` | `"asc" \| "desc"` | No | desc | Sort by deployment date. |
| `platform` | `"farcaster" \| "twitter"` | No | — | Platform filter. |
| `limit` | `number` | No | 20 | Page size (1–50). |
| `offset` | `number` | No | 0 | Offset. |

**Response:** Tokens with trust metadata, user info, and pagination.

```json theme={null}
{
  "tokens": [ { "contract_address": "0x...", "trustStatus": { ... }, ... } ],
  "users": [ ... ],
  "total": 100,
  "hasMore": true
}
```

***

### GET `/api/creator-earnings/{tokenAddress}`

Returns creator fee earnings for a token.

**Authentication:** Public

**Path Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `tokenAddress` | `address` | Yes | — | Token contract address. |

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `chainId` | `number` | No | 8453 | Chain ID (defaults to Base). |

**Response:** Total WETH claimed and per-recipient breakdown.

```json theme={null}
{
  "tokenAddress": "0x...",
  "chainId": 8453,
  "wethAddress": "0x...",
  "totalWethClaimed": "1.5",
  "claimCount": 3,
  "claimsByRecipient": { "0xabc...": "0.75", "0xdef...": "0.75" }
}
```

> Cached for 1 hour.

***

### GET `/api/creator/{address}`

Returns a creator profile with stats.

**Authentication:** Public

**Path Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `address` | `address` | Yes | — | Creator wallet address. |

**Response:** Creator user info and launch stats.

```json theme={null}
{
  "user": { "fid": 1, "username": "...", ... },
  "address": "0x...",
  "stats": { "tokensLaunched": 12 }
}
```

> Cached for 30 seconds.

***

### GET `/api/get-clankers-deployed/by-following`

Returns tokens deployed by accounts that a given FID follows.

**Authentication:** Public

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `fid` | `string` | Yes | — | Farcaster ID. |
| `includeUser` | `boolean` | No | false | Include user data. |

**Response:** Tokens and follower info.

```json theme={null}
{
  "clankers": [ ... ],
  "followers": [ ... ]
}
```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.