Public API

Read-only, no authentication, aggressively cached. Perfect for airdrop sybil scripts, Discord bots or a snapshot before your next campaign. Please keep automated traffic polite - the directory is refreshed every few minutes at the edge.

Endpoints

GEThttps://creatorlist.lol/api/accounts

Paginated, cached directory search. Identical filter grammar to the UI.

q	string	Match against @username or display name.
sort	recent \| quality_desc \| quality_asc \| followers_desc \| username_asc	Sort order.
verdict	100% Human \| AI Assisted \| Full AI Bot	Account verdict filter.
aiPost	No \| Partial \| Yes	AI-for-post filter.
aiComment	Yes \| No	AI-automation-for-comment filter.
engagement	Healthy \| Low \| Botted	Engagement verdict filter.
minQuality / maxQuality	1 - 10	Quality bar range.
minFollowers	number	Lower bound on follower count.
page / pageSize	number	Pagination (pageSize capped at 100).
format=csv	flag	Download up to 5,000 matching rows as CSV.

GEThttps://creatorlist.lol/api/health

Uptime probe. Reports database reachability and the indexed row count.

Example

bash

# Confirmed bot farms only
curl "https://creatorlist.lol/api/accounts?verdict=Full%20AI%20Bot&maxQuality=4"

# Clean allowlist for your airdrop, as CSV
curl -o humans.csv "https://creatorlist.lol/api/accounts?verdict=100%25%20Human&minQuality=8&format=csv"

Authenticated endpoints

These power the reviewer dashboard at /admin and require the cl_admin session cookie.

POST/api/admin/loginExchange the shared ADMIN_SECRET for a signed 12-hour HttpOnly cookie.

GET/api/fetch-profile?username=nurFree X profile resolver (FxTwitter → syndication → follow-button).

GET/api/admin/submissions?status=pendingReview queue for community reports.

POST/api/admin/submissionsApprove or reject a report: { "action": "approve", "id": 7 }.

GET | POST | DELETE/api/admin/accountsCreate, update and delete directory entries.

Scraping friends: if you build something useful on top of this, tell us and we will link it. If you hammer the endpoints, the in-memory rate limiter will start returning 429 responses.