Channels

What the index holds for a channel

How many videos of a YouTube channel are searchable, the newest publish date among them, and the split by transcript source class. Call it when a search or mention lookup came back empty, before telling anyone we do not cover a show, and cite indexed_through as the as-of date for mentions and search_indexed_through for transcript search. It cannot request indexing; channel backfill is not available yet. Free; uses no credits. Every gate is a typed error whose error.unlock.url names the plan that lifts it; pass src=mcp-tool only from the Arcmira MCP server.

get/v1/channels/{channel_id}/coverage

Request

Base URL: https://api.arcmira.com
URL: https://api.arcmira.com/v1/channels/{channel_id}/coverage
Auth: HTTP bearer

Path parameters

channel_idstring required

YouTube channel id, the UC... form.

Query parameters

src'mcp-tool'

The surface making this call. The Arcmira MCP server sends mcp-tool so every unlock link in a gate attributes to the directory install. Omit from your own client.

Response

Success

notestring required

One steering sentence for the agent reading this.

Example response

{
  "channel": {
    "youtube_channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
    "searchable_videos": 412,
    "indexed_through": "2026-08-28T17:00:00.000Z",
    "search_indexed_through": "2026-08-28T17:00:00.000Z",
    "source_mix": {
      "arcmira_premium": 96,
      "creator_captions": 301,
      "third_party_quick": 15
    }
  },
  "note": "Cite indexed_through as the as-of date for mentions and search_indexed_through for transcript search. An empty search is a miss up to search_indexed_through, not proof it was never said."
}

Changes

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