instagram

name	instagram
description	Work with Instagram data via TikHub — fetch user info and posts, search users/reels/hashtags/music/locations, pull post comments and replies, and hashtag feeds. Use when the task targets Instagram. Covers the Instagram V2 API.

Instagram (via TikHub)

Deep coverage of Instagram via the V2 API. Exhaustive endpoints: tikhub-find-endpoint "<goal>" --platform instagram.

Setup gate

[ -z "${TIKHUB_API_KEY:-}" ] && echo "Set TIKHUB_API_KEY first (see tikhub-onboarding)."

Coverage: Instagram-V2. (V1 and V3 are de-scoped — reach them via discovery.)

Key endpoints

Goal	Method + path	Key params
User info	GET /api/v1/instagram/v2/fetch_user_info	username | user_id
User posts	GET /api/v1/instagram/v2/fetch_user_posts	username | user_id, pagination_token
User reels	GET /api/v1/instagram/v2/fetch_user_reels	username | user_id, pagination_token
User stories	GET /api/v1/instagram/v2/fetch_user_stories	username | user_id
Post info	GET /api/v1/instagram/v2/fetch_post_info	code_or_url
Search users	GET /api/v1/instagram/v2/search_users	keyword
General search	GET /api/v1/instagram/v2/general_search	keyword, pagination_token
Search reels	GET /api/v1/instagram/v2/search_reels	keyword, pagination_token
Search hashtags	GET /api/v1/instagram/v2/search_hashtags	keyword
Hashtag posts	GET /api/v1/instagram/v2/fetch_hashtag_posts	keyword, feed_type, pagination_token
Post comments	GET /api/v1/instagram/v2/fetch_post_comments	code_or_url, sort_by, pagination_token
Comment replies	GET /api/v1/instagram/v2/fetch_comment_replies	code_or_url, comment_id, pagination_token
Shortcode → media id	GET /api/v1/instagram/v2/shortcode_to_media_id	shortcode

Example

curl -s "https://api.tikhub.io/api/v1/instagram/v2/fetch_user_posts?username=instagram" \
  -H "Authorization: Bearer $TIKHUB_API_KEY"

Pagination

Everything uses pagination_token — pass the token returned by the previous response; stop when none is returned. Each page is billed — cap it.

Hand off to task skills

• Download posts/reels → social-media-downloader
• Analyze an account → creator-analytics
• Hashtag work → hashtag-research
• Comment mining → comments-analysis
• Listening across keywords → social-listening
• Large pulls → bulk-data-export

Red flags

• Post-level endpoints take code_or_url (the shortcode or full post URL), not the numeric id — convert with shortcode_to_media_id if needed.