Skip to main content
GET
Popular Search
💳 1 credit per request
Explore an Instagram topic and its curated posts. Returns the Popular page’s generated description, sources, suggested terms, media count, and paginated posts. Use the cursor from each response with the same query to fetch the next page.

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

query
string
required

The Popular topic to search for

Example:

"basketball"

cursor
string

The opaque cursor returned by the previous response. Use it with the same query to fetch the next page of posts.

Example:

"opaque-cursor-from-response"

Response

Successful response

Key Response Fields:

  • data.title: The topic title
  • data.total_media_count: Total number of posts for the topic
  • data.description.plain_text: Generated description of the topic
  • data.description.source_uris: Sources cited in the description, keyed by index
  • data.suggested_terms: Related/suggested search terms, keyed by index
  • data.posts: Curated posts, keyed by index (0, 1, 2, ...)
  • data.posts[0].url: Post/reel URL
  • data.posts[0].type: Media type (e.g. reel)
  • data.posts[0].caption: Post caption
  • data.posts[0].play_count: Play count (for video/reel posts)
  • data.posts[0].owner.username: Author's username
  • data.posts[0].owner.is_verified: Whether the author is verified
  • data.cursor: Opaque pagination cursor — pass with the same query to fetch the next page
  • data.has_more: Whether more posts are available