视频自然流量列表接口

接口信息

• 接口名称: 获取视频自然流量列表
• 请求方法: POST
• 接口地址: /open-api/v1/data
• 接口路径: /v4/api/open/video/list
• 接口描述: 根据过滤条件获取视频自然流量列表信息，支持分页查询
• 价格说明: 获取一条数据结果消耗1 credit

请求头:

• Content-Type: application/json
• Accept: application/json

请求参数

请求结构

请求体参数 (params 对象)

请求示例

curl -X POST "https://www.pipispy.com/open-api/v1/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v4/api/open/video/list",
    "params": {
      "search_type": 1,
      "keyword": "fashion",
      "type": 1,
      "region": ["US", "CA"],
      "create_time_start": 1640995200,
      "create_time_end": 1643673600,
      "follower_count_min": 10000,
      "follower_count_max": 1000000,
      "play_count_min": 1000,
      "play_count_max": 1000000,
      "digg_count_min": 100,
      "digg_count_max": 50000,
      "digg_play_rate_min": 0.01,
      "digg_play_rate_max": 0.1,
      "comment_count_min": 10,
      "comment_count_max": 1000,
      "share_count_min": 5,
      "share_count_max": 500,
      "current_page": 1,
      "page_size": 20,
      "sort_key": "play_count",
      "sort_type": "desc",
      "platform": "tiktok_shop"
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [],
    "page": {}
  }
}

响应字段说明

视频信息字段

商品信息字段 (products 数组)

落地页信息字段 (landing_page 数组)

轮播图信息字段 (carousel 数组)

分页信息字段

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "id": "507f1f77bcf86cd799439011",
        "video_url": "https://example.com/video.mp4",
        "cover": "https://example.com/cover.jpg",
        "duration": 30,
        "play_count": 500000,
        "digg_count": 25000,
        "comment_count": 1200,
        "share_count": 800,
        "create_time": 1640995200,
        "desc": "时尚穿搭分享，超好看的搭配推荐",
        "app_image": "https://example.com/avatar.jpg",
        "nickname": "时尚达人",
        "follower_count": 500000,
        "fetch_region": "US",
        "author_url": "https://www.tiktok.com/@fashion_expert",
        "landing_page": [
          {
            "type": "tiktok_shop",
            "url": "https://shop.tiktok.com/product/123"
          }
        ],
        "products": [
          {
            "image": "https://example.com/product.jpg",
            "name": "时尚运动鞋",
            "currency": "USD",
            "price": 99.99,
            "url": "https://shop.tiktok.com/product/123"
          }
        ],
        "review_count": 1500,
        "tiktok_url": "https://www.tiktok.com/@fashion_expert/video/507f1f77bcf86cd799439011",
        "is_collection": false,
        "type": 1,
        "carousel": [
          {
            "type": 2,
            "image": "https://example.com/carousel1.jpg"
          }
        ],
        "shop_flag": 2
      }
    ],
    "page": {
      "total_count": 1250,
      "page_count": 63,
      "current_page": 1,
      "page_size": 20,
      "is_next": true
    }
  }
}

错误码说明

注意事项

1. 页码参数从 1 开始
2. 排序字段支持多种选项：create_time、play_count、digg_count、comment_count、share_count、digg_play_rate
3. 搜索类型支持 4 种模式，默认为综合搜索
4. 时间戳使用秒级时间戳
5. 地区参数支持多个地区数组格式
6. 点赞播放比为点赞数除以播放数的比值
7. 视频类型 1 为自然流量视频，2 为电商视频
8. 店铺标识 1 为普通视频，2 为电商视频