Skip to content
DataXAPI
All Kuaishou APIs
Posts & videosKuaishouVideo · Detail

Kuaishou video detail

Read a public Kuaishou video's caption, author, duration, and view, like, and comment counts by numeric photo ID.

POST/v1/kuaishou/videos/detail

Chinese name: 快手作品详情 · 视频 · 详情 按数字作品 ID 读取一条快手公开作品的文案、作者、时长和播放、点赞、评论数。
kuaishou.videos.detail@v1

Price per call

¥0.02/ call

Nonempty complete results are charged; empty, partial, and failed results are not.

Current statusAvailableChecking live status →
Checking live status

Try it

Sign in and run one real call. The result and charge appear right here.

Security check

Loading the security check…

Checking live execution status…

Execution result

// Result

Request parameters

photo_idstringrequired

pattern: "^\\d{10,20}$" · minLength: 1 · maxLength: 256

Example: "5228960823332207296"

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "photo_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^\\d{10,20}$"
    }
  },
  "required": [
    "photo_id"
  ],
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/kuaishou/videos/detail \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"photo_id":"5228960823332207296"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_kuaishou_videos_detail",
  "message": "success",
  "data": {
    "item": {
      "photo_id": "5228960823332207296",
      "caption": "公开快手作品",
      "timestamp": 1720000000000,
      "duration": 32000,
      "user_id": 228905802,
      "user_name": "公开作者",
      "view_count": 560000,
      "like_count": 12000,
      "comment_count": 800,
      "share_count": 300
    }
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "kuaishou.videos.detail",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.02",
    "balance_after": "49.98",
    "currency": "CNY"
  }
}
Response fields
codenumber
const: 200
request_idstring
messagestring
const: "success"
dataobject
pageobject
warningsarray
metaobject
Response JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "item": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "photo_id": {},
                "caption": {},
                "timestamp": {},
                "duration": {},
                "user_id": {},
                "user_name": {},
                "view_count": {},
                "like_count": {},
                "comment_count": {},
                "share_count": {}
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "item"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "kuaishou.videos.detail"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

  • Use it when you have a numeric photo ID and need the video's public details and performance.

Not for

  • Do not use it to download video, read comments, or access private videos.

Known limitations

  • Only the numeric photo ID is accepted, not the short eid from share links.
  • Playback URLs are not returned.
  • Counts are point-in-time public snapshots, not live or historical trends.

Billing

¥0.02 per call. Nonempty complete results are charged; empty, partial, and failed results are not.

See all pricing →