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

# List Posts

> Returns Reddit posts that match your tracked keywords



## OpenAPI

````yaml GET /posts
openapi: 3.0.3
info:
  title: Mentioned API
  description: API for accessing your competitor monitoring and Reddit visibility data
  version: 1.0.0
servers:
  - url: https://mentioned.to/api/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /posts:
    get:
      summary: List posts
      description: Returns Reddit posts that match your tracked keywords
      operationId: listPosts
      parameters:
        - name: keyword_id
          in: query
          description: Filter by keyword ID
          schema:
            type: integer
        - name: subreddit
          in: query
          description: Filter by subreddit name
          schema:
            type: string
        - name: priority
          in: query
          description: Filter by priority level
          schema:
            type: string
            enum:
              - high
              - medium
              - low
        - name: answered_status
          in: query
          description: Filter by answered status
          schema:
            type: string
            enum:
              - answered
              - unanswered
        - name: has_competitors
          in: query
          description: Only posts mentioning competitors
          schema:
            type: boolean
        - name: include_archived
          in: query
          description: Include archived posts
          schema:
            type: boolean
        - name: sort_by
          in: query
          description: Sort field
          schema:
            type: string
            enum:
              - priority
              - urgency
              - date
              - score
              - comments
        - name: sort_order
          in: query
          description: Sort direction
          schema:
            type: string
            enum:
              - asc
              - desc
        - name: search
          in: query
          description: Full-text search query
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Post'
                  count:
                    type: integer
        '401':
          description: Invalid or missing API key
components:
  schemas:
    Post:
      type: object
      properties:
        id:
          type: integer
        reddit_id:
          type: string
        subreddit:
          type: string
        title:
          type: string
        selftext:
          type: string
        author:
          type: string
        url:
          type: string
        score:
          type: integer
        num_comments:
          type: integer
        created_utc:
          type: string
        permalink:
          type: string
        matched_keywords:
          type: array
          items:
            type: string
        mentioned_competitors:
          type: array
          items:
            type: string
        is_answered:
          type: boolean
        archived:
          type: boolean
        skipped:
          type: boolean
        priority:
          type: string
          enum:
            - high
            - medium
            - low
          nullable: true
        urgency:
          type: string
          enum:
            - urgent
            - not_urgent
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key from Settings > API. Format: `rm_live_xxx`'

````