{
  "openapi": "3.1.0",
  "info": {
    "title": "Sellfy website: machine-readable resources",
    "version": "1.0.0",
    "summary": "Plain-text and structured files published by sellfy.com for AI agents and crawlers.",
    "description": "sellfy.com is the marketing website of Sellfy, an e-commerce platform for creators selling digital products, subscriptions, physical goods and print-on-demand merchandise. This document lists the read-only, unauthenticated resources the website publishes for automated clients: an llms.txt site summary, Markdown copies of key pages, the XML sitemap and the blog RSS feed. It does not describe the Sellfy seller dashboard or storefront APIs. Unknown paths return an HTML 404 page that links to the sitemap, llms.txt and this document.",
    "termsOfService": "https://sellfy.com/terms/",
    "contact": {
      "name": "Sellfy Help Center",
      "url": "https://docs.sellfy.com/"
    }
  },
  "externalDocs": {
    "description": "AI-readable site summary (llms.txt)",
    "url": "https://sellfy.com/llms.txt"
  },
  "servers": [
    {
      "url": "https://sellfy.com",
      "description": "Production website"
    }
  ],
  "tags": [
    { "name": "Discovery", "description": "Files that describe the site and what it offers." },
    { "name": "Content", "description": "Page content in Markdown." },
    { "name": "Feeds", "description": "Sitemaps and syndication feeds." }
  ],
  "paths": {
    "/llms.txt": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getLlmsTxt",
        "summary": "AI-readable site summary",
        "description": "Site overview in the llms.txt format: a short description of Sellfy followed by curated links to product pages, help articles, free tools and legal pages.",
        "responses": {
          "200": {
            "description": "The llms.txt document.",
            "content": {
              "text/plain": {
                "schema": { "type": "string" },
                "example": "# Sellfy\n\n> Sellfy is an e-commerce platform for creators to sell digital products...\n\n## Main site\n\n- [Homepage](https://sellfy.com): Overview of the platform."
              }
            }
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getOpenApi",
        "summary": "This OpenAPI document",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1 description of the machine-readable resources.",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/index.md": {
      "get": {
        "tags": ["Content"],
        "operationId": "getHomepageMarkdown",
        "summary": "Homepage in Markdown",
        "description": "Plain-text version of https://sellfy.com/ : positioning, what you can sell, features, support, pricing summary and FAQs. The HTML homepage advertises this file with a `<link rel=\"alternate\" type=\"text/markdown\">` tag.",
        "responses": {
          "200": {
            "description": "Markdown document.",
            "content": {
              "text/markdown": {
                "schema": { "$ref": "#/components/schemas/MarkdownPage" }
              }
            }
          },
          "404": { "$ref": "#/components/responses/NotFound" }
        }
      }
    },
    "/pricing.md": {
      "get": {
        "tags": ["Content"],
        "operationId": "getPricingMarkdown",
        "summary": "Pricing in Markdown",
        "description": "Plain-text version of https://sellfy.com/pricing/ : plans, monthly and annual prices, annual revenue limits, overage policy, trial and money-back guarantee. The HTML pricing page advertises this file with a `<link rel=\"alternate\" type=\"text/markdown\">` tag.",
        "responses": {
          "200": {
            "description": "Markdown document.",
            "content": {
              "text/markdown": {
                "schema": { "$ref": "#/components/schemas/MarkdownPage" }
              }
            }
          },
          "404": { "$ref": "#/components/responses/NotFound" }
        }
      }
    },
    "/changelog.md": {
      "get": {
        "tags": ["Content"],
        "operationId": "getChangelogMarkdown",
        "summary": "Changelog in Markdown",
        "description": "Plain-text version of https://sellfy.com/changelog/ : every Sellfy release, improvement and fix, newest first, each with its publication date and anchor URL. Generated from the changelog, so it always matches the HTML page, which advertises this file with a `<link rel=\"alternate\" type=\"text/markdown\">` tag.",
        "responses": {
          "200": {
            "description": "Markdown document.",
            "content": {
              "text/markdown": {
                "schema": { "$ref": "#/components/schemas/MarkdownPage" }
              }
            }
          },
          "404": { "$ref": "#/components/responses/NotFound" }
        }
      }
    },
    "/mcp.md": {
      "get": {
        "tags": ["Content"],
        "operationId": "getMcpMarkdown",
        "summary": "Sellfy MCP server in Markdown",
        "description": "Plain-text version of https://sellfy.com/mcp/ : connection details for the Sellfy MCP server, what a connected assistant can and cannot do, click-by-click setup for Claude, ChatGPT, Perplexity, Lovable, Replit and Mistral Le Chat, and example prompts. The HTML page advertises this file with a `<link rel=\"alternate\" type=\"text/markdown\">` tag.",
        "responses": {
          "200": {
            "description": "Markdown document.",
            "content": {
              "text/markdown": {
                "schema": { "$ref": "#/components/schemas/MarkdownPage" }
              }
            }
          },
          "404": { "$ref": "#/components/responses/NotFound" }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "tags": ["Feeds"],
        "operationId": "getSitemap",
        "summary": "XML sitemap",
        "description": "Sitemaps.org XML listing all indexable pages of sellfy.com, including localized pages and blog posts. A human-readable sitemap is at https://sellfy.com/sitemap/.",
        "responses": {
          "200": {
            "description": "Sitemap XML.",
            "content": {
              "application/xml": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/blog/rss.xml": {
      "get": {
        "tags": ["Feeds"],
        "operationId": "getBlogRss",
        "summary": "Blog RSS feed",
        "description": "RSS 2.0 feed of the Sellfy blog (English). Localized feeds live at /{lang}/blog/rss.xml for de, es, fr, it, nl and pt.",
        "responses": {
          "200": {
            "description": "RSS feed.",
            "content": {
              "application/rss+xml": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/changelog/rss.xml": {
      "get": {
        "tags": ["Feeds"],
        "operationId": "getChangelogRss",
        "summary": "Changelog RSS feed",
        "description": "RSS 2.0 feed of every Sellfy product update (English only). Each item links to its anchor on https://sellfy.com/changelog/.",
        "responses": {
          "200": {
            "description": "RSS feed.",
            "content": {
              "application/rss+xml": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "MarkdownPage": {
        "type": "string",
        "description": "UTF-8 Markdown. Starts with a level-1 heading, followed by a blockquote summary, a `Canonical page:` line pointing at the HTML version and a `_Last updated: YYYY-MM-DD_` line.",
        "example": "# Sellfy Pricing\n\n> Sellfy plans are priced by your annual sales volume, not per-transaction fees.\n\nCanonical page: https://sellfy.com/pricing/\n\n_Last updated: 2026-08-05_\n\n## Plans\n..."
      }
    },
    "responses": {
      "NotFound": {
        "description": "The path does not exist. The body is an HTML page (HTTP 404) that links to the homepage, pricing, features, blog, help center, the human-readable sitemap, sitemap.xml, llms.txt and openapi.json so a client can recover.",
        "content": {
          "text/html": {
            "schema": { "type": "string" }
          }
        }
      }
    }
  }
}
