Social Fetch
Instagram

Search Instagram Reels

Search Instagram Reels by keyword with optional date filters and page-based pagination.

GET/v1/instagram/search/reels
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
query*stringquery

Search query text for Instagram Reels.

min 1 chars · max 512 chars

datePostedstringoptionalquery

Optional filter for when matching reels were posted.

one of: last-hour, last-day, last-week, last-month, last-year

pageintegeroptionalquery

1-based results page number. Omit to request the first page. Pagination is page-based.

≥ 1

Response fields
54

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Instagram Reels matching the search query for the requested page. Empty when no reels match.

datareels[]id
string

Instagram media id for this reel.

min 1 chars

datareels[]shortcode
string

Public shortcode used in the Instagram reel URL.

min 1 chars

datareels[]url
string

Canonical public Instagram URL for this reel.

min 1 chars

datareels[]caption
stringnullable

Caption text when Instagram provides one.

datareels[]takenAt
integer

When the reel was taken or posted (Unix epoch seconds).

datareels[]thumbnailUrl
stringoptional

Thumbnail or cover image URL when available.

datareels[]displayUrl
stringoptional

Primary display image URL when available.

datareels[]videoUrl
stringoptional

Direct video URL when a playable URL is available.

datareels[]videoDurationSec
numberoptional

Video duration in seconds when available.

≥ 0

datareels[]hasAudio
booleanoptional

Whether the reel includes audio.

datareels[]accessibilityCaption
stringnullableoptional

Accessibility caption when Instagram provides one.

Engagement metrics when Instagram exposes them.

datareels[]metricsviews
integeroptional

View count when Instagram exposes it.

≥ 0

datareels[]metricsplays
integeroptional

Play count when Instagram exposes it.

≥ 0

datareels[]metricslikes
integeroptional

Like count when Instagram exposes it.

≥ 0

datareels[]metricscomments
integeroptional

Comment count when Instagram exposes it.

≥ 0

Width and height when available.

datareels[]dimensionswidth
integer

Media width in pixels.

≥ 0

datareels[]dimensionsheight
integer

Media height in pixels.

≥ 0

Reel owner metadata when Instagram exposes it.

datareels[]ownerplatformUserId
stringoptional

Instagram numeric user id for the reel owner when present.

datareels[]ownerhandle
stringoptional

Instagram username for the reel owner when present.

datareels[]ownerdisplayName
stringoptional

Display name for the reel owner when present.

datareels[]owneravatarUrl
stringoptional

Profile image URL for the reel owner when present.

datareels[]ownerverified
booleanoptional

Whether Instagram marks the reel owner as verified.

datareels[]ownerprivateAccount
booleanoptional

Whether the reel owner account is private.

datareels[]ownerfollowerCount
integeroptional

Follower count when Instagram exposes it on the owner.

≥ 0

datareels[]ownerpostCount
integeroptional

Post count when Instagram exposes it on the owner.

≥ 0

Tagged location when Instagram exposes it.

datareels[]locationid
stringoptional

Location id when Instagram provides one.

datareels[]locationname
stringnullableoptional

Location name when Instagram provides one.

datareels[]locationslug
stringnullableoptional

Location slug when Instagram provides one.

datareels[]locationaddressJson
stringnullableoptional

Serialized address metadata when Instagram provides it.

Audio attribution when Instagram exposes it.

datareels[]audioartistName
stringnullableoptional

Attributed artist name when available.

datareels[]audiosongName
stringnullableoptional

Attributed song or audio title when available.

datareels[]audiousesOriginalAudio
booleanoptional

Whether the reel uses original audio.

datareels[]audioshouldMuteAudio
booleanoptional

Whether Instagram indicates the audio should be muted.

datareels[]audioshouldMuteAudioReason
stringnullableoptional

Reason for muting audio when Instagram provides one.

datareels[]audioaudioId
stringnullableoptional

Audio track id when Instagram provides one.

datareels[]isAd
booleanoptional

Whether Instagram marks the reel as an ad.

datareels[]isAffiliate
booleanoptional

Whether Instagram marks the reel as affiliate content.

datareels[]isPaidPartnership
booleanoptional

Whether Instagram marks the reel as a paid partnership.

Pagination state for the current response.

datapagecurrentPage
integer

1-based page number for this response.

≥ 1

datapagenextPage
integernullable

Next page number to request when more reels are available; otherwise null.

≥ 1

datapagehasMore
boolean

Whether another page of reels is available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/instagram/search/reels?query=dogs" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Reels search results for the requested page.

On this page

No Headings