POST/v1/tiktok/challenge

TikTok Challenge Info API

Get TikTok challenge/hashtag details and stats. Hashtag research from $0.01/call.

Fetch details about a TikTok challenge by name or ID. Returns challenge metadata, view counts, and description.

Full Docs Get API Key — Free $5 Credit $0.01 / call

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/tiktok/challengett-challenge$0.01/call

Response

Example response — hit "Send Request" to see a live result

{
  "ok": true,
  "data": {
    "challenge": {
      "id": "42164",
      "title": "fyp",
      "desc": "For You Page",
      "stats": {
        "viewCount": 30000000000
      }
    }
  }
}

Features

✓

Challenge metadata

Look up a challenge by name or ID and receive its full record, including the canonical id and title for use in other endpoints.

✓

View count stats

The response includes a viewCount in the stats object, quantifying the total reach a hashtag has accumulated.

✓

Challenge description

Returns the challenge's desc text, explaining what the hashtag or trend is about.

✓

Lookup by name or ID

Accepts either a challenge_name (without the #) or a numeric challenge_id, so you can resolve a hashtag from whichever you have.

Use cases

Hashtag Research

Research TikTok hashtag performance and reach.

Campaign Measurement

Measure the reach and engagement of hashtag marketing campaigns.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/tiktok/challenge', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "challenge_name": "fyp",
    "challenge_id": "42164"
  }),
});
const data = await res.json();
console.log(data);

TikTok Challenge Info API for hashtag stats and reach

The YepAPI TikTok Challenge Info API resolves a hashtag into its full record. Look up a challenge by name like "fyp" or by numeric ID and get its title, description, and total view count — the canonical stats for any TikTok trend.

It is the detail endpoint for hashtag research: discover challenges with the TikTok Challenge Search API, confirm and size them here, then pass the challenge ID to the TikTok Challenge Videos API to study the entries themselves.

What is a TikTok Challenge Info API?

A TikTok Challenge Info API returns the metadata and stats for a specific hashtag challenge, identified by name or numeric ID. With YepAPI you POST a challenge_name (without the #) or a challenge_id to /v1/tiktok/challenge and receive a challenge object with an id, title, desc, and a stats block containing viewCount. Because TikTok offers no open hashtag endpoint, this gives you authoritative, structured data on any trend's reach and definition — the lookup you use to confirm a hashtag and measure its scale before acting on it.

Build your own hashtag research tool

Use this endpoint to build a hashtag-research tool. Accept a hashtag, return its total viewCount and description so a marketer can judge reach at a glance, and snapshot the count over time to track whether a trend is growing or cooling. Resolve by name when that is all you have, or by ID for precision. Feed the challenge ID into the Challenge Videos API to examine entries. The same YepAPI key reaches Instagram and YouTube data, so one tool can cover hashtags across platforms.

TikTok Challenge Info API pricing — $0.01 per call

Each challenge lookup costs $0.01 and returns the hashtag's full metadata and view count. There is no subscription or minimum. Tracking 100 campaign hashtags daily to measure reach costs about $1 per day, and a one-off audit of 500 hashtags runs around $5 — straightforward, usage-based pricing for any marketing budget.

Measure campaign reach with a single lookup

For hashtag marketing, the view count is the headline metric — and this endpoint delivers it in one call. By snapshotting a campaign hashtag's viewCount over time, you can quantify reach, prove ROI, and compare your hashtag against competitors' or industry benchmarks. The name-or-ID flexibility means you can wire it into a dashboard whether your input is a human-readable tag or a stored numeric ID, making campaign measurement effortless.

Try the TikTok Challenge Info API free

Get $5 in free credit with no credit card to begin. That covers 500 hashtag lookups — enough to audit a full set of campaign tags before you pay. Sign up, grab your key, and look up your first challenge now.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

Get API Key — Free $5 Credit

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
Marcus T.
SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
Priya S.
Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Jake R.
Indie Hacker

Frequently asked questions

Fetch details about a TikTok challenge by name or ID. Returns challenge metadata, view counts, and description.

Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/tiktok/challenge. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.