API Changelog

🚀 Public API Launch

ThinkKits API is now publicly available! Our REST API provides programmatic access to — school profiles, funding data, AI tools, and analytics across all 50 states plus DC.

Core School Intelligence Endpoints Added

• GET /schools/search — Autocomplete school search by name with filters
• GET /schools/{nces_id} — Complete school profiles with intelligence scores
• GET /schools/{nces_id}/peers — Demographically similar school analysis
• GET /schools/{nces_id}/health — Composite 0-100 health scoring
• GET /schools/{nces_id}/needs — AI-powered comprehensive needs assessment
• GET /schools/{nces_id}/equity — Equity profile with CRDC indicators
• GET /bright-spots — Schools outperforming demographics

Funding & Grants Intelligence Added

• GET /schools/{nces_id}/funding — Federal funding program eligibility
• POST /purchase/qualify — Funding compliance checker for purchases
• GET /grants/programs — Available grant programs database
• POST /grants/write — AI grant narrative generation (.docx output)
• POST /reports/justification — Audit-ready funding justification reports

Data & Analytics Stack Added

• GET /query/ask — Natural language data queries
• GET /export/schools — Bulk school data export (CSV/JSON)
• GET /districts/{leaid}/spending — F-33 district finance breakdowns
• GET /spending/compare — Cross-district spending comparisons
• GET /equity/gaps — Largest equity gaps by state/metric

Vendor & Sales Intelligence Added

• POST /leads/from-purchase — Targeted lead list generation
• GET /market/summary — TAM analysis and lead tier distribution
• GET /vendors/erate — E-Rate vendor rankings by commitment volume
• GET /vendors/erate/{vendor_name} — Detailed vendor procurement history
• GET /shortages — Teacher shortage areas by state

Geographic Intelligence Added

• GET /states/{abbr}/profile — Comprehensive state-level aggregates
• GET /districts/search — Autocomplete district search
• POST /reports/district — AI district intelligence reports (.docx)

AI Tools & Automation Added

• POST /agent/chat — Conversational AI with full platform access
• POST /extract/document — AI document extraction (images/text)

Account & Marketplace Management Added

• GET /marketplace/tiers — Available API tiers and pricing
• GET /marketplace/usage — Usage statistics and quota monitoring
• GET /standards/certify — Curriculum standards coverage data

Authentication & Security Added

• API key authentication via X-API-Key header
• Tier-based rate limiting: Explorer (3/day), Starter (25/day), Professional (100/day), Business (unlimited)
• Comprehensive rate limit headers (X-RateLimit-*) on all responses
• RFC 7807 compliant error responses with structured problem details

Response Format Standards Added

• Consistent JSON structure with predictable field naming conventions
• Cursor-based pagination for large result sets
• Comprehensive metadata in response headers
• OpenAPI 3.0 specification available at /docs endpoint

Enhanced Analytics & Intelligence Planned

• POST /analytics/compare-schools — Bulk school comparison with custom metrics
• GET /analytics/trends — Multi-year demographic and performance trend analysis
• GET /funding/gap-analysis — District-level funding adequacy analysis
• POST /reports/custom — Custom report generation with dynamic templates

Real-Time Notifications Planned

• POST /webhooks/subscribe — Webhook subscription management
• Real-time notifications for school data changes and updates
• Grant deadline alerts and E-Rate filing period notifications
• Funding opportunity alerts based on school eligibility changes

Advanced Search & Filtering Planned

• Geographic search with radius-based filtering
• Advanced demographic filters with statistical operators
• Saved search templates and result subscriptions
• AI-powered search suggestions and autocomplete

Enhanced AI Capabilities Planned

• Multi-language support for Spanish-speaking districts
• Improved grant writing with ESSA evidence integration
• Predictive analytics for funding opportunity scoring
• Custom AI agent training on district-specific data

GraphQL API Introduction Planned

• Unified GraphQL endpoint at /graphql for all data types
• Real-time subscriptions via WebSocket for live data updates
• Advanced filtering, sorting, and aggregation capabilities
• Client-driven field selection for optimal bandwidth usage

REST API Modernization Breaking

• URL Structure: All endpoints moved to /api/v2/* namespace
• Authentication: OAuth 2.0 with PKCE required, API keys deprecated
• Response Format: JSON:API specification compliance
• Pagination: Cursor-based pagination becomes mandatory

Enhanced Data Model Breaking

• Standardized field naming conventions (snake_case → camelCase)
• Expanded metadata with data lineage and freshness indicators
• Hierarchical relationship modeling for districts, schools, and programs
• Support for historical data snapshots and versioning