List shares of a post

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

---

Returns a paginated list of shares of the specified post, including both plain reshares and quote shares. Authentication is optional.

GET /api/v1/posts/{postId}/shares

List shares of a post

cURL

curl --request GET \
  --url https://public-api.etoro.com/api/v1/posts/{postId}/shares \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>'

200

{
  "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

apiKeyAuth & userKeyAuthoauth2

x-api-key · string · header · default: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663 · required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key · string · header · default: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_ · required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Headers

x-request-id · string<uuid> · required

A unique request identifier.

Example:

"f2f07c7a-0635-4b0f-a6ce-6da4a7cbe3b1"

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

200

application/json

Paginated list of shares

Paginated list of shares on a post

paging · object

Pagination info

Show child attributes

postShares · object[]

List of share entries

Show child attributes