sourcevine
Sign up

Overview

Sourcevine turns any public TikTok, Instagram or YouTube URL into one normalized JSON object. Four endpoints, one schema, freshness on every field.

What Sourcevine does

Sourcevine gives you one API and one response shape across TikTok, Instagram and YouTube. You send a URL or an identifier; you get back a normalized object with the same keys regardless of which platform it came from. You integrate once, and adding a platform later does not change your parsing code.

It returns public profile and post information only. Nothing behind a login, nothing from a private account, and no contact details at any point.

The four endpoints

Endpoint Does
POST /v1/resolve Takes any supported URL, tells you the platform and resource type, returns the object
GET /v1/profile A profile and its public metrics
GET /v1/profile/posts A page of that profile’s posts, with a cursor
GET /v1/post A single post and its public metrics

resolve is the one to reach for when you have a URL from a customer and do not already know what it points at.

What makes the responses usable

Explicit nulls. When a platform does not report a metric you get null, not 0. A zero standing in for “unknown” is the single most common way normalized social data misleads people, and we would rather return nothing than something wrong.

No invented equivalence. A TikTok view and an Instagram view are not the same measurement and we never merge them into one number for you. Same key name, same position, platform-specific meaning — documented in the schema.

Freshness on every object. source_timestamp, fetched_at, cache_age_seconds and freshness ship with every response, so a report built on our data can say exactly when each figure was true.

What it costs

Credits are charged per operation, and cache hits cost nothing. You are billed for live fetches, so checking the same resource repeatedly is cheap rather than punitive. Full detail in credits & billing.

You are also never charged for a request that failed on our side or our upstream’s — including a profile that no longer exists, which our provider still bills us for.

Start here

  1. Quickstart — key to first response in a few minutes
  2. Authentication — keys, projects, rate limits
  3. Normalized schema — every field you can receive

These docs describe the v1 API as specified. Endpoints are rolling out; if something here does not match what the API returns, the API is right and this page is wrong — please tell us.

Last updated 27 August 2026