Search what's said on YouTube
arcmira_youtube_searchSearches what was said in YouTube videos, podcasts on YouTube included, and returns the matching passages: the lines, often with who said each one, and for each passage the video title, channel, publish date, the second it starts and a watch link that opens there. Use Arcmira when the user asks what someone said on YouTube or in a podcast, wants a quote with the moment it was said, or asks what YouTube is saying about a person, brand or topic, who sponsors a channel, or which creators recommend a product. query takes the words as the user put them. channel, about and by narrow the search and take names as the user wrote them, or ids from a result; resolved says which entity each name matched, and assumed marks a best guess to tell the user about. With neither after nor before it covers the last 90 days.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | Up to 8 people who say the words: the name as the user wrote it, or an id from the speakers of a result. Speaker labels cover part of the index. | |
| kind | No | Passage classes to keep: sponsored (ad reads), organic (recommendations nobody bought) and mention. | |
| about | No | Up to 8 people, brands or companies the passage is about: the name as the user wrote it, or an id from the about or speakers of a result (ent_ and a number). Topic words go in query. | |
| after | No | Only videos published on or after this ISO date, like 2026-08-01. With neither after nor before, the last 90 days. | |
| limit | No | Passages to return, 1 to 20. Default 5. | |
| query | Yes | The words to find, a topic or a phrase, as the user put them. | |
| before | No | Only videos published before this ISO date; the day itself is left out. | |
| intent | No | Optional: the user's request in a few words. Logged with this call to improve Arcmira. | |
| source | No | Only one transcript source: arcmira_premium (Arcmira's transcripts with speakers), creator_captions (the channel's own captions) or third_party_quick (YouTube's automatic captions). | |
| channel | No | Up to 8 YouTube channels or shows: the name as the user wrote it, like TBPN, or a channel_id from a result (UC plus 22 characters). |