# Platform API reference (/docs/developers/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](/docs/developers/api-tokens) in an `Authorization: Bearer blsp_…` header. Brand endpoints also accept a [brand key](/docs/developers/api-tokens#brand-keys) (`blsk_…`). Start with the [Platform API](/docs/developers/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 [#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 [#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](/docs/developers/platform-api#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. |

<Callout title="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.

</Callout>

<Callout type="warn" title="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](/docs/developers/api-tokens#revoke-a-token) when you're done, or
  clear this site's data in your browser.

</Callout>