Platform API reference
Every Platform API v1 endpoint, with its parameters, response fields, code samples and a playground.
Base URL: https://www.bloss.app/api/v1. Every request needs a personal API token in an Authorization: Bearer blsp_… header. Brand endpoints also accept a brand key (blsk_…). Start with the Platform API page for pagination, dates, errors and rate limits.
Open an endpoint in the sidebar to see its parameters and its response. The same description is available as an OpenAPI 3.1 document at https://www.bloss.app/api/v1/openapi.json.
Creator API
Free, for your own work as a creator or a coach.
| Area | What you can read |
|---|---|
| Account | Who you are, and every brand you belong to with your role in each (GET /me). |
| Creator | Your marketplace profile, your stats, the brands you create for, your videos, daily views, the team's views where a brand shares them, bounties, Streak Survivor, support tickets and cross-posts. |
| Earnings | Your earnings across brands, payouts, referral payouts and payout setup. These need the Money data permission. |
| Coaching | Your coach profile, students, notes, stages, accountability rules and invitations. |
Brand API
For admins of a brand on the Scale plan, under /brands/{brandId}. A brand on another plan answers 403 plan_required. See Brand API.
| Area | What you can read |
|---|---|
| Brand | Settings, the team and admin invitations, invite links, recruitment applications, support tickets, and API keys and webhooks (metadata only). |
| Creators | The roster, profiles, account alerts, views per day, account analytics, posting compliance and violations, reviews, trials, creator groups, bounties and claims, and Streak Survivor games. |
| Videos and analytics | Videos, sets, tags with their stats, tracked videos, payout cycles, campaign reach (summary, by day, by tag) and the videos behind one day of the analytics chart. |
| Money | Pay rules, payout cycles and payouts, a creator's pay, the Base pay queue, the Bonus pay board, referral payouts, funds, campaign spend and the subscription. Full admins only, with the Money data permissions; the subscription is the agency owner's only. |
Playground requests are real
Each endpoint page has a playground: paste your token, fill in the parameters and send a real request. It returns your actual data. Nothing can be changed: every endpoint is read-only.
Your token stays in this browser
A token you paste into the playground is saved in this browser's local storage, so it's still there next time. Use a dedicated token with only the permissions you're testing, and revoke it when you're done, or clear this site's data in your browser.
Last reviewed Oct 22, 2026
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.
Who am I GET
Your account, your creator and coach profiles, and every brand you belong to, with your role in each. Start here to find the ids other endpoints take.