Batch stories
Active stories for up to 20 users at once.
Upstream
/tiktok/story/archive/detail/v1Every planParameters
| Name | Type | Description |
|---|---|---|
usernamesrequired | string[] | Up to 20 usernames. e.g. acme,kbfan |
Pricing
| Plan | Per call | Per 1,000 calls |
|---|---|---|
| Starter | 10 credits | $1.16 |
| Growth | 10 credits | $0.79 |
| Scale | 10 credits | $0.58 |
Responses
A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes
curl -X POST https://api.tikultra.com/v1/user/stories/batch \
-H "x-api-key: $TIKULTRA_KEY" \
-H "content-type: application/json" \
-d '{"usernames":["acme","kbfan"]}'{
"count": 2,
"users": [
{
"username": "acme",
"has_active_stories": true,
"stories": [
{
"story_id": "7705870000111222333",
"expires_at": 1762956400
}
]
},
{
"username": "kbfan",
"has_active_stories": false,
"stories": []
}
]
}More in Users & profiles
GET/v1/userGet profile5 crGET/v1/user/postsProfile posts5 crGET/v1/user/with-postsProfile with posts10 crGET/v1/user/storiesStories5 crGET/v1/user/repostsReposts5 crGET/v1/user/favoritesFavorites5 crGET/v1/user/playlistsPlaylists5 crGET/v1/user/followersFollowers10 crGET/v1/user/followingsFollowings10 crGET/v1/user/followers/searchSearch followers10 crGET/v1/user/followings/searchSearch followings10 crGET/v1/user/similarSimilar creators10 crGET/v1/user/collectionsCollections5 crGET/v1/user/collections/videosCollection videos5 crGET/v1/user/locate-postLocate post10 crGET/v1/user/seriesCreator series10 crGET/v1/user/auditCreator audit25 crGET/v1/user/visibilityVisibility check25 crGET/v1/user/compareCompare creators25 crGET/v1/user/check-usernameCheck username2 crPOST/v1/user/bulk-checkBulk profile check5 cr / item
Ready to build?
Start with 2,500 free credits and test every public endpoint, then pick a plan.