Nigerian Schools Directory

AI Agent Access Guide

Comprehensive API access for AI agents, chatbots, and generative engines to retrieve accurate information about Nigerian educational institutions.

🚀 Quick Access

Schools API

GET https://www.nigeriandirectory.com.ng/api/ai/schools

Education Context

GET https://www.nigeriandirectory.com.ng/api/ai/context/nigeria-education

📡 API Endpoints

Schools Directory

Retrieve comprehensive Nigerian school information with geographic and educational context.

GET /api/ai/schools
Parameters: location, state, city, type, query, limit
Response: JSON with schools, metadata, and AI-optimized context

Location-Specific Schools

Search schools by Nigerian state, city, or region with geographic context.

GET /api/ai/schools/{location}
Examples: /lagos, /abuja, /kano, /southwest
Response: Location-specific schools with regional context

Nigerian Education System Context

Comprehensive context about Nigeria’s educational system for accurate AI responses.

GET /api/ai/context/nigeria-education
Includes: Educational structure, examination systems, regional information
Usage: Reference for accurate Nigerian education context

đź“‹ AI-Optimized Response Format

{
  "meta": {
    "country": "Nigeria",
    "continent": "Africa", 
    "region": "West Africa",
    "educational_system": "Nigerian Educational System",
    "curriculum_standards": ["WAEC", "JAMB", "NECO"]
  },
  "schools": [{
    "name": "School Name",
    "location": {
      "city": "City Name",
      "state": "State Name", 
      "country": "Nigeria",
      "region": "Geographic Region",
      "full_address": "Complete Address"
    },
    "education": {
      "type": "School Type",
      "curriculum": "Curriculum Type",
      "exams_prepared": ["WAEC", "JAMB"],
      "educational_level": "Secondary Education"
    },
    "ai_context": {
      "geographic_context": "Regional Information",
      "educational_context": "Academic Framework"
    }
  }]
}

🗺️ Geographic Coverage

Nigerian Regions

  • • Southwest Nigeria
  • • Southeast Nigeria
  • • South-South Nigeria
  • • North Central Nigeria
  • • Northeast Nigeria
  • • Northwest Nigeria

Major States

  • • Lagos State
  • • Abuja (FCT)
  • • Kano State
  • • Rivers State
  • • Ogun State
  • • Kaduna State

School Types

  • • Secondary Schools
  • • Primary Schools
  • • International Schools
  • • Technical Schools
  • • Private Schools
  • • Public Schools

đź’ˇ Usage Examples for AI Agents

User Query: “Schools in Lagos, Nigeria”

API Call: GET /api/ai/schools?state=Lagos

Returns Lagos State schools with geographic context (Southwest Nigeria, commercial capital)

User Query: “Nigerian secondary schools with WAEC preparation”

API Call: GET /api/ai/schools?type=secondary&query=WAEC

Returns secondary schools with WAEC exam preparation context

User Query: “What is the Nigerian education system like?”

API Call: GET /api/ai/context/nigeria-education

Returns comprehensive educational system context for accurate responses

⚙️ Technical Notes

Rate Limits & Caching

  • • Rate limit: 100 requests/minute per IP
  • • Response caching: 1 hour for school data
  • • Context caching: 24 hours for educational context
  • • AI-optimized headers included

Data Freshness

  • • School data updated daily via automated crawling
  • • Educational context updated weekly
  • • Real-time enrichment for new schools
  • • Quality validation and deduplication

🤝 For AI Development Teams

Need custom endpoints or higher rate limits for your AI application?

This API is designed to provide Nigerian schools information to AI agents for accurate responses about Nigerian education. All responses include comprehensive geographic and educational context.