Find Caption Matches

Finds exact text in caption tracks without modifying them. Matching uses the
same normalization, composite-media boundaries, and time coordinates as the
targeted caption edit endpoint. Fuzzy alternatives are returned separately
as suggestions and are never reported as exact matches. A resolved match
means the wording was located; a later write can still fail authorization,
version, or edit-boundary checks.

When more than 10 exact matches exist, use the one-based occurrence
parameter to retrieve a specific later match.

Authentication and request validation failures apply to the whole request.
Missing, inaccessible, or otherwise unreadable media are reported as
per-media statuses without exposing whether an inaccessible ID exists.

Requires api token with one of the following permissions

Read all folder and media data

Tokens with the "Act with a team member's permissions" permission
(all:delegate_to_contact_permissions scope) can also be used.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
media_ids
array of strings, unique
required
length between 1 and 50

Explicit hashed IDs of the media whose captions should be searched.

media_ids*
string
required
length between 1 and 500

Exact caption wording to locate.

string
length ≄ 1

Exact IETF language tag. Omit when each media has only one caption track.

integer
≄ 1

One-based exact occurrence to return, including occurrences after the first 10.

integer
≄ 0

Optional start of a time range used to disambiguate the match.

integer
≄ 0

Optional end of a time range used to disambiguate the match.

Headers
string
required
Defaults to 2026-09
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json