Get Artist Posts

Retrieve all social media posts from an artist across all platforms.

Endpoint

GET https://api.recoupable.com/api/posts

Parameters

Name	Type	Required	Description
artist_account_id	string	Yes	The unique identifier of the artist account to fetch posts for
page	number	No	The page number to retrieve (default: 1)
limit	number	No	The number of records per page (default: 20, max: 100)

Request Examples

cURL

curl -X GET "https://api.recoupable.com/api/posts?artist_account_id=YOUR_ARTIST_ACCOUNT_ID&page=1&limit=20" \
  -H "Content-Type: application/json"

Response Format

The API returns JSON responses. Here's an example success response:

{
  "status": "success",
  "posts": [
    {
      "id": "post123",
      "post_url": "https://twitter.com/artist/status/123456789",
      "updated_at": "2024-03-06T15:33:27Z"
    },
    {
      "id": "post456",
      "post_url": "https://instagram.com/p/abc123",
      "updated_at": "2024-03-05T18:22:15Z"
    }
  ],
  "pagination": {
    "total_count": 42,
    "page": 1,
    "limit": 20,
    "total_pages": 3
  }
}

Response Properties

Response Object

Property	Type	Description
status	string	Status of the request ("success" or "error")
posts	array	List of posts from the artist across all social platforms
posts[].id	string	Unique identifier for the post
posts[].post_url	string	Direct URL to the post on the social platform
posts[].updated_at	string	ISO timestamp of when the post was last updated
pagination	object	Pagination metadata for the response
pagination.total_count	number	Total number of records available
pagination.page	number	Current page number
pagination.limit	number	Number of records per page
pagination.total_pages	number	Total number of pages available