API Beta Docs

Authentication

Send your API key as a bearer token. X-API-Key also works.

Authorization: Bearer cf_live_xxx

Mint or rotate your key from Account Settings. The raw key is only shown once; store it somewhere safe.

Endpoint

GET https://collabfeed.io/api/v1/collabs

Examples

Common recipes. All return the same response shape (see below).

curl "https://collabfeed.io/api/v1/collabs?limit=50" \
  -H "Authorization: Bearer cf_live_xxx"

curl "https://collabfeed.io/api/v1/collabs?platform=tiktok&niche=Gaming&limit=50" \
  -H "Authorization: Bearer cf_live_xxx"

curl "https://collabfeed.io/api/v1/collabs?min_views=10000&min_engagement_rate=3&sort=engagement_rate&order=desc" \
  -H "Authorization: Bearer cf_live_xxx"

curl "https://collabfeed.io/api/v1/collabs?brand=Gymshark&limit=100" \
  -H "Authorization: Bearer cf_live_xxx"

curl "https://collabfeed.io/api/v1/collabs?updated_since=2026-05-01T00:00:00Z&limit=200" \
  -H "Authorization: Bearer cf_live_xxx"

Filters

Response shape

Every response has a data array of collab records and a meta object with the applied filters and your usage counters.

{
  "data": [
    {
      "id": "tiktok_7638682041013357855",
      "source_id": "7638682041013357855",
      "platform": "tiktok",
      "brand": "Sony Electronics",
      "creator": {
        "username": "wisteriem",
        "full_name": "Em | Cozy Games & Lifestyle",
        "email": "em@hermanaagency.com",
        "followers_count": 231339,
        "follows_count": 261,
        "profile_likes": 5022316,
        "profile_url": "https://www.tiktok.com/@wisteriem",
        "external_url": "https://beacons.ai/wisteriem",
        "biography": "your introverted cozy lifestyle & gaming bestie",
        "is_business_account": false,
        "is_verified": false
      },
      "niche": {
        "main": "Gaming",
        "sub": "Gaming Accessories"
      },
      "post": {
        "url": "https://www.tiktok.com/@wisteriem/video/7638682041013357855",
        "caption": "#SponsoredbySony I love tuning out the world and immersing myself in my games...",
        "cover_url": "https://p19-common-sign.tiktokcdn-eu.com/...",
        "cached_cover_url": "https://ltiqztjqumeaakcsovjl.supabase.co/storage/v1/object/public/tiktok_covers/...",
        "duration_seconds": 45,
        "hashtags": ["sponsoredbysony", "sonyinzone"],
        "posted_at": "2026-05-11T17:08:11+00:00"
      },
      "metrics": {
        "views": 430,
        "likes": 38,
        "likes_hidden": false,
        "comments": 3,
        "shares": 0,
        "engagement_rate": 9.5349
      },
      "estimated_post_rate": {
        "low": 2086,
        "high": 3823
      },
      "confidence": {
        "brand": 1,
        "niche_main": 1,
        "niche_sub": 0.95
      },
      "is_ad": true,
      "inserted_at": "2026-05-12T06:01:31.630941+00:00",
      "updated_at": "2026-05-12T06:01:31.630941+00:00",
      "brand_contact": {
        "domain": "sony.com",
        "partnership_email": "partnerships@sony.com",
        "partnership_email_verified": true,
        "partnership_email_result_type": "ok",
        "fallback_emails": ["press@sony.com"],
        "partnership_url": "https://creators.sony.com",
        "social_links": {
          "instagram": "sonyelectronics",
          "tiktok": "sonyelectronics"
        }
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 100,
    "has_more": true,
    "records_returned": 1,
    "filters": {
      "platform": "tiktok",
      "niche_main": "Gaming",
      "sort": "posted_at",
      "order": "desc"
    },
    "usage": {
      "month_start": "2026-05-01T00:00:00.000Z",
      "month_end": "2026-06-01T00:00:00.000Z",
      "requests_this_month": 1,
      "rate_limit_per_minute": 120
    }
  }
}

Response fields

All fields can be null unless noted otherwise. Below is what each block contains.

Pagination

Two ways to paginate. For ongoing data syncs, prefer updated_since.

• Incremental sync (recommended): pass updated_since=<ISO timestamp>. Store the maximum updated_at from the response and use it on the next request. When updated_since is set, results default to sort=updated_at&order=asc so the cursor never skips records; keep that ordering if you override sort. This is the only fully reliable primitive for large pulls.
• Offset pagination: page (default 1, max 10) and limit (default 100, max 200). page * limit cannot exceed 1,000 records per filter window; requests past either cap return a 400. With platform=all, deep pages can show approximate ordering because Instagram and TikTok are fetched independently then merged. For full snapshots, narrow by platform, date_from / date_to, or a brand / niche filter.
• Has more: meta.has_more is true if there are additional records past the current page or window.

Rate limits and errors

API keys are rate-limited to 120 requests per minute. No monthly usage cap.

If your Polar subscription is canceled, the linked API key is deactivated automatically and subsequent requests will return 401.