# 搜索用户V3

`POST /api/kuaishou/search_user_v3`

此接口收费较贵，但稳定性更高，具体价格请前往官网查看价格表

## 鉴权

源接口未声明鉴权要求，请结合接入指南确认。

## 请求参数



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| Authorization | header | string | 是 | 在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey · default: "Bearer YOUR_API_KEY" |
| Content-Type | header | string | 是 |  · default: "application/json" |

## 请求体 · application/json



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| keyword | body | string | 是 |  |
| pcursor | body | string | 否 | 分页游标，首次留空，翻页传上一页响应的 pcursor |
| user_relation | body | string | 否 | 关系筛选，all(全部) / same_city(同城) / verified(认证) / live(直播中) / following(已关注) |
| user_gender | body | string | 否 | 性别筛选，all(不限) / male(男) / female(女) |
| fans_sort | body | string | 否 | 粉丝排序，default(默认) / most_to_least(从多到少) / least_to_most(从少到多) |

```json
{
  "type" : "object",
  "properties" : {
    "keyword" : {
      "type" : "string",
      "title" : "关键词"
    },
    "pcursor" : {
      "type" : "string",
      "description" : "分页游标，首次留空，翻页传上一页响应的 pcursor"
    },
    "user_relation" : {
      "type" : "string",
      "description" : "关系筛选，all(全部) / same_city(同城) / verified(认证) / live(直播中) / following(已关注)"
    },
    "user_gender" : {
      "type" : "string",
      "description" : "性别筛选，all(不限) / male(男) / female(女)"
    },
    "fans_sort" : {
      "type" : "string",
      "description" : "粉丝排序，default(默认) / most_to_least(从多到少) / least_to_most(从少到多)"
    }
  },
  "required" : [ "keyword" ]
}
```

```json
{
  "keyword" : "罗永浩",
  "pcursor" : "",
  "user_relation" : "all",
  "user_gender" : "all",
  "fans_sort" : "default"
}
```

## 响应 200 · application/json



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| code | body | integer | 是 |  |
| message | body | string | 是 |  |
| data | body | object | 是 |  |

```json
{
  "type" : "object",
  "properties" : {
    "code" : {
      "type" : "integer"
    },
    "message" : {
      "type" : "string"
    },
    "data" : {
      "type" : "object",
      "properties" : { }
    }
  },
  "required" : [ "code", "message", "data" ]
}
```

```json
{
  "code" : 200,
  "message" : "success",
  "data" : { }
}
```

## cURL

```sh
curl --globoff --request POST 'https://api.getoneapi.com/api/kuaishou/search_user_v3' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "keyword" : "罗永浩",
  "pcursor" : "",
  "user_relation" : "all",
  "user_gender" : "all",
  "fans_sort" : "default"
}'
```