Skip to main content

Ahotu Events API - Complete Documentation

Welcome to the complete documentation portal for the Ahotu Events Content Calendar API. This comprehensive guide covers everything from technical API reference to business value propositions.

🚀 Quick Start​

New to the Events API? Start here:

  1. 📘 Authentication Guide - Get your API credentials set up
  2. 🏗️ Data Model Overview - Understand the data structure
  3. 📝 Query Examples - See the API in action
  4. 🎮 Try the GraphQL Playground - Interactive API explorer

📚 API Documentation​

Authentication & Access​

OAuth 2.0 Authentication

  • Client credentials flow
  • Token management
  • Security best practices
  • Code examples in cURL, JavaScript, and Python

Data Architecture​

Data Model Architecture

  • Hierarchical structure: Events → Editions → Races → Activities
  • Field descriptions and relationships
  • Localization support (16 languages)
  • AI-generated content handling

Query Reference​

GraphQL Query Examples

  • 40+ practical query examples
  • Location-based searches
  • Date range filtering
  • Distance and sport filtering
  • Combined search patterns
  • Faceted navigation

GraphQL Schema Reference

  • Complete type definitions
  • Query parameters
  • Input types and enums
  • Field descriptions
  • Auto-generated from schema.gql

💼 Commercial Documentation​

Platform Overview​

Tenant Customization

  • Multi-tenant architecture
  • Sport and geographic filtering
  • Language selection
  • Custom catalogs
  • Configuration process
  • Real-world use cases

Data Coverage​

Catalog Statistics & Coverage

  • 58,000+ active events
  • 195 countries covered
  • 28 different sports
  • Geographic distribution
  • Data quality metrics
  • Update frequency

Business Value​

Business Benefits & ROI

  • Enterprise-grade infrastructure
  • Production-proven at scale (1M+ monthly users)
  • Search & discovery excellence
  • Integration advantages
  • Customization & flexibility
  • Cost efficiency
  • Competitive advantages

🌍 Data at a Glance​

MetricValue
Active Events58,319+
Total Editions203,810+
Individual Races639,097+
Countries195
Sports28+
Languages16
Query Response Time< 200ms
Monthly Users1M+ on ahotu.com

🎯 Use Cases by Industry​

Training & Fitness Apps​

Build race recommendations aligned with user training plans. Filter by distances, dates, and terrain difficulty.

Key Features:

  • Distance-based filtering (5K to ultra)
  • Course profile data (elevation, terrain)
  • Registration URL integration
  • Geographic search

Learn More: Business Benefits - Training App Integration

Travel & Tourism Platforms​

Feature destination running events to create unique travel packages.

Key Features:

  • Scenic/destination environment tags
  • Multi-language support
  • Geographic queries
  • Event page links

Learn More: Business Benefits - Travel & Tourism

Corporate Wellness​

Encourage employee participation in local community events.

Key Features:

  • Geo-spatial search near office locations
  • Beginner-friendly filtering
  • Team/relay options
  • Date filtering for challenges

Learn More: Business Benefits - Corporate Wellness

Media & Content​

Create dynamic event guides with always-fresh data.

Key Features:

  • Comprehensive event details
  • Historical data for trends
  • Multi-language support
  • Faceted search for categorization

Learn More: Business Benefits - Media & Content

Equipment Retail​

Recommend events to drive product purchases and build customer goals.

Key Features:

  • Product-to-event matching
  • Location-based recommendations
  • Season filtering
  • Affiliate registration tracking

Learn More: Business Benefits - Equipment Retail

🔧 Technical Stack​

  • API Type: GraphQL
  • Architecture: AWS Serverless (Lambda + API Gateway)
  • Search Engine: OpenSearch (Elasticsearch)
  • CDN: CloudFront with multi-region support
  • Authentication: OAuth 2.0 (AWS Cognito)
  • Uptime: 99.9% SLA

📖 Documentation Structure​

This portal is organized into three main sections:

1. API Documentation (/docs/api)​

For developers integrating the API. Includes authentication, data models, queries, and schema reference.

2. Commercial Documentation (/docs/commercial)​

For business stakeholders. Covers platform capabilities, catalog coverage, and ROI considerations.

3. Full Documentation (/docs/full)​

Complete access to all sections for partners with full permissions.

🆘 Support & Resources​

Getting Help​

  • Technical Issues: Contact your integration support team
  • Business Questions: Reach out to your account manager
  • API Status: Check service health dashboard
  • GraphQL Playground: Interactive API explorer

Additional Resources​

  • Environments:

    • Development: For testing and integration
    • Preproduction: Final validation before launch
    • Production: Live API endpoint

  • Updates: Proactive communication about changes and improvements

  • Best Practices: See query examples for optimization tips

🚦 Getting Started Checklist​

💡 What Makes This API Special?​

  1. Battle-Tested Data: Same infrastructure serving 1M+ monthly users on ahotu.com
  2. Global Coverage: 58K+ events across 195 countries and 28 sports
  3. Real-Time Updates: Changes propagate within minutes
  4. Smart Search: OpenSearch with algorithms refined by millions of real searches
  5. Developer-Friendly: GraphQL means fetch exactly what you need
  6. Customizable: Multi-tenant architecture tailored to your needs
  7. Production-Ready: Enterprise SLAs with 99.9% uptime

📞 Ready to Get Started?​

Contact your account manager to:

  • Discuss your specific use case
  • Configure your custom tenant
  • Obtain API credentials
  • Schedule integration support
  • Request a demo or trial access

Next Steps: