Spiral gives your agent every tool with one account. Browse the tools →

Amp · Social Media

How to Use Spotify catalog search in Amp

Find Spotify artists, tracks, playlists, podcasts, and episodes from a text query. Use it to identify matching catalog entries before choosing a specific recording or show; search results do not establish complete catalog coverage.

Prompts to try with Spotify catalog search in Amp

Copy an example into Amp, or ask in your own words.

Use Spotify catalog search for Radiohead Creep and compare the track matches with the references in our music bibliography.

Spotify catalog searchAmp
Try asking
  • Use Spotify catalog search for My First Million and prepare a review table of returned shows and publishers for our podcast directory.

  • Use Spotify catalog search for Daft Punk Get Lucky and list candidate track matches for the unresolved entry in our project.

  • Use Spotify catalog search for Planet Money and separate returned shows from episodes for our directory review.

  • Use Spotify catalog search for Miles Davis So What and compare matching track names and artists before proposing a bibliography correction.

How to set up Spotify catalog search in Amp

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

Use Spiral's MCP server

  1. Add the server

    No header and no client ID or secret: Amp registers itself with Spiral.

    amp mcp add spiral https://api.spiral.ai/mcp
  2. Sign in

    Start amp. Amp opens Spiral's sign-in page in your browser: sign in, pick the organization and click Authorize. No API key.

  3. Check it
    amp mcp doctor

Use the Spiral skill

  1. Send Amp 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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Spotify catalog search

    One request; the result comes back by polling or a webhook.

    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-search",
        "input": {
          "query": "my first million"
        }
      }'

Then paste one of the prompts above: Amp finds Spotify catalog search on Spiral, shows the price and runs it.

Spotify catalog search providers and prices

Spiral runs Spotify catalog search through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Spotify · Search
scrapecreators/spotify-search

What can you do with Spotify catalog search in Amp?

Resolve ambiguous Spotify references in a project's music or podcast list by comparing returned catalog matches. A coding agent can prepare a review table that separates artists, tracks, shows, and episodes before you choose replacements.

Resolve an ambiguous music title

Search for Creep and compare the returned artist and track matches before selecting the recording you mean.

Find a podcast by its published name

Search for My First Million and compare the returned show name and publisher before selecting a podcast.

Check catalog matches for an editorial reference

Search for Radiohead and assemble the returned artist, track, and podcast matches for a researcher to review.

Find episode candidates

Search for Planet Money and review the returned episode titles as candidates for a listening list.

Separate a show from similarly named music

Search for My First Million and separate podcast matches from artist and track matches.

Check a release title

Search for Daft Punk Get Lucky and review matching tracks before adding a Spotify reference to a music bibliography.

Questions about Spotify catalog search in Amp

Can Amp use Spotify catalog search?

Yes. Add Spiral to Amp as an MCP server, and Amp can find and run Spotify catalog search like any built-in tool.

How much does Spotify catalog search cost in Amp?

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 Amp plan is separate.

Do I need a ScrapeCreators account to use Spotify catalog search in Amp?

No. Spiral runs Spotify catalog search 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 catalog search in Amp?

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

Does Amp wait while Spotify catalog search runs?

Spotify catalog search runs in the background. Amp starts the run, checks on it and gives you the json when it's ready.

What kinds of Spotify results can I find?

The provider's published Radiohead test returned artists, tracks, playlists, podcasts, and episodes. That test establishes those five result categories, rather than complete coverage of everything matching the query.

How fresh are Spotify search results?

ScrapeCreators says it fetches the latest available search information when you request it. Spotify separately says it adds new content every day.

How many results does a search return?

The provider's September 24, 2026 Radiohead test returned 20 results each for artists, tracks, playlists, podcasts, and episodes. Those counts describe that test, not a guaranteed maximum for every search.

Does a missing result mean the content is unavailable everywhere?

No. Spotify says its music and podcast catalog changes over time and differs between countries, and search relevance is not a complete catalog export.

Can podcast search identify the publisher?

The documented My First Million search example includes the show name, Hubspot as publisher, and topic metadata. These details help distinguish a show from similarly named music or episodes.

Get started

Start using Spotify catalog search in Amp

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Amp:

Set up Amp

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options