GET /v1/profile

A profile and its public metrics, by URL or by platform and username. One credit, free from cache.

Request

GET /v1/profile
Authorization: Bearer sv_live_…

Parameter	Type	Required	Notes
`url`	string	one of	Profile URL
`platform`	string	one of	`tiktok`, `instagram`, `youtube` — with `username`
`username`	string	one of	Handle, with or without `@`
`freshness`	string	no	`cached` (default) or `fresh`

Pass either url, or platform + username. Passing both returns 400.

Cost: Basic — 1 credit. Free on a cache hit.

Examples

# by URL
curl https://api.sourcevine.io/v1/profile \
  -H "Authorization: Bearer $SOURCEVINE_API_KEY" \
  --data-urlencode "url=https://www.instagram.com/nordickitchen/" -G

# by handle
curl https://api.sourcevine.io/v1/profile \
  -H "Authorization: Bearer $SOURCEVINE_API_KEY" \
  --data-urlencode "platform=instagram" \
  --data-urlencode "username=nordickitchen" -G

{
  "id": "sd_prof_b71e4d0a9c236f88",
  "platform": "instagram",
  "resource_type": "profile",
  "platform_resource_id": "18294771",
  "username": "nordickitchen",
  "display_name": "Nordic Kitchen",
  "avatar_url": "https://…",
  "verified": false,
  "url": "https://www.instagram.com/nordickitchen/",
  "metrics": {
    "followers": 128940,
    "following": 892,
    "posts": 1204,
    "likes": null,
    "views": null
  },
  "availability": { "status": "available", "reason": null },
  "source_timestamp": "2026-08-27T09:38:15Z",
  "fetched_at": "2026-08-27T09:40:51Z",
  "cache_age_seconds": 471,
  "freshness": "cached"
}

Which metrics you actually get

Coverage is a property of the platform, not of us. Nothing here is a gap we intend to close, because the data is not published:

Metric	TikTok	Instagram	YouTube
`followers`	✓	✓	✓ (subscribers)
`following`	✓	✓	`null`
`posts`	✓	✓	✓ (videos)
`likes`	✓ (lifetime)	`null`	`null`
`views`	`null`	`null`	✓ (lifetime)

null means the platform does not report it. It never means zero.

Notes

Handles change. platform_resource_id does not. If you are storing profiles, key on that and treat the handle as display text.
avatar_url expires. Platform CDN URLs rotate — fetch and store the image yourself if you need it to persist.

Last updated 27 August 2026