Skip to content
ShortVid API
All endpoints

Get videos using a sound / music track

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

Paginated list of videos that use a specific sound (data.videos), including no-watermark playback streams and stats.

Query Parameters

  • music_idstringrequired

    Numeric music ID (data.id from /v1/music/info).

    Example: 7106594322274962182

  • countinteger (1 to 30)

    Number of videos per page (max 30).

    Example: 20

  • cursorinteger

    Pagination cursor (0 for first page, then pass data.cursor).

    Example: 0

Example Request (cURL / Python / JavaScript)

curl "https://api.shortvidapi.com/v1/music/posts?music_id=7106594322274962182" \
  -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": "v12044gd0000chddvr3c77u85fgv2j40",
        "video_id": "7231338487075638570",
        "region": "US",
        "title": "take time for yourself this #MentalHealthAwarenessMonth bc even a minute matters #SelfCare #Meditation #Wellness #MentalHealth ",
        "content_desc": [],
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ddd657d17f0b4abf8a35fd0a823b72ec~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token=8e96214b&x-expires=1793631600&x-signature=U5b%2FDUe%2Broz9F...",
        "ai_dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/9152b7eacb1743a191bf96c1983d0640_1683677204~tplv-tiktokx-origin.image?dr=8606&refresh_token=198578b9&x-expires=1793631600&x-signature=AVxgNSblk6BwJakUWODvoi%...",
        "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/1a7f7c9536334a789a11119b2b27c6ba_1683677204~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=fa5bd835&x-expires=1793631600&x-signature=IDxHgpBG...",
        "duration": 60,
        "play": "https://v16m.tiktokcdn-us.com/a5a4ed31914f0da3531788548bf10a9d/6ae7aba9/video/tos/useast5/tos-useast5-pve-0068-tx/o0VI0vfHAA2QJjP6AIeIt4knsbeTxBbDHIC5aU/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=76&ft=aEKfuqT0mI...",
        "wmplay": "https://v16m.tiktokcdn-us.com/2247886b766ca3b39f6bc1da788d2b68/6ae7aba9/video/tos/useast5/tos-useast5-ve-0068c002-tx/ossTIyaDjkebxfhI4AMbDUFtIAVIHQnUCsCHeC/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=108&ft=aEKfuq...",
        "size": 590702,
        "wm_size": 837720,
        "music": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7231338526456204078.mp3",
        "play_count": 589066,
        "digg_count": 96441,
        "comment_count": 1285,
        "share_count": 933,
        "download_count": 732,
        "collect_count": 60365,
        "create_time": 1683677202,
        "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\":\"202611011513167233332CA9C38CA5F55E\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "107955",
          "unique_id": "tiktok",
          "nickname": "TikTok",
          "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=4d557dce&x-expires=1793631600&x-signature=K%2FwI1k7NDfqQRCFbUFM..."
        },
        "is_nff_or_nr": false,
        "is_top": 0
      },
      {
        "aweme_id": "v0f044gc0000chdhjrrc77u79b6ekl9g",
        "video_id": "7231403782897257755",
        "region": "IT",
        "title": "Corso Massaggio πŸŒΏπŸ€β˜˜ #Relax #CorsoMassaggio #CorsoMassaggio #relaxing #TikTok #EsteticaItalianaacademy  Trainer Nataliya Dudar. One Minute Break #oneminute ",
        "content_desc": [
          "Corso Massaggio πŸŒΏπŸ€β˜˜ #Relax #CorsoMassaggio #CorsoMassaggio #relaxing #TikTok #EsteticaItalianaacademy ",
          ""
        ],
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-aiso/oksyLBzqEhAhXBHitCAoIQGfzYb37TVz4mSInG~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token=94a3dcbe&x-expires=1793631600&x-signature=Pvm9eTIn...",
        "ai_dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-aiso/ab6282bfc18243f1acd42161a46d2093_1683692424~tplv-tiktokx-origin.image?dr=8606&refresh_token=a6ab5bac&x-expires=1793631600&x-signature=Od603ttP92Z%2BX0BZtz...",
        "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-aiso/920b07b806a44ff3a62b165f57d7a7cf_1683692443~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=0949ea5d&x-expires=1793631600&x-signature=aq4fM...",
        "duration": 56,
        "play": "https://v16m.tiktokcdn-us.com/8f684ccfd343671a1b0c89ca8a7d19b8/6ae7aba5/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oAkePS2KvBVgxA8RdDpRz39AdWEOQeb61nNnDM/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1086&ft=aE...",
        "wmplay": "https://v16m.tiktokcdn-us.com/934069ed03f70e562cc000dbd690fc6a/6ae7aba5/video/tos/useast2a/tos-useast2a-ve-68c811-euttp/oMyLVHVGEBYTAqSCI3JbThAdQIf7Znts3ozzzh/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1309&ft=aE...",
        "size": 7855962,
        "wm_size": 9459412,
        "music": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7231338526456204078.mp3",
        "play_count": 4970,
        "digg_count": 605,
        "comment_count": 6,
        "share_count": 0,
        "download_count": 0,
        "collect_count": 5,
        "create_time": 1683692421,
        "anchors": [
          {
            "actions": [],
            "anchor_strong": null,
            "component_key": "anchor_poi",
            "description": "Location",
            "extra": "{\"Name\":\"Modena\",\"poi_id\":\"22535865212487759\",\"city_code\":\"3173330\",\"region_code\":\"3175395\",\"poi_backend_type\":\"Place and Address,Places,City|19a3a0\",\"poi_info_source\":\"unknown\",\"video_count\":152625,\"collect_info\":\"{\\\"tt...",
            "general_type": 1,
            "icon": {
              "height": 720,
              "uri": "tiktok-obj/fyp_Icon_Anchor-LS_POI_Location.png",
              "url_list": [
                "https://p16-common.tiktokcdn-us.com/tiktok-obj/fyp_Icon_Anchor-LS_POI_Location.png~tplv-tiktokx-origin.image?biz_tag=anchor.poi&dr=9580&idc=useast8&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474",
                "https://p19-common.tiktokcdn-us.com/tiktok-obj/fyp_Icon_Anchor-LS_POI_Location.png~tplv-tiktokx-origin.image?biz_tag=anchor.poi&dr=9580&idc=useast8&ps=933b5bde&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474"
              ],
              "url_prefix": null,
              "width": 720
            },
            "id": "22535865212487759",
            "keyword": "Modena",
            "log_extra": "{\"anchor_id\":\"22535865212487759\",\"anchor_name\":\"Modena\",\"anchor_type\":\"poi\",\"is_ad_signal\":\"0\"}",
            "schema": "aweme://poi/detail",
            "thumbnail": {
              "height": 64,
              "uri": "tiktok-obj/panel_Icon_Anchor-LS_POI_Location.png",
              "url_list": [
                "https://p19-common.tiktokcdn-us.com/tiktok-obj/panel_Icon_Anchor-LS_POI_Location.png~tplv-tiktokx-origin.image?dr=9580&t=4d5b0474&ps=933b5bde&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
                "https://p16-common.tiktokcdn-us.com/tiktok-obj/panel_Icon_Anchor-LS_POI_Location.png~tplv-tiktokx-origin.image?dr=9580&t=4d5b0474&ps=933b5bde&shp=d05b14bd&shcp=34ff8df6&idc=useast8"
              ],
              "url_prefix": null,
              "width": 64
            },
            "type": 45
          }
        ],
        "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\":\"202611011513167233332CA9C38CA5F55E\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "6793262104088593413",
          "unique_id": "esteticaitalianaacademy",
          "nickname": "Estetica Italiana Academy",
          "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/13da9730da8d3f06341f30f14485246a~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=6a8c7a30&x-expires=1793631600&x-signature=zzNuoCGTnoR%2BFVHdy2OJg0X..."
        },
        "is_nff_or_nr": false,
        "is_top": 0
      }
    ],
    "cursor": 12,
    "hasMore": 1
  }
}

