API interface Introduction

BaoHua Lee edited this page Sep 2, 2018 · 3 revisions

List all videos

1. List all videos

Interface function

List all videos and Video information

URL

https://api.theporn.xyz/v1/video/list

Support Format

JSON

HTTP request method

GET

Request parameter

parameter must type description
start false int The starting position of the video, the default is 0
limit false int The number of videos, the default is 20, the maximum 200
sort false int Sort by, 1: Add video descending 2: Add video ascending The default is 1

response

filed type description
code int Returns the result status. 200: normal; other error code
description string Return result description
msg string code description 200:success
data.avdatas list Video list

example

URL:https://api.theporn.xyz/v1/video/list?start=1&limit=2

 {"msg": "success", "description": "", "code": 200, "data": {"avdatas": [{"tid": 18763, "preview_video_url": "https;//s2.tpcdn.xyz/videos/dcc397c56640e0caa9068c2bf894ca53/preview.mp4", "view_count": 5, "video": {"resolution": [588, 392]}, "duration": 1645.046, "embed_iframe_url": "https://thepornvideos.xyz/video/embed/18763?from_lang=english", "like_count": 0, "big_cover_image_url": "https:/s2.tpcdn.xyz/videos/dcc397c56640e0caa9068c2bf894ca53/cover/1_750?u_c_i_t=1", "small_cover_image_url": "https:/s2.tpcdn.xyz/videos/dcc397c56640e0caa9068c2bf894ca53/cover/5_505_259?u_c_i_t=1", "preview_embed_iframe_url": "https://thepornvideos.xyz/video/preview/18763?from_lang=english", "dislike_count": 0, "title": "\u5927\u5b78\u5c0f\u60c5\u4fb6\u516c\u5bd3\u6fc0\u60c5\u4e7e\u70ae\u611b\u611b\uff0c\u808f\u8d77\u4f86\u771f\u8212\u670d1\u8ce0\u73871.995\uff0c\u5b9a\u4f4d9.95", "hash_id": "dcc397c56640e0caa9068c2bf894ca53"}, {"tid": 18762, "preview_video_url": "https;//s2.tpcdn.xyz/videos/f8fff2639091c514ea51b6406843c5cc/preview.mp4", "view_count": 5, "video": {"resolution": [1280, 720]}, "duration": 696.622, "embed_iframe_url": "https://thepornvideos.xyz/video/embed/18762?from_lang=english", "like_count": 0, "big_cover_image_url": "https:/s2.tpcdn.xyz/videos/f8fff2639091c514ea51b6406843c5cc/cover/1_750?u_c_i_t=1", "small_cover_image_url": "https:/s2.tpcdn.xyz/videos/f8fff2639091c514ea51b6406843c5cc/cover/5_505_259?u_c_i_t=1", "preview_embed_iframe_url": "https://thepornvideos.xyz/video/preview/18762?from_lang=english", "dislike_count": 0, "title": "\u5929\u7136\u7d20\u4eba\u7cfb\u5217-\u521d\u6200\u822c\u7684\u9752\u6f80\u505a\u611b-4 - \u641c\u7d22\u5fae\u4fe1\u516c\u773e\u865f\uff1a\u6211\u53eb\u58de\u58de", "hash_id": "f8fff2639091c514ea51b6406843c5cc"}], "total_count": 8194}}

Get Video By jav_id or tid

1. Get Video By jav_id or tid

Interface function

Get Video By jav_id or tid

URL

https://api.theporn.xyz/v1/video/info/{jav_id}

https://api.theporn.xyz/v1/video/info/{tid}

Support Format

JSON

HTTP request method

GET

Request parameter

parameter must type description
tid false int Video unique ID
jav_id false string JAV unique ID

response

filed type description
code int Returns the result status. 200: normal; other error code
description string Return result description
msg string code description 200:success
data.avdata object Video information

example

URL:https://api.theporn.xyz/v1/video/info/13453

URL:https://api.theporn.xyz/v1/video/info/WANZ-653

Search videos

1. Search videos

Interface function

Search videos by keywords

URL

https://api.theporn.xyz/v1/search

Support Format

JSON

HTTP request mothod

GET

reqeust parameter

parameter must type description
start false int The starting position of the video, the default is 0
limit false int The number of videos, the default is 20, the maximum 200
keyword true string Search keywords

response

filed type description
code int Returns the result status. 200: normal; other [error code]https://github.com/theporn/theporn.api.en/wiki/Error-Codes)
description string Return result description
msg string code description 200:success
data.avdatas list video list

example

URL:https://api.theporn.xyz/v1/search?keyword=sister&start=0&limit=2

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.