ETetoro
Social Feeds

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

Request

Path parameters

postIdstring uuid required

ID of the post to list shares of (UUID)

Query parameters

takeinteger

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

offsetEntityIdstring

Opaque cursor from a previous response for stable paging

order'Asc' | 'Desc'

Sort order

client_request_idstring uuid required

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

Headers

x-request-idstring uuid required
Example:ba06fc93-93e0-431b-bb8b-fa8b4757d657

A unique request identifier.

x-api-keystring password required
Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required
Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

Response

Paginated list of shares

Example response

{
  "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"
        ],
        "countryCode": 840
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.