Item Creator Search - Tabcut Open API

Request

Query Params

sortField

string

optional

Sort field
follower_count_total: Followers
follower_count_90d: Increment of Followers
video_count_total: Videos
play_count_total: Video Views
like_count_total: Likes

Example:

follower_count_total

sortOrder

string

optional

Sorting type

Example:

desc

pageNo

integer

optional

Example:

1

pageSize

integer

optional

Example:

100

keyword

string

optional

Keywords, supporting UID and nickname

Example:

7160831865900467227

region

string

optional

Country abbreviations, e.g., 'GB', 'ID'

Example:

ID

followerCountBegin

integer

optional

Followers

followerCountEnd

integer

optional

Followers

contactPlatform

string

optional

Contact platform: string, enum [twitter, youtube, ins, email], multiple values separated by (backtick). Example: insemail. Multiple values are in an OR relationship.

userSoldTypeSet

string

optional

Ways of promoting products:
0: Never promoted products
1: Use video to promote products
2: Use live broadcast to promote products

Example:

0,1,2

engageRateBegin

string

optional

Interaction rate. Suggested scope
[engageRateBegin, engageRateEnd]
All: [null, null]
Low: [0, 0.001]
Medium: [0.001, 0.1]
High: [0.1, null]

engageRateEnd

string

optional

Interaction rate

officialCreatorFlag

string

optional

Influencer account types
null: all
0: Influencer accounts without opened stores
1: Official influencer accounts with opened stores

period

integer

optional

Data period, with values enum [30, 90]

Example:

30

primaryFollowerGender

string

optional

Gender Enum: male, female

Example:

male

primaryFollowerAge

string

optional

Age Enum: 18 - 24, 25 - 34, 35 - 44, 45 - 54, 55+

Example:

18-24

Header Params

x-appKey

string

required

Example:

x-timestamp

string

required

Example:

x-sign

string

required

Example:

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'http://open.tabcut.com:8090/api/item_creator/search?sortField=follower_count_total&sortOrder=desc&pageNo=1&pageSize=100&keyword=7160831865900467227&region=ID&followerCountBegin=&followerCountEnd=&contactPlatform=&userSoldTypeSet=0,1,2&engageRateBegin=&engageRateEnd=&officialCreatorFlag=&period=30&primaryFollowerGender=male&primaryFollowerAge=18-24' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}'

Responses

🟢200Success

application/json

Body

code

string

required

message

string

required

result

object

required

total

integer

required

pageNo

integer

required

pageSize

integer

required

data

array [object {34}]

required

translated

null

required

serverTime

string

required

Example

{
  "code": "",
  "message": "",
  "result": null,
  "serverTime": ""
}