Skip to main content
GET
Retrieve spoken transcript slices for one topic

Authorizations

Authorization
string
header
required

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

Query Parameters

q
string
required

One topic or phrase. Do not concatenate unrelated names; make one call per topic.

Minimum string length: 2
channel_ids
string

Comma-separated YouTube channel ids (UC...), at most 8. Pass every show in scope unless drilling into one. Ids only: a name answers 400 id_required. Resolve names first with GET /v1/entities/resolve.

channel
string

Alias of channel_ids for code-mode clients; the union of both is the scope.

entity_ids
string

Comma-separated entity ids (ent_{n}), at most 8. A person id filters to that person's appearances; a channel id widens channel_ids. Ids only: a name answers 400 id_required. Resolve names first with GET /v1/entities/resolve.

about
string

Comma-separated entity ids (ent_{n}), at most 8. Only passages about these entities: excerpt pins, exact-name mentions and ad verdicts. Ids only: a name answers 400 id_required. Resolve names first with GET /v1/entities/resolve.

by
string

Comma-separated person ids (ent_{n}), at most 8. Only passages where one of these people speaks the query words. A passage can include other speakers' lines; each line with a known speaker starts with that speaker's name. A non-person id is refused with invalid_query naming its type. Speaker labels cover a minority of shows; an empty result carries a note saying whether the person is labeled anywhere. Ids only: a name answers 400 id_required. Resolve names first with GET /v1/entities/resolve.

kind
string

Comma-separated passage classes: sponsored, organic, mention. Combine with about to read what was said about a brand in ad reads or in organic talk. organic and mention leave out every passage tagged as an ad read, including one that also names other brands; add sponsored to include them.

after
string

Only media published at or after this instant. An after later than your plan's freshness gate is refused with freshness_requires_paid rather than widened. 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.

source
enum<string>

Restrict to one transcript source class. arcmira_premium on a plan without Premium transcripts is refused with filter_requires_paid.

Available options:
arcmira_premium,
creator_captions,
third_party_quick
limit
integer
default:5

Chunks to return, 1 to 20. Default 5.

Required range: 1 <= x <= 20
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

query
string
required

The q parameter echoed back.

limit
integer
required

The limit applied.

returned
integer
required

Chunks returned.

filters
object
required
window
object
required

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

chunks
object[]
required

Ranked slices. Empty means no hit in the shows we index; say so, never search the open web.

as_of
string | null
required

Newest published_at among the chunks. Null when there are none.

search_index
object
required

Health of the search index behind these results. Catalog routes are unaffected by it.

note
string
required

One steering sentence for the agent reading this.

access
object

The gate that reduced this response. Present only when something was withheld; carries the same code, gate, and unlock an outright refusal would.

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.