# Recoup ## Docs - [Get Account](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/accounts/get.md): Retrieve detailed account information by ID. Returns the account with associated profile info, emails, and wallet addresses. - [Get Account ID](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/accounts/id.md): Retrieve the ID of the authenticated account associated with the provided credentials. This is useful when you have an API key or access token but do not yet know the corresponding accountId. - [Scraper Results](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/apify/scraper.md): Check the status and retrieve results from Apify scraper runs. This endpoint uses the Apify API Client to fetch the current status of a scraper run and its results if available. Use the runId returned from endpoints like Instagram Comments, Instagram Profiles, Social Scrape, or Artist Socials Scrape… - [Get Artist Profile](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/artist/profile.md): Retrieve comprehensive profile information for an artist across all connected social media platforms, including profile details and post metrics. - [Get Artist Segments](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/artist/segments.md): Retrieve all segments associated with an artist. This endpoint should be called before using the Segment Fans endpoint to obtain the necessary segment IDs. Supports pagination. - [Get Artist Socials](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/artist/socials.md): Retrieve all social media profiles associated with an artist. This endpoint should be called before using the Social Posts endpoint to obtain the necessary social IDs. - [Socials scrape](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/artist/socials-scrape.md): Trigger scrape jobs for all social profiles linked to an artist. Provide an artist_account_id, and the API will look up the artist's socials and invoke a scraping job for each social profile. Each scrape returns Apify run metadata so you can poll for status and retrieve results. - [Create Artist](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/artists/create.md): Create a new artist account. The artist can optionally be linked to an organization. - [Get Artists](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/artists/list.md): Retrieve artists accessible to an account. Supports filtering by organization or showing only personal (non-organization) artists. - [Get Chats](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/chat/chats.md): Retrieve chat rooms (conversations) for a specific account. Provide an account_id to scope the results, and optionally filter by an artist_account_id. The endpoint returns metadata about each room, including the topic, associated artist, and last updated timestamp. - [Create](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/chat/create.md): Create a new chat room. Optionally associate it with an artist and/or provide a client-generated chat ID. Organization API keys can create chats on behalf of other accounts within their organization by specifying an accountId. - [Generate Chat](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/chat/generate.md): Generate AI-powered text responses using the Recoup chat system. This endpoint processes chat requests and returns generated text along with metadata about the generation process. - [Stream Chat](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/chat/stream.md): Stream AI-powered chat responses using the Recoup chat system. This endpoint mirrors the request payload of the Chat Generate API but returns a streaming response compatible with the Vercel AI SDK `createUIMessageStreamResponse`. The stream emits UI message parts encoded as data chunks that can be p… - [Get Comments](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/comments/get.md): Retrieve comments associated with an artist or a specific post, with support for pagination. This endpoint returns raw comment data including the comment text, associated post, and commenter's social profile reference. - [Get Artist Fans](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/fans/get.md): Retrieve all social profiles from fans of an artist across all platforms. This endpoint aggregates fan data from all connected social media platforms. Supports pagination for large fan lists. - [Generate Image](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/image/generation.md): Generate high-quality images using AI models. Images are automatically stored on Arweave and include In Process moment metadata for provenance and ownership tracking. - [Comments](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/instagram/comments.md): Fetch Instagram comments for multiple post URLs using Apify's Instagram Comment Scraper. The actual comment data will be available in the Apify dataset after the run completes. - [Profiles](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/instagram/profiles.md): Fetch Instagram profile information for multiple handles using Apify's Instagram Profile Scraper. The actual profile data will be available in the Apify dataset after the run completes. - [Introduction](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/introduction.md): API documentation for the Recoup platform - AI agents for the music industry - [Add Artist to Organization](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/organizations/add-artist.md): Add an artist to an organization. This allows organization members to access and manage the artist. This endpoint is idempotent - calling it multiple times with the same artistId and organizationId will not create duplicate records. - [Create Organization](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/organizations/create.md): Create a new organization. The creator is automatically added as a member of the organization. - [Get Organizations](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/organizations/list.md): Retrieve all organizations that an account belongs to. Used for organization selector dropdowns and access control. - [Get Post Comments](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/post/comments.md): Retrieve comments for a specific social media post. This endpoint should be called after obtaining post IDs from the Social Posts endpoint. Returns detailed information about each commenter including their profile data, follower counts, and geographic region. - [Get Artist Posts](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/posts/get.md): Retrieve all social media posts from an artist across all platforms. This endpoint aggregates posts from all connected social media profiles for the specified artist. Supports pagination for large post collections. - [Get Segment Fans](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/segment/fans.md): Retrieve all social profiles from fans within a specific segment. This endpoint should be called after obtaining segment IDs from the Artist Segments endpoint. Supports pagination for large fan lists. - [Get Social Posts](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/social/posts.md): Retrieve all social media posts from a specific social profile. Call the Artist Socials endpoint first to obtain social IDs. - [Social Scrape](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/social/scrape.md): Trigger a social profile scraping job for a given social_id. Use the Get Artist Socials endpoint first to retrieve the social_id values. The response returns Apify run metadata for polling status and retrieving results via the Apify Scraper Results API. - [Get Catalog Songs](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/songs/catalog-songs.md): Retrieve songs within a specific catalog with pagination support. This endpoint joins catalog_songs with songs, song_artists, and accounts to provide comprehensive song information for a given catalog. - [Add Catalog Songs](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/songs/catalog-songs-add.md): Batch add songs to a catalog by ISRC. For each song, the API attempts to look up metadata via internal search. If no data is found, optional fallback fields (name, album, notes, artists) are used. - [Remove Catalog Songs](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/songs/catalog-songs-delete.md): Batch remove songs from a catalog by ISRC. Deletes the relationship in catalog_songs for each catalog_id and ISRC pair. - [Get Catalogs](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/songs/catalogs.md): Retrieve catalogs associated with a specific account. The endpoint joins account_catalogs with catalogs to return catalog metadata for the specified account. - [Create Catalogs](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/songs/catalogs-create.md): Create new catalogs or link existing catalogs to an account. If catalog_id is provided, links the existing catalog. If name is provided without catalog_id, creates a new catalog. If both are provided, catalog_id takes priority. - [Delete Catalogs](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/songs/catalogs-delete.md): Unlink catalogs from an account. If no other accounts are linked to a catalog after removal, the catalog is automatically deleted (cascading to catalog_songs). Otherwise, only the account-catalog relationship is removed. - [Create Songs](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/songs/create.md): Bulk create or fetch songs by ISRC. For each song, the API attempts to look up metadata via internal search. If no data is found, optional fallback fields (name, album, notes, artists) are used. - [Get Songs](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/songs/songs.md): Retrieve songs from the database with optional filtering by ISRC (International Standard Recording Code) or artist account. This endpoint joins the songs table with song_artists and accounts tables to provide comprehensive song information. - [Get Album](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/spotify/album.md): Get Spotify catalog information for a single album. - [Get Artist](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/spotify/artist.md): Get Spotify catalog information for a single artist identified by their unique Spotify ID. - [Get Artist Albums](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/spotify/artist-albums.md): Get Spotify catalog information about an artist's albums. - [Get Artist Top Tracks](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/spotify/artist-top-tracks.md): Get an artist's top tracks by country. - [Search](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/spotify/search.md): Search for artists, albums, tracks, and playlists using the Spotify API. This endpoint is a proxy to the official Spotify Search API. - [Get Subscriptions](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/subscriptions/get.md): Retrieve subscription information for an account. For accounts with enterprise plans, returns a simplified response indicating enterprise status. For standard accounts, returns the full Stripe subscription object. - [Create Task](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/tasks/create.md): Create a new scheduled task. All fields are required. The response shape matches the GET endpoint (an array containing the created task). - [Delete Task](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/tasks/delete.md): Delete an existing scheduled task by its ID. Returns the status of the delete operation. - [Get Tasks](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/tasks/get.md): Retrieve scheduled tasks from the database. Tasks have cron-based execution schedules. Supports filtering by id, account_id, or artist_account_id. - [Update Task](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/tasks/update.md): Update an existing scheduled task. Only the id field is required; any additional fields you include will be updated on the task. The response shape matches the GET endpoint (an array containing the updated task). - [Transcribe Audio](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/transcribe/audio.md): Transcribe audio files using OpenAI Whisper. The API saves both the original audio file and the generated markdown transcript to the customer's files in Supabase Storage. - [Search Tweets](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/x/search.md): Search for tweets using the Twitter Search API, powered by agent-twitter-client (no Twitter API key required). Supports various search modes including Top, Latest, Photos, Videos, and Users. - [Get Trends](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/x/trends.md): Retrieve the current trending topics from Twitter using the getTrends method from agent-twitter-client (no Twitter API key required). - [Recoup API Documentation](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/index.md): Use the Recoup API to build your record label. - [Quickstart](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/quickstart.md): Get your API key and make your first request to the Recoup API. ## OpenAPI Specs - [openapi](https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/api-reference/openapi.json) ## Optional - [Recoup App](https://chat.recoupable.com) - [Website](https://recoupable.com) - [Blog](https://research.recoupable.com/)