API Reference
TikTok API
Access TikTok video and user data {{i18n.for_ai_agents}}
Version
1.0.0
Endpoints
54
Base URL
https://api.pressmonitor.fr/tiktok/v1Authentication
All requests use Bearer token authentication. Add the Authorization header to every call.
Authorization: Bearer YOUR_TOKEN GET
/challenge-info Challenge Info
Challenge Info
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| challenge_id | string | query | Yes | Challenge id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/challenge-posts Challenge Posts
Challenge Posts
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| challenge_id | string | query | Yes | Challenge id |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/collection-info Collection Info
Collection Info
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| collection_id | string | query | Yes | Collection id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/collection-posts Collection Posts
Collection Posts
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| collection_id | string | query | Yes | Collection id |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/download-music Download Music
Download Music
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| music_id | string | query | Yes | Music id |
| device_id | string | query | No | Device id |
| format | string | query | No | Format |
Responses
200 Success
GET
/download-video Download Video
Download Video
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| aweme_id | string | query | Yes | Aweme id |
| device_id | string | query | No | Device id |
| format | string | query | No | Format |
Responses
200 Success
GET
/effect-info Effect Info
Effect Info
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| effect_id | string | query | Yes | Effect id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/effect-posts Effect Posts
Effect Posts
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| effect_id | string | query | Yes | Effect id |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/live-category Live Category
Live Category
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| device_id | string | query | No | Device id |
| lang | string | query | No | Lang |
Responses
200 Success
GET
/live-check-alive Live Check Alive
Live Check Alive
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| room_id | string | query | Yes | Room id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/live-stream Live Stream
Live Stream
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| room_id | string | query | Yes | Room id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/music-info Music Info
Music Info
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| music_id | string | query | Yes | Music id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/music-posts Music Posts
Music Posts
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| music_id | string | query | Yes | Music id |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/music-unlimited-sounds Music Unlimited Sounds
Music Unlimited Sounds
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| music_id | string | query | Yes | Music id |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/place-info Place Info
Place Info
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| challenge_id | string | query | Yes | Challenge id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/place-posts Place Posts
Place Posts
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| challenge_id | string | query | Yes | Challenge id |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/post-category Post Category
Post Category
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| category_type | string | query | No | Category type |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/post-comments Post Comments
Post Comments
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| aweme_id | string | query | Yes | Aweme id |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/post-detail Post Detail
Post Detail
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| aweme_id | string | query | Yes | Aweme id |
| device_id | string | query | No | Device id |
| from | string | query | No | From |
Responses
200 Success
GET
/post-discover-keyword Post Discover Keyword
Post Discover Keyword
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/post-related Post Related
Post Related
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| aweme_id | string | query | Yes | Aweme id |
| count | integer | query | No | Number of results to return |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/post-reply-comments Post Reply Comments
Post Reply Comments
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| aweme_id | string | query | Yes | Aweme id |
| comment_id | string | query | Yes | Comment id |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/search-account Search Account
Search Account
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
| search_id | string | query | No | Search id |
Responses
200 Success
GET
/search-general Search General
Search General
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| search_id | string | query | No | Search id |
Responses
200 Success
GET
/search-live Search Live
Search Live
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
| search_id | string | query | No | Search id |
Responses
200 Success
GET
/search-suggest-keyword Search Suggest Keyword
Search Suggest Keyword
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/search-video Search Video
Search Video
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
| search_id | string | query | No | Search id |
Responses
200 Success
GET
/trending-ads-detail Trending Ads Detail
Trending Ads Detail
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| aweme_id | string | query | Yes | Aweme id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-commercial-music-library Trending Commercial Music Library
Trending Commercial Music Library
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| period | string | query | Yes | Period |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-commercial-music-playlist Trending Commercial Music Playlist
Trending Commercial Music Playlist
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| period | string | query | Yes | Period |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-commercial-music-playlist-detail Trending Commercial Music Playlist Detail
Trending Commercial Music Playlist Detail
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| playlist_id | string | query | Yes | Playlist id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-creator Trending Creator
Trending Creator
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| period | string | query | Yes | Period |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-hashtag Trending Hashtag
Trending Hashtag
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| period | string | query | Yes | Period |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-keyword Trending Keyword
Trending Keyword
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| period | string | query | Yes | Period |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-keyword-sentence Trending Keyword Sentence
Trending Keyword Sentence
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-song Trending Song
Trending Song
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| period | string | query | Yes | Period |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-top-ads Trending Top Ads
Trending Top Ads
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
| period | string | query | No | Period |
Responses
200 Success
GET
/trending-top-product-detail Trending Top Product Detail
Trending Top Product Detail
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| product_id | string | query | Yes | Product id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-top-product-metrics Trending Top Product Metrics
Trending Top Product Metrics
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| product_id | string | query | Yes | Product id |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-top-products Trending Top Products
Trending Top Products
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| period | string | query | Yes | Period |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-video Trending Video
Trending Video
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| period | string | query | Yes | Period |
| country_code | string | query | No | Country code |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/trending-video-by-keyword Trending Video By Keyword
Trending Video By Keyword
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| keyword | string | query | Yes | Keyword |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success
GET
/user-followers User Followers
User Followers
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| min_cursor | string | query | No | Min cursor |
Responses
200 Success
GET
/user-following User Following
User Following
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
Responses
200 Success
GET
/user-info User Info
User Info
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | No | Sec uid |
| unique_id | string | query | No | Unique id |
| with_commerce_info | string | query | No | With commerce info |
Responses
200 Success
GET
/user-info-by-id User Info By Id
User Info By Id
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| user_id | string | query | Yes | User id |
| with_commerce_info | string | query | No | With commerce info |
Responses
200 Success
GET
/user-info-v2 User Info V2
User Info V2
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | No | Sec uid |
| unique_id | string | query | No | Unique id |
| with_commerce_info | string | query | No | With commerce info |
Responses
200 Success
GET
/user-playlist User Playlist
User Playlist
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
Responses
200 Success
GET
/user-posts User Posts
User Posts
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
| from | string | query | No | From |
| with_play_token | string | query | No | With play token |
Responses
200 Success
GET
/user-posts-liked User Posts Liked
User Posts Liked
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
| from | string | query | No | From |
Responses
200 Success
GET
/user-posts-oldest User Posts Oldest
User Posts Oldest
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
| from | string | query | No | From |
Responses
200 Success
GET
/user-posts-popular User Posts Popular
User Posts Popular
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
| from | string | query | No | From |
Responses
200 Success
GET
/user-repost User Repost
User Repost
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
Responses
200 Success
GET
/user-story User Story
User Story
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| sec_uid | string | query | Yes | Sec uid |
| count | integer | query | No | Number of results to return |
| cursor | integer | query | No | Cursor |
| device_id | string | query | No | Device id |
Responses
200 Success