SchoolDigger API V1

{
  "service_type": "platform",
  "base_url": "https://api.schooldigger.com",
  "auth_method": "api_key",
  "auth_config": {
    "parameter_name": "appID",
    "second_parameter_name": "appKey",
    "notes": "REST API V1 (docs at developer.schooldigger.com). Requires appID and appKey as query parameters. Swagger spec referenced at https://api.schooldigger.com/swagger/docs/v3.0 suggests API versioning has advanced beyond V1; the requested 'V1' label may be legacy naming."
  },
  "endpoints": [
    {
      "name": "School search / list",
      "path": "/v1.0/schools",
      "method": "GET",
      "description": "Search schools by name, location, zip, district, level, and type."
    },
    {
      "name": "School detail",
      "path": "/v1.0/schools/{schoolid}",
      "method": "GET",
      "description": "Detailed profile: enrollment, demographics, test scores, teacher ratios, spending, graduation rates."
    },
    {
      "name": "District search / list",
      "path": "/v1.0/districts",
      "method": "GET",
      "description": "Search 18,500+ school districts."
    },
    {
      "name": "District detail",
      "path": "/v1.0/districts/{districtid}",
      "method": "GET",
      "description": "District staffing, finance, test scores, and attendance boundaries."
    },
    {
      "name": "Rankings",
      "path": "/v1.0/rankings",
      "method": "GET",
      "description": "Statewide rankings by level based on standardized test scores (0-5 star scale)."
    },
    {
      "name": "District boundaries",
      "path": "/v1.0/districts/{districtid}/boundaries",
      "method": "GET",
      "description": "District boundary polygons / attendance boundary geometry."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "consumer_site": "Free for public browsing of rankings and school profiles",
      "api": "Commercial REST API; pricing tiered per subscription (details at developer.schooldigger.com)",
      "bulk_data": "Available via AWS Marketplace, Snowflake, and Databricks",
      "notes": "Pricing not publicly enumerated in provided content; assume tiered subscription with free/sandbox developer tier common to this model."
    }
  },
  "rate_limits": {
    "documented": false,
    "notes": "Rate limits are not specified in the provided content. Likely enforced per appID/appKey; consult developer.schooldigger.com."
  },
  "capabilities": [
    "School rankings (0-5 star) for 120,000+ K-12 public and private schools",
    "District data for 18,500+ districts",
    "School profiles: enrollment, demographics, test scores, teacher ratios, per-student spending, graduation rates",
    "District profiles: staffing, finance, test scores, attendance boundaries",
    "Side-by-side school comparisons by city, zip, or district",
    "Search by name, location, zip code, district, level, and type (charter, magnet, private)",
    "District attendance boundary maps / polygons",
    "Historical data up to 35 years (enrollment and demographics)",
    "Statewide rankings by level (elementary, middle, high) with 20+ years of history",
    "Bulk data delivery via AWS Marketplace, Snowflake, Databricks",
    "Data aggregated from NCES, state departments of education, and US Census Bureau"
  ],
  "raw_analysis": "SchoolDigger is a well-established US K-12 school data platform serving parents, homebuyers, researchers, and educators. It is mature and widely cited (Money Magazine, Century 21, Harvard, IXL, Precisely, Coldwell Banker, Franklin Covey). Coverage: 120,000+ schools, 18,500+ districts, all 50 states, with up to 35 years of history. Core value is proprietary 0-5 star school rankings derived from standardized test scores, normalized across states/grades/subjects.\n\nDeveloper access: The service publishes a REST API at api.schooldigger.com with Swagger docs (a v3.0 swagger path is referenced, implying versioning beyond the 'V1' in the user-supplied name). Authentication follows a dual-credential pattern (appID + appKey), typical of API-key-based commercial data APIs. Free consumer browsing coexists with a paid developer API and bulk enterprise delivery via AWS Marketplace, Snowflake, and Databricks — a freemium/commercial hybrid model.\n\nIntegration posture: Strong for data-embedded use cases (real estate, education tech, market research, analytics). No known public server SDKs referenced, but REST + Swagger + an llms.txt resource signal intent to support AI/LLM integrations and rapid developer onboarding. Rate limits and exact API pricing are not stated in provided material and must be confirmed at developer.schooldigger.com. Primary uncertainty: whether 'V1' refers to a deprecated surface versus the current v3.0 API, and whether geographic/boundary data is available in the REST API versus only bulk packages."
}

2/3 tests passed

{
  "overall": 78,
  "dimensions": {
    "token_efficiency": 9.0,
    "first_try_success": 7.5,
    "response_parseability": 9.0,
    "error_clarity": 7.0,
    "doc_quality": 8.0,
    "auth_simplicity": 6.5,
    "latency": 6.5,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "model": "freemium",
    "free_tier": "consumer browsing free; developer API tiered (sandbox likely)",
    "bulk_alternatives": ["AWS Marketplace", "Snowflake", "Databricks"],
    "pricing_transparency": "low — tiered subscription, details only on developer portal"
  },
  "issues": [
    "robots_txt returns 404 (missing or misconfigured), which can confuse crawlers and agent discovery",
    "Pricing not enumerated publicly; tiered API costs opaque without visiting developer portal",
    "No explicit auth flow details (API key vs OAuth) in provided content",
    "Root website latency ~597ms is moderate but not fast"
  ],
  "recommendations": [
    "Publish a proper robots.txt to improve crawler/agent discoverability",
    "Surface API pricing tiers and free/sandbox limits directly on marketing site",
    "Document auth flow explicitly (API key issuance, rate limits) in llms.txt",
    "Leverage the existing /llms.txt file as a strong agent-discovery asset — expand it with endpoint examples"
  ]
}