cohorts

Read cohort query results

Returns cursor-paginated keyword matches plus per-member coverage. Matching is deterministic: Unicode NFKC normalization, locale-independent case folding, whitespace collapse, then whole-word matching at Unicode word boundaries (acme matches #acme but not acmecorp; scripts without word delimiters, such as CJK, effectively require exact token matches). Matched keywords are echoed in their normalized form. On YouTube and Twitch the matched text covers the title and the description. A keyword query does no stemming, fuzzy matching, or semantic expansion. A query submitted with topics and match of topics or both also checks items against your topic descriptions and adds matched_topics and mention_type to each item. The response carries the standard pagination block (send pagination.next_cursor back as cursor) and a dropped counter, and the raw data.next_cursor is accepted as well.

get/cohort-queries/{queryId}/results

Request

  • Base URL: https://www.socialcrawl.dev/v1
  • URL: https://www.socialcrawl.dev/v1/cohort-queries/{queryId}/results
  • Auth: API key in header x-api-key

Path parameters

queryIdstring required
Example:ziJygy91eDlzFJLzzUgIY

Cohort query identifier returned by POST /v1/cohorts/{cohortId}/queries.

Query parameters

cursorstring

Opaque cursor from a previous next_cursor.

limitinteger

Page size. Defaults to 100, capped at 500.

Response

Cohort query results page

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.