Bhagavad Gita API

{
  "service_type": "platform",
  "base_url": "https://bhagavadgita.io",
  "auth_method": "none",
  "auth_config": {},
  "endpoints": [
    {
      "path": "/chapter/{chapter_number}",
      "method": "GET",
      "description": "HTML page with all verses of a chapter, supports optional /hi suffix for Hindi"
    },
    {
      "path": "/chapter/{chapter}/verse/{verse}",
      "method": "GET",
      "description": "HTML page for a specific verse, supports optional /hi suffix for Hindi"
    },
    {
      "path": "/sitemap.xml",
      "method": "GET",
      "description": "XML sitemap listing all chapters and verses"
    },
    {
      "path": "/",
      "method": "GET",
      "description": "Landing page with overview and links"
    },
    {
      "path": "/bhagavad-gita-quotes",
      "method": "GET",
      "description": "Collection of quotes from the Gita"
    },
    {
      "path": "/verse-of-the-day",
      "method": "GET",
      "description": "Daily featured verse"
    },
    {
      "path": "/about",
      "method": "GET",
      "description": "Information about the project and foundation"
    },
    {
      "path": "/acknowledgements",
      "method": "GET",
      "description": "Sources and credits"
    },
    {
      "path": "/mahabharata-characters",
      "method": "GET",
      "description": "Information about Mahabharata characters"
    },
    {
      "path": "/gitagpt",
      "method": "GET",
      "description": "AI chatbot interface based on the Bhagavad Gita"
    },
    {
      "path": "/bhagavad-gita-app",
      "method": "GET",
      "description": "Mobile app promotion page"
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "description": "Free and ad-free, run by a non-profit foundation. No API tiers or paid plans mentioned."
    }
  },
  "rate_limits": {},
  "capabilities": [
    "HTML content serving for chapters and verses",
    "Hindi translations support via URL suffix",
    "Sitemap for structured content discovery",
    "No JavaScript required for content access",
    "Support for multiple scholarly translations and commentaries",
    "Offers verse of the day and quote collections",
    "Integrated Gita GPT AI assistant",
    "Mobile app presence"
  ],
  "raw_analysis": "The Bhagavad Gita API at bhagavadgita.io is a content platform that provides access to the entire Bhagavad Gita, including chapters, verses, Sanskrit transliteration, word-by-word meanings, and translations and commentaries from over 20 scholars. It is run by Ved Vyas Foundation, a non-profit, and offers free, ad-free access to all content without requiring JavaScript. The service is structured primarily as a website rather than a standard REST API; the provided URL points to a generic API provider page, but the additional content describes the BhagavadGita.com website. The 'API' aspect appears to be the ability to retrieve content programmatically via HTTP requests to specific URLs, returning server-rendered HTML. No documented JSON/XML API endpoints are provided, so the platform is assessed as a website with no explicit public REST API. It supports both English and Hindi versions by appending /hi to paths. Content is organized into 18 chapters with 700 verses, and there are auxiliary pages for quotes, daily verses, and an AI assistant (Gita GPT). The platform is mature and widely used, with a clear non-profit mission. For integration, one would scrape HTML or use the sitemap to discover URLs. Authentication is not required, and no pricing is mentioned, indicating a free service. Capabilities are limited to content delivery via HTML, but the breadth of religious and scholarly content is significant for text-based analysis. The raw_analysis should emphasize that no RESTful API exists, and the platform is best accessed via URL crawling."
}

3/3 tests passed

{
  "overall": 78,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 9.0,
    "response_parseability": 7.0,
    "error_clarity": 6.0,
    "doc_quality": 8.0,
    "auth_simplicity": 10.0,
    "latency": 8.0,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "type": "free",
    "note": "Free, ad-free, non-profit. No payment or signup required for core content."
  },
  "issues": [
    "No public REST API documented; agents must scrape HTML or use sitemap, which may break.",
    "llms.txt is present but sparse; lacks API details or structured data endpoints.",
    "Some content (translations/commentaries) may load dynamically requiring JS despite claim of no JS.",
    "No explicit versioning or changelog for content/site updates.",
    "CORS and rate-limit policies not documented."
  ],
  "recommendations": [
    "Add a lightweight JSON API for chapters and verses to enable reliable agent integration.",
    "Include API examples and rate-limit headers in llms.txt.",
    "Offer a simple API key (or no key) for public endpoints to reduce friction.",
    "Document content schema and update frequency for parsing stability.",
    "Add structured data (JSON-LD) to HTML pages for easier scraping fallback."
  ]
}