Skip to main content
GET
Newest indexed videos of a channel

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

channel_id
string
required

YouTube channel id, the UC... form.

Query Parameters

limit
integer
default:10

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

Required range: 1 <= x <= 25
cursor
string

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.

after
string

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.

before
string

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
enum<string>

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.

Available options:
mcp-tool

Response

Success

channel
object
required
episodes
object[]
required

Indexed videos of the channel, newest first.

returned
integer
required
has_more
boolean
required

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

next_cursor
string | null
required

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

window
object
required

The publication window the answer covers, [after, before) in UTC, normalized from after and before.

indexed_through
string | null
required

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

index_age_days
integer | null
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_of
string | null
required

Same as indexed_through.

note
string
required

One steering sentence for the agent reading this.

freshness
object

Present when your plan's freshness gate cut the window: where results on this plan stop. unlock names the plan that reads past it.

unlock
object

Present with freshness when your plan's freshness gate cut the window; note says so.