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

# List content

> Content in one of three views, 15 per page. Requires `content:read`.

- `IDEAS`: new ideas, newest first. Filter with `sources[]`, `stages[]`, `from` and `to`.
- `PLANNED`: scheduled articles, soonest first.
- `PRODUCED`: generating, generated, published and failed articles, recently updated first. Filter with `status`.




## OpenAPI

````yaml /openapi.yaml get /content
openapi: 3.1.0
info:
  title: AeoNut API
  version: '1.0'
  description: >
    Read your workspace's AI visibility, content map and content data. Every
    response is wrapped in

    `{code, messages, data}`. Rates are fractions between 0 and 1 unless a field
    says otherwise.
servers:
  - url: https://services.deepsmith.ai/core/api/external/v1
security:
  - bearerAuth: []
  - apiKeyHeader: []
tags:
  - name: Me
  - name: Workspace
  - name: AI visibility
  - name: Content map
  - name: Content
  - name: IQ
paths:
  /content:
    get:
      tags:
        - Content
      summary: List content
      description: >
        Content in one of three views, 15 per page. Requires `content:read`.


        - `IDEAS`: new ideas, newest first. Filter with `sources[]`, `stages[]`,
        `from` and `to`.

        - `PLANNED`: scheduled articles, soonest first.

        - `PRODUCED`: generating, generated, published and failed articles,
        recently updated first. Filter with `status`.
      parameters:
        - name: mode
          in: query
          schema:
            type: string
            enum:
              - IDEAS
              - PLANNED
              - PRODUCED
            default: IDEAS
        - name: search
          in: query
          schema:
            type: string
            maxLength: 255
        - name: status
          in: query
          description: '`PRODUCED` only.'
          schema:
            type: string
            enum:
              - GENERATING
              - GENERATED
              - PUBLISHED
              - FAILED
        - name: sources[]
          in: query
          description: '`IDEAS` only. Opportunity agent slugs, or `manual`.'
          schema:
            type: array
            items:
              type: string
        - name: stages[]
          in: query
          description: '`IDEAS` only.'
          schema:
            type: array
            items:
              $ref: '#/components/schemas/BuyerStage'
        - name: from
          in: query
          description: '`IDEAS` only. Created on or after this date.'
          schema:
            type: string
            format: date
        - name: to
          in: query
          description: '`IDEAS` only. Created on or before this date.'
          schema:
            type: string
            format: date
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: Content
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Envelope'
                  - properties:
                      data:
                        type: object
                        properties:
                          contents:
                            type: array
                            description: >-
                              Content rows without `body`; GET
                              /content/{content} carries it.
                            items:
                              $ref: '#/components/schemas/Content'
                          pagination:
                            $ref: '#/components/schemas/Pagination'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/ValidationError'
components:
  schemas:
    BuyerStage:
      type: string
      enum:
        - AWARENESS
        - CONSIDERATION
        - DECISION
        - BALANCED
    Envelope:
      type: object
      properties:
        code:
          type: integer
          description: AeoNut status code
        messages:
          type: string
        data: {}
    Content:
      type: object
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        status:
          type: string
          enum:
            - NEW
            - SCHEDULED
            - GENERATING
            - GENERATED
            - PUBLISHED
            - FAILED
        buyer_stage:
          oneOf:
            - $ref: '#/components/schemas/BuyerStage'
            - type: 'null'
        source:
          type:
            - string
            - 'null'
          description: '`MANUAL`, `PROMPT_LIBRARY` or an opportunity agent slug'
        keywords:
          type:
            - array
            - 'null'
          items:
            type: string
        article_promise:
          type:
            - string
            - 'null'
        scope_boundary:
          type:
            - string
            - 'null'
        metadata:
          type:
            - object
            - 'null'
          description: Idea details
          including `run_id` for ideas from an opportunity run: null
        config:
          type: object
          properties:
            autowrite:
              type:
                - boolean
                - 'null'
            planned_for:
              type:
                - string
                - 'null'
              format: date
            planned_time:
              type:
                - string
                - 'null'
        written_on:
          type:
            - string
            - 'null'
          format: date
        published_on:
          type:
            - string
            - 'null'
          format: date-time
        body:
          type:
            - string
            - 'null'
          description: The article in markdown
          once written: null
        cover_image:
          type:
            - string
            - 'null'
        slug:
          type:
            - string
            - 'null'
        permalink:
          type:
            - string
            - 'null'
        meta_title:
          type:
            - string
            - 'null'
        meta_description:
          type:
            - string
            - 'null'
        post_url:
          type:
            - string
            - 'null'
          description: Where the article was published
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    Pagination:
      type: object
      properties:
        from:
          type:
            - integer
            - 'null'
        to:
          type:
            - integer
            - 'null'
        count:
          type: integer
        per_page:
          type: integer
        current_page:
          type: integer
        total:
          type: integer
        total_pages:
          type: integer
        next_url:
          type:
            - string
            - 'null'
        prev_url:
          type:
            - string
            - 'null'
    Scope:
      type: string
      enum:
        - workspace:read
        - visibility:read
        - contentmap:read
        - content:read
        - iq:read
  parameters:
    Page:
      name: page
      in: query
      schema:
        type: integer
        minimum: 1
        default: 1
  responses:
    Unauthorized:
      description: Missing (`code` 4021), invalid, revoked or expired (`code` 4022) API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Envelope'
          example:
            code: 4022
            messages: Invalid, revoked or expired API key.
            data: null
    Forbidden:
      description: The key lacks a required scope
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Envelope'
              - properties:
                  data:
                    type: object
                    properties:
                      required:
                        type: array
                        items:
                          $ref: '#/components/schemas/Scope'
                      missing:
                        type: array
                        items:
                          $ref: '#/components/schemas/Scope'
          example:
            code: 4023
            messages: This API key does not have the scope required for this request.
            data:
              required:
                - visibility:read
              missing:
                - visibility:read
    ValidationError:
      description: Invalid parameters
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key: `Authorization: Bearer API Key Value`'
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.