Parse Query

post/api/search/parse

Request

Base URL: https://api.kolens.ai (the document declares no server; this is the origin it was published from)
URL: https://api.kolens.ai/api/search/parse
Auth: HTTP bearer

querystring required

platformstring nullable

tiktok | instagram | x | douyin

Successful Response

keywordstring required

Short scrapable term to run

filtersobject

Keys are /api/kols query params — forward as-is

parsedboolean required

False = we could not improve on the input; keyword is unchanged

notesstring

What we understood, in the user's language

originalstring

The brief exactly as submitted

needs_topicboolean

Conditions understood but no topic named — ask the user for one. Running the brief as-is would be a guaranteed zero-result charge.

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