Corpus size and coverage

GET/v1/corpus

Reports what is in the index right now: clips per language, how much of the word catalogue has at least one clip, and when the index last grew. Unauthenticated callers get the same numbers, so the endpoint can back a public status page.

Parameters

This endpoint takes no parameters.

Response

Field	Type	Description
languages	object[]
languages[].language	string
languages[].status	live | preparing	Added 4 October 2026. live: the language has approved clips, it is served by the search and feed endpoints, and its numbers are real. preparing: the language is being ingested, videos are processed but clips are held before release, so clips, channels, words, wordsCovered and coverage are 0 until launch. Do not offer a preparing language for search yet.
languages[].clips	integer
languages[].channels	integer
languages[].words	integer	Catalogue size for this language.
languages[].wordsCovered	integer	Words with at least one clip.
languages[].coverage	number	wordsCovered / words.
updatedAt	string (ISO 8601)	Latest approval time across live languages. Languages without approved clips are ignored.

Errors

Status	Code	When
429	rate_limited	Too many requests, or the plan quota is spent. Retry-After carries the wait in seconds.

Example

curl https://clips.vocaflare.com/v1/corpus

{
  "languages": [
    {
      "language": "en",
      "status": "live",
      "clips": 11767,
      "channels": 91,
      "words": 8640,
      "wordsCovered": 7130,
      "coverage": 0.825
    },
    {
      "language": "es",
      "status": "preparing",
      "clips": 0,
      "channels": 0,
      "words": 0,
      "wordsCovered": 0,
      "coverage": 0
    }
  ],
  "updatedAt": "2026-10-04T10:07:09.152527+00:00"
}