[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [SoundCloud search](https://spiral.ai/integrations/muse-code/soundcloud-search)

# How to Use SoundCloud search in Muse Code

Returns matching SoundCloud creators, tracks, playlists, or albums. Use it when you have a name or keyword and need to discover the right public record before inspecting its details.

|  |  |
| --- | --- |
| Model | SoundCloud search |
| Available through | Alexandria |
| Category | Social Media |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with SoundCloud search in Muse Code

- Use SoundCloud search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from SoundCloud search and tell me what changed since last week.
- Check SoundCloud search and summarize what you find in three bullet points.
- Pull the newest data from SoundCloud search and give me the result as a table.
- Check SoundCloud search every morning and tell me only when something changed.

## How to set up SoundCloud search in Muse Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run SoundCloud search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "soundcloud-com/profiles/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds SoundCloud search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## SoundCloud search tools and prices

- [SoundCloud · Search](https://spiral.ai/tools/alexandria/soundcloud-com/profiles/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| type | all, users, tracks, playlists, albums | all | all: mixed users, tracks and sets with per-type facet counts. users, tracks, playlists, albums: one type. |
| genre |  | — | Genre or tag filter (type tracks only), e.g. electronic. |
| limit | 1 to 50 | 20 | Page size, 1..50 (default 20). |
| query |  | — | Search text. Required for the first page. |
| cursor |  | — | next_cursor of the previous page; send with the same type. |

## What can you do with SoundCloud search in Muse Code?

Generate an internal SoundCloud release audit from artist, track, and playlist records. Use name discovery to match the intended artist before adding catalog data to the project.

### Artist research brief

Resolve an artist’s name, identify the public profile, and assemble a brief covering releases, curated collections, public activity, professional connections, and track response.

### Label catalog review

Resolve roster names and compare public artist profiles, uploads, albums, and playlist contents to prepare a catalog review.

### Editorial listening shortlist

Find artists and releases, inspect their collections, and use public curation, professional connections, and track feedback to build a listening shortlist with source links.

### Public music network research

Resolve public artist and label names, inspect their profiles and following relationships, and review shared music to identify professional connections worth researching.

### Playlist curation research

Resolve remembered names, find candidate tracks, inspect existing playlist contents, and explore public artist curation, professional connections, and related-track recommendations.

### Internal music research workspace

Bring name discovery, public profiles, catalogs, collection contents, curation, professional connections, and track response into one internal research workspace.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## SoundCloud search in other agents

- [Amp](https://spiral.ai/integrations/amp/soundcloud-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/soundcloud-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/soundcloud-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/soundcloud-search)
- [Cline](https://spiral.ai/integrations/cline/soundcloud-search)
- [Codex](https://spiral.ai/integrations/codex/soundcloud-search)
- [Cursor](https://spiral.ai/integrations/cursor/soundcloud-search)
- [Devin](https://spiral.ai/integrations/devin/soundcloud-search)
- [dots](https://spiral.ai/integrations/dots/soundcloud-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/soundcloud-search)
- [Gemini](https://spiral.ai/integrations/gemini/soundcloud-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/soundcloud-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/soundcloud-search)
- [goose](https://spiral.ai/integrations/goose/soundcloud-search)
- [Grok](https://spiral.ai/integrations/grok/soundcloud-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/soundcloud-search)
- [Hermes](https://spiral.ai/integrations/hermes/soundcloud-search)
- [Instinct](https://spiral.ai/integrations/instinct/soundcloud-search)
- [Manus](https://spiral.ai/integrations/manus/soundcloud-search)
- [Muse](https://spiral.ai/integrations/muse/soundcloud-search)
- [n8n](https://spiral.ai/integrations/n8n/soundcloud-search)
- [Notion](https://spiral.ai/integrations/notion/soundcloud-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/soundcloud-search)
- [opencode](https://spiral.ai/integrations/opencode/soundcloud-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/soundcloud-search)
- [Raycast](https://spiral.ai/integrations/raycast/soundcloud-search)
- [VS Code](https://spiral.ai/integrations/vscode/soundcloud-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/soundcloud-search)
- [Zapier](https://spiral.ai/integrations/zapier/soundcloud-search)

## More Muse Code guides

- [SoundCloud playlist tracks](https://spiral.ai/integrations/muse-code/soundcloud-playlist-tracks)
- [SoundCloud search suggestions](https://spiral.ai/integrations/muse-code/soundcloud-search-suggestions)
- [SoundCloud followers and following](https://spiral.ai/integrations/muse-code/soundcloud-followers-and-following)
- [SoundCloud track details](https://spiral.ai/integrations/muse-code/soundcloud-track-details)
- [SoundCloud creator public activity](https://spiral.ai/integrations/muse-code/soundcloud-creator-public-activity)
- [SoundCloud track engagement](https://spiral.ai/integrations/muse-code/soundcloud-track-engagement)

## Questions about SoundCloud search in Muse Code

**Can Muse Code use SoundCloud search?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run SoundCloud search like any built-in tool.

**How much does SoundCloud search cost in Muse Code?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Muse Code plan is separate.

**Do I need an Alexandria account to use SoundCloud search in Muse Code?**

No. Spiral runs SoundCloud search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up SoundCloud search in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while SoundCloud search runs?**

SoundCloud search runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

**Does public SoundCloud data include private tracks?**

Private tracks do not appear on public profiles and cannot be found through SoundCloud search. Public likes, reposts, comments, and follows have a different visibility boundary.

**How quickly do profile changes become searchable?**

SoundCloud says a new display name or profile URL becomes searchable immediately within SoundCloud. Google search can take longer to reflect the change.

**How large can a SoundCloud playlist be?**

SoundCloud enforces a 500-track limit per playlist.

**What is the difference between albums and playlists?**

SoundCloud describes albums as collections of tracks released as albums. Playlists are curated track lists from creators or fans.

**Which profile interactions are public?**

SoundCloud says likes, reposts, comments, and follows are always public. Making uploads private does not make those interactions private.

