{
 "openapi": "3.0.3",
 "info": {
  "title": "AI Tool Index directory data",
  "version": "0.1.0",
  "description": "Free static endpoints; /v1/tools is a planned paid endpoint (not live)."
 },
 "paths": {
  "/api/tools.json": {
   "get": {
    "summary": "Full directory (free)",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Directory"
        }
       }
      }
     }
    }
   }
  },
  "/api/sample.json": {
   "get": {
    "summary": "10-tool sample (free)",
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/categories.json": {
   "get": {
    "summary": "Categories (free)",
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/llms-full.txt": {
   "get": {
    "summary": "Full directory as plain text (free)",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "text/plain": {}
      }
     }
    }
   }
  },
  "/api/v1/tools": {
   "get": {
    "summary": "PLANNED, not live: enriched data. Bearer API key or x402 payment.",
    "parameters": [
     {
      "name": "category",
      "in": "query",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "pricing",
      "in": "query",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "since",
      "in": "query",
      "schema": {
       "type": "string",
       "format": "date"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     },
     "402": {
      "description": "Payment required"
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "Tool": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "category": {
      "type": "string"
     },
     "pricing": {
      "type": "string",
      "enum": [
       "free",
       "freemium",
       "paid",
       "trial",
       "unknown"
      ]
     },
     "description": {
      "type": "string"
     },
     "pricing_source": {
      "type": "string",
      "nullable": true
     },
     "affiliate_url": {
      "type": "string",
      "nullable": true
     },
     "featured": {
      "type": "boolean"
     },
     "checked": {
      "type": "string",
      "format": "date"
     },
     "added": {
      "type": "string",
      "format": "date",
      "nullable": true
     },
     "details_url": {
      "type": "string"
     },
     "category_url": {
      "type": "string"
     }
    }
   },
   "Directory": {
    "type": "object",
    "properties": {
     "name": {
      "type": "string"
     },
     "generated": {
      "type": "string"
     },
     "tool_count": {
      "type": "integer"
     },
     "category_count": {
      "type": "integer"
     },
     "categories": {
      "type": "array",
      "items": {
       "type": "object"
      }
     },
     "tools": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Tool"
      }
     }
    }
   }
  }
 }
}