# Recoup API documentation

Source: https://docs.recoupable.dev/

Use the Recoup API to build your record label. Access research, content creation, chat, artist analytics, social media, and platform management endpoints.

These guides cover the authenticated music-platform API. For anonymous search,
reading, and website tools, use the separate [public website API](https://docs.recoupable.dev/public-website-api)
and its [OpenAPI specification](https://recoupable.dev/openapi.json).

## Choose a starting point

| What you want to do | Start here |
| --- | --- |
| Make your first API request | [Quickstart](https://docs.recoupable.dev/quickstart) |
| Build with Go or Python | [SDKs](https://docs.recoupable.dev/sdks) |
| Work from a terminal | [CLI](https://docs.recoupable.dev/cli) |
| Connect an AI assistant | [MCP server](https://docs.recoupable.dev/mcp-server) and [Connect an agent](https://docs.recoupable.dev/mcp-oauth) |
| Search or read the public website without an account | [Website API](https://docs.recoupable.dev/public-website-api) |
| Find an endpoint and its request format | [API overview](https://docs.recoupable.dev/api-reference) |

## Connect your account

For an AI host, start with [MCP OAuth](https://docs.recoupable.dev/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](https://chat.recoupable.dev/keys), or
follow the [verified email/PIN flow](https://docs.recoupable.dev/agents). 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](https://docs.recoupable.dev/authentication) for supported credentials and follow each endpoint’s authentication requirements. [Agent signup](https://docs.recoupable.dev/api-reference/agents/signup) and [email verification](https://docs.recoupable.dev/api-reference/agents/verify) are unauthenticated onboarding operations.

1. Navigate to the [API Keys Management Page](https://chat.recoupable.dev/keys)
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"
```

> **Warning**
> Keep your API key secure. Do not share it publicly or commit it to version control.

## Tools & clients

[Agent signup](https://docs.recoupable.dev/agents)

Verify your email and obtain a separate REST API key.

[Quickstart](https://docs.recoupable.dev/quickstart)

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

[CLI](https://docs.recoupable.dev/cli)

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

[Claude](https://docs.recoupable.dev/claude)

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

[MCP](https://docs.recoupable.dev/mcp-server)

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](https://docs.recoupable.dev/api-reference/research/search)

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

[Content creation](https://docs.recoupable.dev/api-reference/content/create)

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

[Chat](https://docs.recoupable.dev/api-reference/chat/chats)

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

[Social media](https://docs.recoupable.dev/api-reference/social/scrape)

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

[Catalog](https://docs.recoupable.dev/api-reference/songs/songs)

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

[Accounts](https://docs.recoupable.dev/api-reference/accounts/get)

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

[Release players](https://docs.recoupable.dev/essentials/release-player)

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

## Agents

[Content Agent](https://docs.recoupable.dev/content-agent)

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

[Authentication](https://docs.recoupable.dev/authentication)

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

## Read with an agent

- [Documentation index](https://docs.recoupable.dev/llms.txt): all guides and endpoints, grouped by topic, with links to Markdown.
- [Full documentation](https://docs.recoupable.dev/llms-full.txt): the complete documentation and operation schemas in one text file.
- [API overview](https://docs.recoupable.dev/api-reference): 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](mailto:agent@recoupable.dev)

Reach out to our team at [agent@recoupable.dev](mailto:agent@recoupable.dev) for assistance with the Recoup API.