{
  "service": "youtube.tools.town",
  "version": "1.0.0",
  "description": "YouTube utilities without Data API keys: id parsing, thumbnail URLs, oEmbed proxy, embed links — for devs, marketers, and CMS integrations.",
  "limits": {
    "no_api_key": true,
    "oembed_source": "https://www.youtube.com/oembed"
  },
  "endpoints": {
    "docs_html": "GET /",
    "parse": "GET /v1/parse?id= or ?url=",
    "thumbnails": "GET /v1/thumbnails?id= or ?url=",
    "oembed": "GET /v1/oembed?id= or ?url=",
    "embed_info": "GET /v1/embed-info?id= or ?url=",
    "validate": "GET /v1/validate?id= or ?url=",
    "embed_widget": "GET /embed/",
    "health": "GET /health",
    "discovery": "GET /meta"
  },
  "query_params": {
    "id": "11-character video id",
    "url": "watch, youtu.be, embed, shorts, live URL"
  },
  "examples": {
    "parse": "https://youtube.tools.town/v1/parse?url=https://youtu.be/dQw4w9WgXcQ",
    "thumbs": "https://youtube.tools.town/v1/thumbnails?id=dQw4w9WgXcQ",
    "oembed": "https://youtube.tools.town/v1/oembed?id=dQw4w9WgXcQ"
  }
}