---
title: "Get all KOLs discovered on a specific date across all tasks"
method: POST
path: "/api/outbound/kols-by-date"
tags: ["Outbound"]
---

# Get all KOLs discovered on a specific date across all tasks

`POST /api/outbound/kols-by-date`

## Request

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

Returns a deduplicated list of KOLs discovered on the given date (UTC) from the `keyword_kols` table.
Optionally filters by validation status and platform, and can include full KOL details.

## Request body

- object
  - `date` string, required: Date (UTC) to filter by. Accepts YYYY-MM-DD or ISO string.
  - `validation_status` 'pending' | 'validated' | 'rejected' | 'failed': Filter by validation status
  - `platform` 'tiktok' | 'instagram' | 'youtube': Filter by platform
  - `include_kol_details` boolean: Include joined KOL profile details
  - `with_email_only` boolean: When true, only return KOLs that have an email
  - `limit` integer: Max results to return after deduplication
  - `offset` integer: Offset for pagination after deduplication

## Response `200`

Success

- object
  - `success` boolean
  - `data` object
    - `date` string
    - `total_found` integer
    - `unique_kols` integer
    - `kols` object[]
      - `kol_id` string
      - `platform` string
      - `discovered_at` string
      - `validation_status` string
      - `kol` object
  - `processing_time_ms` integer

## Other responses

- `400`: Bad request
- `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)