Outbound

Get KOL IDs associated with outbound keywords or task

Retrieves all KOLs discovered for the specified outbound keywords or task. Returns KOL IDs and metadata without triggering any external workflows. When include_kol_details=true, also fetches video counts from the influencer_videos table. Useful for previewing KOLs before sending outreach or for data analysis.

post/api/outbound/get-kols

Request

  • Base URL: https://api.kolect.com
  • URL: https://api.kolect.com/api/outbound/get-kols
  • Auth: HTTP bearer

Request body

outbound_keyword_idsstring[]

Array of outbound keyword IDs to get KOLs for

outbound_task_idstring uuid

Task ID to get all KOLs for (alternative to keyword IDs)

validation_status'pending' | 'validated' | 'rejected' | 'failed'

Filter KOLs by validation status, defaults to validated

include_kol_detailsboolean

Include full KOL profile details in response, defaults to false

Example request

{
  "outbound_keyword_ids": [
    "0c333bc4-185c-42bc-be78-314ac977d6ac",
    "1d444cd5-296d-53cd-cf89-425bd088e7bd"
  ],
  "outbound_task_id": "0c333bc4-185c-42bc-be78-314ac977d6ac",
  "validation_status": "validated"
}

Response

KOLs retrieved successfully

successboolean
processing_time_msinteger

Example response

{
  "success": true
}

Changes

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