Headers
Get your API keyAPI key (`sfk_...`)
Keyword to search Reels for.
min 1 chars · max 512 chars
`nextCursor` from the previous page.
min 1 chars · max 16384 chars
Endpoint-specific response payload.
Reels matching the query, in Instagram's relevance order. A page can hold few Reels, or none while more pages remain; read `page.hasMore`.
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/reels/search?query=dogs" \
-H "x-api-key: YOUR_API_KEY"Responses
Reels search results.