API reference · TikTok

tiktok/web/general-search

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APISynchronousOpen model
Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run
Model IDtiktok/web/general-search
01

Input Schema

4 parameters · 1 required · 3 optional

ParameterTypeRequiredDescription
keywordstringRequiredSearch keyword
cookiestringOptionalUser cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)
offsetintegerOptionalPage cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor. · Default: 0
search_idstringOptionalSearch id, empty for the first request, need to provide for the second paging, need to get it from the return response of the last request. · Default: ""
02

Output Schema

FieldTypeDescription
idstringUnique identifier for the generation task
statusstringTask status: pending, running, completed, failed, timeout
modelstringModel used for the generation
outputsarrayArray of output items
outputs[].urlstringURL of the generated artifact
outputs[].content_typestringMIME type (e.g. image/png, video/mp4)
errorobject | nullError details if failed, null on success
error.typestringMachine-readable error type code
error.messagestringHuman-readable error description
03

Code Examples

Ready-to-run snippets

const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/run", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "tiktok/web/general-search",
    "offset": 0
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());