Search Instagram Reels
Search Instagram Reels by keyword with optional date filters and page-based pagination.
Operation
/v1/instagram/search/reelsHeaders
API key (`sfk_...`)
Parameters
Search query text for Instagram Reels.
min 1 chars · max 512 chars
Optional filter for when matching reels were posted.
one of: last-hour, last-day, last-week, last-month, last-year
1-based results page number. Omit to request the first page. Pagination is page-based.
≥ 1
Response fields
Endpoint-specific response payload.
Search query that was evaluated for this response.
Instagram Reels matching the search query for the requested page. Empty when no reels match.
Instagram media id for this reel.
min 1 chars
Public shortcode used in the Instagram reel URL.
min 1 chars
Canonical public Instagram URL for this reel.
min 1 chars
Caption text when Instagram provides one.
When the reel was taken or posted (Unix epoch seconds).
Thumbnail or cover image URL when available.
Primary display image URL when available.
Direct video URL when a playable URL is available.
Video duration in seconds when available.
≥ 0
Whether the reel includes audio.
Accessibility caption when Instagram provides one.
Engagement metrics when Instagram exposes them.
View count when Instagram exposes it.
≥ 0
Play count when Instagram exposes it.
≥ 0
Like count when Instagram exposes it.
≥ 0
Comment count when Instagram exposes it.
≥ 0
Width and height when available.
Media width in pixels.
≥ 0
Media height in pixels.
≥ 0
Reel owner metadata when Instagram exposes it.
Instagram numeric user id for the reel owner when present.
Instagram username for the reel owner when present.
Display name for the reel owner when present.
Profile image URL for the reel owner when present.
Whether Instagram marks the reel owner as verified.
Whether the reel owner account is private.
Follower count when Instagram exposes it on the owner.
≥ 0
Post count when Instagram exposes it on the owner.
≥ 0
Tagged location when Instagram exposes it.
Location id when Instagram provides one.
Location name when Instagram provides one.
Location slug when Instagram provides one.
Serialized address metadata when Instagram provides it.
Audio attribution when Instagram exposes it.
Attributed artist name when available.
Attributed song or audio title when available.
Whether the reel uses original audio.
Whether Instagram indicates the audio should be muted.
Reason for muting audio when Instagram provides one.
Audio track id when Instagram provides one.
Whether Instagram marks the reel as an ad.
Whether Instagram marks the reel as affiliate content.
Whether Instagram marks the reel as a paid partnership.
Pagination state for the current response.
1-based page number for this response.
≥ 1
Next page number to request when more reels are available; otherwise null.
≥ 1
Whether another page of reels is available.
Metadata describing the request and billing outcome.
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: v1
Code example
Responses
Reels search results for the requested page.
Error codes