Social Fetch
Get API key
Instagram hub

Instagram Basic Profile API

Resolve a public Instagram account by numeric user id into a compact profile card — handle, bio, follower and post counts, avatar, verification — when you already store the id.

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

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

CRM syncs, creator databases, and backfill jobs often keep Instagram's numeric user id as the stable key. Handles change; ids usually do not. When you already have that id, you do not need a username round-trip just to refresh the public card.

`GET /v1/instagram/profiles/{userId}/basic` takes digits-only `userId` in the path and returns the shared Social Fetch envelope. Branch on `data.lookupStatus` before you write rows — `found`, `private`, and `not_found` are explicit outcomes. When found, `data.profile` includes handle, display name, bio, avatar URLs, verification, profile URL, private-account flag, and `platformUserId`; `data.metrics` carries followers, following, and posts when Instagram exposes them. Keep `meta.requestId` when a row looks wrong.

This is the lightweight id-keyed lookup. Prefer `GET /v1/instagram/profiles/{handle}` when you only have a username and want the full handle-based profile. Posts, reels, and highlights still go through their own paths on the Instagram hub. Pricing is on the credit badge for this operation; bill from `meta.creditsCharged` on every response.

Instagram Basic Profile API FAQ

How do I get an Instagram profile by user id via API?

Call `GET /v1/instagram/profiles/{userId}/basic` with your Social Fetch API key (`x-api-key`) and the numeric Instagram user id in the path (digits only). Read `data.lookupStatus`, `data.profile`, and `data.metrics` in the JSON response. Full parameters and examples are in the API docs.

How much does the Instagram Basic Profile API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

What fields does the basic profile response include?

When `lookupStatus` is `found`, the profile object includes handle, display name, bio, avatar URLs, verification, profile URL, private-account flag, and `platformUserId`. Metrics can include followers, following, and posts. Optional fields such as business or professional flags, category, and external URL appear when Instagram exposes them.

Basic profile by user id vs full profile by handle?

Use `GET /v1/instagram/profiles/{userId}/basic` when you already store the numeric Instagram user id and want a lightweight card. Use `GET /v1/instagram/profiles/{handle}` when you have a username. They are different routes on the Instagram hub.

What happens for private or missing Instagram user ids?

The call still returns a typed `lookupStatus`. Private accounts resolve as `private`; unknown ids as `not_found`. Do not invent follower counts or bios. Keep `meta.requestId` if you need support on a failed enrichment row.

Do I need Instagram Graph API access or creator login?

No. Social Fetch returns publicly visible profile data for enrichment-style lookups. Meta's Instagram Graph API is for accounts you manage or that grant your app access — publishing and owned insights, not arbitrary public creator cards by id.

Does this endpoint return posts or reels?

No. This route returns the lightweight profile card. For recent posts use `GET /v1/instagram/profiles/{handle}/posts`; for reels use `GET /v1/instagram/profiles/{handle}/reels` (those list routes take a handle). See the Instagram platform hub for the full list.

Other Instagram endpoints