Curator API: Get Connections
GET https://api.curator.io/v1.3/connections returns the social network connections in your Curator account as JSON, one page at a time. 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, with Bearer capitalised). The key decides which account you are working in; you only see that account's connections.
Example request
curl "https://api.curator.io/v1.3/connections?status=needs-attention" \
-H "Authorization: Bearer API_KEY"Parameters
Parameter | Description |
|---|---|
| Only connections with this status: |
| Only connections for this network, by network ID, such as 3 for Facebook. |
| Connections per page, between 1 and 100. Default 15. |
| Cursors from |
Response
A 200 response has the connections in data, oldest first, and paging details in meta.pagination:
{
"data": [
{
"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" }
}
],
"meta": {
"success": true,
"pagination": { "per_page": 15, "after": null, "before": null, "after_link": null, "before_link": null }
}
}Paginating with cursors
Follow meta.pagination.after_link for the next page and before_link for the previous one. The links keep your filters but leave out api_key, so send the key in a header or add it again. after is null on the last page and before is null on the first.
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
Errors use the same wrapper, with data set to null and the reason in meta.message.
Status | When | Body |
|---|---|---|
400 | Both |
|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
422 |
|
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|