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

Maximum number of recent posts to include in each scrape dataset, with per-post engagement metrics. On X/Twitter this returns the account's latest posts timeline items — including retweets and replies — each with like, retweet, reply, quote, bookmark, and view counts. On YouTube the depth applies per content type, so each dataset contains up to posts videos plus posts Shorts, each with view, like, and comment counts. On LinkedIn it returns the profile's latest posts posts, each with like, comment, and share counts and a reaction-type breakdown. Other platforms ignore this field. When omitted, each scrape returns the legacy profile snapshot (a single latest item).

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)