Nigerian geo-data,
finally structured.

<?php

use Illuminate\Support\Facades\Http;

class NigeriaLocationService
{
    private string $base = 'https://nigeria.jamiuadewaleyusuf.com/api/v1';

    public function states(string $geoZone = null): array
    {
        $params = $geoZone ? ['geo_zone' => $geoZone] : [];
        return Http::get("{$this->base}/states", $params)->json('data');
    }

    public function lgasByState(string $state): array
    {
        return Http::get("{$this->base}/states/{$state}/lgas")->json('data');
    }

    public function nearby(float $lat, float $lng, int $radius = 100): array
    {
        return Http::get("{$this->base}/nearby", compact('lat', 'lng', 'radius'))->json('data');
    }

    public function lookupPostal(string $code): ?array
    {
        $resp = Http::get("{$this->base}/postal-codes/lookup", ['code' => $code])->json();
        return $resp['status'] === 'success' ? $resp['data'] : null;
    }
}

import requests

BASE = ".jamiuadewaleyusuf.com/api/v1"

# All states in South West
states = requests.get(f"{BASE}/states", params={"geo_zone": "SW"}).json()["data"]

# LGAs by state
lgas = requests.get(f"{BASE}/states/lagos/lgas").json()["data"]

# Nearby
nearby = requests.get(f"{BASE}/nearby", params={
    "lat": 6.45, "lng": 3.39, "radius": 50
}).json()["data"]

# Postal lookup
location = requests.get(f"{BASE}/postal-codes/lookup", params={"code": "100283"}).json()

import 'dart:convert';
import 'package:http/http.dart' as http;

const _base = 'https://nigeria.jamiuadewaleyusuf.com/api/v1';

// Get states
Future<List> getStates() async {
  final res = await http.get(Uri.parse('$_base/states'));
  return jsonDecode(res.body)['data'];
}

// Get LGAs
Future<List> getLgas(String state) async {
  final res = await http.get(Uri.parse('$_base/states/$state/lgas'));
  return jsonDecode(res.body)['data'];
}

// Nearby
Future<List> getNearby(double lat, double lng, {int radius=100}) async {
  final uri = Uri.parse('$_base/nearby').replace(queryParameters: {
    'lat': '$lat', 'lng': '$lng', 'radius': '$radius'
  });
  final res = await http.get(uri);
  return jsonDecode(res.body)['data'];
}

import { useState, useEffect } from 'react';

const BASE = 'https://nigeria.jamiuadewaleyusuf.com/api/v1';

// State → LGA cascade hook
export function useNigeriaLocation() {
  const [states, setStates] = useState([]);
  const [lgas, setLgas] = useState([]);
  const [selectedState, setSelectedState] = useState('');

  useEffect(() => {
    fetch(`${BASE}/states`)
      .then(r => r.json())
      .then(d => setStates(d.data));
  }, []);

  useEffect(() => {
    if (!selectedState) return;
    fetch(`${BASE}/states/${selectedState}/lgas`)
      .then(r => r.json())
      .then(d => setLgas(d.data));
  }, [selectedState]);

  return { states, lgas, setSelectedState };
}

# All states
curl https://nigeria.jamiuadewaleyusuf.com/api/v1/states

# States by geopolitical zone
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/states?geo_zone=SW"

# LGAs for a state
curl https://nigeria.jamiuadewaleyusuf.com/api/v1/states/lagos/lgas

# Nearby (Abuja coords)
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/nearby?lat=9.0765&lng=7.3986&radius=50"

# Postal code lookup
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/postal-codes/lookup?code=900001"

# Search LGAs
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/lgas/search?q=aba"