> ## 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.

# Get Artist Posts

> Retrieve all social media posts from an artist across all platforms. This endpoint aggregates posts from all connected social media profiles for the specified artist. Supports pagination for large post collections.



## OpenAPI

````yaml api-reference/openapi/social.json GET /api/artists/{id}/posts
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/artists/{id}/posts:
    get:
      description: >-
        Retrieve all social media posts from an artist across all platforms.
        This endpoint aggregates posts from all connected social media profiles
        for the specified artist. Supports pagination for large post
        collections.
      parameters:
        - name: id
          in: path
          description: The unique identifier of the artist account to fetch posts for
          required: true
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          description: 'The page number to retrieve (default: 1)'
          required: false
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: 'The number of records per page (default: 20, max: 100)'
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
      responses:
        '200':
          description: Artist posts retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtistPostsResponse'
        '400':
          description: Bad request - invalid or missing `id` path parameter format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtistPostsErrorResponse'
        '401':
          description: Unauthorized - missing or invalid credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtistPostsErrorResponse'
        '403':
          description: Forbidden - caller does not have access to this artist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtistPostsErrorResponse'
        '404':
          description: Artist not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtistPostsErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtistPostsErrorResponse'
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    ArtistPostsResponse:
      type: object
      required:
        - status
        - posts
        - pagination
      properties:
        status:
          type: string
          enum:
            - success
          description: Status of the request
        posts:
          type: array
          items:
            $ref: '#/components/schemas/ArtistPost'
          description: List of posts from the artist across all social platforms
        pagination:
          $ref: '#/components/schemas/ArtistPostsPagination'
          description: Pagination metadata for the response
    ArtistPostsErrorResponse:
      type: object
      required:
        - status
        - error
      properties:
        status:
          type: string
          enum:
            - error
          description: Status of the request
        error:
          type: string
          description: Error message describing what went wrong
    ArtistPost:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the post
        post_url:
          type: string
          description: Direct URL to the post on the social platform
        updated_at:
          type: string
          format: date-time
          description: ISO timestamp of when the post was last updated
    ArtistPostsPagination:
      type: object
      properties:
        total_count:
          type: integer
          description: Total number of posts available
        page:
          type: integer
          description: Current page number
        limit:
          type: integer
          description: Number of posts per page
        total_pages:
          type: integer
          description: Total number of pages available
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Recoup API key. [Learn more](/quickstart#api-keys).
    bearerAuth:
      type: http
      scheme: bearer

````