TEASEDocs
ProductsClubHow-to

Export the full fan roster and conversations

Download a ZIP of your whole fan roster — profiles, conversations, and methodology — for offline analysis or an AI agent.

Who this is for: workspace owners and platform operators who want the raw data, not just the grid.

The Export button lives at the top of the same All Fans screen the DM-history scan runs on. It doesn't download anything by itself — it opens a dialog explaining exactly what's in the archive first; the actual ZIP only starts on Download.

What's in the ZIP

FileContents
fans.csvOne row per fan — name, country, source, earned, tags, profile.
fans/<id>.jsonPer fan: info + our portrait + the full captured conversation.
README.txtA manifest of the archive.
methodology.txtHow source/country/profile are detected, plus the current honest accuracy ceiling — source ≈65%, country ≈78% — and why (an organic fan only names their source about 1 in 10 times; a too-short chat leaves no cultural marker for country).
ai-prompt.txtThe exact prompt the AI uses to attribute every fan — nothing hidden.
SKILL.mdA drop-in skill for your own AI agent, resolving source/country through the API.
curl "https://app.tease.link/api/admin/fans/export?limit=5000" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -o fans-export.zip

limit is capped at 5000 fans. Every read inside the export is strictly owner-scoped — nothing in the archive can belong to another tenant.

DLP-gated: a daily quota, and 2FA step-up when enabled

The export is checked against a daily export quota before the ZIP is built, and a caller with 2FA enabled must supply a fresh step-up code. The gate runs before anything is built, so a rejected request fails cleanly (a clean 401/429) — it never hands back a half-built archive.

Reading one fan without the ZIP

For a single fan, GET /api/admin/fans/{fan_id}/full returns the exact same object as that fan's fans/<id>.json file — info, portrait, and the full conversation — as plain JSON, so an integration doesn't need to download and unzip the whole roster to look up one fan.

What's next

On this page