Curator API: Get Facebook Pages
GET https://api.curator.io/v1.3/connections/CONNECTION_ID/facebook-pages lists the Facebook Pages that a Facebook connection manages, so you can pick one for a Facebook Page 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, with Bearer capitalised). You can only use connections in the account the key belongs to.
Example request
curl "https://api.curator.io/v1.3/connections/CONNECTION_ID/facebook-pages" \
-H "Authorization: Bearer API_KEY"Parameters
Parameter | Description |
|---|---|
| The API ID of a Facebook connection with the status |
Response
A 200 response with an array of Pages in data, or [] when there are none. There is no paging; very long lists can be cut short.
Field | Description |
|---|---|
| The Page's Facebook ID and name. |
| The Page's username and URL, when Facebook provides them. |
| The Page's short name, or |
| The Page's picture, with |
| Whether Facebook granted access to the Page. |
If Facebook says the connection's session 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 a Facebook connection. |
|
418 | The connection's status is not |
|
418 | Facebook says the session has expired. The connection is turned off. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|
502 | Facebook returned another error. |
|