GET /v1/profile/posts

A page of a profile's recent posts, newest first, with an opaque cursor. Two credits a page, free from cache.

Request

GET /v1/profile/posts
Authorization: Bearer sv_live_…

Parameter	Type	Required	Notes
`url`	string	one of	Profile URL
`platform` + `username`	string	one of	Alternative to `url`
`cursor`	string	no	From `next_cursor` of the previous page
`limit`	int	no	1–50, default 20
`freshness`	string	no	`cached` (default) or `fresh`

Cost: List — 2 credits per page, regardless of limit. Free on a cache hit. Fetching 50 in one page costs the same as fetching 10, so use a larger limit when you know you want the volume.

Example

curl https://api.sourcevine.io/v1/profile/posts \
  -H "Authorization: Bearer $SOURCEVINE_API_KEY" \
  --data-urlencode "url=https://www.tiktok.com/@atlas.makes" \
  --data-urlencode "limit=20" -G

{
  "items": [
    {
      "id": "sd_post_1c7be04a92f3d558",
      "platform": "tiktok",
      "resource_type": "post",
      "platform_resource_id": "7042118893001",
      "author": { "platform_resource_id": "6789432100", "username": "atlas.makes" },
      "url": "https://www.tiktok.com/@atlas.makes/video/7042118893001",
      "caption": "the jig that finally worked",
      "media_type": "video",
      "published_at": "2026-08-20T09:00:00Z",
      "metrics": {
        "views": 412000, "likes": 38400, "comments": 921,
        "shares": 2140, "saves": 6630
      }
    }
  ],
  "next_cursor": "eyJvIjoyMH0",
  "availability": { "status": "available", "reason": null },
  "fetched_at": "2026-08-27T09:41:02Z",
  "cache_age_seconds": 288,
  "freshness": "cached"
}

Paginating

next_cursor is opaque — do not parse it, construct it, or store it long term. It is null on the last page.

cursor, posts = None, []
while True:
    r = client.get("/v1/profile/posts",
                   params={"url": url, "limit": 50, "cursor": cursor}).json()
    posts += r["items"]
    cursor = r.get("next_cursor")
    if not cursor:
        break

Each iteration is a separate billable page. A profile with 600 posts is 12 pages at limit=50, so 24 credits — worth knowing before you loop over a list of creators.

Notes

Newest first, always.
Pinned posts may appear out of chronological order on platforms that support pinning. Sort by published_at if strict ordering matters.
Depth varies by platform. How far back the history goes is an upstream property; we do not pad it or pretend otherwise.
A cursor can go stale. If the profile posts while you are paginating, a later page may shift. For exact snapshots, record fetched_at per page.

Last updated 27 August 2026