Skip to main content
Read public Instagram data as JSON through the async task API. Send taskType SOCIAL with platform instagram, and pick what to read with action. A completed request costs 0.5 credits.

Request

Submit the task, then poll GET /v1/async/task/{id} or receive its webhook. See Async tasks.

Actions

username takes a username or a profile URL. postUrl takes a post, reel or IGTV URL, such as https://www.instagram.com/p/Df147tCiAyB/.

Parameters

  • query: Required for search. A keyword, hashtag word or brand name.
  • limit: Optional. search takes 1 to 30, default 10. posts takes 1 to 12, default 12. comments takes 1 to 500, default 50.

Response example

Result fields

  • Every response echoes platform and action. Lists carry returnedCount.
  • profile returns id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, followingCount, postCount, hasReels, highlights, threadsUsername, pronouns and recentPosts. latestStoryAt appears while the account has a story up, and isMemorialized marks a memorialized account.
  • posts returns posts, the account’s 12 most recent posts with likeCount, commentCount and publishedAt read from each post’s own page.
  • post returns post and the post’s first comments. A post has id, code, url, mediaType (image, video or carousel), caption, imageUrl, images, videoUrl, width, height, likeCount, commentCount, publishedAt, username, authorFullName, authorIsVerified, authorProfileImageUrl, coauthors, taggedUsers, topics, audio (the song or the author’s original sound), hasAudio, captionIsEdited, aiLabel and commentsDisabled.
  • comments returns comments, each with id, text, username, likeCount, replyCount and publishedAt. A GIF comment carries gifUrl. availableCount is the post’s comment count, and partial: true marks a list shorter than that count.
  • search returns posts with position, the author’s username, authorId, authorIsVerified and authorProfileImageUrl, and playCount on reels. source is instagram when Instagram has a search page for the keyword, which adds its title, relatedKeywords and Instagram’s own summary of the keyword with the sources its footnote numbers point to. For other keywords source is web, and posts holds public posts and reels from the last 30 days.
  • Instagram shows a signed-out visitor the 12 most recent posts of a profile and about a dozen comments of a post, and posts, post and comments return those. Read post for the counts and publish time of a search result.
  • An account or post that does not exist, a private post, or a page Instagram shows only to signed-in visitors ends the task with PAGE_UNAVAILABLE. Only completed requests are charged.