> ## Documentation Index > Fetch the complete documentation index at: https://docs.xpoz.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Reddit posts by IDs (live) > Fetch up to 100 Reddit posts by ID in one call. IDs Reddit does not return are omitted from the results. Always returns `has_more: false`. Fetches directly from the platform. Not available for trial access keys. ## OpenAPI ````yaml https://api.xpoz.ai/openapi.json get /api/data/reddit/posts/ids/live openapi: 3.1.0 info: title: XPOZ API version: 1.0.0 description: >- Social media data API for Twitter/X, Instagram, Reddit, and TikTok. **Data endpoints** (`/api/data/*`) are authenticated with an API access key and are metered against the account's credits. Most stored-data endpoints share the same query options: `fields` selects which attributes to return, `since`/`until` bound the date range, and `responseType` picks between a synchronous first page (`fast`), a full paged query run as a background operation (`paging`), and a CSV export (`csv`). `/live` endpoints fetch from the platform on demand and page with a cursor instead. **Account, billing, and crawl-settings endpoints** are used by the XPOZ dashboard and authenticate with the user's session. servers: - url: https://api.xpoz.ai description: Production security: [] tags: - name: Twitter (live) description: >- On-demand Twitter/X fetches straight from the platform, cursor-paginated. Not available for trial access keys. - name: Instagram (live) description: >- On-demand Instagram fetches straight from the platform, cursor-paginated. Not available for trial access keys. - name: Reddit (live) description: >- On-demand Reddit fetches straight from the platform, cursor-paginated. Not available for trial access keys. - name: TikTok (live) description: >- On-demand TikTok fetches straight from the platform, cursor-paginated. Not available for trial access keys. - name: Operations description: Polling for background operations started with `responseType=paging`. - name: Account description: Access keys, plan, and usage of the signed-in user. - name: Billing description: Stripe checkout, subscription changes, and add-on purchases. - name: Crawl Settings description: Tracked items collected on a schedule. - name: System Status description: Platform status page and notifications. - name: Platform description: Health, metrics, and this spec. paths: /api/data/reddit/posts/ids/live: get: tags: - Reddit (live) summary: Get Reddit posts by IDs (live) description: >- Fetch up to 100 Reddit posts by ID in one call. IDs Reddit does not return are omitted from the results. Always returns `has_more: false`. Fetches directly from the platform. Not available for trial access keys. operationId: getDataRedditPostsIdsLive parameters: - name: ids in: query required: true description: >- Comma-separated post IDs (base-36, without the `t3_` prefix), up to 100. style: form explode: false schema: type: array maxItems: 100 items: type: string - $ref: '#/components/parameters/RedditPostFields' responses: '200': description: Results. content: application/json: schema: $ref: '#/components/schemas/CursorResponse' '400': description: Validation failed. content: application/json: schema: $ref: '#/components/schemas/SimpleError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/TrialForbidden' default: $ref: '#/components/responses/DataRouteError' security: - AccessKey: [] components: parameters: RedditPostFields: name: fields in: query required: false description: >- Reddit post fields to return. Comma-separated. Allowed values: id, title, selftext, url, permalink, postUrl, thumbnail, authorId, authorUsername, subredditName, subredditId, score, upvotes, downvotes, upvoteRatio, commentsCount, crosspostsCount, isSelf, isVideo, isOriginalContent, over18, spoiler, locked, stickied, archived, linkFlairText, postHint, domain, crosspostParent, createdAt, createdAtTimestamp, createdAtDate, selftextHtml, editedAt, removal. style: form explode: false schema: type: array items: type: string enum: - id - title - selftext - url - permalink - postUrl - thumbnail - authorId - authorUsername - subredditName - subredditId - score - upvotes - downvotes - upvoteRatio - commentsCount - crosspostsCount - isSelf - isVideo - isOriginalContent - over18 - spoiler - locked - stickied - archived - linkFlairText - postHint - domain - crosspostParent - createdAt - createdAtTimestamp - createdAtDate - selftextHtml - editedAt - removal schemas: CursorResponse: type: object properties: results: type: array items: type: object additionalProperties: true description: Entity shaped by the requested `fields`. count: type: integer dataSource: $ref: '#/components/schemas/DataSource' has_more: type: boolean next_page_cursor: anyOf: - type: string - type: 'null' required: - results - count - dataSource - has_more - next_page_cursor description: >- Envelope for on-demand `/live` endpoints: one provider page plus a cursor. SimpleError: type: object properties: success: type: boolean const: false message: type: string required: - success - message DataSource: type: string enum: - database - api - hybrid description: Where the results came from. TrialForbidden: type: object properties: success: type: boolean const: false code: type: string enum: - on_demand_not_available_in_trial message: type: string required: - success - code - message DataRouteError: type: object properties: success: type: boolean const: false message: type: string description: Endpoint-specific label, e.g. `Failed to retrieve Twitter posts`. error: type: string description: Detail. `An unexpected error occurred` for unhandled failures. required: - success - message - error responses: Unauthorized: description: Missing or invalid credentials. content: application/json: schema: $ref: '#/components/schemas/SimpleError' TrialForbidden: description: On-demand search is not available for trial access keys. content: application/json: schema: $ref: '#/components/schemas/TrialForbidden' DataRouteError: description: >- The request could not be fulfilled. Status is 400 for an empty or invalid search query, 402 when CSV export is blocked by plan limits, 500 otherwise. content: application/json: schema: $ref: '#/components/schemas/DataRouteError' securitySchemes: AccessKey: type: http scheme: bearer description: >- XPOZ API access key, created from the dashboard or `POST /api/tokens`. Send as `Authorization: Bearer `. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.