> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recoupable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Social Scrape

> Trigger a social profile scraping job for a given social profile. Use the [Get Artist Socials](/api-reference/artists/socials) endpoint first to retrieve the social profile id values. The response returns Apify run metadata for polling status and retrieving results via the [Apify Scraper Results API](/api-reference/apify/scraper).



## OpenAPI

````yaml api-reference/openapi/social.json POST /api/socials/{id}/scrape
openapi: 3.1.0
info:
  title: Recoup API - Social
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/socials/{id}/scrape:
    post:
      description: >-
        Trigger a social profile scraping job for a given social profile. Use
        the [Get Artist Socials](/api-reference/artists/socials) endpoint first
        to retrieve the social profile id values. The response returns Apify run
        metadata for polling status and retrieving results via the [Apify
        Scraper Results API](/api-reference/apify/scraper).
      parameters:
        - name: id
          in: path
          description: >-
            The unique identifier (UUID) of the social profile to scrape. Obtain
            this from the [Get Artist Socials](/api-reference/artists/socials)
            API.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Scrape job triggered successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApifyRunResult'
        '400':
          description: Bad request - missing required parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialErrorResponse'
components:
  schemas:
    ApifyRunResult:
      type: object
      properties:
        runId:
          type: string
          description: Unique identifier for the Apify run
        datasetId:
          type: string
          description: Unique identifier for the dataset containing scraped data
        error:
          type: string
          nullable: true
          description: Error message if the run failed (null if successful)
    SocialErrorResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - error
          description: Status of the request
        message:
          type: string
          description: Error message

````