Search Blacklist - Block

POST

/api/blacklist/block

Add objects of the specified business type to the search content blacklist in batch.

bizIds: up to 1000 per request, each must be a numeric string

The total blacklist size under the same appKey + bizType must not exceed 50000

Idempotent: blacklisting the same object repeatedly does not duplicate the record; only the reason and effective state are refreshed

After being blacklisted, all search APIs targeting this business type (creator/seller/item/video/live) automatically filter out these objects

Real-time effect: after a successful operation, local caches on each pod are refreshed via Redis broadcast

Request

Header Params

Body Params application/jsonRequired

Example

{
    "bizType": "creator",
    "bizIds": [
        "string"
    ],
    "reason": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://open.tabcut.com:8090/api/blacklist/block' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}' \
--header 'Content-Type: application/json' \
--data '{
    "bizType": "creator",
    "bizIds": [
        "string"
    ],
    "reason": "string"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "code": "200",
    "message": "Success!",
    "result": 5,
    "serverTime": "2026-05-07 14:00:00"
}

Modified at 2026-05-07 07:21:57

Translation of Item category names

Search Blacklist - Check