---
title: "Get KOL IDs associated with outbound keywords or task"
method: POST
path: "/api/outbound/get-kols"
tags: ["Outbound"]
---

# Get KOL IDs associated with outbound keywords or task

`POST /api/outbound/get-kols`

## Request

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

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.

## Request body

- object
  - `outbound_keyword_ids` string[]: Array of outbound keyword IDs to get KOLs for
  - `outbound_task_id` string, 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_details` boolean: Include full KOL profile details in response, defaults to false

## Response `200`

KOLs retrieved successfully

- object
  - `success` boolean
  - `data` object
    - `keywords_processed` integer
    - `total_kols_found` integer
    - `all_kol_ids` string[]: Deduplicated list of all KOL IDs across keywords
    - `results` object[]
      - `keyword_id` string
      - `keyword` string
      - `channel` string
      - `kol_count` integer
      - `kols` object[]
        - `kol_id` string
        - `platform` string
        - `discovery_method` string
        - `followers_count` integer
        - `engagement_rate` number
        - `discovered_at` string
        - `validation_status` string
        - `video_count` integer: Number of videos for this KOL (only when include_kol_details=true)
  - `processing_time_ms` integer

## Other responses

- `400`: Bad request - validation errors
- `500`: Internal server error

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)