Outbound

Get all KOLs discovered on a specific date across all tasks

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.

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

Request body

datestring 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_detailsboolean

Include joined KOL profile details

with_email_onlyboolean

When true, only return KOLs that have an email

limitinteger

Max results to return after deduplication

offsetinteger

Offset for pagination after deduplication

Example request

{
  "date": "2025-02-01"
}

Response

Success

successboolean
processing_time_msinteger

Changes

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