/v1/soundcloud/track

GET

Track

Gets detailed information about a SoundCloud track/song by URL.

Credit cost	Default: 1 credit How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Not specified in the published contract.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`url` SoundCloud track URL.	query / required	`string`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v1/soundcloud/track?url=YOUR_URL' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/soundcloud/track?url=YOUR_URL", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v1/soundcloud/track?url=YOUR_URL",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

artwork_urlrequired

string

captionrequired

null

commentablerequired

boolean

comment_countrequired

integer

created_atrequired

string

{
  "format": "date-time"
}

descriptionrequired

null

downloadablerequired

boolean

download_countrequired

integer

durationrequired

integer

full_durationrequired

integer

embeddable_byrequired

string

genrerequired

string

has_downloads_leftrequired

boolean

idrequired

integer

kindrequired

string

label_namerequired

string

last_modifiedrequired

string

{
  "format": "date-time"
}

licenserequired

string

likes_countrequired

integer

permalinkrequired

string

permalink_urlrequired

string

playback_countrequired

integer

publicrequired

boolean

publisher_metadatarequired

object

idrequired

integer

urnrequired

string

artistrequired

string

album_titlerequired

string

contains_musicrequired

boolean

upc_or_eanrequired

string

isrcrequired

string

explicitrequired

boolean

p_linerequired

string

p_line_for_displayrequired

string

c_linerequired

string

c_line_for_displayrequired

string

release_titlerequired

string

purchase_titlerequired

null

purchase_urlrequired

null

release_daterequired

string

{
  "format": "date-time"
}

reposts_countrequired

integer

secret_tokenrequired

null

sharingrequired

string

staterequired

string

streamablerequired

boolean

tag_listrequired

string

titlerequired

string

urirequired

string

urnrequired

string

user_idrequired

integer

visualsrequired

null

waveform_urlrequired

string

display_daterequired

string

{
  "format": "date-time"
}

mediarequired

object

transcodingsrequired

array

Array items

object

urlrequired

string

presetrequired

string

durationrequired

integer

snippedrequired

boolean

formatrequired

object

protocolrequired

string

mime_typerequired

string

qualityrequired

string

is_legacy_transcodingrequired

boolean

station_urnrequired

string

station_permalinkrequired

string

track_authorizationrequired

string

monetization_modelrequired

string

policyrequired

string

userrequired

object

avatar_urlrequired

string

first_namerequired

string

followers_countrequired

integer

full_namerequired

string

idrequired

integer

kindrequired

string

last_modifiedrequired

string

{
  "format": "date-time"
}

last_namerequired

string

permalinkrequired

string

permalink_urlrequired

string

urirequired

string

urnrequired

string

usernamerequired

string

verifiedrequired

boolean

cityrequired

string

country_coderequired

string

badgesrequired

object

prorequired

boolean

creator_mid_tierrequired

boolean

pro_unlimitedrequired

boolean

verifiedrequired

boolean

station_urnrequired

string

station_permalinkrequired

string

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited