Sign in
Channels

Newest indexed videos of a channel

The indexed videos of a YouTube channel, newest first, each with its video_id, title, publish date, duration, view count, and watch_url on arcmira.com. Pass next_cursor as cursor to continue. The signed token binds the route, filters, caller and visibility; invalid or old tokens return invalid_cursor. A first-page media ID fence excludes later insertions, including old-date backfills; edits and deletions to existing videos remain live. Call it for the latest or most recent episode of a show, or to list what a show published in a window, then pass a video_id to GET /v1/mentions/counts video_ids for what that episode mentions or to GET /v1/transcripts/{video_id} to read it. indexed_through is the newest date we hold for the channel. An empty list means nothing is indexed; channel backfill is not available yet. Uses 4 credits per video returned past the first 5. 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}/videos

Request

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

Path parameters

channel_idstring required

YouTube channel id, the UC... form.

Query parameters

limitinteger

Videos to return, 1 to 25, newest first. Default 10. Pass 1 for the latest episode.

cursorstring

Opaque continuation from next_cursor. Bound to the channel, filters, caller, and visibility; limit may change between pages. Invalid or old tokens return invalid_cursor.

afterstring

Only media published at or after this instant. An ISO 8601 date (2026-09-01) or datetime with offset (2026-09-01T00:00:00Z), read in UTC. The window is half-open: after is inclusive, before is exclusive.

beforestring

Only media published before this instant, so before=2026-09-02 includes all of 2026-09-01. An ISO 8601 date (2026-09-01) or datetime with offset (2026-09-01T00:00:00Z), read in UTC. The window is half-open: after is inclusive, before is exclusive.

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

returnedinteger required
has_moreboolean required

True when more indexed videos exist past limit in the window.

next_cursorstring nullable required

Signed continuation for the next page. Null on the last page.

indexed_throughstring nullable required

Newest publish date among every indexed video of the channel, whatever window was asked for. Null when nothing is indexed.

index_age_daysinteger nullable required

Whole days between indexed_through and now. Past 30 the note says the index may be behind the channel. Null when nothing is indexed.

as_ofstring nullable required

Same as indexed_through.

notestring required

One steering sentence for the agent reading this.

Example response

{
  "channel": {
    "id": "ent_566342",
    "youtube_channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
    "name": "TBPN",
    "page": "https://arcmira.com/yt/@TBPNLive"
  },
  "episodes": [
    {
      "video_id": "dQw4w9WgXcQ",
      "title": "TBPN | Friday, August 28",
      "published_at": "2026-08-28T17:00:00.000Z",
      "duration_seconds": 10812,
      "view_count": 48210,
      "channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
      "channel_name": "TBPN",
      "channel_page": "https://arcmira.com/yt/@TBPNLive",
      "watch_url": "https://arcmira.com/watch?v=dQw4w9WgXcQ"
    }
  ],
  "returned": 1,
  "has_more": true,
  "window": {
    "after": "2026-08-01T00:00:00Z",
    "before": null
  },
  "indexed_through": "2026-08-28T17:00:00.000Z",
  "index_age_days": 3,
  "as_of": "2026-08-28T17:00:00.000Z",
  "note": "Newest indexed episodes first. Pass a video_id to count_occurrences videoIds to list what one episode mentions, or to get_transcript to read it."
}

Changes

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