Use case
Prove a campaign post went live
Confirm a creator posted what they were paid for: read the post by URL, capture public metrics with a timestamp, and re-check it later.
A free skill for your AI assistant: it reads every post URL, records the public metrics and saves a snapshot to compare next time. API calls use credits.
| Post | Status | Views | Likes | Read at |
|---|---|---|---|---|
| @northpeak.coffee · TikTok video | Live | 48,210 | 3,904 | 7 Oct, 09:12 UTC |
| @northpeak.coffee · Instagram reel | Live | 12,877 | 1,120 | 7 Oct, 09:12 UTC |
| @lena.brews · TikTok video | Private | — | — | 7 Oct, 09:13 UTC |
The problem
A creator sends a link and a screenshot. The screenshot is not evidence, and by the time anyone checks, the post may have been edited, made private or deleted. What a reconciliation needs is a number with a timestamp on it, taken by something other than the person being paid.
How it works
- TikTok Video Stats
/v1/tiktok/statsRead views, likes, comments, shares and collects for the delivered post. The response carries fetchedAt, so the number is dated.
- Instagram Post Stats
/v1/instagram/statsSame job on Instagram posts and reels. Fields Instagram does not publish are absent rather than zero, so a missing view count never reads as no views.
- TikTok Profile
/v1/tiktok/profileCapture the account’s follower count on the same day, so reach claims can be checked against the audience that existed at the time.
What this does not do
- A deleted or private post returns a typed availability status, not a number. That is the answer, and it is charged like any lookup.
- Metrics are what the platform publishes publicly. There is no impressions or reach figure, because those live behind the creator’s own analytics login.
- Nothing here proves who was paid, only what the public post shows.
Billing
Each step above costs that API's credit price on every call, including a link that turns out to be deleted or private. A read we could not complete is never charged, and a dead link comes back as a typed status rather than a stale number. How billing works →
APIs used
Try the browser tools
Build with Sourcevine
Start with 100 free credits.
Enough to build and test an integration. No card required.