Social Fetch
Instagram

Get Instagram basic profile

Get a lightweight Instagram profile by numeric user ID.

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

API key (`sfk_...`)

Parameters
1
userId*stringpath

Instagram numeric user id to look up.

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

Response fields
26

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

Code example

curl "https://api.socialfetch.dev/v1/instagram/profiles/258288542/basic" \
  -H "x-api-key: YOUR_API_KEY"

Responses

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

On this page

No Headings