KOL

Fetch detailed KOL profile information (batched)

Accepts a list of KOL IDs and (optionally) a mapping of video IDs belonging to each KOL. Returns the full profile data for each requested KOL and, when videos_by_kol is supplied, an array of matched video titles is embedded inside each KOL object.

post/api/v1/kols/details

Request

  • Base URL: https://api.kolect.com
  • URL: https://api.kolect.com/api/v1/kols/details
  • Auth: HTTP bearer

Request body

kol_idsstring[] required

List of KOL IDs that need to be fetched. If omitted, keys of videos_by_kol will be used.

videos_by_kolobject

Optional mapping kol_id → array of video_id. When provided, the service will fetch titles for these videos and attach them to the corresponding KOL in the response.

Example request

{
  "kol_ids": [
    "1d3f5471-8d0c-4d0a-9f2b-3f1c7c9e9c8e"
  ]
}

Response

Successfully fetched KOL details.

successboolean
matched_countinteger
time_elapsednumber

Example response

{
  "success": true
}

Changes

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