Social Feeds
Get a single post by ID
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.
Retrieves a single discussion post by its ID, including comments preview, emotions data, and requester context. Authentication is optional — unauthenticated requests receive the post without personalised requester context.
get/api/v1/posts/{postId}
Request
- Base URLhttps://public-api.etoro.com
- AuthOAuth 2Authorization codeScopesetoro-public:feed:read
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
postIdstring uuid required
ID of the post to retrieve (UUID)
Query parameters
takeinteger
Number of inline comments to include in the response
badgesExperimentIsEnabledboolean
Flag indicating whether to include user badges in the response
Headers
x-request-idstring uuid required
Example:508839a7-1f29-4489-868f-711dec21cfad
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
Post retrieved successfully
Example response
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"post": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"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
},
"obsoleteId": "12345",
"message": {
"text": "Excited about $TSLA earnings next week!",
"languageCode": "en"
},
"created": "2025-01-15T10:30:00Z",
"updated": "2025-01-16T08:00:00Z",
"type": "Default",
"editStatus": "None",
"attachments": [
{
"url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
"title": "Tesla Q4 Earnings Chart",
"host": "cdn.etoro.com",
"description": "Tesla quarterly earnings breakdown",
"mediaType": "Image",
"media": {
"image": {
"width": 1200,
"height": 630,
"url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
},
"video": {
"videoSourceId": "dQw4w9WgXcQ",
"videoSource": "YouTube",
"image": {
"width": 1280,
"height": 720,
"url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
}
}
}
}
],
"tags": [
{
"market": {
"id": "TSLA",
"symbolName": "TSLA",
"displayName": "Tesla",
"updated": "2025-01-15T00:00:00Z",
"assetType": "Stocks",
"internalId": 59114,
"avatar": {
"small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
"medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
"large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
"svg": {
"url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
"backgroundColor": "#CC0000",
"textColor": "#FFFFFF"
}
},
"application": "eToro",
"metadata": "{}",
"assetTypeId": 10,
"assetTypeSubCategoryId": 101
}
}
],
"mentions": [
{
"user": {
"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
},
"isDirect": true
}
],
"metadata": {
"marketEvent": {
"earningReportId": 1042,
"market": {
"id": "TSLA",
"symbolName": "TSLA",
"displayName": "Tesla",
"updated": "2025-01-15T00:00:00Z",
"assetType": "Stocks",
"internalId": 59114,
"avatar": {
"small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
"medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
"large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
"svg": {
"url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
"backgroundColor": "#CC0000",
"textColor": "#FFFFFF"
}
},
"application": "eToro",
"metadata": "{}",
"assetTypeId": 10,
"assetTypeSubCategoryId": 101
},
"stocksIndustryId": 15,
"earningsDate": "2025-01-15T10:30:00Z",
"isBeforeMarketOpen": true,
"earningsYear": 2025,
"earningsQuarter": 1,
"verified": true,
"marketCap": 800000000000,
"estimatedEps": 1.42,
"estimatedSales": 25000000000,
"tagName": "Reports",
"textKey": 3
},
"trade": {
"type": "Open",
"positionId": 987654321,
"market": {
"id": "TSLA",
"symbolName": "TSLA",
"displayName": "Tesla",
"updated": "2025-01-15T00:00:00Z",
"assetType": "Stocks",
"internalId": 59114,
"avatar": {
"small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
"medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
"large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
"svg": {
"url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
"backgroundColor": "#CC0000",
"textColor": "#FFFFFF"
}
},
"application": "eToro",
"metadata": "{}",
"assetTypeId": 10,
"assetTypeSubCategoryId": 101
},
"gain": 12.5,
"rate": 245.3,
"direction": "Long"
},
"order": {
"type": "Open",
"orderId": 123456789,
"market": {
"id": "TSLA",
"symbolName": "TSLA",
"displayName": "Tesla",
"updated": "2025-01-15T00:00:00Z",
"assetType": "Stocks",
"internalId": 59114,
"avatar": {
"small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
"medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
"large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
"svg": {
"url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
"backgroundColor": "#CC0000",
"textColor": "#FFFFFF"
}
},
"application": "eToro",
"metadata": "{}",
"assetTypeId": 10,
"assetTypeSubCategoryId": 101
},
"rate": 240,
"direction": "Long"
},
"copy": {
"type": "Start",
"user": {
"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
}
},
"poll": {
"id": 55,
"title": "Where do you see $TSLA by year-end?",
"gcid": 7890,
"options": [
{
"id": 1,
"index": 1,
"text": "Bullish",
"votesCount": 128
}
]
},
"article": {
"id": 9001,
"title": "Why TSLA Could Hit $500 This Year",
"url": "https://etoro.com/news/markets/articles/why-tsla-could-hit-500",
"rating": "Bullish",
"featuredImage": {
"url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
"title": "Tesla Q4 Earnings Chart",
"host": "cdn.etoro.com",
"description": "Tesla quarterly earnings breakdown",
"mediaType": "Image",
"media": {
"image": {
"width": 1200,
"height": 630,
"url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
},
"video": {
"videoSourceId": "dQw4w9WgXcQ",
"videoSource": "YouTube",
"image": {
"width": 1280,
"height": 720,
"url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
}
}
}
},
"body": "<p>Tesla has shown strong fundamentals...</p>",
"bodyPreview": "Tesla has shown strong fundamentals this quarter...",
"aiSummary": "Analyst argues Tesla's pipeline supports a $500 target by year-end.",
"languageCode": "en",
"status": "Published",
"editStatus": "None",
"ownerId": 7890,
"created": "2025-01-15T10:30:00Z",
"updated": "2025-01-16T08:00:00Z",
"published": "2025-01-16T09:00:00Z",
"readingTimeMinutes": 3.5,
"wordCount": 750
}
}
},
"commentsData": {
"reactionPaging": {
"totalCount": 14
},
"comments": [
{
"entity": {
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"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
},
"obsoleteId": "98765",
"created": "2025-01-15T10:30:00Z",
"updated": "2025-01-15T11:00:00Z",
"message": {
"text": "Excited about $TSLA earnings next week!",
"languageCode": "en"
},
"attachments": [
{
"url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
"title": "Tesla Q4 Earnings Chart",
"host": "cdn.etoro.com",
"description": "Tesla quarterly earnings breakdown",
"mediaType": "Image",
"media": {
"image": {
"width": 1200,
"height": 630,
"url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
},
"video": {
"videoSourceId": "dQw4w9WgXcQ",
"videoSource": "YouTube",
"image": {
"width": 1280,
"height": 720,
"url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
}
}
}
}
],
"mentions": [
{
"user": {
"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
},
"isDirect": true
}
],
"tags": [
{
"market": {
"id": "TSLA",
"symbolName": "TSLA",
"displayName": "Tesla",
"updated": "2025-01-15T00:00:00Z",
"assetType": "Stocks",
"internalId": 59114,
"avatar": {
"small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
"medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
"large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
"svg": {
"url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
"backgroundColor": "#CC0000",
"textColor": "#FFFFFF"
}
},
"application": "eToro",
"metadata": "{}",
"assetTypeId": 10,
"assetTypeSubCategoryId": 101
}
}
],
"editStatus": "None",
"parent": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"obsoleteId": "12345",
"type": "Post"
}
},
"repliesCount": 2,
"emotionsData": {
"like": {
"paging": {
"totalCount": 42,
"offsetEntityId": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
"next": "/api/v1/reactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/emotions?offset=10&take=10"
},
"emotions": [
{
"type": "Like",
"id": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
"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
},
"obsoleteId": "54321",
"parent": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"obsoleteId": "12345",
"type": "Post"
},
"created": "2025-01-15T10:30:00Z"
}
]
}
}
}
]
},
"emotionsData": {
"like": {
"paging": {
"totalCount": 42,
"offsetEntityId": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
"next": "/api/v1/reactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/emotions?offset=10&take=10"
},
"emotions": [
{
"type": "Like",
"id": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
"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
},
"obsoleteId": "54321",
"parent": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"obsoleteId": "12345",
"type": "Post"
},
"created": "2025-01-15T10:30:00Z"
}
]
}
},
"requesterContext": {
"isLiking": true,
"isFollowing": true
},
"summary": {
"totalCommentsAndReplies": 14,
"sharedCount": 3
},
"reason": {
"type": "followed-user",
"sourceId": "7890",
"owner": "johndoe"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.