# TikTok API Reference Canonical: https://monsterapi.co/docs/api/tiktok Read the TikTok API reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [TikTok](https://monsterapi.co/docs/openapi/platforms/tiktok.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # TikTok: Hashtag posts `GET /tiktok/api/mobile/challenge/item_list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publications-by-ch-id Operation ID: `tiktok_mobile_challenge_items` Returns publications for ch_id. Topic metadata may be absent on some records. Continue with next_cursor and the same ch_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `ch_id` (query, required): Required decimal (1 to 32 digits) topic identifier. Use `data.aweme_list[].cha_list[].cid` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `count` (query, optional): Page-size hint from 1 to 200; defaults to 10. Returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/challenge/item_list](https://monsterapi.co/docs/api/tiktok-topics#tiktok-publications-by-ch-id). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/challenge/item_list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Video comments `GET /tiktok/api/mobile/comment/list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publication-comments Operation ID: `tiktok_mobile_comments` Returns comments for aweme_id. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `aweme_id` (query, required): Required decimal (1 to 32 digits) publication identifier. Use `named.posts[].id` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/comment/list](https://monsterapi.co/docs/api/tiktok-comments#tiktok-publication-comments). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/comment/list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Comment replies `GET /tiktok/api/mobile/comment/reply/list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-comment-replies Operation ID: `tiktok_mobile_comment_replies` Returns replies for item_id and comment_id. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `item_id` (query, required): Required decimal (1 to 32 digits) publication identifier. Use `named.posts[].id` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `comment_id` (query, required): Required decimal (1 to 32 digits) parent comment identifier. Use `named.comments[].id` from [GET /mobile/comment/list](https://monsterapi.co/docs/api/tiktok-comments#tiktok-publication-comments). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/comment/reply/list](https://monsterapi.co/docs/api/tiktok-comments#tiktok-comment-replies). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/comment/reply/list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Video context `GET /tiktok/api/mobile/context/feed` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publication-context Operation ID: `tiktok_mobile_context_feed` Returns a page of publications using aweme_id as context. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `aweme_id` (query, required): Required decimal (1 to 32 digits) publication identifier used to select related publications. Use `named.posts[].id` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/context/feed' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Recommendations `GET /tiktok/api/mobile/feed` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-recommendations Operation ID: `tiktok_mobile_feed` Returns recommended publications. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/feed' \ -H 'Authorization: Bearer ' ``` --- # TikTok: For You publications `GET /tiktok/api/mobile/full/feed` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-for-you-publications Operation ID: `tiktok_mobile_full_feed` Returns a For You page without a publication subject. Use next_cursor for the next page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `count` (query, optional): Page-size hint from 1 to 200; defaults to 1. Returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/full/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-for-you-publications). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent. Empty feed pages return 503 and do not end the feed. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/full/feed' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Posts for a sound `GET /tiktok/api/mobile/music/item_list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publications-by-music-id Operation ID: `tiktok_mobile_music_items` Returns publications for music_id. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `music_id` (query, required): Required decimal (1 to 32 digits) music identifier. Use `named.posts[].music.id` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/music/item_list](https://monsterapi.co/docs/api/tiktok-music#tiktok-publications-by-music-id). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/music/item_list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Account posts `GET /tiktok/api/mobile/post/item_list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publications-by-sec-user-id Operation ID: `tiktok_mobile_posts` Returns publications by sec_user_id in new or popular order. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `sec_user_id` (query, required): Required secure user identifier of 1 to 256 ASCII letters, digits, underscores, hyphens or dots. Use `named.posts[].author.sec_uid` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `sort` (query, optional): New or popular ordering; defaults to new. - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/post/item_list](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publications-by-sec-user-id). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/post/item_list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Posts around a video `GET /tiktok/api/mobile/public/item/locate` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publications-around-an-item Operation ID: `tiktok_mobile_locate` Returns publications around locate_item_id using both author identifiers. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Required decimal (1 to 32 digits) author identifier for the same account as sec_user_id. Use `named.posts[].author.id` from [GET /mobile/post/item_list](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publications-by-sec-user-id). - `sec_user_id` (query, required): Required secure author identifier for the same account as user_id; 1 to 256 ASCII letters, digits, underscores, hyphens or dots. Use `named.posts[].author.sec_uid` from [GET /mobile/post/item_list](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publications-by-sec-user-id). - `locate_item_id` (query, required): Required decimal (1 to 32 digits) publication identifier around which to return publications. Use `named.posts[].id` from [GET /mobile/post/item_list](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publications-by-sec-user-id). - `locate_item_score` (query, optional): Optional signed 64-bit publication score; omit when unavailable. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/public/item/locate' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Followers `GET /tiktok/api/mobile/relation/follower/list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-followers Operation ID: `tiktok_mobile_followers` Returns followers using both user_id and sec_user_id for the same account. Records may repeat across pages. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Required decimal (1 to 32 digits) user identifier for the same account as sec_user_id. Use `named.posts[].author.id` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `sec_user_id` (query, required): Required secure user identifier for the same account as user_id; 1 to 256 ASCII letters, digits, underscores, hyphens or dots. Use `named.posts[].author.sec_uid` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/relation/follower/list](https://monsterapi.co/docs/api/tiktok-users#tiktok-followers). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/relation/follower/list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Following `GET /tiktok/api/mobile/relation/following/list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-following Operation ID: `tiktok_mobile_following` Returns accounts followed by a user using both user_id and sec_user_id for that user. Records may repeat across pages. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Required decimal (1 to 32 digits) user identifier for the same account as sec_user_id. Use `named.posts[].author.id` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `sec_user_id` (query, required): Required secure user identifier for the same account as user_id; 1 to 256 ASCII letters, digits, underscores, hyphens or dots. Use `named.posts[].author.sec_uid` from [GET /mobile/feed](https://monsterapi.co/docs/api/tiktok-publications#tiktok-recommendations). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /mobile/relation/following/list](https://monsterapi.co/docs/api/tiktok-users#tiktok-following). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/mobile/relation/following/list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Topic details `GET /tiktok/api/web/challenge/detail` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-topic-details Operation ID: `tiktok_web_challenge_detail` Returns topic details using exactly one of challengeId or challengeName. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `challengeName` (query, optional): Topic name of 1 to 256 characters; exactly one of challengeName or challengeId is required. - `challengeId` (query, optional): Decimal topic identifier; exactly one of challengeId or challengeName is required. Use `named.challenge.id` from [GET /web/challenge/detail](https://monsterapi.co/docs/api/tiktok-topics#tiktok-topic-details). ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/challenge/detail' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Hashtag posts `GET /tiktok/api/web/challenge/item_list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-topic-publications Operation ID: `tiktok_web_challenge_items` Returns publications for challengeID. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `challengeID` (query, required): Required decimal (1 to 32 digits) topic identifier. Use `named.challenge.id` from [GET /web/challenge/detail](https://monsterapi.co/docs/api/tiktok-topics#tiktok-topic-details). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/challenge/item_list](https://monsterapi.co/docs/api/tiktok-topics#tiktok-topic-publications). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/challenge/item_list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Video comments `GET /tiktok/api/web/comment/list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publication-comments-2 Operation ID: `tiktok_web_comments` Returns comments for aweme_id. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `aweme_id` (query, required): Required decimal (1 to 32 digits) publication identifier. Use `named.posts[].id` from [GET /web/item/detail](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publication-details). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/comment/list](https://monsterapi.co/docs/api/tiktok-comments#tiktok-publication-comments-2). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/comment/list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Comment replies `GET /tiktok/api/web/comment/reply/list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-comment-replies-2 Operation ID: `tiktok_web_comment_replies` Returns replies for item_id and comment_id. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `item_id` (query, required): Required decimal (1 to 32 digits) publication identifier. Use `named.posts[].id` from [GET /web/item/detail](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publication-details). - `comment_id` (query, required): Required decimal (1 to 32 digits) parent comment identifier. Use `named.comments[].id` from [GET /web/comment/list](https://monsterapi.co/docs/api/tiktok-comments#tiktok-publication-comments-2). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/comment/reply/list](https://monsterapi.co/docs/api/tiktok-comments#tiktok-comment-replies-2). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/comment/reply/list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Video details `GET /tiktok/api/web/item/detail` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publication-details Operation ID: `tiktok_web_item_detail` Returns publication details for itemId. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `itemId` (query, required): Required decimal (1 to 32 digits) publication identifier. Use `named.posts[].id` from [GET /web/post/item_list](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publications-by-secuid). ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/item/detail' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Music details `GET /tiktok/api/web/music/detail` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-music-details Operation ID: `tiktok_web_music_detail` Returns music details for musicId. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `musicId` (query, required): Required decimal (1 to 32 digits) music identifier. Use `named.posts[].music.id` from [GET /web/post/item_list](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publications-by-secuid). ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/music/detail' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Posts for a sound `GET /tiktok/api/web/music/item_list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publications-by-musicid Operation ID: `tiktok_web_music_items` Returns publications for musicID. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `musicID` (query, required): Required decimal (1 to 32 digits) music identifier. Use `named.music.id` from [GET /web/music/detail](https://monsterapi.co/docs/api/tiktok-music#tiktok-music-details). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/music/item_list](https://monsterapi.co/docs/api/tiktok-music#tiktok-publications-by-musicid). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/music/item_list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Page information `GET /tiktok/api/web/page/html` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-page-information Operation ID: `tiktok_web_page` Returns a page title, canonical URL, metadata and additional public information for an HTTPS TikTok page URL. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Required HTTPS page URL at `tiktok.com`, `www.tiktok.com` or `m.tiktok.com`, up to 2048 UTF-8 bytes; no credentials, nondefault port or fragment. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/page/html' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Account posts `GET /tiktok/api/web/post/item_list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-publications-by-secuid Operation ID: `tiktok_web_post_items` Returns publications by secUid in new or popular order. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `secUid` (query, required): Required secure user identifier of 1 to 256 ASCII letters, digits, underscores, hyphens or dots. Use `named.user.sec_uid` from [GET /web/user/detail](https://monsterapi.co/docs/api/tiktok-users#tiktok-user-profile). - `sort` (query, optional): New or popular ordering; defaults to new. - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/post/item_list](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publications-by-secuid). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/post/item_list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Recommendations `GET /tiktok/api/web/recommend/item_list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-recommendations-2 Operation ID: `tiktok_web_recommendations` Returns recommended publications. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/recommend/item_list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: General search `GET /tiktok/api/web/search/general/full` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-general-search Operation ID: `tiktok_web_search_general` Returns public objects matching keyword. Continue with next_cursor and the same keyword. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `keyword` (query, required): Required search text of 1 to 256 characters. - `count` (query, optional): Advisory page size from 1 to 200. The result can contain fewer or more records. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/search/general/full](https://monsterapi.co/docs/api/tiktok-search#tiktok-general-search). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/search/general/full' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Search suggestions `GET /tiktok/api/web/search/general/preview` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-search-suggestions Operation ID: `tiktok_web_search_preview` Returns search suggestions for keyword. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `keyword` (query, required): Required search text of 1 to 256 characters. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/search/general/preview' \ -H 'Authorization: Bearer ' ``` --- # TikTok: User search `GET /tiktok/api/web/search/user/full` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-user-search Operation ID: `tiktok_web_search_users` Returns users matching keyword. Continue with next_cursor and the same keyword. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `keyword` (query, required): Required search text of 1 to 256 characters. - `count` (query, optional): Advisory page size from 1 to 200. The result can contain fewer or more records. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/search/user/full](https://monsterapi.co/docs/api/tiktok-search#tiktok-user-search). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/search/user/full' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Author stories `GET /tiktok/api/web/story/item_list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-author-stories Operation ID: `tiktok_web_stories` Returns stories for authorId. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `authorId` (query, required): Required decimal (1 to 32 digits) author identifier. Use `named.user.id` from [GET /web/user/detail](https://monsterapi.co/docs/api/tiktok-users#tiktok-user-profile). - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/story/item_list](https://monsterapi.co/docs/api/tiktok-publications#tiktok-author-stories). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/story/item_list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: User profile `GET /tiktok/api/web/user/detail` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-user-profile Operation ID: `tiktok_web_user_detail` Returns a user profile using at least one of uniqueId, secUid or userId. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `uniqueId` (query, optional): Account handle of 1 to 64 ASCII letters, digits, underscores, hyphens or dots, without @; at least one subject key is required. - `secUid` (query, optional): Secure user identifier of 1 to 256 ASCII letters, digits, underscores, hyphens or dots; optional with another subject key. Use `named.user.sec_uid` from [GET /web/user/detail](https://monsterapi.co/docs/api/tiktok-users#tiktok-user-profile). - `userId` (query, optional): Decimal user identifier; optional with another subject key. Use `named.user.id` from [GET /web/user/detail](https://monsterapi.co/docs/api/tiktok-users#tiktok-user-profile). ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/user/detail' \ -H 'Authorization: Bearer ' ``` --- # TikTok: User relations `GET /tiktok/api/web/user/list` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-user-relations Operation ID: `tiktok_web_users` Returns followers or following for secUid and relation. Count is a page-size hint. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `secUid` (query, required): Required secure user identifier of 1 to 256 ASCII letters, digits, underscores, hyphens or dots. Use `named.user.sec_uid` from [GET /web/user/detail](https://monsterapi.co/docs/api/tiktok-users#tiktok-user-profile). - `relation` (query, optional): Followers or following relation; defaults to followers. - `count` (query, optional): Page-size hint from 1 to 200; returned size may differ. - `cursor` (query, optional): Optional continuation token from next_cursor of [GET /web/user/list](https://monsterapi.co/docs/api/tiktok-users#tiktok-user-relations). Pass it unchanged as cursor to this same GET path with the same filters; omit on the first page. ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/user/list' \ -H 'Authorization: Bearer ' ``` --- # TikTok: Media bytes and metadata `GET /tiktok/api/web/video/cdn` Documentation: https://monsterapi.co/docs/api/tiktok#tiktok-media-bytes-and-metadata Operation ID: `tiktok_web_cdn` Returns up to 1024 media bytes beginning at byte 0, plus metadata, for an HTTPS TikTok media URL. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Required HTTPS media URL at the exact host `v16-webapp-prime.tiktok.com`, `v16-webapp-prime.us.tiktok.com`, or one of these hosts or a subdomain: `tiktokcdn.com`, `tiktokcdn-us.com`, `tiktokcdn-eu.com`, `byteoversea.com`, `ibytedtos.com`, `ibyteimg.com`, `tiktokv.com`, `tiktokv.us`. Limit: 2048 UTF-8 bytes; no credentials, nondefault port or fragment. The returned media URL must satisfy these host restrictions. Use `named.posts[].media_url` from [GET /web/item/detail](https://monsterapi.co/docs/api/tiktok-publications#tiktok-publication-details). ## Responses - 200: Public TikTok data - 400: Invalid subject, query value or cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Resource is private or unavailable Refused at the gateway: the API key is unknown or revoked - 404: Resource is absent or final page is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Response structure is unavailable - 501: Resource requires authentication - 503: Temporary TikTok or service refusal Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/tiktok/api/web/video/cdn' \ -H 'Authorization: Bearer ' ```