Search FAQs

Filmot's public API provides these endpoints. The API documentation lists their parameters, output fields and usage limits:

• getvideos: stored metadata and optional subtitles for specified video IDs.
• getchannelvideos: recent videos from one or more channels.
• getsubtitlesearch: subtitle, caption or transcript search with export formats.
• getmetadatasearch: title and metadata search.
• getchannels: channel profiles and analytics.
• getsearchchannels: channel lookup by name, @handle or UC channel ID.
• getadvancedchannelsearch: advanced channel search with filters such as channel creation date.

Subtitle search can return matching text snippets with their start times; snippets are enabled by default. Results can be sorted by criteria such as view count, upload date, duration or subtitle-text relevance.

To make requests, sign in and create an API key on API Keys. API access is subject to your account's allowance and the documented endpoint limits.

Yes. Filmot's API documentation is based on an OpenAPI specification available at /openapi.json. You can load the JSON into compatible API tools or client generators. A Markdown version for scripts and AI agents is available at /api-documentation-md.

Companion reference pages cover:

• /api-documentation/search-syntax: subtitle and title expressions. Query strings must be URL-encoded.
• /api-documentation/reference-values: accepted country IDs and subtitle language codes.

API calls require a key. Sign in and create one on API Keys.

Yes. The getvideos endpoint returns stored video metadata for one YouTube video ID or a comma-delimited list of IDs. Each record includes the video ID, upload date, duration, title, channel ID and channel name. Use the columns parameter to request additional fields, such as the stored description, view count, like count, category and subtitle, caption or transcript tracks. IDs that Filmot does not know are omitted from the response.

A request can contain up to 200 video IDs, or up to 10 when raw subtitles are requested. The related getchannelvideos endpoint returns recent videos for up to 10 channels identified by their UC channel IDs, with the same selectable fields.

Sign in and create an API key on API Keys after accepting the Terms of Service. See the API documentation for the complete parameters, limits and response format.

Yes. The getchannelvideos API endpoint returns recent videos for up to 10 channels per request, identified by their UC channel IDs. Each video record includes its ID, title, upload date, duration, channel ID and channel name. You can request additional fields, such as the stored description, view count and like count.

The response contains video IDs rather than ready-made YouTube URLs. To build a link, append the ID to https://www.youtube.com/watch?v=.

A request returns at most 200 videos across the requested channels, reduced to 10 when raw subtitles are included. Use the page parameter to request further pages for each channel.

Create an API key on API Keys and consult the API documentation for the complete parameters and response format.

Yes. The /getmetadatasearch endpoint accepts an unlisted parameter: 1 selects records marked unlisted, 0 selects records marked listed, and -1 includes both. The related completeData parameter accepts 1 for complete records, 0 for partial records and -1 for both.

The /getchannelvideos and /getvideos endpoints do not have an unlisted filter. You can request isunlisted in their columns parameter to see the status recorded for each returned video.

Status information may be incomplete or outdated. Use an API key from API Keys and consult the API documentation for applicable limits and terms.