Do I need the numeric challenge_id before calling /v1/challenge/posts?

Yes. Call GET /v1/challenge/info?challenge_name=yourhashtag once (10 Credits) to obtain data.id, then cache that numeric ID in your database and pass it as cid to GET /v1/challenge/posts for all future pagination.

Does /v1/music/info return a playable MP3 link for the audio track?

Yes. GET /v1/music/info returns data.play (direct MP3 audio stream), cover art, duration, artist metadata, and total video usage count (data.user_count).

Trend Intelligence · 20268 min read·Updated 2026-11-03

TikTok Hashtag, Sound & Viral Trends API: Track Breakout Topics in Real Time

How quantitative consumer funds, record labels, and social trend platforms detect breakout TikTok hashtags and audio tracks before they peak — using GET /v1/challenge/info, /v1/music/info, and /v1/feed/list.

Get Free API Key (500 Free Credits) →Run Live Code Example ↓

$0.20 / 1K Videos · $0.10 / 1K Comments & Followers · No OAuth Needed

Instant Quickstart · Copy & Run in 30 Seconds

Track Hashtag Views, Tagged Videos & Sound Usage in Python & Node.js

Execute in Live Playground →

import requests

API_KEY = "tk_live_your_api_key"
HEADERS = {"x-api-key": API_KEY}

def inspect_hashtag_trend(tag: str):
    info = requests.get(
        "https://api.tiktokapi.io/v1/challenge/info",
        params={"challenge_name": tag.lstrip("#")},
        headers=HEADERS,
        timeout=20,
    ).json()["data"]

    posts = requests.get(
        "https://api.tiktokapi.io/v1/challenge/posts",
        params={"cid": info["id"], "count": 20, "cursor": 0},
        headers=HEADERS,
        timeout=25,
    ).json()["data"]

    return {
        "hashtag": info.get("cha_name"),
        "challenge_id": info.get("id"),
        "total_views": info.get("view_count"),
        "total_videos": info.get("user_count"),
        "sample_videos": len(posts.get("videos", [])),
    }

if __name__ == "__main__":
    print(inspect_hashtag_trend("tiktokmademebuyit"))

Key Engineering Takeaways (TL;DR)

✓GET /v1/challenge/info resolves any hashtag name (without #) into its numeric challenge_id, total cumulative view_count, and total video user_count (10 Credits / call).
✓GET /v1/challenge/posts and GET /v1/music/posts stream up to 30 tagged videos per call (2 Credits / video) complete with play_count, share_count, collect_count, and 1080p MP4 links.
✓Music labels and A&R teams poll GET /v1/music/info (10 Credits / call) to track daily video creation velocity (user_count delta) on emerging sound IDs.
✓GET /v1/feed/list provides real-time regional trending videos by ISO country code (US, GB, DE, JP, KR, BR).

1. Core Endpoints for Hashtag, Audio & Regional Trend Tracking

TikTokAPI.io exposes five dedicated endpoints covering topic challenges, sound tracks, and regional For You feeds:

Hashtag, Sound & Trend API endpoints and unit costs
Endpoint	Input Parameter	Key Metrics Returned	Credits Cost
GET /v1/challenge/info	challenge_name (e.g. tiktokmademebuyit)	id, cha_name, view_count, user_count, desc	10 Credits / call
GET /v1/challenge/posts	cid (numeric challenge ID), count, cursor	30 tagged videos/call with engagement & MP4 URLs	2 Credits / video
GET /v1/music/info	url (music ID or URL)	id, title, author, play (MP3), user_count, duration	10 Credits / call
GET /v1/music/posts	music_id, count, cursor	30 videos using the sound track per call	2 Credits / video
GET /v1/feed/list	region (US, GB, JP, DE...), count	Real-time regional trending videos	2 Credits / video

2. Python Script: Resolve Hashtag ID & Track Sound Velocity

The script below resolves a hashtag to its challenge ID, fetches the top tagged videos, and inspects the most frequently used audio track.

Track Hashtag Views, Tagged Videos & Sound Usage in Python & Node.js

Chains GET /v1/challenge/info -> GET /v1/challenge/posts -> GET /v1/music/info.

# 1. Get hashtag view count & challenge ID
curl -s "https://api.tiktokapi.io/v1/challenge/info?challenge_name=tiktokmademebuyit" \
  -H "x-api-key: tk_live_your_api_key" | jq '.data | {id, cha_name, view_count, user_count}'

# 2. Get sound usage velocity
curl -s "https://api.tiktokapi.io/v1/music/info?url=7231338505431288622" \
  -H "x-api-key: tk_live_your_api_key" | jq '.data | {id, title, author, user_count}'

Interactive Engineering Workbench · GET /v1/challenge/info

Verify real-time latency, pagination math & JSON schema

Videos scraped per day (2 Credits / video, up to 33/call)5,000 videos/day

Comments extracted per day (1 Credit / comment, up to 50/call)10,000 comments/day

Followers mapped per day (1 Credit / user, up to 200/call)20,000 followers/day

Our HTTP Calls/Day

452

Large page sizes

Legacy Provider Calls

1,334

30-item small pages

Official Research API

Within 1K Cap

1,000 req/day limit

Estimated Monthly Pipeline Cost (30 Days)

$72.73/ mo with Business bonus ($120.00 base rate)

Daily consumption: 40,000 Credits ($4.00/day)

TikTokAPI.io (with volume bonus):$72.73 / mo

Legacy Scrapers ($1.50 / 1K calls):$60.03 / mo

Failed / 404 request fee:$0.00 (0 Credits)

Start Free (500 Credits) →Full Rate Card

Frequently Asked Questions

Do I need the numeric challenge_id before calling /v1/challenge/posts?: Yes. Call GET /v1/challenge/info?challenge_name=yourhashtag once (10 Credits) to obtain data.id, then cache that numeric ID in your database and pass it as cid to GET /v1/challenge/posts for all future pagination.
Does /v1/music/info return a playable MP3 link for the audio track?: Yes. GET /v1/music/info returns data.play (direct MP3 audio stream), cover art, duration, artist metadata, and total video usage count (data.user_count).