Artist Social Scrape API

Kick off scraping jobs for all social profiles linked to an artist. Provide an artist_account_id, and the API will look up the artist’s socials (see Get Artist Socials) and invoke the Social Scrape API for each social_id. Each scrape returns Apify run metadata so you can poll for status and retrieve results.

Endpoint

POST https://api.recoupable.com/api/artist/socials/scrape

Parameters

Name	Type	Required	Description
artist_account_id	string	Yes	UUID of the artist account to scrape socials

Request Examples

cURL

curl -X POST "https://api.recoupable.com/api/artist/socials/scrape" \
  -H "Content-Type: application/json" \
  -d '{
    "artist_account_id": "1873859c-dd37-4e9a-9bac-80d35a1b2c3d"
  }'

Response Format

[
  {
    "runId": "abc123xyz",
    "datasetId": "def456uvw",
    "error": null
  },
  {
    "runId": "ghi789rst",
    "datasetId": "uvw123lmn",
    "error": null
  }
]

Response Properties

Property	Type	Description
runId	string	Unique identifier for the Apify run
datasetId	string	Unique identifier for the dataset containing scraped data
error	string	Error message if the run failed (null if successful)

Notes

This endpoint orchestrates multiple calls to the Social Scrape API, one for each social tied to the artist.
The number of items returned equals the number of social profiles attached to the artist.
Use the Apify Scraper Results API to monitor progress and download scraped results.
Scrape completion times depend on platform rate limits; results may not appear immediately.