> ## 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.

# List posts by domain

> Costs 4 credits per page.



## OpenAPI

````yaml /openapi.json get /v1/reddit/domains/{domain}/posts
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/domains/{domain}/posts:
    get:
      tags:
        - Reddit — Posts
      summary: List posts by domain
      description: Costs 4 credits per page.
      operationId: getV1RedditDomainsByDomainPosts
      parameters:
        - in: path
          name: domain
          schema:
            type: string
            minLength: 1
          required: true
        - in: query
          name: sort
          schema:
            type: string
            enum:
              - new
              - hot
              - top
              - rising
        - in: query
          name: t
          schema:
            type: string
            enum:
              - hour
              - day
              - week
              - month
              - year
              - all
        - in: query
          name: cursor
          schema:
            type: string
        - in: query
          name: include_nsfw
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
      responses:
        '200':
          description: Domain posts
          content:
            application/json:
              schema:
                type: object
                properties:
                  posts:
                    type: array
                    items:
                      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
                  nextCursor:
                    type:
                      - string
                      - 'null'
                required:
                  - posts
                  - nextCursor
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '402':
          description: Insufficient credits
          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.

````