v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB

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

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
      }
    }
  ]
}