Developer overview
Read Bloss data with the Platform API, let AI agents such as Claude read it through MCP, and get alerts with webhooks.
Bloss gives you three ways to get data out. All of them are read-only: nothing in Bloss can be changed through them.
Platform API
Read your own data as a creator or coach (free), or a brand's data as its admin on the Scale plan: creators, videos, analytics, payouts and more.
AI agents (MCP)
Connect Claude, ChatGPT, Cursor and other agents, and ask questions about your Bloss data in plain language.
Webhooks
Bloss alerts your Discord channel or your own URL when a video crosses a view target, a video link goes dead, a creator stops posting, and more.
Which one should I use?
| You want to | Use |
|---|---|
| Read your earnings, videos and brands as a creator, or your students as a coach | The Platform API with a personal token. Free. |
| Read a brand's creators, videos, analytics or pay from your own code | The Brand API, part of the Platform API. Scale plan. |
| Ask an AI agent about your data | The MCP server. Same rules as the Platform API. |
| Be told when something happens in a brand | Webhooks. |
| Keep an existing campaign integration running | The Campaign API (v0). It keeps working; new integrations should use the Platform API. |
Quickstart
Create a token
Go to AccountAPI tokens and click Create token. Tick Your account: name, email, roles and memberships, plus whatever else you need, and copy the token. It starts with blsp_ and is shown only once. See API tokens.
See who you are
GET /me returns your account and every brand you belong to, with the ids the other endpoints take:
curl https://www.bloss.app/api/v1/me \
-H "Authorization: Bearer $BLOSS_API_TOKEN"Read something
For example, the numbers on your creator Dashboard (views, followers and top videos across every brand) for October. This needs the Your creator profile, stats, brands, videos, bounties and games permission:
curl "https://www.bloss.app/api/v1/creator/stats?from=2026-10-01&to=2026-10-31" \
-H "Authorization: Bearer $BLOSS_API_TOKEN"Every endpoint is in the Platform API reference.
What you can build
- Client reporting: show an agency client live reach and spend for their campaign with the Brand API.
- Budget alerts: read campaign spend with a
prepaymentand act whenatThresholdturnstrue. - A creator dashboard: your views, earnings and payouts across every brand in one place.
- Coaching check-ins: which students haven't posted this week, and how their views are trending.
- An AI assistant: let Claude answer "how did we do this week?" through MCP.
Read-only, and only what you can see
The API and MCP server read only what you can already see in Bloss, within the permissions you give each token. Nothing can be changed, posted or paid through them.
In this section
Platform API
- Platform APIRead your own Bloss data as a creator or coach, or your brand's data on the Scale plan, with the read-only Platform API.
- API tokensCreate a personal API token for the Platform API or an AI agent, choose what it can read, and revoke it when you're done.
- AI agents (MCP)Connect Claude, Cursor and other AI agents to the Bloss MCP server so they can read your Bloss data, or your brand's, and answer questions about it.
- Platform API referencePlatform API reference, Who am I GET, The videos behind one day of the analytics chart GET and more65 guides
Campaign API (v0)
- Campaign API keysCreate, use and revoke brand keys for the Campaign API (v0).
- Core conceptsCampaigns, cycles, spend, pairs, tags and creator groups — how the Campaign API models your brand.
- Campaign API errorsStatus codes and the error format the Campaign API returns.
- Campaign API referenceCampaign API reference, List payout cycles GET, List creator groups and their members GET and more7 guides
Last reviewed Oct 22, 2026