Instagram Profile API reference

Follower count, following count and post count for a public Instagram account. Takes a public URL, returns one object, 2 credits a call.

This named API keeps Instagram fields in Instagram's own vocabulary. For a higher-level product page, see Instagram Profile API.

Endpoint

GET /v1/instagram/profile
Authorization: Bearer sv_live_...

`POST` is also accepted with the same parameters in the request body. Send the key in the `Authorization` header, never in the query string.

Parameters

Name	Type	Required	Notes
`url`	string	yes	Public Instagram URL matching this API's input.

Sample Request

This is a copyable request shape. Replace the sample values with the public Instagram target or parameters your workflow uses.

curl -G 'https://api.sourcevine.io/v1/instagram/profile' \
  -H 'Authorization: Bearer sv_live_...' \
  --data-urlencode 'url=https://www.instagram.com/instagram'

Sample Response

A response this API returned, against the target above. Your values depend on the resource you ask about and when you ask.

{
  "data": {
    "url": "https://www.instagram.com/instagram/",
    "cached": false,
    "fullName": "Instagram",
    "username": "instagram",
    "verified": true,
    "avatarUrl": "https://scontent-bcn1-1.cdninstagram.com/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-bcn1-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gGwCaABaPIWa6O7864T9tmTBQjAmpB2HrenPwgWdAhBJ7IwW1jJCyMjFQXBfd-CCzk&_nc_ohc=jfEnYrZFq7cQ7kNvwGTHBJ8&_nc_gid=ldxcovHOVjqyREdMS8IjBA&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQLSheltqCasW-7trPpsqJj_rMBjOFQemrl2sEQ3wKZ9Nw&oe=6A9D98A7…",
    "fetchedAt": "2026-09-02T07:18:17Z",
    "postCount": 8574,
    "followerCount": 686363298,
    "followingCount": 285,
    "cacheAgeSeconds": null,
    "sourceTimestamp": null
  },
  "success": true,
  "available": true
}

Fields

Field	Type	Notes
`url`	string	Canonical public profile or channel URL.
`username`	string	Platform identity.
`fullName`	string \| null	Display name as the platform publishes it.
`followerCount`	integer \| null	The platform's public audience count.
`postCount`	integer \| null	Platform-specific profile metric.
`fetchedAt`	ISO datetime	When Sourcevine read the public page.
`sourceTimestamp`	ISO datetime \| null	The platform timestamp when it is available.
`cached`	boolean	True when this answer repeats an identical request made moments earlier.
`cacheAgeSeconds`	integer	Seconds since the reading was taken.

Availability States

Status	Charged	Client behavior
`available`	yes for live reads	Use data.
`not_found`	yes	Store the state and stop polling.
`private`	yes	Store the state and stop polling.
`unsupported`	no	Fix the URL or call the matching API.
`upstream_unavailable`	no	Retry later with backoff.

Unavailable resources return `success: true`, `available: false`, `availability`, and `data: null`. API or authentication failures return `success: false` with an `error` object.

Billing

A call costs 2 credits. A deleted, private or empty resource is charged like any lookup and says so. An unsupported URL or a read we could not complete is not charged. The `X-Credits-Charged` response header is the source of truth for what happened on that request.

Successful responses include `fetchedAt`, the time we read the platform.

What This API Does Not Return

No contact or bio fields: Bios, email addresses, phone numbers, postal addresses and messenger handles are outside the response contract.
No private data: Private accounts, restricted content and unavailable resources return typed availability instead of guessed data.
No identity matching: Sourcevine does not claim that two profiles on different platforms belong to the same person.

Last updated 1 September 2026