Look up the canonical profile per platform for a handle

curl --request GET \
  --url https://api.juicer.io/v1/data/profiles \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "platform": "<string>",
      "term": "<string>",
      "exact_match": true,
      "profiles": [
        {
          "platform": "<string>",
          "metrics": {
            "follower_count": 123,
            "post_count": 123,
            "total_view_count": 123,
            "avg_views_per_post": 123,
            "language": "<string>",
            "location": "<string>",
            "recent_post_engagement": {
              "likes": 123,
              "comments": 123,
              "shares": 123,
              "views": 123,
              "sampled_post_url": "<string>",
              "sampled_post_created_at": "2023-11-07T05:31:56Z"
            }
          },
          "platform_id": "<string>",
          "handle": "<string>",
          "display_name": "<string>",
          "url": "<string>",
          "image": "<string>",
          "description": "<string>",
          "verified": true
        }
      ]
    }
  ],
  "meta": {
    "total_results": 123,
    "platforms": [
      {
        "platform": "<string>",
        "term": "<string>",
        "success": true,
        "count": 123,
        "message": "<string>"
      }
    ]
  }
}

Data API

Look up the canonical profile per platform for a handle

Resolves one or more handles to their canonical profile on each requested platform. Pass several handles as a comma-separated term list — every term is looked up on every platform independently, and each data[] entry is a { platform, term, exact_match, profiles[] } group. Hashtag terms (#foo) are rejected.

Every profile object includes every field and every metrics key; any value not available for a given account is null. Do not assume a field is always present — coverage varies by platform and account.

When a platform has an exact handle match, profiles holds that one account (exact_match: true). Otherwise it holds best-effort candidate matches for you to disambiguate (exact_match: false).

If one platform fails or has no result, others still return. Check meta.platforms for per-platform status.

GET

data

profiles

Look up the canonical profile per platform for a handle

curl --request GET \
  --url https://api.juicer.io/v1/data/profiles \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "platform": "<string>",
      "term": "<string>",
      "exact_match": true,
      "profiles": [
        {
          "platform": "<string>",
          "metrics": {
            "follower_count": 123,
            "post_count": 123,
            "total_view_count": 123,
            "avg_views_per_post": 123,
            "language": "<string>",
            "location": "<string>",
            "recent_post_engagement": {
              "likes": 123,
              "comments": 123,
              "shares": 123,
              "views": 123,
              "sampled_post_url": "<string>",
              "sampled_post_created_at": "2023-11-07T05:31:56Z"
            }
          },
          "platform_id": "<string>",
          "handle": "<string>",
          "display_name": "<string>",
          "url": "<string>",
          "image": "<string>",
          "description": "<string>",
          "verified": true
        }
      ]
    }
  ],
  "meta": {
    "total_results": 123,
    "platforms": [
      {
        "platform": "<string>",
        "term": "<string>",
        "success": true,
        "count": 123,
        "message": "<string>"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

term

string

required

One or more handles to resolve, comma-separated (no # hashtag prefix; @ prefix allowed and stripped). Each handle is looked up on every requested platform. Up to 5 handles per request.

Example:

"juicer,juicerio,juicer.io"

platforms

string

required

Comma-separated list of platforms. Supported: Bluesky, YouTube, LinkedIn, Pinterest, Twitter (X), Instagram, Facebook, TikTok. Unsupported names appear in meta.platforms with error_code = "unknown_platform".

Example:

"Bluesky,YouTube,LinkedIn"

Response

Profiles fetched successfully

data

object[]

required

Show child attributes