Instagram

Search Instagram by hashtag

Search public Instagram posts and Reels by hashtag.

GET/v1/instagram/search/hashtags
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
hashtagstringrequiredquery

Hashtag to search for. A leading # is optional.

min 1 chars · max 256 chars

datePostedstringoptionalquery

Optional filter for when matching posts were posted.

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

mediaTypestringoptionalquery

Content filter. Use `all` for posts and Reels, or `reels` for Reels only. Default: `all`.

one of: all, reels

cursorstringoptionalquery

Pagination cursor returned by a previous response.

min 1 chars

Response fields
53

Endpoint-specific response payload.

datahashtag
string

Hashtag evaluated for this response, without a leading #.

datamediaType
string

Content filter applied for this response.

one of: all, reels

Instagram posts matching the hashtag for the requested page. Empty when no posts match.

dataposts[]id
string

Instagram media id for this post.

min 1 chars

dataposts[]shortcode
string

Public shortcode used in the Instagram post URL.

min 1 chars

dataposts[]url
string

Canonical public Instagram URL for this post.

min 1 chars

dataposts[]caption
stringnullable

Caption text when Instagram provides one.

dataposts[]createdAt
string

When the post was taken or posted (ISO-8601).

dataposts[]isVideo
boolean

Whether this media item is a video or Reel.

dataposts[]thumbnailUrl
stringoptional

Thumbnail or cover image URL when available.

dataposts[]displayUrl
stringoptional

Primary display image URL when available.

dataposts[]videoUrl
stringoptional

Direct video URL when a playable URL is available.

dataposts[]videoDurationSec
numberoptional

Video duration in seconds when available.

≥ 0

dataposts[]hasAudio
booleanoptional

Whether the post includes audio.

dataposts[]accessibilityCaption
stringnullableoptional

Accessibility caption when Instagram provides one.

Engagement metrics when Instagram exposes them.

dataposts[]metricsviews
integeroptional

View count when Instagram exposes it.

≥ 0

dataposts[]metricsplays
integeroptional

Play count when Instagram exposes it.

≥ 0

dataposts[]metricslikes
integeroptional

Like count when Instagram exposes it.

≥ 0

dataposts[]metricscomments
integeroptional

Comment count when Instagram exposes it.

≥ 0

Post owner metadata when Instagram exposes it.

dataposts[]ownerplatformUserId
stringoptional

Instagram numeric user id for the post owner when present.

dataposts[]ownerhandle
stringoptional

Instagram username for the post owner when present.

dataposts[]ownerdisplayName
stringoptional

Display name for the post owner when present.

dataposts[]owneravatarUrl
stringoptional

Profile image URL for the post owner when present.

dataposts[]ownerverified
booleanoptional

Whether Instagram marks the post owner as verified.

dataposts[]ownerprivateAccount
booleanoptional

Whether the post owner account is private.

dataposts[]ownerfollowerCount
integeroptional

Follower count when Instagram exposes it on the owner.

≥ 0

dataposts[]ownerpostCount
integeroptional

Post count when Instagram exposes it on the owner.

≥ 0

Tagged location when Instagram exposes it.

dataposts[]locationid
stringoptional

Location id when Instagram provides one.

dataposts[]locationname
stringnullableoptional

Location name when Instagram provides one.

dataposts[]locationslug
stringnullableoptional

Location slug when Instagram provides one.

dataposts[]locationaddressJson
stringnullableoptional

Serialized address metadata when Instagram provides it.

Audio attribution when Instagram exposes it.

dataposts[]audioartistName
stringnullableoptional

Attributed artist name when available.

dataposts[]audiosongName
stringnullableoptional

Attributed song or audio title when available.

dataposts[]audiousesOriginalAudio
booleanoptional

Whether the post uses original audio.

dataposts[]audioshouldMuteAudio
booleanoptional

Whether Instagram indicates the audio should be muted.

dataposts[]audioshouldMuteAudioReason
stringnullableoptional

Reason for muting audio when Instagram provides one.

dataposts[]audioaudioId
stringnullableoptional

Audio track id when Instagram provides one.

dataposts[]isAd
booleanoptional

Whether Instagram marks the post as an ad.

dataposts[]isAffiliate
booleanoptional

Whether Instagram marks the post as affiliate content.

dataposts[]isPaidPartnership
booleanoptional

Whether Instagram marks the post as a paid partnership.

Pagination state for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when another page exists.

datapagehasMore
boolean

Whether another page of results 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

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/instagram/search/hashtags?hashtag=makeup" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Hashtag search results for the requested tag.