Overview#
Swonkie is a social media management platform that helps teams plan, publish and analyse content across multiple social networks.The Swonkie API gives developers programmatic access to the same data and actions available in the Swonkie application. You can manage posts, pull performance insights, track competitors, organize content with labels, and handle media uploads, all through a straightforward REST interface.The API is designed for teams building automation workflows (n8n, Make, Zapier), internal tooling, data pipelines, or custom integrations with third-party systems.
Base URL#
All API requests are made to the following base URL:https://api.swonkie.dev/v2
v2) is part of every endpoint path. When a new API version is released, the previous version remains accessible under its own segment to avoid breaking existing integrations.
Authentication#
Every request must include two HTTP headers that identify your workspace and authorize access:| Header | Description |
|---|
X-API-ID | Your workspace App ID |
X-API-KEY | Your workspace API Key |
Key Rotation#
Each workspace has a Primary Key and a Secondary Key. You can rotate keys without downtime by promoting the secondary key before revoking the primary. Both keys are valid simultaneously during the transition window.
Resources#
| Resource | Description |
|---|
| Profiles | List connected social profiles and competitor accounts in your workspace |
| Insights | Retrieve aggregate and per-post performance metrics for profiles and competitors |
| Posts | Create, read, update, delete and move posts through approval workflow stages |
| Labels | Manage labels used to categorize and filter posts |
| Media | Upload and manage images and videos attached to posts |
What You Can Build#
Schedule and publish content across multiple social networks programmatically
Pull analytics data into your own dashboards or data warehouse
Automate content approval pipelines using the post stage workflow
Monitor competitor performance and generate custom reports
Build n8n, Make or Zapier workflows triggered by your own systems
Modified at 2026-03-12 17:51:46
