Get Comments

Retrieve comments associated with an artist or a specific post, with support for pagination.

Endpoint

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

Parameters

Name	Type	Required	Description
artist_account_id	string	Yes	The unique identifier of the artist account
post_id	string	No	Filter comments by specific post
page	number	No	Page number for pagination (default: 1)
limit	number	No	Number of comments per page (default: 10)

Request Examples

cURL

curl -X GET "https://api.recoupable.com/api/comments?artist_account_id=YOUR_ARTIST_ID&page=1&limit=10" \
  -H "Content-Type: application/json"
  # -H "Authorization: Bearer YOUR_API_KEY" # Coming soon

Response Format

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

{
  "status": "success",
  "comments": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "post_id": "123e4567-e89b-12d3-a456-426614174001",
      "social_id": "123e4567-e89b-12d3-a456-426614174002",
      "comment": "Great post!",
      "commented_at": "2024-03-27T12:00:00Z"
    }
  ],
  "pagination": {
    "total_count": 48,
    "page": 1,
    "limit": 10,
    "total_pages": 5
  }
}

Response Properties

Response Object

Property	Type	Description
status	string	Status of the request ("success" or "error")
comments	array	List of comment objects
comments[].id	string	UUID of the comment
comments[].post_id	string	UUID of the associated post
comments[].social_id	string	UUID of the social profile
comments[].comment	string	Comment text content
comments[].commented_at	string	Timestamp with timezone of when the comment was made
pagination	object	Pagination information
pagination.total_count	number	Total number of comments available
pagination.page	number	Current page number
pagination.limit	number	Number of comments per page
pagination.total_pages	number	Total number of pages available