Skip to navigation
Spyglass APISearch

Fetch Instagram or TikTok comments

Return public comments for specific Instagram or TikTok posts. Pass post URLs or the platform id. At least one of instagramIds or tiktokIds is required (max 20 each). limit is comment pages per post (default 1, max 20).

Instagram accepts a shortcode or a post URL:

  • C2xY9abcD1e
  • https://www.instagram.com/p/C2xY9abcD1e/
  • https://www.instagram.com/reel/C2xY9abcD1e/

TikTok accepts a video id or a post URL:

  • 7234567890123456789
  • https://www.tiktok.com/@nike/video/7234567890123456789

Recent posts may be scraped live; older posts with stored comments are served from cache.

Limited to 20 requests per minute per user. Costs $0.0050 per successful page of comments returned, charged against your plan’s monthly credits. Each comment page fetched live (limit, default 1) is one billed unit. Cached posts do not scrape and are not billed.

Authentication

AuthorizationBearer

An API key from Settings → API, prefixed sg_live_.

Request

This endpoint expects an object.
instagramIdslist of stringsOptional
Instagram post shortcodes or post URLs
tiktokIdslist of stringsOptional
TikTok video ids or post URLs
limitintegerOptional1-20
Comment pages to fetch per post. Default 1.

Response

Comments grouped by post.
countinteger
postslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
405
Method Not Allowed Error
413
Content Too Large Error
429
Too Many Requests Error
500
Internal Server Error