Get Instagram profile

Get an Instagram profile by handle, profile URL or user id, optionally with its latest posts and About this account details.

GET/v2/instagram/profiles/{profile}
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
profilestringrequiredpath

Handle, profile URL or numeric user id.

includearrayoptional+1 eachquery

Optional extras, comma-separated: `recentMedia`, `about` (+1 credit each).

any of: recentMedia, about (comma-separated)

Response fields
131

Endpoint-specific response payload.

datalookupStatus
string

`found`; `private` when the account is private (only what Instagram shows publicly is returned); `not_found` when it doesn't exist.

one of: found, private, not_found

The profile. Null when not found.

dataprofileid
stringnullable

Instagram user id.

pattern: ^\d+$

dataprofilehandle
stringnullable

Username, without @.

dataprofiledisplayName
stringnullable

Display name.

dataprofileavatarUrl
stringnullable

Profile picture. Instagram CDN URL; it expires after a while.

dataprofileverified
booleannullable

Whether the account is verified.

dataprofileprivateAccount
booleannullable

Whether the account is private.

dataprofilebio
stringnullable

Bio text.

dataprofileprofileUrl
string

Public profile URL.

dataprofileavatarUrlHd
stringnullable

Higher-resolution profile picture. Instagram CDN URL; it expires after a while.

dataprofileexternalUrl
stringnullable

Website link on the profile.

Links in the bio. Null when unknown.

dataprofilebioLinks[]title
stringnullable

Link title.

dataprofilebioLinks[]url
string

Destination URL.

min 1 chars

dataprofilecategory
stringnullable

Category label, such as Musician.

dataprofileaccountType
stringnullable

Account type. Null when unknown.

one of: personal, business, creator, null

Profile counts.

dataprofilemetricsfollowers
integernullable

Followers.

≥ 0

dataprofilemetricsfollowing
integernullable

Accounts followed.

≥ 0

dataprofilemetricsposts
integernullable

Posts on the profile.

≥ 0

dataprofilehasHighlights
booleannullable

Whether the profile has story highlights.

dataprofilehasActiveStory
booleannullable

Whether a story is live right now.

Public contact details. Null unless a business shows them.

dataprofilecontactemail
stringnullable

Public contact email.

dataprofilecontactphone
stringnullable

Public contact phone, with the country code when known.

Business address. Null when none is shown.

dataprofilecontactaddressstreet
stringnullable

Street address.

dataprofilecontactaddresscity
stringnullable

City as shown; it can include the region or country.

dataprofilecontactaddresspostalCode
stringnullable

Postal code.

dataprofilecontactaddresslat
numbernullable

Latitude.

dataprofilecontactaddresslng
numbernullable

Longitude.

Latest posts and Reels on the profile grid, with `include=recentMedia`. Null when not asked for, for private accounts, or when unavailable (not charged).

datarecentMedia[]id
string

Media id.

pattern: ^\d+$

datarecentMedia[]shortcode
stringnullable

Shortcode used in the media URL. Null for stories.

datarecentMedia[]url
stringnullable

Public URL: `/reel/` for Reels, `/p/` otherwise. Null for stories.

datarecentMedia[]kind
string

`post`, `reel` or `story`.

one of: post, reel, story

datarecentMedia[]mediaType
stringnullable

`image`, `video` or `carousel`. Null when unknown.

one of: image, video, carousel, null

datarecentMedia[]caption
stringnullable

Caption text.

datarecentMedia[]altText
stringnullable

Alt text Instagram generated or the owner wrote. Null when none or not reported.

datarecentMedia[]createdAt
stringnullable

When it was posted.

The account that posted it. Null when unknown.

datarecentMedia[]ownerid
stringnullable

Instagram user id.

pattern: ^\d+$

datarecentMedia[]ownerhandle
stringnullable

Username, without @.

datarecentMedia[]ownerdisplayName
stringnullable

Display name.

datarecentMedia[]owneravatarUrl
stringnullable

Profile picture. Instagram CDN URL; it expires after a while.

datarecentMedia[]ownerverified
booleannullable

Whether the account is verified.

datarecentMedia[]ownerprivateAccount
booleannullable

Whether the account is private.

Engagement counts. Null when this view doesn't report one.

datarecentMedia[]metricslikeCount
integernullable

Likes. Null when hidden or not reported.

≥ 0

datarecentMedia[]metricscommentCount
integernullable

Comments.

≥ 0

datarecentMedia[]metricsplayCount
integernullable

Plays, for videos. Counts Instagram plays only, not plays of a cross-posted copy on other apps.

≥ 0

datarecentMedia[]metricsshareCount
integernullable

Shares.

≥ 0

datarecentMedia[]metricssaveCount
integernullable

Saves.

≥ 0

datarecentMedia[]metricslikesHidden
booleannullable

Whether the owner hides the like count.

datarecentMedia[]imageUrl
stringnullable

Image, or a video's cover image. Instagram CDN URL; it expires after a while.

datarecentMedia[]thumbnailUrl
stringnullable

Small preview image. Instagram CDN URL; it expires after a while.

datarecentMedia[]videoUrl
stringnullable

Video file. Instagram CDN URL; it expires after a while.

datarecentMedia[]durationSec
numbernullable

Video length in seconds, to the millisecond.

Pixel size. Null when unknown.

datarecentMedia[]dimensionswidth
integer

Width in pixels.

≥ 0

datarecentMedia[]dimensionsheight
integer

Height in pixels.

≥ 0

Every item of a carousel, in order. Null when not a carousel.

