cohorts

Upload cohort members

Upserts one chunk of 1-1,000 members; a cohort holds at most 10,000. Re-sending the same external_id updates its identity without growing the count. Supported platforms: bluesky, instagram, kwai, linkedin, threads, tiktok, truth-social, twitch, twitter, youtube.

put/cohorts/{cohortId}/members

Request

  • Base URL: https://www.socialcrawl.dev/v1
  • URL: https://www.socialcrawl.dev/v1/cohorts/{cohortId}/members
  • Auth: API key in header x-api-key

Path parameters

cohortIdstring required
Example:4MRtBDNO0stwfon8emOHT

Cohort identifier returned by POST /v1/cohorts.

Headers

Idempotency-Keystring uuid required

Required UUID that makes the mutation safely retriable. Replaying the same key with the same body returns the original resource with the X-Idempotent-Replay and Idempotent-Replayed headers; replaying it with a different body returns 422 IDEMPOTENCY_KEY_PAYLOAD_MISMATCH.

Request body

Example request

{
  "members": [
    {
      "external_id": "buyer_01983",
      "handle": "natgeo"
    }
  ]
}

Response

Member upload applied

cachedboolean
credits_remaininginteger nullable
credits_usedinteger
endpointstring
platformstring
request_idstring
successboolean

Example response

{
  "platform": "cohorts",
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.