# SoundCloud

> Search SoundCloud, browse your tracks and followers, and create, update or delete playlists.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/soundcloud

## Actions

### Create playlist

Create playlist.

**Inputs**

- Title (`title`, text, required): Title.
- Description (`description`, text): Description.
- Sharing (`sharing`, text): Sharing. One of: `private`, `public`.
- Tracks (`track_urns`, list): Tracks.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "artwork_url": "example",
    "created_at": "example",
    "description": "example",
    "downloadable": false,
    "duration": 1,
    "ean": "example",
    "embeddable_by": "example",
    "genre": "example",
    "kind": "example",
    "label": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "label_id": 1,
    "label_name": "example",
    "last_modified": "example",
    "license": "example",
    "likes_count": 1,
    "permalink": "example",
    "permalink_url": "example",
    "playlist_type": "example",
    "purchase_title": "example",
    "purchase_url": "example",
    "release": "example",
    "release_day": 1,
    "release_month": 1,
    "release_year": 1,
    "sharing": "example",
    "streamable": false,
    "tag_list": "example",
    "tags": "example",
    "title": "example",
    "track_count": 1,
    "tracks": [],
    "tracks_uri": "example",
    "type": "example",
    "uri": "example",
    "urn": "example",
    "user": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "user_urn": "example"
  }
}
```

### Delete playlist

Delete playlist.

**Inputs**

- Playlist (`playlist_urn`, text, required): Playlist.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {}
}
```

### Get playlist

Get playlist.

**Inputs**

- Playlist urn (`playlist_urn`, text, required): User playlist URN or system playlist (station) URN. Examples: - User playlist: `soundcloud:playlists:1212781357` - System playlist (station): `soundcloud:system-playlists:track-stations:2287580618`
- Access (`access`, list): Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details. One or more of: `playable`, `preview`, `blocked`. Default: `["playable", "preview"]`.
- Show tracks (`show_tracks`, true/false): A boolean flag to request a playlist with or without tracks. Default is `true`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "artwork_url": "example",
    "created_at": "example",
    "description": "example",
    "downloadable": false,
    "duration": 1,
    "ean": "example",
    "embeddable_by": "example",
    "genre": "example",
    "kind": "example",
    "label": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "label_id": 1,
    "label_name": "example",
    "last_modified": "example",
    "license": "example",
    "likes_count": 1,
    "permalink": "example",
    "permalink_url": "example",
    "playlist_type": "example",
    "purchase_title": "example",
    "purchase_url": "example",
    "release": "example",
    "release_day": 1,
    "release_month": 1,
    "release_year": 1,
    "sharing": "example",
    "streamable": false,
    "tag_list": "example",
    "tags": "example",
    "title": "example",
    "track_count": 1,
    "tracks": [],
    "tracks_uri": "example",
    "type": "example",
    "uri": "example",
    "urn": "example",
    "user": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "user_urn": "example"
  }
}
```

### Get profile

Get profile.

**Inputs**: None.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "avatar_url": "example",
    "city": "example",
    "comments_count": 1,
    "country": "example",
    "created_at": "example",
    "description": "example",
    "discogs_name": "example",
    "first_name": "example",
    "followers_count": 1,
    "followings_count": 1,
    "full_name": "example",
    "kind": "example",
    "last_modified": "example",
    "last_name": "example",
    "likes_count": 1,
    "locale": "example",
    "online": false,
    "permalink": "example",
    "permalink_url": "example",
    "plan": "example",
    "playlist_count": 1,
    "primary_email_confirmed": false,
    "private_playlists_count": 1,
    "private_tracks_count": 1,
    "public_favorites_count": 1,
    "quota": {
      "unlimited_upload_quota": false,
      "upload_seconds_left": 1,
      "upload_seconds_used": 1
    },
    "reposts_count": 1,
    "subscriptions": "example",
    "track_count": 1,
    "upload_seconds_left": 1,
    "uri": "example",
    "urn": "example",
    "username": "example",
    "website": "example",
    "website_title": "example"
  }
}
```

### Get track

Get track.

**Inputs**

- Track urn (`track_urn`, text, required): SoundCloud Track urn

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "access": "playable",
    "artwork_url": "example",
    "available_country_codes": "example",
    "bpm": 1.0,
    "comment_count": 1,
    "commentable": false,
    "created_at": "example",
    "description": "example",
    "download_count": 1,
    "download_url": "example",
    "downloadable": false,
    "duration": 1,
    "embeddable_by": "example",
    "favoritings_count": 1,
    "genre": "example",
    "isrc": "example",
    "key_signature": "example",
    "kind": "example",
    "label_name": "example",
    "license": "example",
    "metadata_artist": "example",
    "permalink_url": "example",
    "playback_count": 1,
    "purchase_title": "example",
    "purchase_url": "example",
    "release": "example",
    "release_day": 1,
    "release_month": 1,
    "release_year": 1,
    "reposts_count": 1,
    "reveal_comments": false,
    "reveal_stats": false,
    "secret_uri": "example",
    "sharing": "example",
    "station_urn": "example",
    "stream_url": "example",
    "streamable": false,
    "tag_list": "example",
    "title": "example",
    "uri": "example",
    "urn": "example",
    "user": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "user_favorite": false,
    "user_playback_count": 1,
    "waveform_url": "example"
  }
}
```

### Get user

Get user.

**Inputs**

- User urn (`user_urn`, text, required): SoundCloud User id

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "avatar_url": "example",
    "city": "example",
    "country": "example",
    "created_at": "example",
    "description": "example",
    "discogs_name": "example",
    "first_name": "example",
    "followers_count": 1,
    "followings_count": 1,
    "full_name": "example",
    "kind": "example",
    "last_modified": "example",
    "last_name": "example",
    "permalink": "example",
    "permalink_url": "example",
    "plan": "example",
    "playlist_count": 1,
    "public_favorites_count": 1,
    "reposts_count": 1,
    "station_urn": "example",
    "subscriptions": "example",
    "track_count": 1,
    "uri": "example",
    "urn": "example",
    "username": "example",
    "website": "example",
    "website_title": "example"
  }
}
```

