小影API 小影API

Movies

Movie aggregation service: categories, lists, details, episode lists, and playback URLs (m3u8) for films and TV shows — build a complete streaming site with the "list → detail → play" flow.

/api/movies/

Service Description

The movie service aggregates data from a film and TV site and provides the full chain of categories, filters, home recommendations, lists, details, episode lists and playback URLs (m3u8). Following "category, list, detail, playback URL" is enough to build a movie site, and the search endpoint looks titles up by keyword.

Key IDs follow a fixed order: the id returned by the categories API goes to the list API's type_id, an item's id goes to the detail API's vod_id, and the sid / nid from the detail response go to the playback API. Chaining them yields a complete playback flow.

Metadata such as title, synopsis and episode count is cached for a long time, while playback URLs (m3u8) expire and are cached only briefly, so do not cache playback URLs on the client for long. This service requires project signature authentication.

555 Movies

555 Movies (5dy4.vip) Signature Required

Crawls the source site in real time and caches the results. Data (titles / details / episode counts) is cached longer, while playback URLs (m3u8) are cached briefly so they stay fresh.

GET /api/movies/movie_555/categories Total calls: 509

Category List

Get available categories (main categories / sub-categories / specials).

  • Use it to build site navigation: main holds the primary categories and sub holds the TV-series sub-categories; every returned id can be passed to the list endpoint as type_id.
GET /api/movies/movie_555/filters Total calls: 20981

Filters

Get the filters available for a category: sub-categories, region, genre, language, year, and sort order.

Required: category ID (see the category list endpoint), e.g. 1=Movies 2=TV Series.

  • Returns data.sub_types (sub-categories; pass value back as type_id) and data.groups.
  • data.groups holds five groups — region, genre, language, year and sort order; pass value back to the list endpoint as the same-named parameter.
  • Available values differ per category (anime offers Japan / Europe & America, variety offers Reality Show / Talk Show, and so on), and the year list grows as the site adds titles. Render the filter bar from this endpoint instead of hard-coding values in the client.
GET /api/movies/movie_555/home Total calls: 252

Home Feed

Get home feed data: the carousel and all recommendation blocks (best of the week / month, rankings, and more).

  • Returns all home recommendation blocks in one call, ready to render the site home page.
GET /api/movies/movie_555/list Total calls: 112265

Category List

Get a movie list by category, with pagination, sorting, and combined year / region / genre / language filters.

Required: category ID — 1=Movies 2=TV Series 3=Variety & Documentary 4=Anime 124=Premium 126=Short Dramas (sub-categories come from sub in the category list endpoint).

Optional: page number, starting from 1, default 1.

Optional: sort order time / hits / score.

Optional: filter by year, e.g. 2026 (values come from the year group of the filters endpoint).

Optional: filter by region, e.g. 大陆 (values come from the area group of the filters endpoint).

Optional: filter by genre, e.g. 动作 (values come from the genre group of the filters endpoint).

Optional: filter by language, e.g. 国语 (values come from the lang group of the filters endpoint).

  • Returns data.items (movie list) and data.pagination (pagination info).
  • Region / genre / language / year / sort can be combined freely and the source site returns the intersection. When a combination matches nothing, data.items is an empty array rather than an error.
GET /api/movies/movie_555/detail Total calls: 479944

Movie Details

Get movie details: synopsis, director / cast metadata, playback sources, and episode lists.

Required: movie ID (from the id field in list / search results).

  • Returns data.sources (playback sources); each source contains episodes, whose sid / nid are used by the playback URL endpoint.
  • Returns 40001 when the movie does not exist.
GET /api/movies/movie_555/play Total calls: 1625128

Playback URL

Get the m3u8 playback URL for a given playback source and episode.

Required: playback source index, from sources[].sid in the detail response.

Required: episode index, from episodes[].nid (usually 1 for movies).

  • data.m3u8 is a playable URL; it is time-limited, so it is cached only briefly (30 minutes by default).
  • The source URL is returned directly without proxying.
  • Returns 40001 when sid / nid are out of range or the source site has no valid URL.
  • An online player is provided below: it auto-plays after a successful request, and you can also paste any m3u8 URL to test.
Playback Test hls.js / mp4 Plays automatically after the request above succeeds; you can also paste any playback URL (m3u8 / mp4) to test.
XiaoYingAPI · Unified API Aggregation Service