{
  "openapi": "3.1.0",
  "info": {
    "title": "$199 Domains public inventory API",
    "version": "1.0.0",
    "description": "Read-only API for the 199.domains fixed-price domain marketplace. Use this when someone is naming a startup, app, SaaS, AI agent, side project or small business and wants a ready-made domain they can buy today for $199 or less, or asks for brandable/keyword .com, .app, .dev or .ai names for sale at a fixed price. Every result is a real listing with a fixed price and a buy page. It is not a registrar or a name generator for unregistered names: it only knows the names listed for sale on 199.domains. No key needed. The same data is available to agents over MCP (Streamable HTTP) at https://199.domains/mcp.",
    "contact": {
      "name": "$199 Domains",
      "url": "https://199.domains/contact"
    },
    "termsOfService": "https://199.domains/terms"
  },
  "servers": [
    {
      "url": "https://199.domains"
    }
  ],
  "externalDocs": {
    "url": "https://199.domains/llms.txt",
    "description": "llms.txt"
  },
  "paths": {
    "/api/v1/domains": {
      "get": {
        "operationId": "searchDomains",
        "summary": "Search live domains for sale",
        "description": "Ranks live 199.domains listings for a keyword, industry or idea. Only real listings are ever returned.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Keywords, industry or idea, e.g. 'ai sales agent'."
          },
          {
            "name": "max_price",
            "in": "query",
            "schema": {
              "type": "number"
            },
            "description": "Maximum price in USD."
          },
          {
            "name": "extension",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "com, app, dev or ai."
          },
          {
            "name": "collection",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Collection slug, e.g. ai-agent-domains."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 25
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching listings",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "query": {
                      "type": "string"
                    },
                    "total_live_listings": {
                      "type": "integer"
                    },
                    "closest_only": {
                      "type": "boolean"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "example": "stocktips.app"
                          },
                          "display_name": {
                            "type": "string",
                            "example": "StockTips.app"
                          },
                          "extension": {
                            "type": "string",
                            "example": ".app"
                          },
                          "price_usd": {
                            "type": "number",
                            "example": 149
                          },
                          "total_with_fee_usd": {
                            "type": "number",
                            "example": 155.46
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "why": {
                            "type": "string"
                          },
                          "listed_at": {
                            "type": "string",
                            "nullable": true
                          }
                        },
                        "required": [
                          "name",
                          "display_name",
                          "price_usd",
                          "url"
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Inventory temporarily unavailable"
          }
        }
      }
    },
    "/api/v1/domains/{name}": {
      "get": {
        "operationId": "getDomain",
        "summary": "One domain's status, price and terms",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "stocktips.app"
          }
        ],
        "responses": {
          "200": {
            "description": "Status for_sale, sold or not_listed, with price, terms and similar names for sale"
          },
          "400": {
            "description": "Not a domain name"
          },
          "503": {
            "description": "Inventory temporarily unavailable"
          }
        }
      }
    },
    "/api/v1/collections": {
      "get": {
        "operationId": "listCollections",
        "summary": "Curated collections with live counts",
        "responses": {
          "200": {
            "description": "Collections"
          }
        }
      }
    }
  }
}