TikTok Post API

Post detail API for videos and slideshows

Extract TikTok post data for videos and slideshows including media, engagement, hashtags, author and music metadata. Accepts a public TikTok post URL or numeric video ID and supports paginated feed crawling.

Try It Free View Docs
1 CreditCost
Video + ImagePost Types
CursorPagination

Quick Start

Get started with a simple API call.

const response = await fetch('https://api.crawlkit.sh/v1/crawl/tiktok/post', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://www.tiktok.com/@nike/video/7364512345678901234',
    options: {
      timeout: 30000
    }
  })
});

const { data } = await response.json();
console.log(data.post.id, data.post.stats.plays);

Key Features

Everything you need for reliable tiktok post workflows.

Post Detail Extraction

Scrape one TikTok post by URL or numeric video ID with description, media type, ad flag, and timestamps.

Engagement Metrics

Get plays, likes, comments, shares, saves, and reposts for performance analytics.

Media Payload

Returns video properties and image arrays depending on post type (video or slideshow).

Author + Music Data

Includes author identity and soundtrack metadata (title, author, album, duration).

Feed Pagination

Use /v1/crawl/tiktok/posts with cursor + secUid to crawl profile content page by page.

Proxy Playback

Use signed media URLs when you need to stream or download post assets server-side.

How It Works

Get started in minutes with our simple API.

1

Get Your API Key

Sign up for free and get your API key instantly. No credit card required.

2

Make Your First Request

Use our simple REST API with your favorite programming language.

3

Get Structured Data

Receive clean JSON responses ready to use in your application.

API Response

Get clean, structured JSON data with every request. Our API returns comprehensive data including status codes, timing information, and your remaining credits.

  • Consistent JSON structure
  • Detailed timing metrics
  • Credit usage tracking
  • Error handling built-in
Response
{
  "success": true,
  "data": {
    "post": {
      "id": "7364512345678901234",
      "postUrl": "https://www.tiktok.com/@nike/video/7364512345678901234",
      "description": "New drop. #nike #justdoit",
      "createdAt": "2025-01-12T19:24:00Z",
      "mediaType": "video",
      "author": {
        "id": "6770059218303183878",
        "username": "nike",
        "nickname": "Nike",
        "avatar": "https://p16-sign-va.tiktokcdn.com/...",
        "verified": true
      },
      "music": {
        "title": "original sound",
        "author": "nike",
        "album": null,
        "duration": 14,
        "coverUrl": "https://p16-sign.tiktokcdn.com/..."
      },
      "video": {
        "duration": 14,
        "url": "https://v16m-default.tiktokcdn.com/...",
        "coverUrl": "https://p16-sign.tiktokcdn.com/...",
        "width": 1080,
        "height": 1920
      },
      "images": [],
      "stats": {
        "plays": 1289000,
        "likes": 245000,
        "comments": 3200,
        "shares": 4100,
        "saves": 5600,
        "reposts": 740
      },
      "hashtags": [
        { "id": "16567153", "title": "nike" },
        { "id": "9238742", "title": "justdoit" }
      ],
      "locationCreated": "US",
      "isAd": false
    },
    "timing": { "total": 1900 },
    "creditsUsed": 1,
    "creditsRemaining": 98
  }
}

Use Cases

Common applications for TikTok Post.

Viral Content Analysis

Track format, hashtags, and engagement patterns across creators.

Trend Monitoring

Continuously ingest new posts from target profiles with cursor pagination.

Creative Intelligence

Benchmark hooks, sounds, and posting styles by vertical.

Attribution Pipelines

Store normalized post-level metrics for BI and campaign reporting.

Frequently Asked Questions

Everything you need to know about the TikTok Post API.

Use canonical TikTok post URLs such as /@username/video/{id}, or send the numeric video ID directly. The endpoint accepts public video and slideshow posts.

Use /v1/crawl/tiktok/posts with username and cursor. Pass secUid from the response to paginate faster and more reliably.

Yes. mediaType identifies video or image, and the payload returns the corresponding video or images fields.

TikTok Post uses 1 credit per request.

Start Using TikTok Post API Today

Get 100 free credits to test the API. No credit card required.

Get Started Free View Pricing