Curator API: Get Connections
GET https://api.curator.io/v1.2/connections returns the social network connections in your Curator account as JSON. A connection is an account you have linked, such as Facebook or Instagram, that some source types need. The request needs your API key, and your plan must include API access. Only HTTPS is supported.
Authentication
Send your Curator API key (find it in the Curator Dashboard) in one of three ways: as a query string (?api_key=API_KEY), as a Basic auth header with the API key as the username, or as a Bearer token (Authorization: Bearer API_KEY). The key decides which account you are working in; you only see that account's connections.
Example request
curl "https://api.curator.io/v1.2/connections?api_key=API_KEY"Response
A 200 response is a JSON array of connection objects, with no wrapper, no paging, and no set order. It lists connections with the status valid, invalid, or revoked. Connections that need attention are left out.
[
{
"id": "CONNECTION_ID",
"network_connection_id": 3,
"user_id": "...",
"user_name": "Glenn Taylor",
"user_image": "https://...",
"status": "valid",
"activated_at": "2026-10-20T03:15:40.000000Z",
"revoked_at": null,
"network": { "id": 3, "name": "Facebook" }
}
]Connection object
Field | Description |
|---|---|
| The connection's API ID (a UUID). Use it as |
| The kind of connection: 1 Twitter, 2 Instagram, 3 Facebook, 4 Pinterest, 11 LinkedIn, 16 Instagram Business (through Facebook), 20 Spotify, 21 Slack, 23 Reddit, 24 Simpleview, 25 TikTok, 26 Threads. |
| The linked account's ID, name, and image on its network. |
|
|
| When the connection was made, and when it was revoked, in UTC. |
| The network, with |
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|