Social Fetch
Instagram

Get Instagram profile

Get a full Instagram profile by handle.

GET/v1/instagram/profiles/{handle}
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
handle*stringpath

Instagram handle to look up, with or without a leading @.

min 1 chars · max 64 chars

Response fields
51

Endpoint-specific response payload.

datalookupStatus
string

Whether the profile was resolved.

one of: found, private, not_found

Profile details when available.

dataprofileplatform
string

Social platform for this profile.

one of: instagram

dataprofilehandle
string

Instagram username without the leading @.

dataprofiledisplayName
stringnullable

Public display name on the Instagram profile.

dataprofilebio
stringnullable

Profile biography text.

dataprofileavatarUrl
stringnullable

Best available square avatar image URL.

dataprofileavatarUrlHd
stringnullableoptional

Higher-resolution avatar URL when available.

dataprofileverified
boolean

Whether Instagram marks the profile as verified.

dataprofileprofileUrl
string

Canonical public Instagram profile URL.

min 1 chars

dataprofileprivateAccount
boolean

Whether the account is private.

dataprofileplatformUserId
stringoptional

Instagram numeric user id as a string.

dataprofilebusinessAccount
booleanoptional

Whether the account is a business account.

dataprofileprofessionalAccount
booleanoptional

Whether the account is a professional/creator account.

dataprofilecategoryName
stringnullableoptional

Category label when Instagram provides one.

dataprofileexternalUrl
stringnullableoptional

Primary external link from the profile.

dataprofilehighlightReelCount
integeroptional

Number of story highlights on the profile.

≥ 0

Structured bio links when available.

dataprofilebioLinks[]title
stringnullable

Link title shown on the profile.

dataprofilebioLinks[]url
string

Destination URL.

min 1 chars

Profile metrics when available.

datametricsfollowers
integer

Follower count reported by Instagram.

≥ 0

datametricsfollowing
integer

Following count reported by Instagram.

≥ 0

datametricsposts
integer

Total public posts count on the profile grid.

≥ 0

Recent grid posts from the profile when available.

datarecentPosts[]id
string

Instagram media id for this post (vendor-defined).

datarecentPosts[]shortcode
string

Public shortcode for the post URL.

datarecentPosts[]mediaType
string

Normalized media type.

one of: video, image, sidecar, unknown

datarecentPosts[]caption
stringnullable

Post caption when available.

datarecentPosts[]takenAt
integer

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

datarecentPosts[]commentCount
integeroptional

Comment count when available.

≥ 0

datarecentPosts[]likeCount
integeroptional

Like count when available.

≥ 0

datarecentPosts[]videoViewCount
integeroptional

Video view count for video posts when available.

≥ 0

datarecentPosts[]displayUrl
stringoptional

Primary display image URL.

datarecentPosts[]thumbnailUrl
stringoptional

Thumbnail image URL.

datarecentPosts[]videoUrl
stringoptional

Direct video URL when available.

Width and height when available.

datarecentPosts[]dimensionswidth
integer

Media width in pixels.

≥ 0

datarecentPosts[]dimensionsheight
integer

Media height in pixels.

≥ 0

Suggested related accounts when available.

datarelatedProfiles[]platformUserId
string

Instagram user id for the account.

datarelatedProfiles[]handle
string

Instagram username.

datarelatedProfiles[]displayName
stringnullable

Display name.

datarelatedProfiles[]avatarUrl
stringnullable

Profile picture URL.

datarelatedProfiles[]verified
boolean

Whether the account is verified.

datarelatedProfiles[]privateAccount
boolean

Whether the account is private.

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/profiles/charlidamelio" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Lookup result. Check `data.lookupStatus` for `found`, `private`, or `not_found`.

On this page

No Headings