Skip to main content
POST
cURL

Path Parameters

id
string<uuid>
required

The unique identifier (UUID) of the social profile to scrape. Obtain this from the Get Artist Socials API.

Query Parameters

posts
integer

Recent-post depth. 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, so pass it whenever you need post history. Every returned post is stored with its engagement counts. See the per-platform table above.

Required range: 1 <= x <= 100
subtitles
boolean
default:false

YouTube only. When true, the scrape also downloads each returned video's captions (auto-generated captions preferred, English, plain text). The transcript is returned on the run's dataset items as subtitles[0].plaintext and is not persisted; read it from Scraper Results while the run's dataset is available. Ignored on every other platform. Adds no credits beyond the posts price.

Response

Scrape job 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)