GET /v1/post

A single post and its public metrics, by URL. One credit, free from cache.

Request

GET /v1/post
Authorization: Bearer sv_live_…

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

Example

curl https://api.sourcevine.io/v1/post \
  -H "Authorization: Bearer $SOURCEVINE_API_KEY" \
  --data-urlencode "url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" -G

{
  "id": "sd_post_5c08a1fe62b4903d",
  "platform": "youtube",
  "resource_type": "post",
  "platform_resource_id": "dQw4w9WgXcQ",
  "author": { "platform_resource_id": "UCq2mAtlasMakes", "username": "atlasmakes" },
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "caption": "Building the workbench, part 3",
  "media_type": "video",
  "published_at": "2026-08-18T14:22:00Z",
  "metrics": {
    "views": 1840000, "likes": 96200, "comments": 4180,
    "shares": null, "saves": null
  },
  "availability": { "status": "available", "reason": null },
  "source_timestamp": "2026-08-27T09:39:00Z",
  "fetched_at": "2026-08-27T09:41:12Z",
  "cache_age_seconds": 132,
  "freshness": "cached"
}

Which metrics you actually get

Deleted posts

A post that no longer exists returns 200 with:

{ "availability": { "status": "not_found", "reason": "resource_deleted" } }

This is not charged, even though our upstream bills us for the lookup. Do not retry it — the post is gone, and asking again produces the same answer at the same cost to us.

If you are tracking posts over time, record the not_found and stop polling that resource. A deleted post reads as a 100% drop in engagement, and treating it as a measurement rather than a deletion will quietly corrupt any retention analysis you build on it.

Last updated 27 August 2026