Get an Instagram topic
Get an Instagram Popular topic: its title, description and related searches, plus its curated posts.
Headers
Get your API keyAPI key (`sfk_...`)
A topic such as `harry potter`, or its instagram.com/popular link.
`nextCursor` from the previous page.
min 1 chars · max 16384 chars
Endpoint-specific response payload.
`found` when Instagram has a Popular page for the topic; `not_found` when it has none (the topic is too rare or unknown). A later page is always `found`.
one of: found, not_found
The topic, on the first page only. Null on later pages and when `lookupStatus` is `not_found`.
Topic title as Instagram shows it.
Short generated description of the topic. Null when Instagram gives none.
Pages the description draws on, in the order its footnote markers cite them. Null when there is no description.
min 1 chars
Posts Instagram counts under the topic. Null when not given.
≥ 0
Related searches Instagram suggests for the topic. Null when not given.
min 1 chars
One page of the posts Instagram curates for the topic, in its ranking (not chronological). Empty when `lookupStatus` is `not_found`.
Media id.
pattern: ^\d+$
Shortcode used in the media URL. Null for stories.
Public URL: `/reel/` for Reels, `/p/` otherwise. Null for stories.
`post`, `reel` or `story`.
one of: post, reel, story
`image`, `video` or `carousel`. Null when unknown.
one of: image, video, carousel, null
Caption text.
Alt text Instagram generated or the owner wrote. Null when none or not reported.
When it was posted.
The account that posted it. Null when unknown.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
Engagement counts. Null when this view doesn't report one.
Likes. Null when hidden or not reported.
≥ 0
Comments.
≥ 0
Plays, for videos. Counts Instagram plays only, not plays of a cross-posted copy on other apps.
≥ 0
Shares.
≥ 0
Saves.
≥ 0
Whether the owner hides the like count.
Image, or a video's cover image. Instagram CDN URL; it expires after a while.
Small preview image. Instagram CDN URL; it expires after a while.
Video file. Instagram CDN URL; it expires after a while.
Video length in seconds, to the millisecond.
Pixel size. Null when unknown.
Width in pixels.
≥ 0
Height in pixels.
≥ 0
Every item of a carousel, in order. Null when not a carousel.
Media id of this item.
pattern: ^\d+$
`image` or `video`. Null when unknown.
one of: image, video, null
Image, or a video's cover. Instagram CDN URL; it expires after a while.
Video file. Instagram CDN URL; it expires after a while.
Video length in seconds, to the millisecond. Null for images.
Pixel size. Null when unknown.
Width in pixels.
≥ 0
Height in pixels.
≥ 0
Alt text Instagram generated or the owner wrote. Null when none or not reported.
Music or original audio. On a story, the music sticker. Null when none.
Audio id.
pattern: ^\d+$
Song or sound title.
Artist name.
Whether it is original audio rather than licensed music.
Username of the account behind original audio.
Collab co-authors. Empty when none.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
Accounts tagged in the media. Empty when none. Null when this view doesn't carry tags.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
Tagged location. Null when none.
Location id.
pattern: ^\d+$
Place name.
Latitude.
Longitude.
Whether it is labelled as a paid partnership.
Brands named in the paid-partnership label. Empty when it is not a partnership. Null when this view doesn't say.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
Whether the owner turned comments off. Null when this view doesn't say.
Whether the owner pinned it to their profile (to the Reels tab, when listed there). Null when this view doesn't say.
Story-only details. Null for posts and Reels.
When the story expires, or expired for a story kept in a highlight.
Link stickers.
Link destination: the address the sticker opens, not Instagram's redirect.
min 1 chars
Text shown on the sticker. Can be null on a profile's first lookup.
Accounts mentioned. On a profile's first lookup, an account's `id`, `avatarUrl` and `verified` can be null.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
The post or Reel the story re-shares. Null when none.
Media id of the shared post or Reel.
pattern: ^\d+$
Shortcode of the shared post or Reel.
min 1 chars
Pagination state. Pass `nextCursor` as `cursor` for the next page while `hasMore` is true.
one of: cursor, offset, page
Null when continuation is unknown for this page.
≥ 0
≥ 0
≥ 0
≥ 0
≥ 0
≥ 0
Metadata about the API response.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v2
Code example
curl "https://api.socialfetch.dev/v2/instagram/topics/morning%20coffee%20routine" \
-H "x-api-key: YOUR_API_KEY"Responses
An Instagram Popular topic and its posts.