InsightSocial API
TikTok

Effect › Videos

GET
/v1/tiktok/effect/videos

Returns public TikTok videos created with a camera effect, each with engagement counts, caption, author, and a playable URL.

Use it with an effect id from effects, and send the cursor back unchanged. TikTok picks its own page size here and ignores the one you ask for.

20 credits per call.

Re-running the exact same call within 6h is free.

Paginates by cursor — see Pagination.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

effect_id*string

TikTok effect id, as returned by /v1/tiktok/effects.

cursor?string

Cursor from the previous response to fetch the next page of videos.

region?string

Two-letter country code for the proxy location. Defaults to US.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tiktok/effect/videos?effect_id=string"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Comment GET

Returns one TikTok comment with its current like count, reply count, pinned flag, author, and timestamp, found by link, by id, or by its text. Use it to re-check a single known comment without paging the whole section; use post/comments when you want the section itself. **Metered: 40–120 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 6h is free.

Effects GET

Returns TikTok camera effects by id, each with its name, its designer, the views of videos made with it, and how many such videos exist. Use it to look several effects up in one call, and match results by the returned id. Repeated ids collapse and unknown ids drop, so the response can be shorter. **20 credits** per call. Re-running the exact same call within 6h is free.