Skip to main content

​
Base URL

https://api.boosterberg.com/v1
Beta environment: 
https://api.boosterberg.com-beta.com/v1

​
Authentication

Most endpoints require a Bearer token. Authentication works in two steps:
  1. Sign in to Boosterberg via Facebook (the only login method currently available)
  2. The server exchanges your Facebook token for a Boosterberg-specific Bearer token — this is the token you use for all API calls
Pass the token in the Authorization header: 
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.boosterberg.com/v1/user/detail
Endpoints marked as public (presets browsing, geo locations, agency details, reviews) do not require authentication.
Getting your Bearer token for testing: Call POST /user/login-fb or POST /user/signup-fb with a valid Facebook access token. The response includes an access_token field — that’s your Bearer token for all subsequent API calls.

​
Supported Page & Account Types

Boosterberg creates paid ads on behalf of your Facebook and Instagram pages. The following account types are supported:
PlatformAccount TypeSupported
FacebookBusiness PageYes
FacebookPersonal ProfileNo
InstagramBusiness Account (linked to a Facebook Business Page)Yes
InstagramCreator AccountNo
InstagramPersonal AccountNo
Instagram accounts must be Business Accounts connected to a Facebook Business Page. Personal and Creator Instagram accounts cannot be used because the Meta Ads API requires a Business Page linkage to run promotions.

​
Response Format

Success responses return the data directly — an object, array, boolean, or integer depending on the endpoint. Error responses follow this structure: 
{
  "name": "Bad Request",
  "message": "Description of what went wrong",
  "code": "ERROR_CODE",
  "status": 400
}

​
API Sections

Authentication

Login and signup via Facebook

Campaigns

Create, manage, and monitor boosting campaigns

Posts

View and manage individual boosted posts

Presets

Browse and use campaign templates

Billing

Billing information and invoices

Agencies

Agency directory and management