Curator API: Create a Source
POST https://api.curator.io/v1.3/sources adds a source to one of your feeds and loads its first posts. 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 add sources to feeds in the account the key belongs to.
Example request
curl -X POST "https://api.curator.io/v1.3/sources" \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{"feed_id": "FEED_ID", "source_type": 16, "tag": "https://www.curator.io/blog/rss"}'Parameters
Send parameters as JSON or form fields.
Parameter | Description |
|---|---|
| The API ID of the feed to add the source to. |
| The source type ID from the table below. |
| What to pull posts from, up to 200 characters: an account handle, hashtag, search term, or URL, depending on the source type. It is checked only when the first posts load. |
| For source types that need a connection: the API ID of the connection to use (see Curator API: Get Connections). When left out, Curator uses the first valid connection for that network. Ignored for other source types. |
Curator names the source and sets how often it updates from your plan. The same source can be added more than once.
Response
Adding a source loads its first posts during the request, so it can take a few seconds. On success, the response is a 200 with the new source object (described in Curator API: Get Sources, without account) in data, and the number of posts found in meta.message:
{
"data": { "id": "SOURCE_ID", "feed_id": "FEED_ID", "status": "active", ... },
"meta": { "success": true, "message": "30 posts were added to your feed" }
}If the first posts fail to load, the source is removed and the response is an error: a 422 when the connection has expired (the connection is also turned off until you reconnect it in the Curator Dashboard), or a 502 for anything else, such as a tag that doesn't work.
Source types
Types marked "Yes" need a connection to that network, added under Connections in the Curator Dashboard.
ID | Source type | Needs a connection |
|---|---|---|
1 | Twitter Hashtag | Yes |
3 | Twitter User | Yes |
5 | Facebook Page | Yes |
7 | Pinterest User | No |
9 | Flickr Hashtag | No |
10 | YouTube Hashtag | No |
11 | Tumblr Hashtag | No |
13 | YouTube Channel | No |
14 | Tumblr User | No |
15 | Flickr User | No |
16 | RSS | No |
27 | Flickr Album | No |
28 | Vimeo Tag | No |
29 | Diffbot Crawlbot | No |
32 | Glassdoor Employer Reviews | No |
33 | Instagram Business Account | Yes |
34 | Instagram Account | Yes |
35 | YouTube Playlist | No |
38 | Instagram Business Hashtag | Yes |
39 | Yelp Business Reviews | No |
40 | DeviantArt User Gallery | No |
41 | Behance Project | No |
43 | Slack Channel Feed | Yes |
45 | Giphy Search | No |
46 | Instagram Business Mention | Yes |
47 | Instagram Stories | Yes |
48 | Reddit Subreddit Feed | Yes |
49 | Reddit User Feed | Yes |
51 | TikTok User Videos | Yes |
54 | Instagram Tagged Business / Collab Posts | Yes |
55 | Facebook Page Mention | Yes |
56 | LinkedIn Company Page | No |
57 | TikTok Hashtag | Yes |
58 | Google Reviews (Lite) | No |
59 | Google Reviews | No |
60 | Threads User | Yes |
61 | Threads Mentions | Yes |
62 | LinkedIn Profile Page | No |
LinkedIn, TikTok Hashtag, and Google Reviews sources also depend on your plan and have their own limits.
Errors
Errors use the same wrapper, with data set to null and the reason in meta.message.
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
403 | You have reached a source limit, the source type is not on your plan, or your subscription is paused. | A |
404 | No feed in your account matches |
|
422 | A required parameter is missing, or |
|
422 | The source type was not found or is not active, or the connection was not found, is not valid, is for another network, or is missing. | A |
422 | The first posts failed to load because the connection expired. The source is removed and the connection turned off. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|
502 | The first posts failed to load for another reason, such as a |
|