{
  "openapi": "3.1.0",
  "info": {
    "title": "FreeAPI Public Developer Infrastructure",
    "version": "2.4.0",
    "description": "The open API infrastructure for modern developers curating 1000+ free public REST APIs across 47 categories.",
    "contact": {
      "name": "Canpolat Kaya",
      "url": "https://findfreeapi.com",
      "email": "canpolat@canpolatkaya.com"
    },
    "license": {
      "name": "CC0-1.0",
      "url": "https://creativecommons.org/publicdomain/zero/1.0/"
    }
  },
  "servers": [
    {
      "url": "https://findfreeapi.com",
      "description": "Production Edge Gateway"
    }
  ],
  "paths": {
    "/llms.txt": {
      "get": {
        "summary": "LLM Ingestion Index",
        "description": "Curated machine-readable overview of FreeAPI directory for AI search engines.",
        "responses": {
          "200": {
            "description": "Markdown index of categories, APIs, and tools",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "Complete 1000+ API Dataset Corpus",
        "description": "Full dataset of 1000+ free developer APIs with authentication and rate limits.",
        "responses": {
          "200": {
            "description": "Full Markdown corpus of all APIs",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/api/proxy": {
      "get": {
        "summary": "Edge CORS Proxy Gateway",
        "description": "High-speed edge proxy to bypass browser Same-Origin Policy during prototyping.",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Target public REST API URL to proxy",
            "schema": {
              "type": "string",
              "format": "uri"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Proxied response with permissive CORS headers"
          }
        }
      }
    }
  }
}
