sangtao.ai
API key

Đăng bài

Nhạc TikTok

Nhạc TikTok thịnh hành cho bài ảnh — dùng cho musicSoundId.

GEThttps://api.sangtao.ai/v2/publishing/tiktok/music

Xác thực

Không cần — endpoint này công khai, gọi không cần API key.

Nhạc thịnh hành từ thư viện nhạc thương mại của TikTok, dùng cho bài ảnh TikTok (carousel). Không cần key, không tốn credit. Gửi songClipId của một bản nhạc làm platforms[].musicSoundId ở Đăng bài. Bỏ trống thì TikTok tự chọn nhạc; bài video và nền tảng khác bỏ qua.

Danh sách được cache 1 giờ.

Tham số query

  • genrestring

    Thể loại nhạc. Mặc định POP; các giá trị hợp lệ trả về ở genres

  • dateRangestring

    Thịnh hành trong 1 ngày, 7 ngày hoặc 30 ngày gần nhất. Mặc định 7DAY

    Giá trị có thể:1DAY7DAY30DAY

Response

  • genrestringbắt buộc

    Thể loại của danh sách này

  • dateRangestringbắt buộc

    Khoảng thời gian của danh sách này

    Giá trị có thể:1DAY7DAY30DAY

  • tracksobject[]bắt buộc

    Các bản nhạc

    Hiện thuộc tính con

    • songClipIdstringbắt buộc

      Gửi làm platforms[].musicSoundId ở Đăng bài

    • titlestring | null

      Tên bài

    • artiststring | null

      Ca sĩ

    • thumbnailUrlstring | null

      Ảnh bìa

    • previewUrlstring | null

      Link nghe thử

    • durationSecnumber | null

      Thời lượng, tính bằng giây

    • genresstring[]bắt buộc

      Các thể loại của bài

    • rankstring | null

      Thứ hạng thịnh hành

  • genresstring[]bắt buộc

    Các giá trị hợp lệ của query genre, để làm bộ lọc

  • dateRangesstring[]bắt buộc

    Các giá trị hợp lệ của query dateRange, để làm bộ lọc

Mã lỗi

MãerrorCodeKhi nào
400INVALID_GENREgenre không nằm trong danh sách genres
400INVALID_DATE_RANGEdateRange không phải 1DAY, 7DAY hoặc 30DAY
404NO_PUBLISHING_TEAMHệ thống chưa có nhóm đăng bài nào (gần như không xảy ra)
GET/publishing/tiktok/music
curl "https://api.sangtao.ai/v2/publishing/tiktok/music?genre=POP&dateRange=7DAY"
{
  "success": true,
  "data": {
    "genre": "POP",
    "dateRange": "7DAY",
    "tracks": [
      {
        "songClipId": "7301234567890123456",
        "title": "Song title",
        "artist": "Artist",
        "thumbnailUrl": "https://…",
        "previewUrl": "https://…",
        "durationSec": 60,
        "genres": [
          "POP"
        ],
        "rank": "1"
      }
    ],
    "genres": [
      "ROCK",
      "POP",
      "LATIN",
      "…"
    ],
    "dateRanges": [
      "1DAY",
      "7DAY",
      "30DAY"
    ]
  }
}