Skip to main content
GET
/
search
/
posts
Search posts across all feeds
curl --request GET \
  --url https://api.juicer.io/v1/search/posts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "external_id": "<string>",
      "platform": "<string>",
      "url": "<string>",
      "message": "<string>",
      "external_created_at": "2023-11-07T05:31:56Z",
      "poster": {
        "display_name": "<string>",
        "name": "<string>",
        "url": "<string>",
        "image": "<string>",
        "platform_id": "<string>"
      },
      "media": [
        {
          "url": "<string>",
          "preview_image_url": "<string>",
          "width": 123,
          "height": 123,
          "alt_text": "<string>",
          "platform_id": "<string>"
        }
      ],
      "like_count": 123,
      "comment_count": 123,
      "tagged_users": "<string>",
      "pinned": true,
      "referenced_post": {
        "poster": {
          "display_name": "<string>",
          "name": "<string>",
          "url": "<string>",
          "image": "<string>",
          "platform_id": "<string>"
        },
        "message": "<string>",
        "url": "<string>",
        "platform_id": "<string>",
        "post_created_at": "2023-11-07T05:31:56Z",
        "media": [
          {
            "url": "<string>",
            "preview_image_url": "<string>",
            "width": 123,
            "height": 123,
            "alt_text": "<string>",
            "platform_id": "<string>"
          }
        ]
      },
      "reshared_by": {
        "display_name": "<string>",
        "name": "<string>",
        "url": "<string>",
        "image": "<string>",
        "platform_id": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "meta": {
    "page": 123,
    "per_page": 123,
    "total_count": 123,
    "total_pages": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.juicer.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Query Parameters

query
string
required

Text to search for. Use + for AND, , for OR.

Example:

"product+launch"

feed_ids
string

Comma-separated feed IDs to narrow the search scope

platforms
string

Comma-separated platform names to filter by

starting_at
string<date-time>

Only posts after this date

ending_at
string<date-time>

Only posts before this date

page
integer
default:1
per_page
integer
default:25
Required range: x <= 100

Response

Search results

data
object[]
meta
object