Skip to main content
GET
/
api
/
v1
/
posts
/
{postId}
/
comments
List comments on a post
curl --request GET \
  --url https://public-api.etoro.com/api/v1/posts/{postId}/comments \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "reactionPaging": {
    "totalCount": 42,
    "offsetEntityId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "next": "/api/v1/reactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/comments?take=20&offsetEntityId=7c9e6679-7425-40de-944b-e07fc1f90ae7"
  },
  "comments": [
    {
      "entity": {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "owner": {
          "id": "7890",
          "username": "johndoe",
          "firstName": "John",
          "lastName": "Doe",
          "avatar": {
            "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
            "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
            "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
            "svg": {
              "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
              "backgroundColor": "#2196F3",
              "textColor": "#FFFFFF"
            }
          },
          "roles": [
            "Regular"
          ],
          "isBlocked": false,
          "isPrivate": false,
          "countryCode": 840,
          "piLevel": 0
        },
        "obsoleteId": "98765",
        "created": "2025-01-15T10:30:00Z",
        "updated": "2025-01-15T11:00:00Z",
        "message": {
          "text": "Excited about $TSLA earnings next week!",
          "languageCode": "en"
        },
        "attachments": [
          {
            "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
            "title": "Tesla Q4 Earnings Chart",
            "host": "cdn.etoro.com",
            "description": "Tesla quarterly earnings breakdown",
            "mediaType": "Image",
            "media": {
              "image": {
                "width": 1200,
                "height": 630,
                "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
              },
              "video": {
                "videoSourceId": "dQw4w9WgXcQ",
                "videoSource": "YouTube",
                "image": {
                  "width": 1280,
                  "height": 720,
                  "url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
                }
              }
            }
          }
        ],
        "mentions": [
          {
            "user": {
              "id": "7890",
              "username": "johndoe",
              "firstName": "John",
              "lastName": "Doe",
              "avatar": {
                "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
                "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
                "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
                "svg": {
                  "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
                  "backgroundColor": "#2196F3",
                  "textColor": "#FFFFFF"
                }
              },
              "roles": [
                "Regular"
              ],
              "isBlocked": false,
              "isPrivate": false,
              "countryCode": 840,
              "piLevel": 0
            },
            "isDirect": true
          }
        ],
        "tags": [
          {
            "market": {
              "id": "TSLA",
              "symbolName": "TSLA",
              "displayName": "Tesla",
              "updated": "2025-01-15T00:00:00Z",
              "assetType": "Stocks",
              "internalId": 59114,
              "avatar": {
                "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
                "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
                "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
                "svg": {
                  "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
                  "backgroundColor": "#CC0000",
                  "textColor": "#FFFFFF"
                }
              },
              "application": "eToro",
              "metadata": "{}",
              "assetTypeId": 10,
              "assetTypeSubCategoryId": 101
            }
          }
        ],
        "isSpam": false,
        "editStatus": "None",
        "parent": {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "obsoleteId": "12345",
          "type": "Post"
        }
      },
      "repliesCount": 2,
      "replies": "<array>",
      "emotionsData": {
        "like": {
          "paging": {
            "totalCount": 42,
            "offsetEntityId": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
            "next": "/api/v1/reactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/emotions?offset=10&take=10"
          },
          "emotions": [
            {
              "type": "Like",
              "id": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
              "owner": {
                "id": "7890",
                "username": "johndoe",
                "firstName": "John",
                "lastName": "Doe",
                "avatar": {
                  "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
                  "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
                  "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
                  "svg": {
                    "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
                    "backgroundColor": "#2196F3",
                    "textColor": "#FFFFFF"
                  }
                },
                "roles": [
                  "Regular"
                ],
                "isBlocked": false,
                "isPrivate": false,
                "countryCode": 840,
                "piLevel": 0
              },
              "obsoleteId": "54321",
              "parent": {
                "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                "obsoleteId": "12345",
                "type": "Post"
              },
              "created": "2025-01-15T10:30:00Z"
            }
          ]
        }
      },
      "requesterContext": {
        "isOwner": false,
        "isFlaggingAsSpam": false,
        "isSubscribed": false,
        "isLiking": false,
        "isSaved": false,
        "isPinned": false,
        "isRequesterBlocking": false,
        "isInteractionRestricted": false
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

eToro OAuth2. Each operation lists the scopes that grant access as separate security requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. The same scopes back the x-api-key/x-user-key credential pair.

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"ad9f6e34-90d8-491f-bef8-8b326acbb53f"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Path Parameters

​
postId
string<uuid>
required

ID of the parent post (UUID)

Query Parameters

​
take
integer
default:20

Number of items to return (1–100, default 20)

Required range: 1 <= x <= 100
​
offsetEntityId
string

Opaque cursor from previous response for stable paging

​
order
enum<string>
default:Desc

Sort order

Available options:
Asc,
Desc
​
badgesExperimentIsEnabled
boolean
default:false

Include user badges in the response

Response

Paginated comment list

Paginated list of comments or replies on a parent entity

​
reactionPaging
object

Pagination info

​
comments
object[]

List of comment/reply items