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.

Warehouse connector

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

​
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.