Get creator's public video posts

GET/v1/user/posts2 Credits / video (min 10 Credits)($0.20 / 1K videos)

Paginated list of public videos and photo carousels posted by a creator (data.videos), newest first, including canonical video_url / share_url, content_type (video or image), direct unwatermarked MP4 streams (play, no_watermark_url, has_watermark, video_format, bitrate_kbps), hashtags, mentioned_user_ids, parsed POI location (location_name, poi), disclosure flags (is_pinned, is_ad, is_paid_partnership, is_ecommerce), music metadata, and full engagement statistics (play_count, digg_count, comment_count, share_count, collect_count, download_count). Pass unique_id, user_id, or sec_uid.

Query Parameters

unique_idstringrequired
Creator handle without @, e.g. tiktok.
Example: tiktok
countinteger (1 to 35)
Number of videos per page (max 35).
Example: 20
cursorstring
Pagination cursor (0 for the first page, then pass data.cursor).
Example: 0

Example Request (cURL / Python / JavaScript)

curl "https://api.shortvidapi.com/v1/user/posts?unique_id=tiktok" \
  -H "x-api-key: tk_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://shortvidapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "videos": [
      {
        "aweme_id": "v15044gf0000dbj5qpfog65strb9nsc0",
        "video_id": "7702947070604332319",
        "region": "US",
        "title": "already planning next halloween? 👀🎃  take notes from @Mason Smith. find more DIY inspo on TikTok.",
        "content_desc": [],
        "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/o0MgwFCRVDqH5jE2uAADA0yEIfcX7fEE9PQAlA~tplv-tiktokx-cropcenter:300:400.jpeg?dr=10399&refresh_token=8a000905&x-expires=1793631600&x-signature=%2B14gOseSjg82%...",
        "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/o0MgwFCRVDqH5jE2uAADA0yEIfcX7fEE9PQAlA~tplv-tiktokx-origin.image?dr=10395&refresh_token=a2b2e40e&x-expires=1793631600&x-signature=Ha14D7SOKvvXidOmAJKSbU0XqX...",
        "origin_cover": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oom34f8ERQ3AZVsf53QCa0DqazwFEEllBAA1X5~tplv-tiktokx-360p.webp?dr=10375&refresh_token=930ca11e&x-expires=1793631600&x-signature=tJg50cTT9toOSuuG1e%2B3DsgebcI...",
        "duration": 43,
        "play": "https://v16m.tiktokcdn-eu.com/2fcf9572312c0c44acc748dfaeba1aec/6ae8a880/video/tos/alisg/tos-alisg-ve-37c799-sg/oglE3HF54QDrl5gA1whAfaE3qMIIRe0EVN3luB/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=1277&ft=aXW-TQc6UEefu...",
        "wmplay": "https://v16m.tiktokcdn-eu.com/25390ecc1288064f4181a68f4f1f4d5c/6ae8a880/video/tos/alisg/tos-alisg-ve-37c799-sg/ogGM8KiEIiA1yVcftXiqm3zbYb6a5CA7BAyIQ8/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=1172&ft=aXW-TQc6UEefu...",
        "size": 7086434,
        "wm_size": 6501323,
        "music": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-tx2/7703208257951353631.mp3",
        "music_info": {
          "id": "7702947082445114142",
          "title": "original sound - tiktok",
          "play": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-tx2/7703208257951353631.mp3",
          "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=6b6577e4&x-expires=1793631600&x-signature=YlliRM8d9eEKmusLK%2Fdv...",
          "author": "TikTok",
          "original": true,
          "duration": 43,
          "album": "",
          "create_time": 1793482139
        },
        "play_count": 108971,
        "digg_count": 1808,
        "comment_count": 489,
        "share_count": 154,
        "download_count": 3,
        "collect_count": 163,
        "create_time": 1793482137,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"20261101231220C500F1DBD61147C8A143\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "6532035046562332674",
        "author": {
          "id": "107955",
          "unique_id": "tiktok",
          "nickname": "TikTok",
          "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:300:300.jpeg?dr=10397&refresh_token=3dcaab0a&x-expires=1793631600&x-signature=wXV%2FXqJt4HyHzp%2Fyq6L6..."
        },
        "is_nff_or_nr": false,
        "is_top": 0
      },
      {
        "aweme_id": "v15044gf0000dbf4vl7og65thduibd60",
        "video_id": "7700680369246358815",
        "region": "US",
        "title": "TikTok asked. @Aston Martin Aramco F1 Team answered. 🏎️🏁 @allena holzworth goes behind the scenes in the garage at Austin for Search Files. 🔎",
        "content_desc": [
          "TikTok asked. @Aston Martin Aramco F1 Team answered. 🏎️🏁",
          ""
        ],
        "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/ooAASpEQIEAqKN3fpUFVeCGcWAA42EAIDClRAk~tplv-tiktokx-cropcenter:300:400.jpeg?dr=10399&refresh_token=002536a1&x-expires=1793631600&x-signature=xh4IfCOr0uV14gu...",
        "ai_dynamic_cover": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/ooAASpEQIEAqKN3fpUFVeCGcWAA42EAIDClRAk~tplv-tiktokx-origin.image?dr=10395&refresh_token=95d86332&x-expires=1793631600&x-signature=7ujRC8Uig9vFIKJIPg%2F4FcMe...",
        "origin_cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/osVuQ8aIADEfLAhiYovCfFB7fIq9UQvFjJvptD~tplv-tiktokx-360p.webp?dr=10375&refresh_token=5aafbff5&x-expires=1793631600&x-signature=hl2CIieoUnyu2esFUX%2FcQmkbpsc...",
        "duration": 74,
        "play": "https://v16m.tiktokcdn-eu.com/6b2fb045eb13748d12465ebd6961031b/6ae8a89f/video/tos/alisg/tos-alisg-ve-37c799-sg/owCbAUavXFmTFIJgQVED7DfYIhoVAfpvIqeULj/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=1068&ft=aXW-TQc6UEefu...",
        "wmplay": "https://v16m.tiktokcdn-eu.com/d661022d8bedaa22b21ce2a21f349f29/6ae8a89f/video/tos/alisg/tos-alisg-ve-37c799-sg/o44kevTAgBKgetAtYSYpoWiCeAH9CUNgTvhiee/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=984&ft=aXW-TQc6UEefub...",
        "size": 10236652,
        "wm_size": 9432622,
        "music": "https://sf19-music.tiktokcdn-eu.com/obj/ies-music-ttp-dup-us/tx27700680424468515614.mp3",
        "music_info": {
          "id": "7700680397922814751",
          "title": "original sound - tiktok",
          "play": "https://sf19-music.tiktokcdn-eu.com/obj/ies-music-ttp-dup-us/tx27700680424468515614.mp3",
          "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=6b6577e4&x-expires=1793631600&x-signature=YlliRM8d9eEKmusLK%2Fdv...",
          "author": "TikTok",
          "original": true,
          "duration": 74,
          "album": "",
          "create_time": 1792954383
        },
        "play_count": 741457,
        "digg_count": 7598,
        "comment_count": 3371,
        "share_count": 828,
        "download_count": 30,
        "collect_count": 740,
        "create_time": 1792954380,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"20261101231220C500F1DBD61147C8A143\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "6825494616634442757,6781477132889654277",
        "author": {
          "id": "107955",
          "unique_id": "tiktok",
          "nickname": "TikTok",
          "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:300:300.jpeg?dr=10397&refresh_token=3dcaab0a&x-expires=1793631600&x-signature=wXV%2FXqJt4HyHzp%2Fyq6L6..."
        },
        "is_nff_or_nr": true,
        "is_top": 0
      }
    ],
    "cursor": "1791584711583",
    "hasMore": true
  }
}

