API Reference

Complete API documentation for building custom integrations with Fanaura.

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY
GET
/v1/fans

List all fans in your database

FansGET
/v1/fans/:id

Get details for a specific fan

FansPOST
/v1/campaigns

Create a new pre-save campaign

CampaignsGET
/v1/campaigns/:id

Get campaign details and analytics

CampaignsGET
/v1/heatmap

Get geographic distribution of fans

AnalyticsPOST
/v1/ai/query

Query fan data using natural language

AI

Example Request

curl -X GET https://api.fanaura.com/v1/fans \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Official SDKs

JavaScript / TypeScript

npm install @fanaura/sdk

Python

Coming soon

Ruby

Coming soon

Detailed API documentation coming soon