Curator API: Get Instagram Business Accounts
GET https://api.curator.io/v1.2/connections/CONNECTION_ID/instagram-businesses lists the Instagram business accounts linked to the Facebook Pages of an Instagram Business connection, so you can pick one for an Instagram Business source. Curator asks Facebook for the list on every request. 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). You can only use connections in the account the key belongs to.
Example request
curl "https://api.curator.io/v1.2/connections/CONNECTION_ID/instagram-businesses?api_key=API_KEY"Parameters
Parameter | Description |
|---|---|
| The API ID of an Instagram Business connection ( |
Response
A 200 response is a JSON array of Instagram business accounts. Facebook Pages without a linked Instagram business account are left out.
Field | Description |
|---|---|
| The account's Instagram business ID and Instagram ID. |
| The account's username and name. |
| The account's profile picture. |
| The linked Facebook Page, with |
If Facebook says the connection has expired, Curator turns the connection off, emails your account about it, and returns the 418 below. Reconnect it in the Curator Dashboard.
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
403 | The connection belongs to another account. |
|
404 | No connection has that ID. |
|
418 | The connection is not an Instagram Business connection. |
|
418 | The connection's status is not |
|
418 | Facebook says the connection has expired. The connection is turned off. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|
500 | Facebook returned another error. |
|