Video Comments

GET/v1/tiktok/video/comments1 credit

Returns the comments on a TikTok video, 20 per page, with each comment's author, text, like count and reply count.

01Query parameters

Name	Type	Description
urlrequired	string	The video's URL (`tiktok.com/@user/video/<id>` or a short share link).
cursoroptional	integer	The `cursor` value of the previous page, to get the next one.
trimoptional	boolean	Accepted for compatibility; this endpoint always returns full comment objects.Default: `false`

02Request

curl "https://api.scrapesocial.ai/v1/tiktok/video/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7683195368279985438" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/tiktok/video/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7683195368279985438

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "alias_comment_deleted": false,
  "comments": [
    {
      "allow_download_photo": false,
      "author_pin": false,
      "aweme_id": "7683195368279985438",
      "cid": "7700502796314886913",
      "collect_stat": 0,
      "comment_language": "en",
      "comment_post_item_ids": null,
      "content_type": 1,
      "create_time": 1792913032,
      "digg_count": 0,
      "fold_status": -1,
      "image_list": null,
      "is_author_digged": false,
      "is_comment_translatable": true,
      "is_high_purchase_intent": true,
      "label_list": null,
      "no_show": false,
      "reply_comment": null,
      "reply_comment_total": 0,
      "reply_id": "0",
      "reply_to_reply_id": "0",
      "seeking_help_model_type": 0,
      "share_info": {
        "acl": {
          "add_to_story_code": 0,
          "code": 0,
          "extra": "{}"
        },
        "desc": "Dani Ⓜ’s comment: We Ethiopians have had thousands of over accounts suspendeds and more accounts continue to be suspende we urge tikto to conduct an urgent and transparent investigation in to this matter we also call on tiktok to address concerns about possible censorship and human rights violations while protecting cultural identity and freedom of expression",
        "title": "hear how @Palina La Diva 🌐 spinning tracks on LIVE brings techno lovers together 🪩",
        "url": "https://m.tiktok.com/v/7683195368279985438.html?_d=egbd5adc0ba79j&comment_author_id=7049800719280587777&preview_pb=0&share_comment_id=7700502796314886913&share_item_id=7683195368279985438&sharer_language=en&source=h5_m&u_code=0"
      },
      "sort_tags": "{\"cold_start\":1,\"fine_sort_cold_queue\":1,\"rough_sort_search_queue\":1,\"top_list\":1}",
      "status": 1,
      "stick_position": 0,
      "text": "We Ethiopians have had thousands of over accounts suspendeds and more accounts continue to be suspende we urge tikto to conduct an urgent and transparent investigation in to this matter we also call on tiktok to address concerns about possible censorship and human rights violations while protecting cultural identity and freedom of expression",
      "text_extra": [],
      "text_to_image_item_ids": null,
      "thread_has_more": false,
      "thread_id": 0,
      "trans_btn_style": 0,
      "translated_text_extra": null,
      "update_reason": "pass",
      "user": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "uri": "tos-alisg-avt-0068/231d63cdd3c70d40ed85b87891f3d4dd",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/231d63cdd3c70d40ed85b87891f3d4dd~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=b51c5bfc&x-expires=1793034000&x-signature=bUr%2Ft8y7DU%2FNbEoRZ3Gyras%2FrXk%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my2",
            "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/231d63cdd3c70d40ed85b87891f3d4dd~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=5cc3d23b&x-expires=1793034000&x-signature=Az%2FH7wGntBnCJNTcmlkqDORjcQs%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my2"
          ],
          "url_prefix": null
        },
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "cover_url": null,
        "custom_verify": "",
        "enterprise_verify_reason": "",
        "events": null,
        "followers_detail": null,
        "geofencing": null,
        "homepage_bottom_toast": null,
        "item_list": null,
        "mutual_relation_avatars": null,
        "need_points": null,
        "nickname": "Dani Ⓜ",
        "platform_sync_info": null,
        "predicted_age_group": "4",
        "relative_users": null,
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAArZCX6wG54pmOFX3daSesupDfXf6JzgyQYxIN8kf-VQTgJfEO48de-XmjO18UlTEG",
        "shield_edit_field_info": null,
        "type_label": null,
        "uid": "7049800719280587777",
        "unique_id": "daniemolla0",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      },
      "user_buried": false,
      "user_digged": 0
    },
    {
      "allow_download_photo": false,
      "author_pin": false,
      "aweme_id": "7683195368279985438",
      "cid": "7700103024308372276",
      "collect_stat": 0,
      "comment_language": "en",
      "comment_post_item_ids": null,
      "content_type": 1,
      "create_time": 1792819960,
      "digg_count": 0,
      "fold_status": -1,
      "image_list": null,
      "is_author_digged": false,
      "is_comment_translatable": true,
      "is_high_purchase_intent": false,
      "label_list": null,
      "no_show": false,
      "reply_comment": null,
      "reply_comment_total": 0,
      "reply_id": "0",
      "reply_to_reply_id": "0",
      "seeking_help_model_type": 0,
      "share_info": {
        "acl": {
          "add_to_story_code": 0,
          "code": 0,
          "extra": "{}"
        },
        "desc": "DJ Dillys |Personal🙂‍↕️🎈❤️’s comment: I really want to be like you some day",
        "title": "hear how @Palina La Diva 🌐 spinning tracks on LIVE brings techno lovers together 🪩",
        "url": "https://m.tiktok.com/v/7683195368279985438.html?_d=egbd5adc0ba79j&comment_author_id=7700092895851922438&preview_pb=0&share_comment_id=7700103024308372276&share_item_id=7683195368279985438&sharer_language=en&source=h5_m&u_code=0"
      },
      "sort_tags": "{\"cold_start\":1,\"fine_sort_cold_queue\":1,\"rough_sort_cold_queue\":1,\"top_list\":1}",
      "status": 1,
      "stick_position": 0,
      "text": "I really want to be like you some day",
      "text_extra": [],
      "text_to_image_item_ids": null,
      "thread_has_more": false,
      "thread_id": 0,
      "trans_btn_style": 0,
      "translated_text_extra": null,
      "update_reason": "pass",
      "user": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "uri": "tos-alisg-avt-0068/06ca177b606e8fef6815396ffd2a69de",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/06ca177b606e8fef6815396ffd2a69de~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=b83ac845&x-expires=1793034000&x-signature=yGZwo7jPzHeytPZTYOTQJcU3p6I%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my2",
            "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/06ca177b606e8fef6815396ffd2a69de~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=90a81979&x-expires=1793034000&x-signature=xbUjWqrARXcmeByfRA4En5bHzpw%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my2"
          ],
          "url_prefix": null
        },
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "cover_url": null,
        "custom_verify": "",
        "enterprise_verify_reason": "",
        "events": null,
        "followers_detail": null,
        "geofencing": null,
        "homepage_bottom_toast": null,
        "item_list": null,
        "mutual_relation_avatars": null,
        "need_points": null,
        "nickname": "DJ Dillys |Personal🙂‍↕️🎈❤️",
        "platform_sync_info": null,
        "predicted_age_group": "",
        "relative_users": null,
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAAGptCAFoq-3THfU0sUkFxTKXlXmo_awwFIbTCze6SIq3on3D5OXefuckiB8JvR4wF",
        "shield_edit_field_info": null,
        "type_label": null,
        "uid": "7700092895851922438",
        "unique_id": "djdillysss",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      },
      "user_buried": false,
      "user_digged": 0
    }
  ],
  "cursor": 20,
  "extra": {
    "api_debug_info": null,
    "fatal_item_ids": null,
    "now": 1792948130000
  },
  "has_filtered_comments": 0,
  "has_more": 1,
  "log_pb": {
    "impr_id": "2026102601085036C1497B513A3C34086F"
  },
  "reply_style": 2,
  "status_code": 0,
  "status_msg": "",
  "top_gifts": null,
  "total": 3633
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Comments are in `comments`; `total` is the video's comment count. To page, send the response's `cursor` back as `cursor` (20, 40, ...); stop when `has_more` is 0. Use a comment's `cid` with the Comment Replies endpoint. A page with no comments, including for an unknown video, is an empty list for 0 credits.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.