[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Spotify artist profile](https://spiral.ai/integrations/windsurf/spotify-artist-profile)

# How to Use Spotify artist profile in Windsurf

Returns Spotify artist data including follower totals, monthly listeners, top listener cities, and top tracks. Use it to compare artists' audiences, research music markets, or prepare an artist brief.

|  |  |
| --- | --- |
| Model | Spotify artist profile |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Spotify artist profile in Windsurf

- Use Spotify artist profile for Kehlani at https://open.spotify.com/artist/0cGUm45nv7Z6M6qdXYQGTX and add her follower total and monthly listeners to our project's artist report.
- Use Spotify artist profile for Radiohead at https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb and build a table of the returned listener cities, countries, regions, and listener counts.
- Use Spotify artist profile for Daft Punk at https://open.spotify.com/artist/4tZwfgrHOc3mvqYlEYSvVi and add the returned top-track list to our artist detail view.
- Use Spotify artist profile for Taylor Swift at https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02 and compare the audience totals with the last saved response in this project.
- Use Spotify artist profile for Coldplay at https://open.spotify.com/artist/4gzpq5DPGxSnKTe4SA8HAU and create a report component that labels monthly listeners as a rolling 28-day measure.

## How to set up Spotify artist profile in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 Spotify artist profile**: 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": "scrapecreators",
    "model": "scrapecreators/spotify-artist",
    "input": {
      "id": "0cGUm45nv7Z6M6qdXYQGTX"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Spotify artist profile on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## Spotify artist profile tools and prices

- [Spotify · Artist](https://spiral.ai/tools/scrapecreators/scrapecreators/spotify-artist) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| id |  | — | Spotify artist id. If you'd prefer to use the URL instead, you can use the url parameter instead. |
| url |  | — | Spotify artist URL. If you'd prefer to use the id instead, you can use the id parameter instead. |

## What can you do with Spotify artist profile in Windsurf?

Build an artist comparison view with Spotify follower totals, monthly listeners, and top listener cities. A coding agent can map the returned statistics into your project's reports and compare saved responses for changes.

### Artist comparison brief

Compare follower totals and monthly listeners for a shortlist of public artists before an editorial or partnership discussion.

### Tour market research

Use returned top-city listener counts to identify markets worth investigating for an artist's next tour.

### Release audience report

Compare saved observations of monthly listeners and followers before and after a release to describe audience changes.

### Music editor briefing

Combine an artist's returned top tracks and audience totals into a concise brief for an interview or feature.

### Regional promotion shortlist

Compare artists' returned listener cities to find candidates with an audience in a planned promotion market.

### Label roster reporting

Build a consistent comparison of follower totals, monthly listeners, and top listener cities across a label's public artist roster.

### Top-track change digest

Compare successive artist responses and summarize changes in the returned top-track lists.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## Spotify artist profile in other agents

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

## More Windsurf guides

- [Spotify album details](https://spiral.ai/integrations/windsurf/spotify-album-details)
- [Spotify catalog search](https://spiral.ai/integrations/windsurf/spotify-catalog-search)
- [SoundCloud track engagement](https://spiral.ai/integrations/windsurf/soundcloud-track-engagement)
- [Spotify playlist tracks](https://spiral.ai/integrations/windsurf/spotify-playlist-tracks)
- [SoundCloud track details](https://spiral.ai/integrations/windsurf/soundcloud-track-details)
- [Spotify podcast details](https://spiral.ai/integrations/windsurf/spotify-podcast-details)

## Questions about Spotify artist profile in Windsurf

**Can Windsurf use Spotify artist profile?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Spotify artist profile like any built-in tool.

**How much does Spotify artist profile cost in Windsurf?**

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need a ScrapeCreators account to use Spotify artist profile in Windsurf?**

No. Spiral runs Spotify artist profile on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Spotify artist profile in Windsurf?**

About two minutes: add the server, then sign in, then check it.

**Does Windsurf wait while Spotify artist profile runs?**

Spotify artist profile runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**What does Spotify's monthly listener count measure?**

It covers listeners over the last 28 days, including both active and programmed listening. It is a rolling audience measure, so label it separately from follower totals.

**How fresh is the Spotify data?**

ScrapeCreators says it fetches the latest information available from Spotify when you request it. That describes retrieval freshness; it does not establish an update schedule for Spotify's underlying figures.

**What geographic audience detail is available?**

The documented response includes top listener cities with country codes, region codes, and listener counts. This provides city-level audience context for market research.

**Can I identify an artist's individual followers?**

Spotify provides a follower total, not individual follower names. Spotify states that even Spotify for Artists does not show those names.

**Does the artist response contain music information too?**

Yes. The documented artist response includes top tracks with album artwork references alongside the audience statistics.

