TikTok modelsapi generation api

tiktok/app-v3/user-search-result

Name: Get user search results of specified keywords
Author: TikTok

Get user search results of specified keywords.

Input

Count(integer)

Number

Keyword(string)

Keyword

Offset(integer)

Offset

User Search Follower Count(string)

Sort by number of followers

User Search Other Pref(string)

Sort by other preferences

User Search Profile Type(string)

Sort by account type

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDtiktok/app-v3/user-search-result

Input Schema

6 parameters · 1 required · 5 optional

Parameter	Type	Required	Description
`keyword`	string	Required	Keyword
`count`	integer	Optional	Number · Default: 20
`offset`	integer	Optional	Offset · Default: 0
`user_search_other_pref`	string	Optional	Sort by other preferences · Default: ""
`user_search_profile_type`	string	Optional	Sort by account type · Default: ""
`user_search_follower_count`	string	Optional	Sort by number of followers · Default: ""

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Code Examples

Ready-to-run snippets

curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "tiktok/app-v3/user-search-result",
  "count": 20,
  "offset": 0,
  "user_search_other_pref": "",
  "user_search_profile_type": "",
  "user_search_follower_count": "",
  "prompt": "a beautiful sunset over mountains"
}'

← Back to Get user search results of specified keywords

API README

Get user search results of specified keywords

Get user search results of specified keywords. It is suitable for tiktok workflows.

Capability

Get user search results of specified keywords. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.

Common use cases

Search and discover relevant records for research, monitoring, and product experiences.
Enrich profiles, accounts, and business records with structured context.
Create repeatable integrations that pass structured results to downstream business systems.

Related Models

tiktok/app-v3/check-live-room-onlineCheck if live room is online The Room ID of the live room can be obtained from the `/api/v1/tiktok/web/get_live_room_id` interface through the live room link.tiktok/app-v3/check-live-room-online-batchBatch check TikTok live rooms' online status, supports up to 50 room IDs Room IDs can be retrieved from `/api/v1/tiktok/web/get_live_room_id`.tiktok/app-v3/content-translateGet content translation data. This capability focuses on tiktok (tiktok app v3) workflows centered on get content translation data.tiktok/app-v3/creator-search-insightsGet creator search insights data, used to understand trending search topics and creative inspiration.tiktok/app-v3/creator-search-insights-detailGet creator search insights detail data, used to query search statistics for specific query.tiktok/app-v3/creator-search-insights-trendGet creator search insights trend data, including search popularity by region and time.tiktok/app-v3/creator-search-insights-videosGet creator search insights related videos, query popular related videos for the search term.tiktok/app-v3/general-search-resultGet comprehensive search results of specified keywords.