Share 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.
Creates a share post that references an existing post. Two variants are supported:
- Reshare — send
messageas an empty string (""). - Quote share — send
messagewith your commentary text.
Returns 201 on success. See the request body for field-level semantics, including how to collapse share chains.
Authorizations
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
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
A unique request identifier.
"3a1c2044-ad72-42cf-952d-d2c7819c6f3c"
Body
Share payload.
message(required) — set to""for a reshare, or to your commentary text for a quote share. Must be present; cannot be null.sharedOriginDiscussion(required) — the ID of the post being shared.sharedDiscussionId(optional) — set this only whensharedOriginDiscussionitself points to a share. It collapses the chain so the created Post'smetadata.share.sharedPostrefers tosharedDiscussionIdandmetadata.share.sharedOriginPostrefers tosharedOriginDiscussion, giving readers a flat 2-level reference instead of recursing through the share history. Leave unset for first-level shares.
Request body for sharing a post. Both message and sharedOriginDiscussion are required. Use message = "" for a reshare or a non-empty message for a quote share.
Required. Set to "" (empty string) for a reshare, or to the commentary text for a quote share. Cannot be null or omitted.
""
Required. ID of the post being shared.
"d9020c00-c364-11ee-8080-80005148990b"
Optional. Only set this when sharedOriginDiscussion itself points to a share — it identifies the intermediate share, so the created Post's metadata.share.sharedPost is set to this post and metadata.share.sharedOriginPost to sharedOriginDiscussion, collapsing the chain to a 2-level reference in subsequent reads. Leave unset for first-level shares.
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
List of attachments for a post or comment (request body format)
Response
Share post created
A feed post returned by create / update / get-by-ID
Unique post ID
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
eToro user profile (slim projection)
Legacy numeric post ID
"12345"
Creation timestamp
"2025-01-15T10:30:00Z"
Post/comment text content
Last-edited timestamp
"2025-01-16T08:00:00Z"
True when the post has been soft-deleted
false
Post type
Default, Share, MarketEvent, Trade, Order, Copy, Poll, Article "Default"
Post type–specific metadata — only the relevant key is populated
True when the post is classified as spam
false
Edit lifecycle status
None, Edited, Moderated "None"