---
title: "对KOL列表进行硬性过滤"
method: POST
path: "/api/search-hard-filter"
tags: ["Search"]
---

# 对KOL列表进行硬性过滤

`POST /api/search-hard-filter`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/search-hard-filter`
- Auth: HTTP bearer

根据campaign的要求对KOL列表进行国家和播放量中位数的硬性过滤

## Request body

- object
  - `kol_list` object, required
    - `success` boolean
    - `data` object[]
      - `kol_id` string
  - `search_term_id` string, uuid, required: 根据channel参数决定查询的表：tiktok->search_terms, instagram->ig_hashtags, youtube->youtube_terms
  - `channel` 'tiktok' | 'instagram' | 'youtube', required: 指定搜索渠道，决定search_term_id的查询表
  - `hard_requirements` object, required
    - `median_views_low` number
    - `median_views_high` number
    - `followers_low` number
    - `followers_high` number
    - `countries` string[]

## Response `200`

成功过滤KOL列表

- object
  - `success` boolean
  - `data` string[]
  - `stats` object
    - `total_passed` number: 通过过滤的KOL总数
    - `newly_inserted` number: 新插入到campaign_kols表的记录数

## Other responses

- `400`: 请求参数错误
- `500`: 服务器内部错误

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)