Skip to main content
POST
cURL

Authorizations

x-api-key
string
header
required

Your Recoup API key. Learn more.

Body

application/json

Artist to scrape socials for

artist_account_id
string<uuid>
required

UUID of the artist account to scrape socials for

Example:

"1873859c-dd37-4e9a-9bac-80d35a1b2c3d"

posts
integer

Recent-post depth applied to every profile in the batch. Honored on TikTok, YouTube (per content type), X and LinkedIn; ignored on Instagram (always the profile's latest posts, up to 12), Threads and Facebook. Without it TikTok, YouTube and X return a single latest item. Every returned post is stored with its engagement counts; see the per-platform table on Social Scrape. Credits: 5 + posts per profile.

Required range: 1 <= x <= 100
Example:

10

Response

Scrape jobs triggered successfully

runId
string

Unique identifier for the Apify run

datasetId
string

Unique identifier for the dataset containing scraped data

error
string | null

Error message if the run failed (null if successful)