BUILD WITH RECOUP
The Recoup API.
Artist data, research, content creation, and the tools to connect them. Find the endpoint you need and start building.
On this page
Artists
GETGet Artists
/api/artistsGETGet Artist Profile/api/artists/{id}/profilePOSTCreate Artist/api/artistsPATCHUpdate Artist/api/artists/{id}POSTPin Artist/api/artists/{id}/pinDELETEUnpin Artist/api/artists/{id}/pinDELETEDelete Artist/api/artists/{id}GETGet Artist Socials/api/artists/{id}/socialsDELETEDelete Artist Social/api/artists/{id}/socials/{socialId}GETGet Artist Fans/api/artists/{id}/fansChats
POSTStream Chat
/api/chatGETResume Chat Stream/api/chat/{chatId}/streamPOSTStart Chat Run/api/chat/runsGETGet Chat Run Status/api/chat/runs/{runId}POSTStop Chat/api/chat/{chatId}/stopPOSTCreate Chat/api/chatsGETGet Chats/api/chatsGETGet Chat Artist/api/chats/{id}/artistPATCHUpdate Chat/api/chatsDELETEDelete Chat/api/chatsPOSTCompact Chats/api/chats/compactGETList Models/api/ai/modelsGETGet Chat Messages/api/chats/{id}/messagesPOSTCopy Chat Messages/api/chats/{id}/messages/copyDELETEDelete Trailing Chat Messages/api/chats/{id}/messages/trailingResearch
POSTArtist Events
/api/research/eventsGETTrack Stats/api/research/track/statsGETTrack measurements/api/research/tracks/{id}/measurementsGETAlbum measurements/api/research/albums/{id}/measurementsPOSTCreate measurement job/api/research/measurement-jobsPOSTWeb Search/api/research/webPOSTDeep Research/api/research/deepPOSTPeople Search/api/research/peoplePOSTExtract URL/api/research/extractPOSTEnrich/api/research/enrichCatalog
GETGet Songs
/api/songsPOSTCreate Songs/api/songsPOSTAnalyze Songs/api/songs/analyzeGETList Analyze Presets/api/songs/analyze/presetsGETGet Catalogs/api/accounts/{id}/catalogsPOSTCreate Catalog/api/catalogsPATCHRename Catalog/api/catalogs/{catalogId}DELETEDelete Catalog/api/catalogs/{catalogId}POSTRun Valuation/api/valuationGETGet Runs/api/runsGETGet Catalog Measurements/api/catalogs/{catalogId}/measurementsGETGet Catalog Valuations/api/catalogs/{catalogId}/valuationsGETGet Catalog Songs/api/catalogs/songsPOSTAdd Catalog Songs/api/catalogs/songsDELETERemove Catalog Songs/api/catalogs/songsContent
POSTCreate Content
/api/content/createPOSTGenerate Image/api/content/imagePOSTGenerate Video/api/content/videoPOSTGenerate Caption/api/content/captionPOSTTranscribe Audio/api/content/transcribePATCHEdit Content/api/contentPOSTUpscale Content/api/content/upscalePOSTAnalyze Video/api/content/analyzeGETList Templates/api/content/templatesGETGet Template Detail/api/content/templates/{id}GETValidate Artist/api/content/validateGETEstimate Cost/api/content/estimateGETGenerate Image/api/image/generatePOSTTranscribe Audio/api/transcribePOSTGenerate Music/api/musicGETList Music Generations/api/musicGETGet Music Generation/api/music/{generationId}GETGet Artist Posts/api/artists/{id}/postsGETGet Comments/api/commentsAgents & Sandboxes
POSTAgent Signup
/api/agents/signupPOSTVerify Agent Email/api/agents/verifyGETList Templates/api/agents/templatesPOSTCreate Template/api/agents/templatesPATCHUpdate Template/api/agents/templates/{id}DELETEDelete Template/api/agents/templates/{id}PUTFavorite Template/api/agents/templates/{id}/favoriteGETGet Tasks/api/tasksPOSTCreate Task/api/tasksPATCHUpdate Task/api/tasksDELETEDelete Task/api/tasksGETGet Task Runs/api/tasks/runsPOSTSlack Webhook/api/content-agent/{platform}POSTTask Callback/api/content-agent/callbackGETList Sandboxes/api/sandboxesPOSTCreate Sandbox/api/sandboxesPATCHUpdate Snapshot/api/sandboxesDELETEDelete Sandbox/api/sandboxesPOSTSetup Sandbox/api/sandboxes/setupGETGet File Contents/api/sandboxes/filePOSTStage File/api/sandboxes/staged-filePOSTUpload Files/api/sandboxes/filesPOSTCreate Session/api/sessionsGETGet Session/api/sessions/{sessionId}PATCHUpdate Session/api/sessions/{sessionId}GETList Session Chats/api/sessions/{sessionId}/chatsPOSTCreate Session Chat/api/sessions/{sessionId}/chatsGETGet Session Chat/api/sessions/{sessionId}/chats/{chatId}PATCHUpdate Session Chat/api/sessions/{sessionId}/chats/{chatId}DELETEDelete Session Chat/api/sessions/{sessionId}/chats/{chatId}POSTMark Chat Read/api/sessions/{sessionId}/chats/{chatId}/readPOSTCreate or restore session sandbox/api/sandboxGETGet session sandbox status/api/sandbox/statusGETReconnect to session sandbox/api/sandbox/reconnectAccounts
GETGet Account ID
/api/accounts/idGETGet Account/api/accounts/{id}POSTCreate Account/api/accountsPATCHUpdate Account/api/accountsPOSTAdd Artist to Account/api/accounts/artistsPOSTCreate Subscription Session/api/subscriptions/sessionsPOSTClaim Subscription/api/subscriptions/claimGETGet Account Subscription/api/accounts/{id}/subscriptionPOSTCreate Billing Portal Session/api/accounts/{id}/portalGETGet Default Payment Method/api/accounts/{id}/payment-methodPOSTSave a Payment Method/api/accounts/{id}/payment-methodDELETERemove the Payment Method/api/accounts/{id}/payment-methodGETList Account Payments/api/accounts/{id}/paymentsGETGet Auto Top-up Settings/api/accounts/{id}/auto-top-upPUTUpdate Auto Top-up Settings/api/accounts/{id}/auto-top-upPOSTCreate Credits Top-Up Session/api/credits/sessionsGETGet Account Credits/api/accounts/{id}/creditsGETGet Account Usage/api/accounts/{id}/usagePATCHUpdate Pulse/api/pulsesGETList Pulses/api/pulsesGETGet Organizations/api/organizationsPOSTCreate Organization/api/organizationsPOSTAdd Artist to Organization/api/organizations/artistsPOSTAdd Member to Organization/api/organizations/membersDELETERemove Member from Organization/api/organizations/membersGETList Organization Domains/api/organizations/domainsPOSTAdd Organization Domain/api/organizations/domainsDELETERemove Organization Domain/api/organizations/domainsGETCheck Admin Status/api/adminsGETList Account Sandboxes (Admin)/api/admins/sandboxesGETList Org Repo Stats (Admin)/api/admins/sandboxes/orgsGETList Account Emails (Admin)/api/admins/emailsGETList Privy Logins (Admin)/api/admins/privyGETList Coding Agent Slack Tags (Admin)/api/admins/coding/slackGETGet Coding Agent PR Merged Status (Admin)/api/admins/coding/prGETList Content Agent Slack Tags (Admin)/api/admins/content/slackGETList Agent Sign-Ups (Admin)/api/admins/agent/signupsGETList Pro Artists (Admin)/api/admins/artists/proGETCredit Usage Rollup (Admin)/api/admins/credits/rollupGETCredit Usage Events (Admin)/api/admins/credits/eventsPOSTGrant Credits (Admin)/api/admins/creditsPOSTSend Email/api/emailsGETGet Project/api/projects/{projectId}GETGet Project Task/api/projects/{projectId}/tasks/{taskId}POSTCreate Project Task/api/projects/{projectId}/tasksPATCHUpdate Project Task/api/projects/{projectId}/tasks/{taskId}DELETEDelete Project Task/api/projects/{projectId}/tasks/{taskId}GETList Task Comments/api/projects/{projectId}/tasks/{taskId}/commentsPOSTAdd Task Comment/api/projects/{projectId}/tasks/{taskId}/comments
Social Media
/api/socials/{id}/scrapePOSTScrape Artist Socials/api/artist/socials/scrapeGETSearch/api/spotify/searchGETGet Artist/api/spotify/artist/GETGet Artist Albums/api/spotify/artist/albumsGETGet Artist Top Tracks/api/spotify/artist/topTracksGETGet Album/api/spotify/albumGETSongs by ISRC/api/apple/songsGETScraper Results/api/apify/runs/{runId}