Docs

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.

Make your first request Authentication
On this page

Artists

Chats

Research

GETResearch Search/api/researchGETLookup by URL/api/research/lookupGETArtist Profile/api/research/profileGETPlatform Metrics/api/research/metricsGETAudience Demographics/api/research/audienceGETInsights Activities/api/research/insightsGETCareer Timeline/api/research/careerGETMilestones/api/research/milestonesPOSTArtist Events/api/research/eventsGETSimilar Artists/api/research/similarGETSocial URLs/api/research/urlsGETAlbums/api/research/albumsGETTracks/api/research/tracksGETTrack/api/research/trackGETTrack Stats/api/research/track/statsGETTrack measurements/api/research/tracks/{id}/measurementsGETAlbum measurements/api/research/albums/{id}/measurementsPOSTCreate measurement job/api/research/measurement-jobsGETPlaylist Placements/api/research/playlistsGETTrack Playlists/api/research/track/playlistsPOSTWeb Search/api/research/webPOSTDeep Research/api/research/deepPOSTPeople Search/api/research/peoplePOSTExtract URL/api/research/extractPOSTEnrich/api/research/enrich

Catalog

GETGet 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}/measurementsGETCatalog Playcount History/api/catalogs/{catalogId}/playcount-historyGETGet Catalog Songs/api/catalogs/songsPOSTAdd Catalog Songs/api/catalogs/songsDELETERemove Catalog Songs/api/catalogs/songsGETDaily Catalog Streams/api/catalogs/{catalogId}/streamsGETCatalog Stream Tracking/api/catalogs/{catalogId}/stream-trackingPOSTUpdate Catalog Stream Tracking/api/catalogs/{catalogId}/stream-trackingPOSTContext Engine/api/contextPOSTStart guest context/api/context/guestGETRead guest context/api/context/guestPOSTClaim guest context/api/context/guest/claim

Content

POSTUpload a public file/api/uploadPOSTCreate 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 lipsync (release pending)/api/content/lipsyncPOSTGenerate Music/api/musicGETList Music Generations/api/musicGETGet Music Generation/api/music/{generationId}GETGet Artist Posts/api/artists/{id}/postsGETGet Comments/api/comments

Social Media

Agents & 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/reconnect

Accounts

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/domainsGETList Professional Roster/api/organizations/professionalsPOSTConfirm Professional Roster Addition/api/organizations/professionalsGETCheck 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/slackGETList Coding Agent Slack Authors (Admin)/api/admins/coding-agent/slack-tagsGETGet Coding Agent PR Merged Status (Admin)/api/admins/coding/prGETList Content Agent Slack Tags (Admin)/api/admins/content/slackGETList Agent Key Metadata (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

Connectors

Sites

Players

Additional endpoints