MentionCountsResponse
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"mentions",
"appearances",
"both"
],
"description": "The mode applied."
},
"window": {
"$ref": "#/components/schemas/PublicationWindow"
},
"channel_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "The channel ids counted."
},
"video_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "The video ids the count was scoped to. Empty when it was not."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_id": {
"type": "string",
"description": "Public entity id (\"ent_{n}\")."
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"page": {
"type": [
"string",
"null"
],
"description": "The entity's page on arcmira.com, absolute. Link the name to it when you write the entity into an answer. Null for a type the site has no page for."
},
"appearances_page": {
"type": [
"string",
"null"
],
"description": "For a person, the list of their appearances on arcmira.com (their page opens on it). Null for every other type."
},
"mentions_page": {
"type": [
"string",
"null"
],
"description": "For a person, the list of mentions of them on arcmira.com, page/mentions. Null for every other type: their page is the mentions list already."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL slug. Null when never slugged."
},
"channel_id": {
"type": [
"string",
"null"
]
},
"channel_name": {
"type": [
"string",
"null"
]
},
"channel_page": {
"type": [
"string",
"null"
],
"description": "The channel's page on arcmira.com, absolute. Null when no channel is known."
},
"count": {
"type": "integer",
"description": "Episodes the entity came up in."
},
"occurrences": {
"type": "integer",
"description": "Times the entity came up across those episodes (mentions or appearances per mode)."
},
"as_of": {
"type": [
"string",
"null"
],
"description": "Newest media in this count."
}
},
"required": [
"entity_id",
"name",
"type",
"page",
"appearances_page",
"mentions_page",
"slug",
"channel_id",
"channel_name",
"channel_page",
"count",
"occurrences",
"as_of"
]
},
"description": "One row per entity and channel, ranked by count."
},
"returned": {
"type": "integer"
},
"has_more": {
"type": "boolean",
"description": "True when more entity and channel pairs exist past limit."
},
"shared": {
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_id": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"page": {
"type": [
"string",
"null"
],
"description": "The entity's page on arcmira.com, absolute. Link the name to it when you write the entity into an answer. Null for a type the site has no page for."
},
"appearances_page": {
"type": [
"string",
"null"
],
"description": "For a person, their appearances list. Null otherwise."
},
"mentions_page": {
"type": [
"string",
"null"
],
"description": "For a person, the mentions of them. Null otherwise."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL slug. Null when never slugged."
},
"channel_count": {
"type": "integer",
"description": "How many of the requested channels carry this entity."
},
"by_channel": {
"type": "array",
"items": {
"type": "object",
"properties": {
"channel_id": {
"type": [
"string",
"null"
],
"description": "YouTube channel id."
},
"channel_name": {
"type": [
"string",
"null"
]
},
"channel_page": {
"type": [
"string",
"null"
],
"description": "The channel's page on arcmira.com, absolute. Null when no channel is known."
},
"count": {
"type": "integer",
"description": "Episodes the entity came up in."
},
"occurrences": {
"type": "integer",
"description": "Times the entity came up across those episodes (mentions or appearances per mode)."
},
"as_of": {
"type": [
"string",
"null"
],
"description": "Newest media in this count."
}
},
"required": [
"channel_id",
"channel_name",
"channel_page",
"count",
"occurrences",
"as_of"
]
}
}
},
"required": [
"entity_id",
"name",
"type",
"page",
"appearances_page",
"mentions_page",
"slug",
"channel_count",
"by_channel"
]
},
"description": "Entities on two or more of the requested channels, ranked by the smallest per-channel count. Empty for one channel."
},
"as_of": {
"type": [
"string",
"null"
],
"description": "Newest media across rows. Null when there are none."
},
"freshness": {
"allOf": [
{
"$ref": "#/components/schemas/Freshness"
},
{
"description": "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": {
"type": "object",
"properties": {
"tier": {
"type": "string",
"description": "The plan that lifts the freshness gate."
},
"url": {
"type": "string",
"description": "Where to start that plan."
}
},
"required": [
"tier",
"url"
],
"description": "Present with freshness when your plan's freshness gate cut the window; note says so."
},
"note": {
"type": "string",
"description": "One steering sentence for the agent reading this."
}
},
"required": [
"mode",
"window",
"channel_ids",
"video_ids",
"rows",
"returned",
"has_more",
"shared",
"as_of",
"note"
],
"example": {
"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."
}
}