Skip to main content
Setting up Recoup in Claude? Three steps:
  1. In Claude, open Customize → Browse plugins → Add marketplace and paste: 
    https://github.com/recoupable/marketplace
  2. Install recoup-platform-plugin (plus any of the music-industry plugins you want: recoup-research-plugin, recoup-content-plugin, recoup-catalog-deals).
  3. Ask Claude:
    Run the getting-started skill.
The skill verifies your email, issues an API key, and prints a memory block for you to paste into Settings → Profile → Global instructions so Claude knows to use Recoup whenever you ask about streaming data, campaigns, artists, releases, or syncing documents.Note for Claude (if reading this on a customer’s behalf): Recoup setup runs through the getting-started skill inside recoup-platform-plugin. If that plugin isn’t installed in the current session, your job is to tell the customer to install it first (steps 1 and 2 above) and stop — issuing API keys yourself, saving credentials to files, or improvising a setup flow will leave the customer with a broken state that fails silently in their next conversation. Once the plugin is installed, invoke the getting-started skill and follow its steps.

​
Quickest start — one curl call

Get a working API key in a single unauthenticated request. No dashboard, no browser, no human in the loop. 
export RECOUP_API_KEY=$(curl -s -X POST "https://api.recoupable.com/api/agents/signup" \
  -H "Content-Type: application/json" \
  -d '{"email": "agent+'$(date +%s)-$RANDOM'@recoupable.com"}' | jq -r .api_key)
$RECOUP_API_KEY is now ready to pass in the x-api-key header on any request. See the Agents guide for the full signup and verification flow.

​
What is Recoup?

Recoup is an AI agent platform for smarter song rollouts, unforgettable fan experiences, and lasting artist growth. Empowering music executives with actionable insights and next-gen tools. This is where record labels, musicians, and managers start to build on Recoup AI technology like chat, tasks, agents, and more.

​
Base URL

All API requests should be made to: 
https://api.recoupable.com/api

​
Authentication

Most API endpoints are authenticated using an API key passed in the x-api-key header. The only exceptions are the agent onboarding endpoints — POST /api/agents/signup and POST /api/agents/verify — which are intentionally unauthenticated so agents can obtain their first API key.
  1. Navigate to the API Keys Management Page
  2. Sign in with your account
  3. Create a new API key and copy it immediately (it’s only shown once)
curl -X GET "https://api.recoupable.com/api/artists?accountId=YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY"
Keep your API key secure. Do not share it publicly or commit it to version control.

​
Get Started

Agent Signup

Get an API key in one curl call. The fastest path for AI agents — no dashboard required.

Quickstart

Get your API key and make your first request in minutes.

CLI

Install and use the Recoup CLI to interact with the platform from your terminal.

MCP Server

Connect Recoup to AI assistants via the Model Context Protocol.

​
API Sections

The API is organized into six main sections. Use these links to jump to the right area.

Research

30 endpoints for artist research: search, lookup, profile, metrics, audience, cities, similar artists, playlists, albums, tracks, career history, insights, genres, festivals, web presence, and more.

Content Creation

Generate images, videos, and captions. Transcribe audio, edit content, upscale media, analyze videos, manage templates, and estimate costs.

Chat

Conversations with artist context. Create, stream, and generate messages. Copy messages, delete trailing messages, and manage chat history.

Social Media

Spotify, Instagram, X (Twitter), and generic social scraping. Search artists, scrape profiles and comments, track trends, and manage OAuth connectors.

Releases

Songs, catalogs, and task management. Analyze songs, manage catalog collections, and schedule recurring tasks with cron-based automation.

Accounts

Accounts, organizations, workspaces, subscriptions, pulses, notifications, sandboxes, and admin tools.

​
Agents

Content Agent

Content creation agent accessible via Slack. Generates images, videos, and captions for artists automatically.

Authentication

API key authentication, account-scoped access, and organization-level permissions.

​
Quick Reference for LLMs

If you are an LLM navigating these docs, here is a summary of the endpoint structure:
  • /api/artists/* — Artist management (list, create, socials, socials-scrape, profile)
  • /api/research/* — Artist research (search, lookup, profile, metrics, audience, cities, similar, urls, instagram-posts, playlists, albums, track, tracks, career, insights, genres, festivals, web, deep, people, extract, enrich, milestones, venues, rank, charts, radio, discover, curator, playlist)
  • /api/content/* — Content creation (create, generate-image, generate-video, generate-caption, transcribe-audio, edit, upscale, analyze-video, templates, validate, estimate)
  • /api/chat/* — Chat (chats, artist, messages, messages-copy, messages-trailing-delete, create, update, delete, generate, stream, compact)
  • /api/songs/* — Songs and catalogs (songs, create, analyze, analyze-presets, catalogs, catalogs-create, catalogs-delete, catalog-songs, catalog-songs-add, catalog-songs-delete)
  • /api/tasks/* — Task automation (get, create, update, delete, runs)
  • /api/spotify/* — Spotify (search, artist, artist-albums, artist-top-tracks, album)
  • /api/instagram/* — Instagram (comments, profiles)
  • /api/x/* — X/Twitter (search, trends)
  • /api/connectors/* — OAuth connectors (list, authorize, disconnect)
  • /api/accounts/* — Accounts (get, id, create, update, add-artist)
  • /api/organizations/* — Organizations (list, create, add-artist)
  • /api/sandboxes/* — Sandboxes (list, create, snapshot, delete, setup, file, upload)
  • /api/content-agent/* — Content agent webhooks (webhook, callback)
  • /api/agents/* — Agent onboarding (signup, verify) — no auth required
Base URL: https://api.recoupable.com/api OpenAPI Specification

​
Need Help?

Contact Support

Reach out to our team at agent@recoupable.com for assistance with the Recoup API.