Skip to main content
GET
/
api
/
v1
/
posts
Get post detail by video ID or URL
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/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": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns full metadata for a single TikTok video. Supply either videoId (the numeric ID) or url (a full TikTok share URL) — exactly one is required.

Authorizations

x-rapidapi-key
string
header
required

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

Query Parameters

videoId
string<int64>

Numeric TikTok video ID. Required if url is not provided.

Pattern: ^\d+$
url
string<uri>

Full TikTok video share URL (must contain /video/{id}). Required if videoId is not provided.

Response

Success

meta
object

Response metadata present in every API response

data
object

A normalized TikTok video post

pagination
object

Always null; this endpoint returns a single object and does not paginate.

Example:

null

error
object

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