Search library
Keyword search across the library: start here to turn a topic, creator or category name into the video ids Get video takes and the niche and format slugs List videos takes. Results carry each hit's type, id, slug, name and page URL; video hits carry a preview of their hook (Get video has the whole one) and their description, not their stats. Plain keywords, not Boolean operators. A misspelt search is corrected once (correctedQuery), and hint says when a word was read as a word start or a phrase. One set of results, no pagination. Same answer as the MCP tool search_library. Each request counts against the team's call allowance, shared with MCP; past it, a 402.
/api/v1/searchAuthentication
OAuth token, API key or signed-in session, sent as Authorization: Bearer <token> (a session rides on its cookie). An OAuth token needs mcp:read. See authentication.
Query parameters
qstringrequiredPlain keywords, e.g. "morning routine", "skincare", a creator name. No OR, AND or quotes: videos holding every word rank first. 2 to 200 characters.
limitintegerHow many results, 1 to 25. Default
10.
Response fields
querystringcorrected_querystringPresent when nothing matched as written and the results are for these corrected words.
hintstringHow the words were read (corrected, a word start, or a phrase): tell the reader.
notestringWhy there are no results, or that the list was cut short.
resultsarray of objectEach with
type,id,slug,name,description,platform,url.
Responses
- 200
Search videos, creators, niches and formats. Body:
SearchResults. - 400
A parameter is malformed or not supported. Body:
Problem. - 401
No account: send an API key, an OAuth access token or a session cookie. WWW-Authenticate names the protected-resource metadata. Body:
Problem. - 402
The team's call allowance is used up (
quota_exceeded), or the account has no plan and so no calls (no_plan), or an account with no plan asked past a list's first page (plan_limit);resolutionsays what to do and links the plans page. Body:Problem. - 403
The token lacks mcp:read. Body:
Problem. - 429
Rate limit exceeded; wait Retry-After seconds. Body:
Problem. - 500
The request failed on our side. Body:
Problem.