API接口

API价格

API接口

解析视频链接

允许已授权的用户通过此接口更新自己的信息。
  • URL：https://www.xiazaitool.com/api/parseVideoUrl
  • Method：Post
  • 需要登录：否
  • 需要鉴权：是

请求参数

参数
类型
说明
约束
url
String
解析链接
需要符合解析平台链接要求，例如小红书中要包含 xiaohongshu.com
token
String
token
购买请联系我们获取

请求示例

可以仅传递部分请求参数。
{
  "url":"http://xhslink.com/a/PJBKG1EJF5ebb",
  "token":"test"
}

响应参数

参数
参数
类型
是否必填
说明
status
int
是
状态码，200成功，500失败，429剩余额度不足
success
Boolean
是
是否成功
message
string
否
提示信息
data
object
是
响应数据
title
string
是
视频标题
coverUrls
string
是
封面图片链接
videoUrls
string
是
视频链接
leftTimes
string
是
剩余解析次数
isVideo
bool
是
是否为图片
like
int
否
点赞数
comment
int
否
评论数
collect
int
否
收藏数
createTime
string
否
作品发布时间
pics
array
否
图片链接解析的图片组，字符串集合
time
string
是
响应时间

成功响应

条件：请求参数合法，并且用户身份校验通过。
状态码：200 OK
响应示例：响应会将修改后的用户信息数据返回，一个id为 1234 的用户设置他们的姓名后将会返回：
{
    "status": 200,
    "success": true,
    "message": "操作成功",
    "data": {
        "pics": null,
        "title": "一口气看完《苏里南》，全长38分钟#一剪到底 #韩剧 #苏里南 #唐人街 #我的观影报告",
        "coverUrls": "https://sns-webpic-qc.xhscdn.com/202504272138/203e041fb35788553bfb6e3df839dae7/1040g2sg31gp9hksa34005ofk9clk0tb2s2emssg!nd_prv_wlteh_webp_3",
        "videoUrls": "https://v83-017.douyinvod.com/ddc2970e3ee1b33810f2bb6d778952ac/6619e99b/video/tos/cn/tos-cn-ve-15c001-alinc2/osGeBphZsZDStNDTAhucpigIzNAWfAUNNBmysE/?a=1128&ch=0&cr=0&dr=0&cd=0%7C0%7C0%7C0&cv=1&br=996&bt=996&cs=0&ds=3&ft=7EYOIDDhNdIVwMyJBMfusYLsGoySYsvJHqCThbLfK&mime_type=video_mp4&qs=0&rc=ZGc1NGYzN2k4ZDw0ZTs5OEBpM2dqcjQ6ZmhzbzMzNGkzM0BhMl5gNDAyNl8xLjAvNi5iYSMwbmEucjQwYjNgLS1kLTBzcw%3D%3D&btag=10e000b8001&cquery=100y&dy_q=1712968320&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20240413083200ED14CBB5F8F9AA4347D7",
        "leftTimes": 1000,
        "usageTimes": 2000,
        "isVideo": true,
        "like": 10,
        "comment": 18,
        "collect": 15,
        "createTime": "2025-04-27 17:06:46"
    },
    "time": "2025-04-27 21:37:46"
}

错误响应

条件：请求数据非法，例如 url不符合规则。
状态码：500 BAD REQUEST
响应示例:

{
    "status": 500,
    "success": false,
    "message": "链接不符合要求！",
    "data": null,
    "time": "2024-04-13 08:35:54"
}

注意事项

💡 以上出入参全部采用json格式字符串传输

调用示例

Python


import requests

# 定义请求的URL
url = "https://www.xiazaitool.com/api/parseVideoUrl"

# 定义请求参数
payload = {
    "url": "https://v.douyin.com/iLxWK7jr/",
    "token": "test"
}

# 定义请求头（可选）
headers = {
    "Content-Type": "application/json"
}

# 发送 POST 请求
response = requests.post(url, json=payload, headers=headers)

# 输出响应状态码和内容
print("Status Code:", response.status_code)
print("Response Body:", response.json())

Java


import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;

public class PostRequestExample {
    public static void main(String[] args) {
        try {
            // 1. 定义请求的 URL
            URL url = new URL("https://www.xiazaitool.com/api/parseVideoUrl");
            
            // 2. 打开连接
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/json"); // 设置请求头
            conn.setDoOutput(true);

            // 3. 定义请求参数（JSON 格式）
            String jsonInputString = "{\"url\": \"https://v.douyin.com/iLxWK7jr/\", \"token\": \"test\"}";

            // 4. 发送请求
            try (OutputStream os = conn.getOutputStream()) {
                byte[] input = jsonInputString.getBytes("utf-8");
                os.write(input, 0, input.length);
            }

            // 5. 获取响应
            int responseCode = conn.getResponseCode();
            System.out.println("Response Code: " + responseCode);

            conn.disconnect();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

PHP

<?php
// 请求的 URL
$url = "https://www.xiazaitool.com/api/parseVideoUrl";

// 参数数据
$data = [
"url" => "https://v.douyin.com/iLxWK7jr/",
"token" => "test"
];

// 使用 curl 发起请求
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); // 转换为 JSON 格式

// 执行请求并获取响应
$response = curl_exec($ch);

// 检查是否有错误
if (curl_errno($ch)) {
echo 'Curl error: ' . curl_error($ch);
} else {
echo "Response: " . $response;
}

// 关闭curl会话
curl_close($ch);
?>