datarecentMedia[]carousel[]id
stringnullable

Media id of this item.

pattern: ^\d+$

datarecentMedia[]carousel[]mediaType
stringnullable

`image` or `video`. Null when unknown.

one of: image, video, null

datarecentMedia[]carousel[]imageUrl
stringnullable

Image, or a video's cover. Instagram CDN URL; it expires after a while.

datarecentMedia[]carousel[]videoUrl
stringnullable

Video file. Instagram CDN URL; it expires after a while.

datarecentMedia[]carousel[]durationSec
numbernullable

Video length in seconds, to the millisecond. Null for images.

Pixel size. Null when unknown.

datarecentMedia[]carousel[]dimensionswidth
integer

Width in pixels.

≥ 0

datarecentMedia[]carousel[]dimensionsheight
integer

Height in pixels.

≥ 0

datarecentMedia[]carousel[]altText
stringnullable

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.

datarecentMedia[]audioid
stringnullable

Audio id.

pattern: ^\d+$

datarecentMedia[]audiotitle
stringnullable

Song or sound title.

datarecentMedia[]audioartist
stringnullable

Artist name.

datarecentMedia[]audioisOriginal
booleannullable

Whether it is original audio rather than licensed music.

datarecentMedia[]audioartistHandle
stringnullable

Username of the account behind original audio.

Collab co-authors. Empty when none.

datarecentMedia[]coauthors[]id
stringnullable

Instagram user id.

pattern: ^\d+$

datarecentMedia[]coauthors[]handle
stringnullable

Username, without @.

datarecentMedia[]coauthors[]displayName
stringnullable

Display name.

datarecentMedia[]coauthors[]avatarUrl
stringnullable

Profile picture. Instagram CDN URL; it expires after a while.

datarecentMedia[]coauthors[]verified
booleannullable

Whether the account is verified.

datarecentMedia[]coauthors[]privateAccount
booleannullable

Whether the account is private.

Accounts tagged in the media. Empty when none. Null when this view doesn't carry tags.

datarecentMedia[]taggedUsers[]id
stringnullable

Instagram user id.

pattern: ^\d+$

datarecentMedia[]taggedUsers[]handle
stringnullable

Username, without @.

datarecentMedia[]taggedUsers[]displayName
stringnullable

Display name.

datarecentMedia[]taggedUsers[]avatarUrl
stringnullable

Profile picture. Instagram CDN URL; it expires after a while.

datarecentMedia[]taggedUsers[]verified
booleannullable

Whether the account is verified.

datarecentMedia[]taggedUsers[]privateAccount
booleannullable

Whether the account is private.

Tagged location. Null when none.

datarecentMedia[]locationid
stringnullable

Location id.

pattern: ^\d+$

datarecentMedia[]locationname
stringnullable

Place name.

datarecentMedia[]locationlat
numbernullable

Latitude.

datarecentMedia[]locationlng
numbernullable

Longitude.

datarecentMedia[]isPaidPartnership
booleannullable

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.

datarecentMedia[]sponsors[]id
stringnullable

Instagram user id.

pattern: ^\d+$

datarecentMedia[]sponsors[]handle
stringnullable

Username, without @.

datarecentMedia[]sponsors[]displayName
stringnullable

Display name.

datarecentMedia[]sponsors[]avatarUrl
stringnullable

Profile picture. Instagram CDN URL; it expires after a while.

datarecentMedia[]sponsors[]verified
booleannullable

Whether the account is verified.

datarecentMedia[]sponsors[]privateAccount
booleannullable

Whether the account is private.

datarecentMedia[]commentsDisabled
booleannullable

Whether the owner turned comments off. Null when this view doesn't say.

datarecentMedia[]isPinned
booleannullable

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.

datarecentMedia[]storyexpiresAt
stringnullable

When the story expires, or expired for a story kept in a highlight.

Link stickers.

datarecentMedia[]storylinkStickers[]url
string

Link destination: the address the sticker opens, not Instagram's redirect.

min 1 chars

datarecentMedia[]storylinkStickers[]displayUrl
stringnullable

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.

datarecentMedia[]storymentions[]id
stringnullable

Instagram user id.

pattern: ^\d+$

datarecentMedia[]storymentions[]handle
stringnullable

Username, without @.

datarecentMedia[]storymentions[]displayName
stringnullable

Display name.

datarecentMedia[]storymentions[]avatarUrl
stringnullable

Profile picture. Instagram CDN URL; it expires after a while.

datarecentMedia[]storymentions[]verified
booleannullable

Whether the account is verified.

datarecentMedia[]storymentions[]privateAccount
booleannullable

Whether the account is private.

The post or Reel the story re-shares. Null when none.

datarecentMedia[]storysharedMediaid
string

Media id of the shared post or Reel.

pattern: ^\d+$

datarecentMedia[]storysharedMediashortcode
string

Shortcode of the shared post or Reel.

min 1 chars

About this account details, with `include=about`. Null when not asked for or unavailable (not charged).

dataaboutaccountBasedIn
stringnullable

Country or region the account is based in.

dataaboutjoinedMonth
stringnullable

Month the account joined, as YYYY-MM.

pattern: ^\d{4}-(0[1-9]|1[0-2])$

dataaboutformerUsernamesCount
integernullable

How many usernames it has had before. Zero when it has never been renamed. Null when unknown.

≥ 0

Metadata about the API response.

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: v2

Code example

curl "https://api.socialfetch.dev/v2/instagram/profiles/nike?include=value" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Instagram profile.