Skip to main content
The Public API is HTTP-first — every endpoint works with curl, Python, or your own client. Pick the path that matches the job.

REST API

Any language. One-off scripts and custom clients.

TypeScript SDK

Node.js, serverless, and Edge — typed methods and JSONL streaming.

API emulator

Local campaign lifecycle. No Meta spend.

Warehouse connector

ELT into DuckDB or BigQuery. Catalog + daily metrics, no pipeline code.

MCP server

Cursor, Claude, or another AI client. Read-only tools, no install.

REST API vs TypeScript SDK

Both hit the same base URL and return the same JSON envelope. The SDK does not add capabilities beyond what the API exposes — including create, budget, stop, and tiers for wallet campaigns (generation: 3), plus self-serve soundlinks (soundlinks:read). To create a soundlink, see Creating soundlinks.

TypeScript SDK

Install from npm: soundlink · Source: github.com/Fan-ID/lib Requires Node.js 18+ (native fetch). See the TypeScript guide for install, write examples (Idempotency-Key), metrics, and configuration.
Server-side only. Never expose your sk_* API key in a browser or mobile app — call Soundlink from your backend and keep the key in environment variables.

Warehouse connector

Python CLI that syncs campaigns and soundlinks into DuckDB or BigQuery. Read-only — it does not wrap create, budget, or video import. Clone from GitHub (not on PyPI yet): github.com/Fan-ID/soundlink-warehouse-connector. See the warehouse connector guide.

MCP server

Hosted at https://api.getsoundlink.com/mcp. Connect Cursor or Claude with an API key or an OAuth app. Read-only. See the MCP server guide.