Social Fetch
Instagram

Get Instagram basic profile

Get a lightweight Instagram profile by numeric user ID.

Operation

GET/v1/instagram/profiles/{userId}/basic

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

userIdstringrequired

Instagram numeric user id to look up.

min 1 chars · max 32 chars · pattern: ^\d+$

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the profile was found, private, or not found.

one of: found, private, not_found

dataprofile
objectrequirednullable

Profile details when available.

dataprofileplatform
stringrequired

Social platform for this profile.

one of: instagram

dataprofilehandle
stringrequired

Instagram username without the leading @.

dataprofiledisplayName
stringrequirednullable

Public display name on the Instagram profile.

dataprofilebio
stringrequirednullable

Profile biography text.

dataprofileavatarUrl
stringrequirednullable

Best available square avatar image URL.

dataprofileavatarUrlHd
stringnullable

Higher-resolution avatar URL when available.

dataprofileverified
booleanrequired

Whether Instagram marks the profile as verified.

dataprofileprofileUrl
stringrequired

Canonical public Instagram profile URL.

min 1 chars

dataprofileprivateAccount
booleanrequired

Whether the account is private.

dataprofileplatformUserId
stringrequired

Instagram numeric user id as a string.

dataprofilebusinessAccount
boolean

Whether the account is a business account.

dataprofileprofessionalAccount
booleannullable

Whether the account is a professional or creator account.

dataprofileaccountType
integernullable

Instagram account type code when available.

dataprofilecategoryName
stringnullable

Category label when Instagram provides one.

dataprofileexternalUrl
stringnullable

Primary external link from the profile.

datametrics
objectrequirednullable

Profile metrics when available.

datametricsfollowers
integerrequired

Follower count reported by Instagram.

≥ 0

datametricsfollowing
integerrequired

Following count reported by Instagram.

≥ 0

datametricsposts
integerrequired

Total public posts count on the profile grid.

≥ 0

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

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

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page