> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nephia.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Reddit post by id

> Costs 2 credits. Post only — use /comments for the thread.



## OpenAPI

````yaml /openapi.json get /v1/reddit/posts/{id}
openapi: 3.1.0
info:
  title: Nephia API
  description: >-
    B2B API for structured data from live Sources (Vinted, X, Reddit).
    Authenticate with an API key on your Account. Pull endpoints charge credits
    per request. Watches poll on an interval and deliver webhook events. Product
    request quota is per Account (all API keys share one bucket), by Plan: Free
    60/min, Starter 350/min, Growth 700/min, Pro 1,200/min. Credit packs do not
    raise the quota.
  version: 1.0.0
servers:
  - url: https://api.nephia.cc
    description: Production
  - url: http://localhost:3000
    description: Local
security:
  - ApiKeyAuth: []
tags:
  - name: Account
    description: Account balance
  - name: Vinted — Search
    description: Vinted catalog search
  - name: Vinted — Items
    description: Vinted listing detail
  - name: Vinted — Users
    description: Vinted sellers and wardrobes
  - name: Vinted — Reference
    description: Vinted filter metadata
  - name: Vinted — Watches
    description: Vinted watches, events, and activity
  - name: X — Tweets
    description: Tweet lookup, replies, thread, quotes, and engagers
  - name: X — Users
    description: X profiles, timelines, and social graphs
  - name: X — Search
    description: Tweet search
  - name: X — Lists
    description: X list timelines
  - name: X — Trends
    description: Trend places and snapshots
  - name: X — Watches
    description: X watches, events, and activity
  - name: Reddit — Search
    description: Reddit post, subreddit, and user search
  - name: Reddit — Posts
    description: Reddit posts, comments, duplicates, and trending
  - name: Reddit — Subreddits
    description: Subreddit profiles, listings, and rules
  - name: Reddit — Users
    description: Reddit user profiles and activity
  - name: Reddit — Watches
    description: Reddit watches, events, and activity
paths:
  /v1/reddit/posts/{id}:
    get:
      tags:
        - Reddit — Posts
      summary: Get a Reddit post by id
      description: Costs 2 credits. Post only — use /comments for the thread.
      operationId: getV1RedditPostsById
      parameters:
        - in: path
          name: id
          schema:
            type: string
            minLength: 1
          required: true
      responses:
        '200':
          description: Post detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  fullname:
                    type: string
                  title:
                    type: string
                  selftext:
                    type: string
                  selftextHtml:
                    type:
                      - string
                      - 'null'
                  url:
                    type: string
                  permalink:
                    type: string
                  domain:
                    type: string
                  author:
                    type: object
                    properties:
                      id:
                        type:
                          - string
                          - 'null'
                      username:
                        type: string
                      fullname:
                        type:
                          - string
                          - 'null'
                    required:
                      - id
                      - username
                  authorFlairText:
                    type:
                      - string
                      - 'null'
                  subreddit:
                    type: string
                  subredditPrefixed:
                    type: string
                  subredditId:
                    type:
                      - string
                      - 'null'
                  subredditSubscribers:
                    type:
                      - number
                      - 'null'
                  score:
                    type: number
                  ups:
                    type: number
                  upvoteRatio:
                    type:
                      - number
                      - 'null'
                  numComments:
                    type: number
                  numCrossposts:
                    type:
                      - number
                      - 'null'
                  gilded:
                    type:
                      - number
                      - 'null'
                  totalAwards:
                    type:
                      - number
                      - 'null'
                  awards:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        count:
                          type: number
                        iconUrl:
                          type:
                            - string
                            - 'null'
                      required:
                        - id
                        - name
                        - count
                        - iconUrl
                  createdAt:
                    type: string
                  editedAt:
                    type:
                      - string
                      - 'null'
                  isNsfw:
                    type: boolean
                  isSelf:
                    type: boolean
                  isSpoiler:
                    type: boolean
                  isLocked:
                    type: boolean
                  isStickied:
                    type: boolean
                  isArchived:
                    type: boolean
                  isOriginalContent:
                    type: boolean
                  isVideo:
                    type: boolean
                  isGallery:
                    type: boolean
                  distinguished:
                    type:
                      - string
                      - 'null'
                  removedByCategory:
                    type:
                      - string
                      - 'null'
                  linkFlairText:
                    type:
                      - string
                      - 'null'
                  linkFlairBackgroundColor:
                    type:
                      - string
                      - 'null'
                  linkFlairTextColor:
                    type:
                      - string
                      - 'null'
                  linkFlairTemplateId:
                    type:
                      - string
                      - 'null'
                  thumbnail:
                    type:
                      - string
                      - 'null'
                  previewImages:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        width:
                          type: number
                        height:
                          type: number
                      required:
                        - url
                        - width
                        - height
                  media:
                    type: 'null'
                  galleryData:
                    type: 'null'
                required:
                  - id
                  - fullname
                  - title
                  - selftext
                  - selftextHtml
                  - url
                  - permalink
                  - domain
                  - author
                  - authorFlairText
                  - subreddit
                  - subredditPrefixed
                  - subredditId
                  - subredditSubscribers
                  - score
                  - ups
                  - upvoteRatio
                  - numComments
                  - numCrossposts
                  - gilded
                  - totalAwards
                  - awards
                  - createdAt
                  - editedAt
                  - isNsfw
                  - isSelf
                  - isSpoiler
                  - isLocked
                  - isStickied
                  - isArchived
                  - isOriginalContent
                  - isVideo
                  - isGallery
                  - distinguished
                  - removedByCategory
                  - linkFlairText
                  - linkFlairBackgroundColor
                  - linkFlairTextColor
                  - linkFlairTemplateId
                  - thumbnail
                  - previewImages
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '404':
          description: Post not found, removed, or subreddit unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '429':
          description: >-
            Request quota exceeded. Retry after the `Retry-After` header
            (seconds). Response includes `RateLimit-*` headers (IETF draft-7).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
              example:
                error: Rate limit exceeded
                code: TOO_MANY_REQUESTS
        '503':
          description: Upstream temporarily unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created from the Nephia dashboard for your Account.

````