Data lookups
Read a public Instagram or TikTok post's metrics and comments from its URL, or a creator's profile from their handle. Nothing is stored.
Fetch post details and engagement stats
Fetch normalized post content, its owner, and engagement counts. Use owner.accountId, not the handle in the URL, to verify ownership. A metric is null when it is not available for this post.
Counts may be up to 15 minutes old, or up to 6 hours for a reduced-detail read (source: "fallback"). Responses usually take a few seconds; slow cases, such as a reduced-detail read or a post that turns out to be gone, can take up to a minute or more. Set your client timeout to 120 seconds.
Authorization
AuthorizationRequiredBearer <token>API token. Send it as Authorization: Bearer <API_TOKEN>.
In: header
Query Parameters
urlRequiredstringInstagram post/reel or TikTok video URL.
"uri"Current post details and metrics
Fetch stats for up to 25 posts in one call
Fetches the same data as GET /v1/stats for up to 25 post URLs (Instagram and TikTok can be mixed). Results come back in input order.
Per-URL outcome: each result is either ok: true with the GET /v1/stats fields, or ok: false with the error code that URL would have returned on its own (e.g. POST_NOT_FOUND, SCRAPING_RATE_LIMITED). Individual lookup failures do not change the 200 response for an accepted batch; a malformed body or rate-limit rejection returns 422 or 429 before processing. Check each result's ok and the summary counts.
Limits and usage: each input URL consumes one of the 60 per-IP batch URL units per minute. Duplicate URLs are fetched once, returned in each original position, and billed once. Each unique URL that succeeds before the 100-second batch deadline counts as one billable unit in GET /auth/usage; failed or timed-out URLs are not billed.
Lookups run concurrently. URLs still incomplete at the deadline return BATCH_TIMEOUT.
Counts may be up to 15 minutes old, or up to 6 hours for a reduced-detail read (source: "fallback").
Authorization
AuthorizationRequiredBearer <token>API token. Send it as Authorization: Bearer <API_TOKEN>.
In: header
Request Body
application/jsonRequiredurlsRequiredarray<string>Instagram post/reel or TikTok video URLs. Invalid URLs are returned as per-item VALIDATION_ERROR results.
One result per input URL, in input order
Fetch one page of comments
Fetch comments for an Instagram post/reel or TikTok video. Pass nextCursor back as cursor until nextCursor is null.
There is no sort, order or page size parameter, and other query parameters are ignored. Comments come back in the order the platform returns them, on every page, and the platform chooses the page size. The response returns top-level comments only, with no reply objects; replyCount is a count. Replies are a separate on-demand lookup.
A successful empty list means the post has no comments. On TikTok, an empty first page is checked against the video itself, so a missing video returns an error, typically 404 POST_NOT_FOUND.
On TikTok, hasMore can be true while nextCursor is null; there is then no next page to request.
Authorization
AuthorizationRequiredBearer <token>API token. Send it as Authorization: Bearer <API_TOKEN>.
In: header
Query Parameters
urlRequiredstringInstagram post (/p/) or reel (/reel/) URL, or TikTok video URL (tiktok.com/@user/video/id). Short links such as vm.tiktok.com are rejected with VALIDATION_ERROR.
"uri"cursorstringnextCursor from the previous response, sent back unchanged. Omit it, or leave it empty, for the first page. It is not validated: on TikTok a value that is not a number is not rejected, it is sent on as NaN.
One page of comments
Fetch a creator profile
Fetch a normalized Instagram or TikTok profile. Handles may be supplied with or without @. profile.accountId is stable across handle changes. A private Instagram account can sometimes still be read with reduced detail (source: "fallback"), which can take up to about 90 seconds; otherwise it is answered with 403 PROFILE_RESTRICTED.
Counts may be up to 15 minutes old.
Authorization
AuthorizationRequiredBearer <token>API token. Send it as Authorization: Bearer <API_TOKEN>.
In: header
Query Parameters
platformRequiredstring"instagram" | "tiktok"handleRequiredstringHandle only, not a profile URL.
Current public profile
Last updated on