Skip to main content

​
What it does

Returns metadata for a TikTok audio track including title, artist, duration, usage count, and cover image. Look up any sound by its audio ID.

​
Tool details

FieldValue
Tool nametiktok.get_audio
PlatformTikTok
REST endpointGET /v1/tiktok/audios/{audioId}
Result typeDetail tool

​
Parameters

ParameterSourceTypeRequiredDescription
audioIdpathstringYesTikTok audio/music ID
projection_presetsharedstringNoOptional. Defaults to minimal. Allowed values: full, minimal, identity, engagement, content.
data_fieldssharedstring[]NoOptional. Adds top-level keys from data on top of the selected projection_preset.

​
Example

{
  "name": "tiktok.get_audio",
  "arguments": {
    "audioId": "7517710000000000000",
    "projection_preset": "minimal",
    "data_fields": [
      "entityId",
      "name",
      "url",
      "image"
    ]
  }
}

​
Available data fields

[
  "@context",
  "type",
  "id",
  "url",
  "name",
  "duration",
  "mediaType",
  "attributedTo",
  "icon",
  "image",
  "entityId",
  "album",
  "isOriginal",
  "isCopyrighted",
  "videoCount"
]

​
Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.