Response Fields

Success (code === 0). Charged according to the endpoint credit rate.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://shortvidapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`videos`	array of object
`aweme_id`	string	Example: v15044gf0000dbj5qpfog65strb9nsc0
`video_id`	string	Example: 7702947070604332319
`region`	string	Example: US
`title`	string	Example: already planning next halloween? 👀🎃 take notes from @Maso
`content_desc`	array of string
`cover`	string	Example: https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-
`ai_dynamic_cover`	string	Example: https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-
`origin_cover`	string	Example: https://p19-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-
`duration`	integer	Example: 43
`play`	string	Example: https://v16m.tiktokcdn-eu.com/2fcf9572312c0c44acc748dfaeba1a
`wmplay`	string	Example: https://v16m.tiktokcdn-eu.com/25390ecc1288064f4181a68f4f1f4d
`size`	integer	Example: 7086434
`wm_size`	integer	Example: 6501323
`music`	string	Example: https://sf16-music.tiktokcdn-eu.com/obj/ies-music-tx2/770320
`music_info`	object
`play_count`	integer	Example: 108971
`digg_count`	integer	Example: 1808
`comment_count`	integer	Example: 489
`share_count`	integer	Example: 154
`download_count`	integer	Example: 3
`collect_count`	integer	Example: 163
`create_time`	integer	Example: 1793482137
`anchors`	string
`anchors_extras`	string	Example:
`is_ad`	boolean	Example: false
`commerce_info`	object
`commercial_video_info`	string	Example:
`item_comment_settings`	integer	Example: 0
`mentioned_users`	string	Example: 6532035046562332674
`author`	object
`is_nff_or_nr`	boolean	Example: false
`is_top`	integer	Example: 0
`cursor`	string	Example: 1791584711583
`hasMore`	boolean	Example: true

Status Codes

200: Success (code === 0). Charged according to the endpoint credit rate.
400: Invalid parameters, or API key placed in the URL query string (not charged).
401: Missing or invalid x-api-key header (not charged).
402: Insufficient credit balance (not charged).
403: Account disabled (not charged).
404: Unknown endpoint or disabled unstable endpoint (not charged).
405: Method not allowed — all /v1/* data endpoints use GET (not charged).
429: Rate limit exceeded (not charged). Respect the Retry-After header.
503: Temporary upstream or gateway error (not charged). Retry with exponential backoff.

Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.