SearchKuaishouUser · Search

Kuaishou user search

Page through public Kuaishou accounts for a keyword, optionally only verified or live accounts, sorted by followers.

POST/v1/kuaishou/users/search

Chinese name: 快手用户搜索 · 用户 · 搜索按关键词分页搜索快手公开账号，可只看认证或直播中账号并按粉丝数排序。
kuaishou.users.search@v1

Price at launch

¥0.19/ call

Nothing is charged before launch.

Coming soonChecking live status →

Available to try at launch

Try it

This API is coming soon

We are running launch checks. Once live, you can try it right here at the price shown above; nothing is charged before then. You can already read the parameters and response example.

Available now on the same platform

Request parameters

keywordstringrequired

minLength: 1 · maxLength: 100

Example: "汽车之家"

user_relationstringoptional

enum: "all" | "verified" | "live" · default: "all"

Example: "verified"

fans_sortstringoptional

enum: "default" | "most_to_least" | "least_to_most" · default: "default"

cursorstringoptional

minLength: 1

Request JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "user_relation": {
      "default": "all",
      "type": "string",
      "enum": [
        "all",
        "verified",
        "live"
      ]
    },
    "fans_sort": {
      "default": "default",
      "type": "string",
      "enum": [
        "default",
        "most_to_least",
        "least_to_most"
      ]
    },
    "cursor": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "keyword"
  ],
  "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/users/search \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"汽车之家","user_relation":"verified"}'

import { ExactApiClient } from "@dataxapi/sdk";

const client = new ExactApiClient({
  baseUrl: "https://api.dataxapi.com",
  apiKey: process.env.DATAXAPI_API_KEY,
});

const result = await client.call("kuaishou_users_search_v1", {
  "keyword": "汽车之家",
  "user_relation": "verified"
});
console.log(result.data);

import os
from dataxapi import ExactApiClient

client = ExactApiClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])

result = client.call("kuaishou_users_search_v1", {
    "keyword": "汽车之家",
    "user_relation": "verified",
})
print(result["data"])

[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"

Response example

200 · application/json

{
  "code": 200,
  "request_id": "req_example_kuaishou_users_search",
  "message": "success",
  "data": {
    "items": [
      {
        "user_id": 228905802,
        "user_name": "公开作者",
        "user_text": "公开简介",
        "kwaiId": "public_kwai",
        "fansCount": 3500000,
        "verified": true
      }
    ]
  },
  "page": {
    "next_cursor": "cursor_example"
  },
  "warnings": [],
  "meta": {
    "listing_id": "kuaishou.users.search",
    "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.19",
    "balance_after": "49.81",
    "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": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "user_id": {},
              "user_name": {},
              "user_text": {},
              "kwaiId": {},
              "fansCount": {},
              "verified": {},
              "verifiedDetail": {}
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "kuaishou.users.search"
        },
        "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 to find candidate Kuaishou accounts by brand, category, or name.

Not for

Do not use it for identity verification, contact discovery, or location targeting.

Known limitations

Result order is set by the platform and does not explain ranking causality.
Only the returned DataXAPI cursor can continue the same query.
Counts are point-in-time public snapshots, not live or historical trends.

Billing

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

See all pricing →