scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTProduct
  • POSTProduct Reviews
  • POSTUser Profile
  • POSTVideo Post
  • POSTVideo Search

TikTok Video Post

1 credit

Get a TikTok video with its comments.

POST/api/v1/tools/tiktok/video/post

Parameters

urlstringrequired

TikTok video URL.

maxCommentsnumber

Maximum number of comments. Defaults to 200.

numberOfPagesnumber

Number of comment pages to fetch.

fieldsstring[]

Fields per comment. Available: cid, text, createTime, likeCount, replyCount, replyToCommentId, replyToReplyId, language, author, isAuthorLiked. Use ["*"] for all.

Response Schema

dataobject

TikTok video post result

videoobject

Video information.

commentsobject[]

Array of comment objects.

countnumber

Number of comments returned

metaobject

Request metadata

toolstring

Tool name (tiktok-video-post)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/tiktok/video/post \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@tiktok/video/7340001234567890001",
    "maxComments": 50
  }'

Response Example

{
  "data": {
    "video": {
      "id": "7340001234567890001",
      "desc": "Check out this amazing recipe! #cooking #foodtok",
      "createTime": 1713945600,
      "author": {
        "uniqueId": "tiktok",
        "nickname": "TikTok"
      },
      "stats": {
        "diggCount": 245000,
        "shareCount": 12300,
        "commentCount": 8450,
        "playCount": 5200000
      }
    },
    "comments": [
      {
        "cid": "7340100000000000001",
        "text": "This looks delicious!",
        "createTime": 1713946200,
        "likeCount": 1523,
        "replyCount": 12,
        "author": {
          "uniqueId": "foodlover",
          "nickname": "Food Lover"
        }
      },
      {
        "cid": "7340100000000000002",
        "text": "Saving this for later",
        "createTime": 1713947800,
        "likeCount": 342,
        "replyCount": 3,
        "author": {
          "uniqueId": "chefmike",
          "nickname": "Chef Mike"
        }
      }
    ],
    "count": 2
  },
  "meta": {
    "tool": "tiktok-video-post",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}