TIKTOK API

Comments

Retrieve comments from TikTok with a single API request.

GET/api/data/v1/tiktok/video/comments
1credit base cost

Request parameters

Up to 1 credit

TikTok video URL

Cursor to get more comments. Get 'cursor' from previous response.

Set to true to get a trimmed response

Try in the console

Live requests use your prepaid balance. Cached responses cost zero where supported.

curl --request GET \
  --url 'https://fetchgoblin.com/api/data/v1/tiktok/video/comments' \
  --header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'

Response

Example
{
  "success": true,
  "credits_charged": 1,
  "comments": [
    {
      "aweme_id": "7517114944362499342",
      "text": "DAVE BUY A TEAM",
      "user": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "uri": "tos-useast5-avt-0068-tx/446370164449562d1008889225530f6d",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/446370164449562d1008889225530f6d~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=662e5e49&x-expires=1750374000&x-signature=a6DJxD8%2BkNeZRm7Sfpjc55T8mhE%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5"
          ],
          "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": "Robert Lessner",
        "platform_sync_info": null,
        "relative_users": null,
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAA9rB4k_Ei3NexA5p2lb8naaa4LTgNCOdY0W9NHVo63016XkdsuZgvjkgolBnUkG8W",
        "shield_edit_field_info": null,
        "type_label": null,
        "uid": "6958917445306926086",
        "unique_id": "dimebag.duster",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      },
      "create_time": 1750216932,
      "reply_comment_total": 14,
      "digg_count": 3322,
      "comment_language": "en"
    }
  ],
  "cursor": 20,
  "total": 1114
}
Example data from the API specification. Run a request to retrieve current data.

Response shape

This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.

View JSON Schema +
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "credits_remaining": {
      "type": "integer"
    },
    "credits_charged": {
      "type": "integer"
    },
    "comments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "aweme_id": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "user": {
            "type": "object",
            "properties": {
              "account_labels": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "ad_cover_url": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "advance_feature_item_order": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "advanced_feature_info": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "avatar_thumb": {
                "type": "object",
                "properties": {
                  "uri": {
                    "type": "string"
                  },
                  "url_list": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "url_prefix": {
                    "type": [
                      "string",
                      "object",
                      "array",
                      "number",
                      "boolean",
                      "null"
                    ]
                  }
                }
              },
              "bold_fields": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "can_message_follow_status_list": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "can_set_geofencing": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "cha_list": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "cover_url": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "custom_verify": {
                "type": "string"
              },
              "enterprise_verify_reason": {
                "type": "string"
              },
              "events": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "followers_detail": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "geofencing": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "homepage_bottom_toast": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "item_list": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "mutual_relation_avatars": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "need_points": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "nickname": {
                "type": "string"
              },
              "platform_sync_info": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "relative_users": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "search_highlight": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "sec_uid": {
                "type": "string"
              },
              "shield_edit_field_info": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "type_label": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "uid": {
                "type": "string"
              },
              "unique_id": {
                "type": "string"
              },
              "user_profile_guide": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "user_tags": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "white_cover_url": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              }
            }
          },
          "create_time": {
            "type": "integer"
          },
          "reply_comment_total": {
            "type": "integer"
          },
          "digg_count": {
            "type": "integer"
          },
          "comment_language": {
            "type": "string"
          }
        }
      }
    },
    "cursor": {
      "type": "integer"
    },
    "total": {
      "type": "integer"
    }
  }
}