v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB
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}

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

idstring

Discussion wrapper ID (same as post ID)

{"stackTrail":"components:schemas:Discussion:properties:reason","oasType":"schema","type":"unknown","description":"Why this post appears in the feed (ForYou only). May be null or an object: { type: 'followed-user'|'instrument-trending', sourceId, owner }","example":{"type":"followed-user","sourceId":"7890","owner":"johndoe"},"nullable":true}