const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.arcmira.com/v1/mentions/counts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.arcmira.com/v1/mentions/counts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.arcmira.com/v1/mentions/counts \
--header 'Authorization: Bearer <token>'{
"mode": "mentions",
"window": {
"after": "2026-06-01T00:00:00Z",
"before": null
},
"channel_ids": [
"UC-DRzaGnL_vtBUpCFH5M0tg",
"UClWkDGXEzsh77GAhs90wpXw"
],
"video_ids": [],
"rows": [
{
"entity_id": "ent_14",
"name": "Ramp",
"type": "organization",
"page": "https://arcmira.com/org/ramp",
"appearances_page": null,
"mentions_page": null,
"slug": "ramp",
"channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
"channel_name": "TBPN",
"channel_page": "https://arcmira.com/yt/@TBPNLive",
"count": 23,
"as_of": "2026-08-28T17:00:00.000Z"
},
{
"entity_id": "ent_14",
"name": "Ramp",
"type": "organization",
"page": "https://arcmira.com/org/ramp",
"appearances_page": null,
"mentions_page": null,
"slug": "ramp",
"channel_id": "UClWkDGXEzsh77GAhs90wpXw",
"channel_name": "Moment of Truth",
"channel_page": "https://arcmira.com/yt/@MomentofTruthShow",
"count": 3,
"occurrences": 7,
"as_of": "2026-08-21T16:00:00.000Z"
}
],
"returned": 2,
"has_more": false,
"shared": [
{
"entity_id": "ent_14",
"name": "Ramp",
"type": "organization",
"page": "https://arcmira.com/org/ramp",
"appearances_page": null,
"mentions_page": null,
"slug": "ramp",
"channel_count": 2,
"by_channel": [
{
"channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
"channel_name": "TBPN",
"channel_page": "https://arcmira.com/yt/@TBPNLive",
"count": 23,
"as_of": "2026-08-28T17:00:00.000Z"
},
{
"channel_id": "UClWkDGXEzsh77GAhs90wpXw",
"channel_name": "Moment of Truth",
"channel_page": "https://arcmira.com/yt/@MomentofTruthShow",
"count": 3,
"occurrences": 7,
"as_of": "2026-08-21T16:00:00.000Z"
}
]
}
],
"as_of": "2026-08-28T17:00:00.000Z",
"note": "Catalog counts, all-time unless you passed a window. shared ranks true overlap by the smallest per-channel count. Use search_transcripts afterwards only for quotes."
}{
"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>"
}
}
}Ranked catalog counts of who a set of channels mention
A small ranked table of entity and channel counts, all-time unless after is set. Pass channel_ids for what shows talk about and entity_types to match the question (topic for subjects, person for guests, organization,product for brands). Pass video_ids with one id from GET /v1/channels//videos for what a single episode mentions. Two or more channel_ids also return shared, the entities on more than one of them ranked by the smallest per-channel count, which is true overlap. 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 ranked entry 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/mentions/counts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.arcmira.com/v1/mentions/counts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.arcmira.com/v1/mentions/counts \
--header 'Authorization: Bearer <token>'{
"mode": "mentions",
"window": {
"after": "2026-06-01T00:00:00Z",
"before": null
},
"channel_ids": [
"UC-DRzaGnL_vtBUpCFH5M0tg",
"UClWkDGXEzsh77GAhs90wpXw"
],
"video_ids": [],
"rows": [
{
"entity_id": "ent_14",
"name": "Ramp",
"type": "organization",
"page": "https://arcmira.com/org/ramp",
"appearances_page": null,
"mentions_page": null,
"slug": "ramp",
"channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
"channel_name": "TBPN",
"channel_page": "https://arcmira.com/yt/@TBPNLive",
"count": 23,
"as_of": "2026-08-28T17:00:00.000Z"
},
{
"entity_id": "ent_14",
"name": "Ramp",
"type": "organization",
"page": "https://arcmira.com/org/ramp",
"appearances_page": null,
"mentions_page": null,
"slug": "ramp",
"channel_id": "UClWkDGXEzsh77GAhs90wpXw",
"channel_name": "Moment of Truth",
"channel_page": "https://arcmira.com/yt/@MomentofTruthShow",
"count": 3,
"occurrences": 7,
"as_of": "2026-08-21T16:00:00.000Z"
}
],
"returned": 2,
"has_more": false,
"shared": [
{
"entity_id": "ent_14",
"name": "Ramp",
"type": "organization",
"page": "https://arcmira.com/org/ramp",
"appearances_page": null,
"mentions_page": null,
"slug": "ramp",
"channel_count": 2,
"by_channel": [
{
"channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
"channel_name": "TBPN",
"channel_page": "https://arcmira.com/yt/@TBPNLive",
"count": 23,
"as_of": "2026-08-28T17:00:00.000Z"
},
{
"channel_id": "UClWkDGXEzsh77GAhs90wpXw",
"channel_name": "Moment of Truth",
"channel_page": "https://arcmira.com/yt/@MomentofTruthShow",
"count": 3,
"occurrences": 7,
"as_of": "2026-08-21T16:00:00.000Z"
}
]
}
],
"as_of": "2026-08-28T17:00:00.000Z",
"note": "Catalog counts, all-time unless you passed a window. shared ranks true overlap by the smallest per-channel count. Use search_transcripts afterwards only for quotes."
}{
"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
Only media published at or after this instant. Counts are all-time without it. 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