Tiktok

TikTok: users, posts, comments, hashtags, and search.

Get a user by handle

get

Returns a TikTok user profile by handle (without @).

Cost: 50 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

usernamestring · min: 1 · max: 100RequiredExample: tiktok

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/tiktok/user/handle/{username}

GET /tiktok/user/handle/{username} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "107955",
      "username": "tiktok",
      "nickname": "TikTok",
      "url": "https://www.tiktok.com/@tiktok",
      "bio": "One TikTok can make a big impact",
      "bioUrl": "https://linktr.ee/tiktok",
      "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/avatar.jpg",
      "verified": true,
      "profileCategory": "",
      "followers": 89000000,
      "following": 7,
      "likes": 1300000000,
      "videos": 1100
    }
  ],
  "pricing": {
    "creditsCharged": 51
  }
}

Get posts published by a user

get

Returns posts published by a TikTok user. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive). region may bias results toward a specific country (e.g. US).

Cost: 60 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 107955

Query parameters

regionstring · min: 2 · max: 5Optional

maxItemsinteger · min: 1 · max: 200Optional

cursorstringOptional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/tiktok/user/{id}/posts

GET /tiktok/user/{id}/posts HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "7636131611674692894",
      "title": "Check this out!",
      "postPage": "https://www.tiktok.com/@tiktok/video/7636131611674692894",
      "uploadedAt": 1714560000,
      "uploadedAtFormatted": "2024-05-01T00:00:00Z",
      "views": 750000,
      "likes": 12500,
      "comments": 793,
      "shares": 1250,
      "bookmarks": 320,
      "poi": {},
      "channel": {
        "id": "107955",
        "username": "tiktok",
        "name": "TikTok",
        "bio": "One TikTok can make a big impact",
        "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/avatar.jpg"
      },
      "collabInfo": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "song": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "hashtags": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "subtitleInformation": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "creditsCharged": 61
  }
}

Get a post by ID

get

Returns a single TikTok post by its numeric ID.

Cost: 60 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 50RequiredExample: 7636131611674692894

Query parameters

regionstring · min: 2 · max: 5Optional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/tiktok/post/{id}

GET /tiktok/post/{id} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "7636131611674692894",
      "title": "Check this out!",
      "postPage": "https://www.tiktok.com/@tiktok/video/7636131611674692894",
      "uploadedAt": 1714560000,
      "uploadedAtFormatted": "2024-05-01T00:00:00Z",
      "views": 750000,
      "likes": 12500,
      "comments": 793,
      "shares": 1250,
      "bookmarks": 320,
      "poi": {},
      "channel": {
        "id": "107955",
        "username": "tiktok",
        "name": "TikTok",
        "bio": "One TikTok can make a big impact",
        "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/avatar.jpg"
      },
      "collabInfo": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "song": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "hashtags": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "subtitleInformation": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pricing": {
    "creditsCharged": 61
  }
}

Get comments on a post

get

Returns comments on a TikTok post. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Cost: 30 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 7636131611674692894

Query parameters

maxItemsinteger · min: 1 · max: 500Optional

cursorstringOptional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/tiktok/post/{id}/comments

GET /tiktok/post/{id}/comments HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "7636187917325304607",
      "parentId": "7636187917325304606",
      "awemeId": "7636131611674692894",
      "text": "Love this!",
      "createdAt": "2026-05-05T19:46:32.000Z",
      "likeCount": 25,
      "replyCount": 3,
      "commentLanguage": "en",
      "isAuthorLiked": false,
      "user": {
        "id": "12345",
        "username": "someuser",
        "nickname": "Some User",
        "avatar": "text",
        "verified": false,
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "creditsCharged": 31
  }
}

Get replies to a comment

get

Returns replies to a specific TikTok comment. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Cost: 30 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 7636131611674692894

commentIdstring · min: 1 · max: 100RequiredExample: 7636187917325304607

Query parameters

maxItemsinteger · min: 1 · max: 500Optional

cursorstringOptional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/tiktok/post/{id}/comments/{commentId}/replies

GET /tiktok/post/{id}/comments/{commentId}/replies HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "7636187917325304607",
      "parentId": "7636187917325304606",
      "awemeId": "7636131611674692894",
      "text": "Love this!",
      "createdAt": "2026-05-05T19:46:32.000Z",
      "likeCount": 25,
      "replyCount": 3,
      "commentLanguage": "en",
      "isAuthorLiked": false,
      "user": {
        "id": "12345",
        "username": "someuser",
        "nickname": "Some User",
        "avatar": "text",
        "verified": false,
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "creditsCharged": 31
  }
}

Search TikTok posts

get

Search TikTok posts by keyword. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Cost: 60 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

keywordstring · min: 1 · max: 100RequiredExample: recipe

regionstring · min: 2 · max: 5Optional

dateRangestringOptional

sortTypestringOptional

maxItemsinteger · min: 1 · max: 200Optional

cursorstringOptional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/tiktok/post/search

GET /tiktok/post/search?keyword=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "7636131611674692894",
      "title": "Check this out!",
      "postPage": "https://www.tiktok.com/@tiktok/video/7636131611674692894",
      "uploadedAt": 1714560000,
      "uploadedAtFormatted": "2024-05-01T00:00:00Z",
      "views": 750000,
      "likes": 12500,
      "comments": 793,
      "shares": 1250,
      "bookmarks": 320,
      "poi": {},
      "channel": {
        "id": "107955",
        "username": "tiktok",
        "name": "TikTok",
        "bio": "One TikTok can make a big impact",
        "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/avatar.jpg"
      },
      "collabInfo": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "song": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "hashtags": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "subtitleInformation": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "creditsCharged": 61
  }
}

Get a post by URL

get

Returns a single TikTok post by its full URL.

Cost: 30 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

urlstring · uri · min: 1 · max: 2048RequiredExample: https://www.tiktok.com/@tiktok/video/7636131611674692894

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/tiktok/post

GET /tiktok/post?url=https%3A%2F%2Fexample.com HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "7636131611674692894",
      "title": "Check this out!",
      "postPage": "https://www.tiktok.com/@tiktok/video/7636131611674692894",
      "uploadedAt": 1714560000,
      "uploadedAtFormatted": "2024-05-01T00:00:00Z",
      "views": 750000,
      "likes": 12500,
      "comments": 793,
      "shares": 1250,
      "bookmarks": 320,
      "poi": {},
      "channel": {
        "id": "107955",
        "username": "tiktok",
        "name": "TikTok",
        "bio": "One TikTok can make a big impact",
        "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/avatar.jpg"
      },
      "collabInfo": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "song": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "hashtags": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "subtitleInformation": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pricing": {
    "creditsCharged": 31
  }
}

Get a hashtag by name

get

Returns a TikTok hashtag profile by name (without #).

Cost: 60 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

namestring · min: 1 · max: 100RequiredExample: fyp

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/tiktok/hashtag/handle/{name}

GET /tiktok/hashtag/handle/{name} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "12345",
      "name": "fyp",
      "views": 1234567890
    }
  ],
  "pricing": {
    "creditsCharged": 61
  }
}