## /movies Get list of movies ### Method GET ### Parameters | Parameter | Required | Options | Default | Description | |-----------|----------|---------|---------|-------------| | page | No | | 1 | Page number | | magnet | No | exist, all | exist | exist: Only return movies with magnet links
all: Return all movies | | filterType | No | star, genre, director, studio, label, series | | Filter type, must be used with filterValue
star: Actor
genre: Category
director: Director
studio: Producer
label: Publisher
series: Series | | filterValue | No | | | Filter value, must be used with filterType | | type | No | normal, uncensored | normal | normal: Censored movies
uncensored: Uncensored movies | ### Request Examples `/movies` Return the first page of movies with magnet links `/movies?filterType=star&filterValue=rsv&magnet=all` Return the first page of movies with actor ID rsv, including both movies with and without magnet links `/movies?page=2&filterType=genre&filterValue=4` Return the second page of movies with category ID 4, only returning movies with magnet links `/movies?type=uncensored` Return the first page of uncensored movies, only returning movies with magnet links ### Response Example ```json { // Movie list "movies": [ { "date": "2023-04-28", "id": "YUJ-003", "img": "https://www.javbus.com/pics/thumb/9n0d.jpg", "title": "夫には言えない三日間。セックスレスで欲求不満な私は甥っ子に中出しさせています。岬ななみ", "tags": ["HD", "Subtitled", "New release 3 days ago"] } // ... ], // Pagination information "pagination": { "currentPage": 1, "hasNextPage": true, "nextPage": 2, "pages": [1, 2, 3] }, // Filter information, note: only returned when request parameters include filterType and filterValue "filter": { "name": "岬ななみ", "type": "star", "value": "rsv" } } ``` ## /movies/search Search for movies ### Method GET ### Parameters | Parameter | Required | Options | Default | Description | |-----------|----------|---------|---------|-------------| | keyword | Yes | | | Search keyword | | page | No | | 1 | Page number | | magnet | No | exist, all | exist | exist: Only return movies with magnet links
all: Return all movies | | type | No | normal, uncensored | normal | normal: Censored movies
uncensored: Uncensored movies | ### Request Examples `/movies/search?keyword=三上` Search for movies with keyword "三上" on the first page, only returning movies with magnet links `/movies/search?keyword=三上&magnet=all` Search for movies with keyword "三上" on the first page, including both movies with and without magnet links ### Response Example ```json { // Movie list "movies": [ { "date": "2020-08-15", "id": "SSNI-845", "img": "https://www.javbus.com/pics/thumb/7t44.jpg", "title": "彼女の姉は美人で巨乳しかもドS！大胆M性感プレイでなす術もなくヌキまくられるドMな僕。三上悠亜", "tags": ["HD", "Subtitled"] } // ... ], // Pagination information "pagination": { "currentPage": 2, "hasNextPage": true, "nextPage": 3, "pages": [1, 2, 3, 4, 5] }, "keyword": "三上" } ``` ## /movies/{movieId} Get movie details ### Method GET ### Request Example `/movies/SSIS-406` Return details for movie with ID SSIS-406 ### Response Example ```json { "id": "SSIS-406", "title": "SSIS-406 才色兼備な女上司が思う存分に羽目を外し僕を連れ回す【週末限定】裏顔デート葵つかさ", "img": "https://www.javbus.com/pics/cover/8xnc_b.jpg", // Cover image size "imageSize": { "width": 800, "height": 538 }, "date": "2022-05-20", // Movie duration "videoLength": 120, "director": { "id": "hh", "name": "五右衛門" }, "producer": { "id": "7q", "name": "エスワンナンバーワンスタイル" }, "publisher": { "id": "9x", "name": "S1 NO.1 STYLE" }, "series": { "id": "xx", "name": "xx" }, "genres": [ { "id": "e", "name": "巨乳" } // ... ], // Actor information, a movie may include multiple actors "stars": [ { "id": "2xi", "name": "葵つかさ" } ], // Movie preview images "samples": [ { "alt": "SSIS-406 才色兼備な女上司が思う存分に羽目を外し僕を連れ回す【週末限定】裏顔デート葵つかさ - Sample image - 1", "id": "8xnc_1", // Large image "src": "https://pics.dmm.co.jp/digital/video/ssis00406/ssis00406jp-1.jpg", // Thumbnail "thumbnail": "https://www.javbus.com/pics/sample/8xnc_1.jpg" } // ... ], // Similar movies "similarMovies": [ { "id": "SNIS-477", "title": "クレーム処理会社の女社長土下座とカラダで解決します夢乃あいか", "img": "https://www.javbus.com/pics/thumb/4wml.jpg" } // ... ], "gid": "50217160940", "uc": "0" } ``` ## /magnets/{movieId} Get movie magnet links ### Method GET ### Parameters | Parameter | Required | Options | Default | Description | |-----------|----------|---------|---------|-------------| | gid | No | | | gid from movie details. If provided together with `uc`, it will be used directly; otherwise auto-fetched from the movie page | | uc | No | | | uc from movie details. If provided together with `gid`, it will be used directly; otherwise auto-fetched from the movie page | | sortBy | No | date, size | size | Sort by date or size, must be used with sortOrder | | sortOrder | No | asc, desc | desc | Ascending or descending, must be used with sortBy | ### Request Examples `/magnets/SSNI-730` Return magnet links for movie with ID SSNI-730, with `gid` and `uc` auto-fetched `/magnets/SSNI-730?gid=42785257471&uc=0` Return magnet links for movie with ID SSNI-730, using the provided `gid` and `uc` `/magnets/SSNI-730?gid=42785257471&uc=0&sortBy=size&sortOrder=asc` Return magnet links for movie with ID SSNI-730, sorted by size in ascending order `/magnets/SSNI-730?gid=42785257471&uc=0&sortBy=date&sortOrder=desc` Return magnet links for movie with ID SSNI-730, sorted by date in descending order ### Response Example ```json [ { "id": "17508BF5C17CBDF7C77E12DAAD1BDAB325116585", "link": "magnet:?xt=urn:btih:17508BF5C17CBDF7C77E12DAAD1BDAB325116585&dn=SSNI-730-C", // Whether it's HD "isHD": true, "title": "SSNI-730-C", "size": "6.57GB", // Size in bytes "numberSize": 7054483783, "shareDate": "2021-03-14", // Whether it has subtitles "hasSubtitle": true } // ... ] ``` ## /stars/{starId} Get actor details ### Method GET ### Parameters | Parameter | Required | Options | Default | Description | |-----------|----------|---------|---------|-------------| | type | No | normal, uncensored | normal | normal: Censored movie actor details
uncensored: Uncensored movie actor details | ### Request Examples `/stars/2xi` Return details for actor 葵つかさ `/stars/2jd?type=uncensored` Return details for actor 波多野結衣 ### Response Example ```json { "avatar": "https://www.javbus.com/pics/actress/2xi_a.jpg", "id": "2xi", "name": "葵つかさ", "birthday": "1990-08-14", "age": "32", "height": "163cm", "bust": "88cm", "waistline": "58cm", "hipline": "86cm", "birthplace": "大阪府", "hobby": "ジョギング、ジャズ鑑賞、アルトサックス、ピアノ、一輪車" } ```