What the index holds for a channel
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.arcmira.com/v1/channels/{channel_id}/coverage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.arcmira.com/v1/channels/{channel_id}/coverage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.arcmira.com/v1/channels/{channel_id}/coverage \
--header 'Authorization: Bearer <token>'{
"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."
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}Search
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; to ask for a channel, send feedback with its channel id. 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
What the index holds for a channel
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.arcmira.com/v1/channels/{channel_id}/coverage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.arcmira.com/v1/channels/{channel_id}/coverage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.arcmira.com/v1/channels/{channel_id}/coverage \
--header 'Authorization: Bearer <token>'{
"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."
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"reason": "no_credential",
"param": "<string>",
"gate": "rows",
"resource": {
"kind": "media_rows",
"beyond_row": 123
},
"unlock": {
"tier": "<string>",
"url": "<string>",
"offer": null,
"action": {
"kind": "<string>",
"method": "<string>",
"url": "<string>"
}
},
"retry_after_seconds": 123,
"details": {
"quote": {
"quarters": 123,
"rows": 123,
"charge": {
"unit": "rows",
"amount": 123,
"from": "included"
},
"max_on_demand_cents": 123
},
"limit": {
"kind": "plan_credits",
"unit": "credits",
"amount": 123,
"used": 123,
"resets_at": "<string>"
},
"url": "<string>"
}
}
}