# SoundCloud Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/soundcloud/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/soundcloud-search |

## Description

Unlock music data from SoundCloud for analytics, research, and marketing with Piloterr's powerful API. Get 50 free requests now!

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/soundcloud/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "query": "anthony",
  "results": [
    {
      "link": "https://soundcloud.com/artistx/anthony",
      "likes": 150,
      "plays": 4500,
      "title": "Anthony",
      "comments": 20,
      "duration": "3:45",
      "username": "ArtistX",
      "upload_date": "2023-09-15"
    },
    {
      "link": "https://soundcloud.com/dj_anthony/anthony_groove",
      "likes": 120,
      "plays": 3200,
      "title": "Anthony's Groove",
      "comments": 15,
      "duration": "4:02",
      "username": "DJ_Anthony",
      "upload_date": "2023-08-10"
    },
    {
      "link": "https://soundcloud.com/user237/antoines_dream",
      "likes": 95,
      "plays": 2100,
      "title": "Antoine's Dream",
      "comments": 10,
      "duration": "5:10",
      "username": "user237",
      "upload_date": "2023-07-20"
    },
    {
      "link": "https://soundcloud.com/remix_master/anthony_remix",
      "likes": 200,
      "plays": 5000,
      "title": "Anthony Remix",
      "comments": 30,
      "duration": "4:45",
      "username": "remix_master",
      "upload_date": "2023-06-25"
    }
  ]
}
```

## Documentation

## Overview
Unlock music data from SoundCloud for analytics, research, and marketing with Piloterr's powerful API. Get 50 free requests now!

## Quickstart
```
GET https://api.piloterr.com/v2/soundcloud/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate SoundCloud Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Soundcloud without maintaining scrapers
- Power internal dashboards and workflow automations with live Soundcloud data