Response Fields

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

FieldTypeSample / Notes
codeintegerExample: 0
providerstringExample: https://shortvidapi.com
statusstringExample: ok
msgstringExample: success
dataobject
videosarray of object
aweme_idstringExample: v12044gd0000chddvr3c77u85fgv2j40
video_idstringExample: 7231338487075638570
regionstringExample: US
titlestringExample: take time for yourself this #MentalHealthAwarenessMonth bc e
content_descarray of string
coverstringExample: https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-
ai_dynamic_coverstringExample: https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-
origin_coverstringExample: https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-
durationintegerExample: 60
playstringExample: https://v16m.tiktokcdn-us.com/a5a4ed31914f0da3531788548bf10a
wmplaystringExample: https://v16m.tiktokcdn-us.com/2247886b766ca3b39f6bc1da788d2b
sizeintegerExample: 590702
wm_sizeintegerExample: 837720
musicstringExample: https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7231338526456
play_countintegerExample: 589066
digg_countintegerExample: 96441
comment_countintegerExample: 1285
share_countintegerExample: 933
download_countintegerExample: 732
collect_countintegerExample: 60365
create_timeintegerExample: 1683677202
anchorsstring
anchors_extrasstringExample:
is_adbooleanExample: false
commerce_infoobject
commercial_video_infostringExample:
item_comment_settingsintegerExample: 0
mentioned_usersstringExample:
authorobject
is_nff_or_nrbooleanExample: false
is_topintegerExample: 0
cursorintegerExample: 12
hasMoreintegerExample: 1

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.