Recoup

Get started with Recoup.

Try Our Platform

Use Recoup’s AI tools for your artists, releases, and catalog.

Build Your Platform

Our team builds custom AI software for your business.

Getting started

Build with Recoup.

Connect your music, your tools, and your AI. Guides and API documentation to help you get started.

Start building Explore the API
On this page

These guides cover the authenticated music-platform API. For anonymous search, reading, and website tools, use the separate public website API and its OpenAPI specification.

Choose a starting point

What you want to doStart here
Make your first API requestQuickstart
Build with Go or PythonSDKs
Work from a terminalCLI
Connect an AI assistantMCP server and Connect an agent
Search or read the public website without an accountWebsite API
Find an endpoint and its request formatAPI overview

Connect your account

For an AI host, start with MCP OAuth: sign in to your real account, approve the intended scope and verify access with a read. For REST integrations, create an API key in your account settings, or follow the verified email/PIN flow. Keep credentials in a secret facility. An empty roster can be valid; do not create a disposable account to recover access.

Platform base URL

Platform API requests should be made to:

bash
https://api.recoupable.dev/api

Authentication

For API-key requests, pass your key in the x-api-key header. Read Authentication for supported credentials and follow each endpoint’s authentication requirements. Agent signup and email verification are unauthenticated onboarding operations.

  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)
bash
curl -X GET "https://api.recoupable.dev/api/artists?accountId=YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY"

Tools & clients

Agent signup

Verify your email and obtain a separate REST API key.

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.

Claude

Connect Claude to Recoup through MCP OAuth, then add optional workflow skills.

MCP

Connect Recoup to AI assistants via the Model Context Protocol.

Explore the API

The API includes these major sections. Use these links to jump to the right area.

Research

Recoup artist and track discovery, current metrics, activities and playlists; web research, upcoming events, and stored play-count measurements.

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.

Catalog

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

Accounts

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

Release players

Hosted listening pages, embeddable players, event reporting and fan connections.

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.

Read with an agent

  • Documentation index: all guides and endpoints, grouped by topic, with links to Markdown.
  • Full documentation: the complete documentation and operation schemas in one text file.
  • API overview: browse endpoints by topic. Each reference includes its method, path, authentication, request, responses, and specification.
  • Page Markdown: use Copy page or View as Markdown on any page. You can also append .md to a page URL, or request it with Accept: text/markdown.

Use the exact method and path in the endpoint reference; navigation labels are summaries. Check availability notes before calling an operation. A pending or unavailable feature is not a callable endpoint. Keep anonymous website tools separate from authenticated account operations.

Need help?

Contact support

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