API reference · TikTok
tiktok/bulk/profile-history
Integrate this model through SandBase's unified API, with production-ready schemas and examples.
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
tiktok/bulk/profile-history01
Input Schema
6 parameters · 0 required · 6 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
since | string | Optional | Returns posts older than this date. |
until | string | Optional | Returns posts newer than this date. |
maxItems | integer | Optional | Maximum number of items that you want as output. · Min: -9007199254740991 · Max: 9007199254740991 |
startUrls | array | Optional | Paste the TikTok URLs, and get the results immediately. User URLs are supported. |
usernames | array | Optional | Usernames of TikTok users. Paste the usernames and get the results immediately. Please remove @ sign before paste. |
customMapFunction | string | Optional | Function that takes each of the objects as argument and returns data that will be mapped by the function itself. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically. |
02
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 |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
03
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "tiktok/bulk/profile-history",
"prompt": "a beautiful sunset over mountains"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"