Guides

Overview

Programmatically create and manage ad campaigns on Meta and TikTok through a single unified interface.

Advertising API

The Symphony Advertising API lets you programmatically create, manage, and monitor paid ad campaigns on Meta (Facebook & Instagram) and TikTok — through a single unified interface.

One Interface, Two Platforms

The core design principle: you integrate once using a unified CampaignInput schema, and Symphony handles all platform-specific translation behind the scenes.

Your App  ──→  POST /campaigns { adPlatform: "meta", campaignInput: {...} }
                                                │
                                        Symphony API
                                       ┌────────┴────────┐
                                       ▼                  ▼
                                  Meta Ads API      TikTok Ads API
                                  (Facebook,        (TikTok)
                                   Instagram)

You send the same CampaignInput structure regardless of platform. Symphony maps your targeting, budgets, creatives, and conversion settings to each platform's native API format.

Key Capabilities

CapabilityDescription
Create campaignsLaunch link-click or conversion campaigns on Meta or TikTok
Manage budgets & datesUpdate lifetime budgets, extend end dates, pause/unpause
Search targeting inputsFind interests, geographies, and languages per platform
Pull analyticsGet campaign performance metrics
Receive webhooksGet notified on campaign lifecycle events

Supported Platforms

Meta (Facebook & Instagram)

  • Interest-based audience targeting
  • Age targeting (13–65)
  • Conversion tracking via Facebook Pixel
  • Geography targeting at country, region, and city level
  • Gender and language targeting

TikTok

  • Interest-based audience targeting
  • Hashtag audience targeting (unique to TikTok)
  • Age range currently hardcoded to 18–34
  • Geography, gender, and language targeting

Prerequisites

Before you can use the Advertising API, you need:

  1. A Symphony API key — contact [email protected] to request access
  2. A brand with connected ad platform accounts (Meta and/or TikTok)
  3. Ad platform credentials — Facebook access token or TikTok access token for the brand

Base URL

All Advertising API endpoints are served at:

https://api.symphonyos.co/api/sym/v2/

Authentication

All requests require an x-api-key header:

curl https://api.symphonyos.co/api/sym/v2/api-test \
  -H "x-api-key: your-api-key"

Next Steps