Skip to content

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.

get/api/v1/search

Authentication

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

  • qstringrequired

    Plain keywords, e.g. "morning routine", "skincare", a creator name. No OR, AND or quotes: videos holding every word rank first. 2 to 200 characters.

  • limitinteger

    How many results, 1 to 25. Default 10.

Response fields

  • querystring

  • corrected_querystring

    Present when nothing matched as written and the results are for these corrected words.

  • hintstring

    How the words were read (corrected, a word start, or a phrase): tell the reader.

  • notestring

    Why there are no results, or that the list was cut short.

  • resultsarray of object

    Each 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); resolution says 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.