MSP Software Posts API

openapi: 3.2.0
info:
  title: MSP Software Posts API
  version: 1.0.0
  description: 'Read-only JSON API for MSP Software: categories, software listings and vendors. No authentication, no writes, no PII, no individual price reports.


    The same data reaches machines four other ways: an MCP server at https://mspsoftware.net/mcp (Streamable HTTP, read-only), a short index at https://mspsoftware.net/llms.txt, every listing in one file at https://mspsoftware.net/llms-full.txt, and one listing as Markdown at https://mspsoftware.net/software/{slug}.md.


    Human documentation, with the feeds, is at https://mspsoftware.net/api.


    Facts, feature checklists, buyer guides, FAQ answers, aggregate ratings and reported-pricing aggregates on MSP Software may be quoted with attribution to MSP Software and a link to the page cited. Reviews are the reviewers'' own words and are not covered.'
  contact:
    email: contact@mspsoftware.net
servers:
- url: https://mspsoftware.net/api/v1
security: []
tags:
- name: Posts
paths:
  /posts:
    get:
      summary: List published blog posts, newest first
      operationId: listPosts
      responses:
        '200':
          description: Every published blog post.
          content:
            application/json:
              schema:
                type: object
                required:
                - data
                - meta
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PostSummary'
                  meta:
                    type: object
                    properties: {}
      tags:
      - Posts
  /posts/{slug}:
    get:
      summary: Get one published blog post
      operationId: getPost
      parameters:
      - name: slug
        in: path
        required: true
        description: 'A slug: the name in lower case with hyphens.'
        schema:
          type: string
      responses:
        '200':
          description: The post with its body as Markdown.
          content:
            application/json:
              schema:
                type: object
                required:
                - data
                - meta
                properties:
                  data:
                    $ref: '#/components/schemas/Post'
                  meta:
                    type: object
                    properties: {}
        '404':
          description: No resource at that slug.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Posts
components:
  schemas:
    Post:
      type: object
      title: Post
      description: A published blog post with its body as Markdown.
      properties:
        slug:
          type: string
        title:
          type: string
        description:
          type: string
        author:
          type:
          - string
          - 'null'
        url:
          type: string
          format: uri
        published_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        body_markdown:
          type: string
    Error:
      type: object
      title: Error
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              examples:
              - not_found
            message:
              type: string
    PostSummary:
      type: object
      title: PostSummary
      description: A published blog post, without its body.
      properties:
        slug:
          type: string
        title:
          type: string
        description:
          type: string
        author:
          type:
          - string
          - 'null'
        url:
          type: string
          format: uri
        published_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
externalDocs:
  description: API documentation
  url: https://mspsoftware.net/api