Which creator this API key belongs to
Returns the creator account behind the key, plus metadata about the key itself.
/api/external/meReturns the creator account behind the key, plus metadata about the key itself.
Call it once at startup to confirm the key works and to learn the creator's id, username and accountType — posting to the For You feed needs CREATOR or AGENCY, and every link surface needs a username. The key block tells you which integration the key was minted for and its rate-limit tier, matching the X-RateLimit-Tier header.
Authentication
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
Responses
| Name | Type | Description | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id | string | The creator’s Dropfans user id. Stable — safe to key your own records on. | |||||||||||||||
username | string | null | The creator’s public @handle, without the @. Null until the creator picks one — several link surfaces (GET /api/external/links, the post url) need it. | |||||||||||||||
name | string | null | Display name. Null when unset. | |||||||||||||||
image | string | null | Profile image URL. Null when the creator has no avatar. Format: uri | |||||||||||||||
accountType | string | Account class of the key’s owner. Posting to the For You feed requires CREATOR or AGENCY. One of: CONSUMER, CREATOR, AGENCY | |||||||||||||||
key | object | Metadata about the API key used on this request (added 2026-08-19).Show child attributes
|
{
"id": "clx2f8a1b0001qw3k",
"username": "valeria",
"name": "Valeria",
"image": "https://cdn.dropfans.io/valeria/profile.jpg",
"accountType": "CREATOR",
"key": {
"name": "KVIQA",
"app": {
"slug": "kviqa",
"name": "KVIQA"
},
"tier": "app"
}
}Errors
| Status | Body | When |
|---|---|---|
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
Rate limiting
Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.
Code samples
curl "https://www.dropfans.io/api/external/me" \
-H "Authorization: Bearer $DROPFANS_API_KEY"const res = await fetch(`https://www.dropfans.io/api/external/me`, {
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
},
});
console.log(await res.json());import os
import requests
res = requests.get(
"https://www.dropfans.io/api/external/me",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())Notes
The accountType and key fields were added with the public launch (2026-08-19); id, username, name and image are unchanged from the original response.
Questions? [email protected]