REST API
Quick start
Your first request to the FanConvert public API, in curl, JavaScript and Python.
The public API reads your creators, conversations, fans, sales, statistics, scripts, media and emergencies, with the same isolation as the dashboard. It can never send a message to a fan.
Base URL: https://app.fanconvert.ai/public/v1
1. Create a key
In FanConvert: Réglages › API & MCP › Nouvelle clé (Settings › API & MCP › New key), choosing Connecter un outil ou un développeur (API). Details: Create a key. Keep it in an environment variable, never in code.
2. First request
GET /me describes the key in use: its creators, permissions and expiry.
curl https://app.fanconvert.ai/public/v1/me \
-H "Authorization: Bearer $FANCONVERT_API_KEY"{
"keyId": "3f1c…",
"organizationId": "org_…",
"scopes": ["creators:read", "statistics:read"],
"creatorIds": ["emma-demo"],
"expiresAt": "2026-12-07T05:40:00Z"
}3. List your creators
curl https://app.fanconvert.ai/public/v1/creators \
-H "Authorization: Bearer $FANCONVERT_API_KEY"Next
- Authentication and permissions
- Pagination, Errors, Rate limits
- Webhooks: receive sales without polling
- Full reference
Last updated on