Filmot APIfilmot.com ↗
Search Filmot's YouTube subtitle database by keyword, find bilingual subtitle pairs, and look up channel metadata with subscriber and view counts.
What is the Filmot API?
The Filmot API exposes 3 endpoints that let you search YouTube subtitle data and channel metadata from Filmot's indexed database. The search_subtitles endpoint returns up to 60 videos per page with matching subtitle snippets, view counts, and upload dates. The search_transverso endpoint finds cross-language subtitle pairs, returning the source and target text alongside timestamps. The search_channels endpoint looks up channels by name with subscriber and view count figures.
curl -X GET 'https://api.parse.bot/scraper/17532800-a068-4b63-a3c0-61fa737691d9/search_channels?query=MrBeast' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace filmot-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.filmot_youtube_subtitle_search_api import Filmot, Channel, SubtitleMatch, Video
filmot = Filmot()
# Search for YouTube channels by name
for channel in filmot.channels.search(query="Vsauce"):
print(channel.name, channel.subscriber_count_display, channel.handle)
# Search subtitles across two languages (translation search)
for match in filmot.subtitlematches.search(query="thank you", source_lang="en", target_lang="fr", source_lang_name="English", target_lang_name="French"):
print(match.video_id, match.source_text, match.target_text)
# Search video subtitles by keyword with pagination
for video in filmot.videos.search(query="climate change", limit=120):
print(video.title, video.channel_name, video.view_count)
Search for YouTube channels by name using autocomplete. Returns channel metadata including subscriber count, view count, thumbnail, and handle. Results are ranked by relevance to the query string.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Channel name to search for |
{
"type": "object",
"fields": {
"query": "search query string that was used",
"total": "integer total number of matching channels",
"channels": "array of channel objects with channel_id, name, thumbnail_url, subscriber_count, subscriber_count_display, view_count, view_count_display, and handle"
},
"sample": {
"data": {
"query": "MrBeast",
"total": 100,
"channels": [
{
"name": "MrBeast",
"handle": "@MrBeast",
"channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"view_count": 55490911305,
"thumbnail_url": "http://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
"subscriber_count": 497000000,
"view_count_display": "55.5B",
"subscriber_count_display": "497M"
}
]
},
"status": "success"
}
}About the Filmot API
Subtitle Search
The search_subtitles endpoint accepts a query string and an optional page integer for pagination, returning up to 60 video results per page. Each item in the videos array includes video_id, title, channel_name, channel_id, view_count, upload_date, duration, and a subtitle_snippet showing the matched text in context. The total_clips field returns a human-readable count (e.g., '3.4M clips found') indicating the scale of matching results across Filmot's index.
Cross-Language Subtitle Matching
The search_transverso endpoint accepts a query alongside source_lang and target_lang language codes (e.g., en, fr, de, es) or their display-name equivalents via source_lang_name and target_lang_name. Each result in the results array includes video_id, video_url, timestamp_seconds, source_text, and target_text, making it straightforward to compare how a phrase is rendered across subtitle tracks. This is useful for translation research, language learning tools, and finding how specific terminology is localized in real video content.
Channel Search
The search_channels endpoint functions as an autocomplete lookup — pass a partial or full channel name as query and the response returns a channels array with each channel's channel_id, name, thumbnail_url, subscriber_count, subscriber_count_display, and view_count. The total field gives the integer count of matched channels, which can be large for common name fragments.
The Filmot API is a managed, monitored endpoint for filmot.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when filmot.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official filmot.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a language learning tool that surfaces real YouTube examples of a phrase in two languages using
search_transverso - Index YouTube video content by keyword to build a searchable clip library using
search_subtitles - Identify which channels have covered a specific topic by matching
channel_nameandchannel_idfrom subtitle results - Track how often a product name or brand term appears in YouTube subtitles by iterating
search_subtitlespages and summingtotal_clips - Resolve a channel name to its
channel_idandsubscriber_countfor use in downstream YouTube Data API calls viasearch_channels - Analyze how a technical term is localized across subtitle languages by querying
search_transversowith differentsource_lang/target_langpairs - Build a journalism tool that finds video clips mentioning a specific keyword along with
upload_dateandview_countfor editorial context
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Filmot offer an official developer API?+
What does `search_subtitles` return beyond the matching text?+
video_id, title, channel_name, channel_id, view_count, upload_date, duration, and a subtitle_snippet showing the matched phrase in context. The total_clips field gives a display string indicating the total number of matching subtitle clips across Filmot's index, not just the current page.Does `search_transverso` support all language pairs?+
en, fr, de, or es via source_lang and target_lang. Pairs with lower subtitle coverage on YouTube — such as less-common languages — will return fewer results or none. The total field in the response reflects actual match count for the requested pair.Does the API return full subtitle transcripts for a video?+
search_subtitles returns a subtitle_snippet — a short excerpt around the matched keyword — not a full transcript. Full per-video transcript retrieval is not currently covered. You can fork this API on Parse and revise it to add a full-transcript endpoint if your use case requires complete caption text.Is there a way to filter subtitle search results by upload date, channel, or view count?+
search_subtitles endpoint accepts only query and page as inputs; server-side filtering by date range, channel, or view count is not currently exposed. The upload_date, channel_id, and view_count fields are returned per result so you can filter client-side. You can fork this API on Parse and revise it to add those filter parameters if Filmot's interface supports them.