{
  "name": "Genius",
  "description": "Turf's sports-specific retrieval API for scraped and indexed article sources.",
  "baseUrl": "https://genius.turf.fyi",
  "defaultMode": "sources",
  "endpoints": {
    "ask": {
      "path": "/ask",
      "examples": {
        "latestCricketSources": "https://genius.turf.fyi/ask?q=latest%20cricket",
        "latestNhlSources": "https://genius.turf.fyi/ask?q=latest%20nhl",
        "aiAnswer": "https://genius.turf.fyi/ask?q=who%20will%20win%20sabres%20canadiens%20game%207&sport=nhl&responseMode=ai"
      },
      "responseModes": {
        "sources": "Default. Returns matching articles and structured markdown URLs without a generated answer.",
        "summary": "Returns a lightweight article-list answer.",
        "ai": "Uses Workers AI to answer from the retrieved article markdown."
      }
    },
    "markdown": "https://genius.turf.fyi/markdown?url=https://example.com",
    "extract": {
      "path": "/extract",
      "body": {
        "url": "https://example.com",
        "prompt": "Extract the title and key facts from this page."
      }
    },
    "crawl": {
      "feeds": "https://genius.turf.fyi/crawl/feeds",
      "status": "https://genius.turf.fyi/crawl/status",
      "articles": "https://genius.turf.fyi/crawl/articles?sport=nba&limit=20"
    }
  },
  "sources": [
    "ESPN RSS and articles",
    "ESPNcricinfo RSS summaries where article pages block browser fetches"
  ],
  "cache": "Use cache=refresh to refresh, cache=bypass to skip cache, ttl=<seconds> to override freshness."
}