# Spotify, SoundCloud e Apple Music

> Spotify, SoundCloud e Apple Music: Artistas, faixas, álbuns e podcasts públicos.

URL: https://apicultura.app/ferramentas/musica-streaming/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Spotify, SoundCloud e Apple Music na APIcultura

Acesse Spotify, SoundCloud e Apple Music pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Artistas, faixas, álbuns e podcasts públicos. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Redes (dados públicos)](/catalogo/?cat=social). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `spotify-buscar` | Buscar no Spotify | R$ 0,02 | `POST /v1/call/spotify-buscar` |
| `spotify-artista` | Artista no Spotify | R$ 0,02 | `POST /v1/call/spotify-artista` |
| `spotify-podcast` | Podcast no Spotify | R$ 0,02 | `POST /v1/call/spotify-podcast` |
| `soundcloud-faixa` | Faixa no SoundCloud | R$ 0,02 | `POST /v1/call/soundcloud-faixa` |
| `applemusic-buscar` | Buscar no Apple Music | R$ 0,02 | `POST /v1/call/applemusic-buscar` |

### Buscar no Spotify (`spotify-buscar`)

Busca faixas, artistas e álbuns. Preço: R$ 0,02 por chamada.

- `query` (string, obrigatório), ex.: `my first million`

### Schema de entrada de spotify-buscar

```json
{
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Artista no Spotify (`spotify-artista`)

Seguidores e gêneros de um artista. Preço: R$ 0,02 por chamada.

- `id` (string, opcional), ex.: `0cGUm45nv7Z6M6qdXYQGTX`
- `url` (string, opcional), ex.: `https://open.spotify.com/artist/0cGUm45nv7Z6M6qdXYQGTX`

### Schema de entrada de spotify-artista

```json
{
  "required": [],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Podcast no Spotify (`spotify-podcast`)

Dados de um podcast. Preço: R$ 0,02 por chamada.

- `id` (string, opcional), ex.: `3mliji9352UAk3XnWElnDV`
- `url` (string, opcional), ex.: `https://open.spotify.com/show/3mliji9352UAk3XnWElnDV`

### Schema de entrada de spotify-podcast

```json
{
  "required": [],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Faixa no SoundCloud (`soundcloud-faixa`)

Detalhes de uma faixa. Preço: R$ 0,02 por chamada.

- `url` (string, obrigatório), ex.: `https://soundcloud.com/kehlanimusic/lights-on-feat-big-sean`

### Schema de entrada de soundcloud-faixa

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Buscar no Apple Music (`applemusic-buscar`)

Busca músicas e artistas. Preço: R$ 0,02 por chamada.

- `query` (string, obrigatório), ex.: `taylor swift`
- `type` (string, opcional), ex.: `song`

### Schema de entrada de applemusic-buscar

```json
{
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "type": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "spotify-buscar", "input": {"query":"my first million"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/spotify-buscar \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"my first million"}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 0,02 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Experimente

Teste no playground interativo: [Spotify, SoundCloud e Apple Music no playground](/ferramentas/ferramenta.html?slug=musica-streaming). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Spotify, SoundCloud e Apple Music é marca de seus respectivos donos, citada apenas para identificar a integração.
