recoup-api
Recoupable API
Call the Recoupable production API to fetch artist data, social metrics, org context, research, and to trigger platform operations.
- Base URL:
https://recoup-api.vercel.app/api - LLM-readable docs:
https://developers.recoupable.com— Mintlify site. Use/llms.txtfor the endpoint index,/llms-full.txtfor full content, and the OpenAPI JSONs listed below for machine-readable schemas.
Authentication
Your sandbox receives a short-lived access token in RECOUP_ACCESS_TOKEN. Use it as a Bearer token on every request:
curl -H "Authorization: Bearer $RECOUP_ACCESS_TOKEN" \
https://recoup-api.vercel.app/api/artists/{artistId}/socials
If RECOUP_ACCESS_TOKEN is empty, the user is not authenticated — tell them to sign in rather than retrying.
Org scoping (RECOUP_ORG_ID)
More from recoupable/skills
artist-workspace
How to work in artist directories — including creating, enumerating, and editing them. Use when creating or onboarding a new artist ("create artist", "onboard X", "add this artist", "set up a new artist") — this skill scaffolds the artist's `RECOUP.md` checklist file and drives the multi-step setup from it. Use when adding or updating artist context (identity, brand, voice, audience), adding songs, organizing files inside an artist directory, or figuring out where something belongs. Also use when the account asks inventory questions like "what artists do I have", "list my artists", "which orgs am I in", "what's in this sandbox" — the filesystem tree is the authoritative answer. And use when the account mentions an artist by name and the task involves their files, context, or content — even if they don't say "artist directory." This includes tasks like researching an artist, creating content for an artist, updating an artist's brand, or adding a face guide.
101trend-to-song
Create songs and content campaigns from trending cultural moments. Use when someone identifies a trending topic, viral moment, reality TV drama, meme, or cultural event and wants to turn it into a song and distribution strategy. Also triggers on "make a song about this trend," "capitalize on this moment," "reverse engineer from the market," "cultural moment to song," "trend-jack," or "burner page strategy." This flips the traditional music workflow — instead of song-first then marketing, you go market-first then song.
3songwriting
Guide for writing and evaluating song lyrics and concepts. Use when brainstorming song ideas, writing lyrics, evaluating song drafts, refining hooks, or improving existing songs. Applies the 7 C's framework to ensure songs are memorable, clear, and authentic.
3getting-started
Set up Recoupable from scratch — install the CLI, get an API key, and make your first call. Use this skill when the user says "set up Recoupable", "install Recoup", "get an API key", "connect to Recoup", "use Recoupable", "onboard to Recoup", "how do I start", or when an agent needs to configure itself to use the Recoupable platform.
3chartmetric
Chartmetric music analytics API for streaming data, playlist placements, audience demographics, and competitive analysis. Use when the user needs artist/track/album analytics, playlist tracking, streaming metrics, audience insights, chart positions, similar artists, or any music industry data. Triggers on requests involving Spotify followers, monthly listeners, TikTok trends, Instagram audience, playlist pitching research, or competitive artist analysis.
3streaming-growth
Strategy for growing a new or early-stage music artist to key streaming milestones on Spotify and other DSPs. Use when someone asks about getting more streams, unlocking Spotify Showcase or Marquee, increasing Spotify Popularity score, playlist pitching, DSP advertising, or growing an artist from near-zero. Triggers on "how do we get more streams," "unlock Spotify ads," "playlist push," "get to a thousand listeners," "artist growth strategy," or "Spotify Popularity score.
3