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",
      "brand_raw": "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.

Row semantics

Each row is one post, not one relationship. A creator who ran five partnerships with the same brand appears in five rows, so to count distinct creators for a brand, dedupe on creator.username per platform; to count distinct brands for a creator, dedupe on brand. Spelling variants of the same brand resolve to one canonical brand value; the label exactly as scraped is kept in brand_raw, and sort=brand orders by brand_raw.

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 each platform is 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.

Usage terms

The API license is deliberately broad: use the data inside your own products and analyses, display it to your end users, keep a full synced copy on your side (that's what updated_since is for), and build the features you want on top of it, including exports.

The few rules:

• Your use of the data, including contact details, has to comply with the laws that apply to you, and the data can't be used to spam or harm the creators and brands in it
• Contact details can't be republished as a standalone public database
• Your API key stays inside your team

We may revoke API access for use that violates these rules. See also our Terms of Service.