Add a source to a feed

curl --request POST \
  --url https://api.juicer.io/v1/feeds/{feed_id}/sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "Instagram",
  "term": "nasa",
  "term_type": "username",
  "options": {
    "retweets": "<string>",
    "replies": "<string>",
    "only_reels": "<string>",
    "only_posts": "<string>"
  }
}
'

{
  "data": {
    "id": 123,
    "platform": "<string>",
    "term": "<string>",
    "term_type": "<string>",
    "name": "<string>",
    "options": {},
    "syncable": true,
    "unsyncable_reason": "<string>",
    "synced_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z"
  }
}

Sources

Add a source to a feed

Creates a new source and performs an initial sync to fetch posts. Some platforms (like LinkedIn) sync asynchronously — check syncable status after creation.

Use GET /platforms to see available platforms and their supported term types.

Example — Reddit: use term_type: "channel" with a subreddit name (or reddit.com/r/... URL) to pull a subreddit’s posts, or term_type: "mentions" with any keyword to pull Reddit search results:

{ "platform": "Reddit", "term": "aww", "term_type": "channel" }
{ "platform": "Reddit", "term": "your brand", "term_type": "mentions" }

Returns 422 with error.code = "source_limit_reached" and an upgrade action if the feed’s source limit is exceeded. Returns 422 with error.code = "social_account_required" and a connect action if the platform requires OAuth and no account is connected.

POST

feeds

{feed_id}

sources

Add a source to a feed

curl --request POST \
  --url https://api.juicer.io/v1/feeds/{feed_id}/sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "Instagram",
  "term": "nasa",
  "term_type": "username",
  "options": {
    "retweets": "<string>",
    "replies": "<string>",
    "only_reels": "<string>",
    "only_posts": "<string>"
  }
}
'

{
  "data": {
    "id": 123,
    "platform": "<string>",
    "term": "<string>",
    "term_type": "<string>",
    "name": "<string>",
    "options": {},
    "syncable": true,
    "unsyncable_reason": "<string>",
    "synced_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

API key prefixed with jcr_. To obtain a key programmatically (no dashboard required), see POST /v1/authorize.

Path Parameters

feed_id

integer

required

Body

application/json

platform

string

required

Social media platform (use GET /platforms to see options)

Example:

"Instagram"

term

string

required

Username, hashtag, or URL

Example:

"nasa"

term_type

string

required

Type of search term (use GET /platforms to see valid types per platform)

Example:

"username"

options

object

Platform-specific options

Show child attributes

Response

Source created

data

object

Show child attributes

List sources for a feed Remove a source from a feed