Get Instagram basic profile

Get a lightweight Instagram profile by numeric user ID when you already have the id.

GET/v1/instagram/profiles/{userId}/basic
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
userIdstringrequiredpath

Instagram numeric user id to look up.

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

Response fields
27

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
string

Instagram numeric user id as a string.

dataprofilebusinessAccount
booleanoptional

Whether the account is a business account.

dataprofileprofessionalAccount
booleannullableoptional

Whether the account is a professional or creator account.

dataprofileaccountType
integernullableoptional

Instagram account type code when available.

dataprofilecategoryName
stringnullableoptional

Category label when Instagram provides one.

dataprofileexternalUrl
stringnullableoptional

Primary external link from the profile.

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

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

Responses

Instagram basic profile lookup result.