Skip to main content
GET
/
api
/
v1
/
challenges
/
{challengeId}
/
posts
Get posts for a hashtag challenge
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/challenges/{challengeId}/posts \
  --header 'x-rapidapi-key: <api-key>'
{
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2025-03-12T14:32:01.498Z",
    "cached": false,
    "version": "2025-01"
  },
  "data": [
    {
      "post_id": "7351234567890123456",
      "caption": "do this for a week and see what happens #fitness",
      "created_at": 1711929600,
      "is_ad": false,
      "plays": 42000000,
      "likes": 3100000,
      "comments": 18000,
      "shares": 92000,
      "saves": 410000,
      "reposts": 5200,
      "cover_url": "https://p16-sign.tiktokcdn-us.com/...",
      "share_url": "https://www.tiktok.com/@charlidamelio/video/7351234567890123456",
      "sound_id": "7016547803243022337",
      "sound_title": "original sound",
      "sound_author": "charlidamelio",
      "sound_is_original": true,
      "hashtags": [
        {
          "id": "229207",
          "name": "fitness"
        }
      ],
      "author_username": "charlidamelio",
      "author_display_name": "charli d'amelio",
      "author_verified": true,
      "author_avatar_url": "https://p16-sign.tiktokcdn-us.com/...",
      "duration_seconds": 27,
      "video_height": 1024,
      "video_width": 576
    }
  ],
  "pagination": {
    "cursor": "1778971238000",
    "has_more": true
  },
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns a paginated list of TikTok videos associated with the specified hashtag challenge. Challenge IDs are numeric — to find a challenge ID for a hashtag, search TikTok and extract the ID from the URL.

Authorizations

x-rapidapi-key
string
header
required

Your RapidAPI subscription key. Injected automatically by the RapidAPI gateway in production.

Path Parameters

challengeId
string<int64>
required

Numeric TikTok challenge/hashtag ID

Pattern: ^\d+$

Query Parameters

count
integer
default:20

Number of posts to return (1–50)

Required range: 1 <= x <= 50
cursor
string

Opaque pagination cursor returned by a previous response. Do not interpret or compute this value — pass it back exactly as received. Omit (or pass cursor=0) to start from the beginning. The numeric value has no relationship to the number of items requested or returned.

Response

Success

meta
object

Response metadata present in every API response

data
object[]
pagination
object

Cursor-based pagination info

error
object

Error details. Present only when the request failed; null on success.