Developers

b00st.com Campaign API

Create, update and report on b00st.com ad campaigns. Each API token is scoped to one organization; request one from developers@b00st.com.

Download OpenAPI (YAML)OpenAPI (JSON)

Basics

  • Base URL: https://app.b00st.com
  • Version: 20261015. Every path starts with its version date.
  • Auth: send Authorization: Bearer <token>. Each token is scoped to one organization. Request one from developers@b00st.com.
  • Rate limits: over the limit returns HTTP 429 with a Retry-After header.

Endpoints

  • get/api/20261015/campaigns

    Retrieve a paginated list of campaigns

  • post/api/20261015/campaigns

    Create a new campaign

  • put/api/20261015/campaigns

    Update one or more campaigns

    Applies the same changes to every listed campaign. Changing targetLink also repoints each campaign's short link. Tokens can only update campaigns in their own organization.

  • delete/api/20261015/campaigns

    Delete one or more campaigns

  • get/api/20261015/campaigns/data

    Retrieve aggregated summary stats for all supported platforms

    API-key-authenticated callers are rate limited and receive HTTP 429 with a Retry-After header when they exceed the configured limit.

  • post/api/20261015/campaigns/data

    Retrieve aggregated summary stats (body PIDs)

    API-key-authenticated callers are rate limited and receive HTTP 429 with a Retry-After header when they exceed the configured limit.

  • get/api/20261015/campaigns/data/{platform}

    Retrieve aggregated summary stats for a single platform

    API-key-authenticated callers are rate limited and receive HTTP 429 with a Retry-After header when they exceed the configured limit.

  • post/api/20261015/campaigns/data/{platform}

    Retrieve detailed timeseries or platform-specific analytics

    For non-Dub platforms, this returns timeseries-compatible data. API-key-authenticated callers are rate limited and receive HTTP 429 with a Retry-After header when they exceed the configured limit.

Request and response schemas, parameters and examples are in the OpenAPI spec. Load it into Postman, Insomnia or your code generator, or hand it to an AI agent.