tubitv.com APItubitv.com ↗
Access Tubi TV's free streaming catalog via API. List 100+ categories, browse movies and TV series with titles, cast, ratings, watch URLs, and more.
curl -X GET 'https://api.parse.bot/scraper/3b4482fa-50a4-475d-a612-75d5c78654eb/list_content?limit=5&category=horror' \ -H 'X-API-Key: $PARSE_API_KEY'
List movies and series for a given category on Tubi TV. Returns content with titles, descriptions, direct watch URLs, cast, ratings, and metadata. Use list_categories to discover available category slugs. Supports pagination via cursor.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return per page (max 50). |
| cursor | integer | Pagination cursor. Use next_cursor from a previous response to fetch the next page of results. |
| category | string | Category slug. Use list_categories to see all available slugs (e.g. documentary, horror, action, comedy, drama, sci_fi_and_fantasy, featured, movie_night). |
{
"type": "object",
"fields": {
"items": "array of content objects with id, title, description, type, year, duration_seconds, watch_url, actors, directors, tags, ratings, poster_url, thumbnail_url, has_subtitle, language",
"cursor": "integer - Current cursor position",
"category": "string - Category display name",
"description": "string - Category description",
"next_cursor": "integer or null - Next cursor for pagination, null if no more results",
"category_slug": "string - Category slug identifier",
"total_in_page": "integer - Number of items returned in this page"
},
"sample": {
"data": {
"items": [
{
"id": "100001935",
"tags": [
"Sci-Fi",
"Action",
"Horror"
],
"type": "movie",
"year": 2018,
"title": "The Predator",
"actors": [
"Boyd Holbrook",
"Trevante Rhodes"
],
"ratings": [
"R"
],
"language": "English",
"directors": [
"Shane Black"
],
"watch_url": "https://tubitv.com/movies/100001935/the-predator",
"poster_url": "https://canvas-lb.tubitv.com/opts/TWoKEi2YHDP4sw==/d90e28a3-7678-422d-9bea-30f2e10a76a1/CJADEL4EOgUxLjEuOQ==",
"description": "When a young boy accidentally sparks a battle with genetically-enhanced aliens, a ragtag crew of ex-Marines bands together to save the human race.",
"has_subtitle": true,
"thumbnail_url": "https://canvas-lb.tubitv.com/opts/R3LG94V0rzjJEQ==/0f0e12ae-394b-40f1-addb-a3c8731e8ea2/CIAFEOgCOgUxLjEuOQ==",
"duration_seconds": 6418
},
{
"id": "688842",
"tags": [
"Horror",
"Independent",
"Thriller"
],
"type": "movie",
"year": 2018,
"title": "Hereditary",
"actors": [
"Toni Collette",
"Alex Wolff"
],
"ratings": [
"R"
],
"language": "English",
"directors": [
"Ari Aster"
],
"watch_url": "https://tubitv.com/movies/688842/hereditary",
"poster_url": "https://canvas-lb.tubitv.com/opts/je6c_yHRaO8-Og==/c73ba1af-e710-4618-8514-9746cee5bd6c/CJADEL4EOgUxLjEuOQ==",
"description": "After their grandmother passes away, a family tries to outrun the sinister fate they've inherited.",
"has_subtitle": true,
"thumbnail_url": "https://canvas-lb.tubitv.com/opts/QDrRR_gGWu2YJg==/fbbfc5a5-90eb-42b2-bec6-8ae62a6518c9/CIAFEOgCOgUxLjEuOQ==",
"duration_seconds": 7646
}
],
"cursor": 0,
"category": "Horror ",
"description": "Your worst fears? We've got 'em, from classic spine-tinglers to modern slashers.",
"next_cursor": 5,
"category_slug": "horror",
"total_in_page": 2
},
"status": "success"
}
}About the tubitv.com API
The Tubi TV API gives developers structured access to Tubi's free streaming catalog across 100+ content categories through 2 endpoints. The list_categories endpoint enumerates every available genre or collection with its slug, and list_content returns paginated arrays of movies and TV series including titles, descriptions, cast, ratings, duration, and direct watch URLs for any given category.
Endpoints and Core Data
The API exposes two endpoints. list_categories takes no inputs and returns a flat list of category objects, each with an id, title, description, slug, and type. The slug field is what you pass to list_content as the category parameter. The total field tells you how many categories exist across the catalog.
list_content accepts a category slug, an optional limit (up to 50 items per page), and an optional integer cursor for pagination. The response includes an items array of content objects — each carrying id, title, description, type (movie or series), year, duration_seconds, watch_url, actors, directors, tags, and ratings. The response also surfaces category, category_slug, description for the category itself, total_in_page, cursor, and next_cursor.
Pagination
Pagination is cursor-based. Each list_content response includes a next_cursor integer that you pass back as the cursor parameter on the next request. When next_cursor is null, you have reached the end of that category's results. Combined with the 50-item page cap, this lets you page through large genre catalogs like drama or action incrementally.
Category Coverage
Tubi carries categories spanning documentaries, horror, action, comedy, drama, and many more niche collections. Because category slugs can change or expand, the recommended pattern is to call list_categories first to get the current slug list before constructing list_content requests.
- Build a cross-platform search index of free streaming titles using
title,description, andwatch_urlfields. - Track which movies or series are available in a specific genre by polling
list_contentwith a givencategoryslug. - Populate a recommendation engine with cast and director data from the
actorsanddirectorsresponse fields. - Display content ratings and release years to help users filter Tubi offerings before clicking through to
watch_url. - Audit catalog size per category by iterating pages with
next_cursorand countingtotal_in_pagevalues. - Aggregate tag metadata across categories to map thematic overlap between Tubi collections.
| 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 | 250 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 Tubi TV have an official developer API?+
What does `list_content` return for each title?+
items array includes id, title, description, type (movie or series), year, duration_seconds, watch_url, actors, directors, tags, and ratings. The response also includes category-level metadata: category, category_slug, and the category description.How does pagination work across large categories?+
list_content response returns a next_cursor integer. Pass that value as the cursor parameter on your next request to fetch the following page. When next_cursor is null, there are no further results in that category. Page size is controlled by the limit parameter, capped at 50.Can I search for a specific title or filter by year, rating, or actor?+
year, ratings, or actors fields. You can also fork this API on Parse and revise it to add a search or filter endpoint.