Search

Full-text search for KOLs with advanced filtering and pagination

Performs a full-text search on video titles to find Key Opinion Leaders (KOLs). Supports complex query syntax, result ranking, and cursor-based pagination.

Query Syntax (PostgreSQL tsquery format):

  • Basic match: camera
  • Multi-word (any): camera tripod (equivalent to camera | tripod)
  • Require all: camera & tripod
  • Exclude: camera & !phone
  • Phrase search: "vlog camera setup"
post/api/v1/search/inbound/full-text-by-page

Request

  • Base URL: https://api.kolect.com
  • URL: https://api.kolect.com/api/v1/search/inbound/full-text-by-page
  • Auth: HTTP bearer

Request body

querystring

Natural language query with optional operators.

limitinteger

Maximum number of videos to process. Use -1 for unlimited.

similarity_thresholdnumber float

Minimum similarity score (0-1) for a video to be included when ranking is enabled.

ranking_mode'sum' | 'max'

How to aggregate similarity scores for ranking KOLs.

enable_rankingboolean

If true, enables similarity ranking using ts_rank_cd.

top_kolsinteger

If specified, returns only the top N KOLs based on the ranking.

cursorstring

Base64 encoded cursor for KOL-level pagination.

page_sizeinteger

Number of KOLs to return per page.

min_videosinteger

Minimum number of matched videos a KOL must have to be included.

max_videosinteger

Maximum number of matched videos to return per KOL.

Example request

{
  "query": "camera & dslr"
}

Response

Search completed successfully.

successboolean
matched_countinteger
total_kols_foundinteger
videos_searchedinteger
time_elapsednumber
next_cursorstring nullable
has_moreboolean

Changes

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