const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.arcmira.com/v1/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.arcmira.com/v1/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.arcmira.com/v1/search \
--header 'Authorization: Bearer <token>'{
"query": "Ramp corporate cards",
"limit": 5,
"returned": 1,
"filters": {
"channel_ids": [
"UC-DRzaGnL_vtBUpCFH5M0tg"
],
"entity_ids": [],
"about": [
{
"id": "ent_14",
"name": "Ramp",
"type": "organization"
}
],
"by": [],
"kind": [
"sponsored"
]
},
"window": {
"after": "2026-08-01T00:00:00Z",
"before": null
},
"chunks": [
{
"id": "UC-DRzaGnL_vtBUpCFH5M0tg/2026-08-04/dQw4w9WgXcQ.md#12",
"video_id": "dQw4w9WgXcQ",
"channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
"channel_name": "TBPN",
"video_title": "TBPN | Tuesday, August 4",
"speakers": [
"John Coogan"
],
"source": "creator_captions",
"source_label": "3rd Party (Video Creator)",
"published_at": "2026-08-04T17:00:00.000Z",
"text": "Ramp corporate cards have been on the show for a while now, and the pitch is still the same: spend less time on expenses.",
"start_seconds": 4787,
"line_start_seconds": 4787,
"watch_url": "/watch?v=dQw4w9WgXcQ&t=4787",
"cite_line": "[TBPN | Tuesday, August 4](/watch?v=dQw4w9WgXcQ&t=4787) · @1:19:47 · TBPN · Aug 4, 2026",
"score": 0.71,
"match": "phrase",
"about": [
{
"id": "ent_14",
"name": "Ramp",
"type": "organization"
}
],
"speakers_by": [
{
"id": "ent_27",
"name": "John Coogan",
"type": "person"
}
]
}
],
"as_of": "2026-08-04T17:00:00.000Z",
"search_index": {
"state": "live",
"missing_before": null
},
"note": "Quote text as a spoken beat of a few sentences and cite watch_url with published_at. State the window from window.after when you passed one."
}{
"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>"
}
}
}{
"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>"
}
}
}Retrieve spoken transcript slices for one topic
Search indexed YouTube and podcast transcripts for passages matching a word or phrase. Returns passage text, source metadata, publication dates, and timestamped watch links. Narrow to passages about an entity with about, or passages where a person speaks with by. Scope with channel_ids (or channel) and entity_ids (a person id filters to that person’s appearances). Filter to sponsored, organic or mention passages with kind. Every filter takes ids, never names: resolve a name first with GET /v1/entities/resolve, or the call answers 400 id_required naming the parameter. Results carry names beside ids (filters.about, filters.by, chunk about and speakers_by). Use one topic per call. Search results include text on every plan within the plan’s publication-date window. Explicitly requesting source=arcmira_premium on a plan without Premium transcripts is refused with filter_requires_paid. An after later than the plan’s freshness gate is refused with freshness_requires_paid rather than widened. A window the gate cut carries freshness (delay_days, served_through), unlock, and a note that says where results on this plan stop. Uses 4 credits per chunk 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.
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.arcmira.com/v1/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.arcmira.com/v1/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.arcmira.com/v1/search \
--header 'Authorization: Bearer <token>'{
"query": "Ramp corporate cards",
"limit": 5,
"returned": 1,
"filters": {
"channel_ids": [
"UC-DRzaGnL_vtBUpCFH5M0tg"
],
"entity_ids": [],
"about": [
{
"id": "ent_14",
"name": "Ramp",
"type": "organization"
}
],
"by": [],
"kind": [
"sponsored"
]
},
"window": {
"after": "2026-08-01T00:00:00Z",
"before": null
},
"chunks": [
{
"id": "UC-DRzaGnL_vtBUpCFH5M0tg/2026-08-04/dQw4w9WgXcQ.md#12",
"video_id": "dQw4w9WgXcQ",
"channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
"channel_name": "TBPN",
"video_title": "TBPN | Tuesday, August 4",
"speakers": [
"John Coogan"
],
"source": "creator_captions",
"source_label": "3rd Party (Video Creator)",
"published_at": "2026-08-04T17:00:00.000Z",
"text": "Ramp corporate cards have been on the show for a while now, and the pitch is still the same: spend less time on expenses.",
"start_seconds": 4787,
"line_start_seconds": 4787,
"watch_url": "/watch?v=dQw4w9WgXcQ&t=4787",
"cite_line": "[TBPN | Tuesday, August 4](/watch?v=dQw4w9WgXcQ&t=4787) · @1:19:47 · TBPN · Aug 4, 2026",
"score": 0.71,
"match": "phrase",
"about": [
{
"id": "ent_14",
"name": "Ramp",
"type": "organization"
}
],
"speakers_by": [
{
"id": "ent_27",
"name": "John Coogan",
"type": "person"
}
]
}
],
"as_of": "2026-08-04T17:00:00.000Z",
"search_index": {
"state": "live",
"missing_before": null
},
"note": "Quote text as a spoken beat of a few sentences and cite watch_url with published_at. State the window from window.after when you passed one."
}{
"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>"
}
}
}{
"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>"
}
}
}Authorizations
Query Parameters
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.
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.
Response
Success