TikTok Gifting API: Tracking Diamonds, Gifts and Top Gifters

Why gifting data matters more than follower counts

Follower count is the number everyone can see, and it is the least useful one for judging a LIVE creator. A creator with a modest following and a loyal gifting audience can out-earn one with ten times the followers who never streams. For an agency deciding who to recruit or where to focus coaching, earned diamonds are the closest thing to ground truth: they measure an audience that shows up and spends, not one that tapped follow once a year ago.

The same is true in the other direction. The people sending the gifts, often called whales, are a small group responsible for a large share of any market's gifting volume. Knowing who they are, which creators they support, and when they were last active tells you more about a market's real money flow than any public statistic.

What a gifting API should give you

There is no official TikTok endpoint for any of this, so gifting data comes from providers who record it live from public streams. When you evaluate one, look for these capabilities.

• Diamonds per creator over time. Not a single lifetime blob, but totals you can attribute to a tracking window, so a creator who earned nothing this month cannot hide behind an old spike.
• A top-gifter leaderboard per market. Ranked spenders with lifetime and recent windows, so you can tell an active whale from a retired one.
• Gifter detail. For one spender, exactly which creators they fund and for how much. This is how you find the patrons behind a rising creator.
• Honest accounting. Gift streaks and combos on TikTok report running totals while they animate, and a naive recorder counts the same diamonds repeatedly. Ask any provider how they handle streak accounting; a wrong answer here inflates every number downstream.

What this looks like in practice

As a concrete example, the RnG API exposes the gifting layer of our recruitment platform as JSON: per-creator diamond totals on the creator feed, a per-country top-gifter leaderboard, and a detail endpoint showing which creators one gifter supports. A request for a market's biggest spenders looks like this:

curl "https://rngrow.com/api/v1/gifters?country=RO&sort=7d" \
  -H "X-API-Key: rng_live_YOUR_KEY"

Sorting by the rolling seven days matters more than it looks: lifetime boards freeze around historic whales, while the weekly view shows you who is spending right now. Typical uses include watching whether a creator you manage is gaining or losing patron support, spotting when a major gifter shifts spend toward a competitor's creator, and qualifying recruitment targets by proven earnings rather than follower counts.

A note on estimated value

Diamonds convert to money at rates that depend on how the creator cashes out, so any dollar figure attached to a diamond count is an estimate. Treat estimated value as a comparison tool between creators and gifters, not as an accounting number. The diamond counts themselves are the stable unit, and comparisons made in diamonds hold up regardless of payout details.

The takeaway

Gifting data is the closest you can get to seeing the real economy of TikTok LIVE, and it is only available from providers who record it as it happens. Whether you use it to qualify recruits, retain earners, or track the whales who fund a market, insist on timestamps, recent-window rankings, and correct streak accounting. With those in place, a gifting API turns the most opaque part of TikTok into numbers your team can act on.