TikTok Search

Retrieve TikTok Post by ID

Retrieve normalized metadata for a public TikTok post by ID. This endpoint does not expose no-watermark/download-only media URLs.

Billing metadata: successful billable responses include the X-Desearch-Cost-Usd, X-Desearch-Usage-Count, X-Desearch-Service, and X-Desearch-Currency headers. JSON object responses also include optional cost_usd, usage_count, service, and currency fields. For example, usage_count=10 at $0.015 / 1,000 resolves to cost_usd=0.00015. JSON arrays, text, and streaming responses keep their body shape and expose billing metadata only through headers.

get/desearch/tiktok/post/{id}

Request

  • Base URL: https://api.desearch.ai
  • URL: https://api.desearch.ai/desearch/tiktok/post/{id}
  • Auth: API key in header Authorization

Path parameters

idstring required

TikTok video/post ID

Response

A normalized TikTok post object.

OR
object required

Example response

{
  "id": "7620891413932166433",
  "url": "https://www.tiktok.com/@tiktok/video/7620891413932166433",
  "text": "caption text",
  "createTime": "2024-01-15T10:30:00Z",
  "author": {
    "id": "12345",
    "username": "desearch",
    "nickname": "Desearch",
    "avatar": "https://example.com/avatar.jpg",
    "verified": true,
    "following": 1200,
    "followers": 50000,
    "heart": 300000
  },
  "stats": {
    "playCount": 120000,
    "digCount": 5000,
    "commentCount": 120,
    "shareCount": 45,
    "collectCount": 10
  },
  "music": {
    "id": "67890",
    "title": "Song Name",
    "authorName": "Artist"
  },
  "videoDuration": 15000,
  "videoWidth": 1080,
  "videoHeight": 1920,
  "thumbnailUrl": "https://example.com/thumb.jpg",
  "mediaUrl": "https://example.com/video.mp4"
}

Changes

No recorded changes to this operation across all 1 revision of this API.