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[].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)

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",
      "clips": 252,
      "channels": 56,
      "words": 8640,
      "wordsCovered": 2758,
      "coverage": 0.319
    }
  ],
  "updatedAt": "2026-09-17T02:10:00Z"
}