Skip to main content
GET
/
api
/
v1
/
posts
/
{postId}
/
shares
List shares of a post
curl --request GET \
  --url https://public-api.etoro.com/api/v1/posts/{postId}/shares \
  --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>'
{
  "paging": {
    "totalCount": 17,
    "offsetEntityId": "c3d4e5f6-a7b8-4901-cdef-345678901234",
    "next": "/api/v1/feeds/post/d9020c00-c364-11ee-8080-80005148990b/shares?take=20&offsetEntityId=c3d4e5f6-a7b8-4901-cdef-345678901234"
  },
  "postShares": [
    {
      "shareReactionId": "e5f6a7b8-c9d0-4123-efab-567890123456",
      "createdAt": "2025-01-15T10:30:00Z",
      "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
      }
    }
  ]
}

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:

"cbb3f2d8-458a-441b-a6c6-5b16656474f3"

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 list shares of (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 a previous response for stable paging

order
enum<string>
default:Desc

Sort order

Available options:
Asc,
Desc
client_request_id
string<uuid>
required

Client-generated correlation ID (UUID). Required for request tracing and idempotency.

Response

Paginated list of shares

Paginated list of shares on a post

paging
object

Pagination info

postShares
object[]

List of share entries