Social Scrape API

Trigger a social profile scraping job for a given social_id. Use the Get Artist Socials endpoint first to retrieve the social_id values you can pass here. The response returns Apify run metadata that you can use to poll for status and retrieve results via the Apify Scraper Results API.

Endpoint

POST https://api.recoupable.com/api/social/scrape

Parameters

Name	Type	Required	Description
social_id	string	Yes	UUID of the social profile to scrape. Obtain this from the Get Artist Socials API.

Request Examples

cURL

curl -X POST "https://api.recoupable.com/api/social/scrape" \
  -H "Content-Type: application/json" \
  -d '{
    "social_id": "123e4567-e89b-12d3-a456-426614174005"
  }'

Example Response

{
  "runId": "abc123xyz",
  "datasetId": "def456uvw",
  "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 triggers a background scrape job powered by Apify.
The actual social profile data is written to the Apify dataset referenced by datasetId.
Use the Apify Scraper Results API to monitor job status and retrieve data.
Scrape duration depends on platform rate limits; results may not be immediate.
Ensure you have the correct social_id by first calling Get Artist Socials.