Skip to main content
GET
/
api
/
v1
/
posts
/
{postId}
Get a single post by ID
curl --request GET \
  --url https://public-api.etoro.com/api/v1/posts/{postId} \
  --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>'
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "post": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "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": "12345",
    "message": {
      "text": "Excited about $TSLA earnings next week!",
      "languageCode": "en"
    },
    "created": "2025-01-15T10:30:00Z",
    "updated": "2025-01-16T08:00:00Z",
    "type": "Default",
    "isDeleted": false,
    "isSpam": false,
    "editStatus": "None",
    "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"
            }
          }
        }
      }
    ],
    "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
        }
      }
    ],
    "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
      }
    ],
    "metadata": {
      "share": {
        "sharedPost": "<unknown>",
        "sharedOriginPost": "<unknown>"
      },
      "marketEvent": {
        "earningReportId": 1042,
        "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
        },
        "stocksIndustryId": 15,
        "earningsDate": "2025-01-15T10:30:00Z",
        "isBeforeMarketOpen": true,
        "earningsYear": 2025,
        "earningsQuarter": 1,
        "verified": true,
        "marketCap": 800000000000,
        "estimatedEps": 1.42,
        "estimatedSales": 25000000000,
        "tagName": "Reports",
        "textKey": 3
      },
      "trade": {
        "type": "Open",
        "positionId": 987654321,
        "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
        },
        "gain": 12.5,
        "rate": 245.3,
        "direction": "Long"
      },
      "order": {
        "type": "Open",
        "orderId": 123456789,
        "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
        },
        "rate": 240,
        "direction": "Long"
      },
      "copy": {
        "type": "Start",
        "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
        }
      },
      "poll": {
        "id": 55,
        "title": "Where do you see $TSLA by year-end?",
        "gcid": 7890,
        "options": [
          {
            "id": 1,
            "index": 1,
            "text": "Bullish",
            "isUserVoted": false,
            "votesCount": 128
          }
        ]
      },
      "article": {
        "id": 9001,
        "title": "Why TSLA Could Hit $500 This Year",
        "url": "https://etoro.com/news/markets/articles/why-tsla-could-hit-500",
        "rating": "Bullish",
        "featuredImage": {
          "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"
              }
            }
          }
        },
        "body": "<p>Tesla has shown strong fundamentals...</p>",
        "bodyPreview": "Tesla has shown strong fundamentals this quarter...",
        "aiSummary": "Analyst argues Tesla's pipeline supports a $500 target by year-end.",
        "languageCode": "en",
        "status": "Published",
        "editStatus": "None",
        "ownerId": 7890,
        "created": "2025-01-15T10:30:00Z",
        "updated": "2025-01-16T08:00:00Z",
        "published": "2025-01-16T09:00:00Z",
        "readingTimeMinutes": 3.5,
        "wordCount": 750
      }
    }
  },
  "commentsData": {
    "reactionPaging": {
      "totalCount": 14
    },
    "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
        }
      }
    ]
  },
  "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": true,
    "isSaved": false,
    "isPinned": false,
    "isRequesterBlocking": false,
    "isInteractionRestricted": false,
    "isFollowing": true
  },
  "summary": {
    "totalCommentsAndReplies": 14,
    "sharedCount": 3
  },
  "reason": {
    "type": "followed-user",
    "sourceId": "7890",
    "owner": "johndoe"
  }
}

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:

"43d64148-cd2c-469e-8337-5d66a5105394"

​
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 post to retrieve (UUID)

Query Parameters

​
take
integer<int32>
default:10

Number of inline comments to include in the response

Required range: x >= 0
​
badgesExperimentIsEnabled
boolean
default:false

Flag indicating whether to include user badges in the response

Response

Post retrieved successfully

A single discussion entry in a feed — wraps a Post with its interaction data

​
id
string

Discussion wrapper ID (same as post ID)

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

​
post
object

Post data embedded inside a Discussion feed item

​
commentsData
object

Inline comments preview

​
emotionsData
object

Aggregated emotions (likes) on an entity

​
requesterContext
object

Requester's relationship state with the post

​
summary
object

Post-level engagement counters

​
reason
any | null

Why this post appears in the feed (ForYou only). May be null or an object: { type: 'followed-user'|'instrument-trending', sourceId, owner }

Example:
{
  "type": "followed-user",
  "sourceId": "7890",
  "owner": "johndoe"
}