### List followers

List followers.

**Inputs**

- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List followings

List followings.

**Inputs**

- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.
- Offset (`offset`, number): Offset of first result. Deprecated, use `linked_partitioning` instead. Default: `0`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List liked tracks

List liked tracks.

**Inputs**

- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.
- Access (`access`, list): Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details. One or more of: `playable`, `preview`, `blocked`. Default: `["playable", "preview", "blocked"]`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List my playlists

List my playlists.

**Inputs**

- Show tracks (`show_tracks`, true/false): A boolean flag to request a playlist with or without tracks. Default is `true`.
- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List my tracks

List my tracks.

**Inputs**

- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List playlist tracks

List playlist tracks.

**Inputs**

- Playlist urn (`playlist_urn`, text, required): User playlist URN or system playlist (station) URN. Examples: - User playlist: `soundcloud:playlists:1212781357` - System playlist (station): `soundcloud:system-playlists:track-stations:2287580618`
- Access (`access`, list): Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details. One or more of: `playable`, `preview`, `blocked`. Default: `["playable", "preview"]`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List related tracks

List related tracks.

**Inputs**

- Track urn (`track_urn`, text, required): SoundCloud Track urn
- Access (`access`, list): Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details. One or more of: `playable`, `preview`, `blocked`. Default: `["playable", "preview"]`.
- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.
- Offset (`offset`, number): Offset of first result. Deprecated, use `linked_partitioning` instead. Default: `0`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List track comments

List track comments.

**Inputs**

- Track urn (`track_urn`, text, required): SoundCloud Track urn
- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.
- Offset (`offset`, number): Offset of first result. Deprecated, use `linked_partitioning` instead. Default: `0`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List user playlists

List user playlists.

**Inputs**

- User urn (`user_urn`, text, required): SoundCloud User id
- Access (`access`, list): Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details. One or more of: `playable`, `preview`, `blocked`. Default: `["playable", "preview"]`.
- Show tracks (`show_tracks`, true/false): A boolean flag to request a playlist with or without tracks. Default is `true`.
- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### List user tracks

List user tracks.

**Inputs**

- User urn (`user_urn`, text, required): SoundCloud User id
- Access (`access`, list): Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details. One or more of: `playable`, `preview`, `blocked`. Default: `["playable", "preview"]`.
- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### Search playlists

Search playlists.

**Inputs**

- Q (`q`, text): search
- Access (`access`, list): Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details. One or more of: `playable`, `preview`, `blocked`. Default: `["playable", "preview"]`.
- Show tracks (`show_tracks`, true/false): A boolean flag to request a playlist with or without tracks. Default is `true`.
- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.
- Offset (`offset`, number): Offset of first result. Deprecated, use `linked_partitioning` instead. Default: `0`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### Search tracks

Search tracks.

**Inputs**

- Q (`q`, text): search
- Access (`access`, list): Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details. One or more of: `playable`, `preview`, `blocked`. Default: `["playable", "preview"]`.
- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.
- Offset (`offset`, number): Offset of first result. Deprecated, use `linked_partitioning` instead. Default: `0`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### Search users

Search users.

**Inputs**

- Q (`q`, text): search
- Limit (`limit`, number): Number of results to return in the collection. From 1 to 200. Default: `50`.
- Offset (`offset`, number): Offset of first result. Deprecated, use `linked_partitioning` instead. Default: `0`.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}
```

### Update playlist

Update playlist.

**Inputs**

- Playlist (`playlist_urn`, text, required): Playlist.
- Title (`title`, text): Title.
- Description (`description`, text): Description.
- Sharing (`sharing`, text): Sharing. One of: `private`, `public`.
- Tracks (`track_urns`, list): Tracks.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "artwork_url": "example",
    "created_at": "example",
    "description": "example",
    "downloadable": false,
    "duration": 1,
    "ean": "example",
    "embeddable_by": "example",
    "genre": "example",
    "kind": "example",
    "label": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "label_id": 1,
    "label_name": "example",
    "last_modified": "example",
    "license": "example",
    "likes_count": 1,
    "permalink": "example",
    "permalink_url": "example",
    "playlist_type": "example",
    "purchase_title": "example",
    "purchase_url": "example",
    "release": "example",
    "release_day": 1,
    "release_month": 1,
    "release_year": 1,
    "sharing": "example",
    "streamable": false,
    "tag_list": "example",
    "tags": "example",
    "title": "example",
    "track_count": 1,
    "tracks": [],
    "tracks_uri": "example",
    "type": "example",
    "uri": "example",
    "urn": "example",
    "user": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "user_urn": "example"
  }
}
```
