4 Best APIs for Location Data in Nigeria

CountryStateCity is a free, open-source geographic reference database exposed as a REST API, providing structured data for all 250 countries in the world, their states and provinces, and their cities and local government areas. For Nigerian developers, it is particularly valuable because it includes all 36 Nigerian states plus the Federal Capital Territory (FCT), all 774 Local Government Areas (LGAs), and major Nigerian cities — providing the authoritative administrative geography of Nigeria in a machine-readable format. **What CountryStateCity Does** CountryStateCity exposes a hierarchical geographic database through a simple RESTful API. The three levels of the hierarchy are: 1. **Countries**: 250 countries with ISO2 code, ISO3 code, phone code, currency, flag emoji, region (continent), and subregion. Example: Nigeria → ISO2: NG, ISO3: NGA, phone: 234, currency: NGN. 2. **States**: All states, provinces, regions, and administrative divisions within each country, with their ISO code, state code, latitude, longitude, and type (State, Province, Region, Territory, etc.). 3. **Cities**: All cities and towns within each state, with latitude and longitude coordinates. For Nigeria specifically: - **36 states + FCT**: Abia, Adamawa, Akwa Ibom, Anambra, Bauchi, Bayelsa, Benue, Borno, Cross River, Delta, Ebonyi, Edo, Ekiti, Enugu, FCT Abuja, Gombe, Imo, Jigawa, Kaduna, Kano, Katsina, Kebbi, Kogi, Kwara, Lagos, Nasarawa, Niger, Ogun, Ondo, Osun, Oyo, Plateau, Rivers, Sokoto, Taraba, Yobe, Zamfara - **774 LGAs**: All Local Government Areas of Nigeria, enabling granular administrative-level targeting - **Major cities**: Lagos, Abuja, Kano, Ibadan, Port Harcourt, Benin City, and hundreds of secondary cities and towns **How Developers Use CountryStateCity** **Option 1: REST API** After registering for a free API key at countrystatecity.in, you make GET requests with the key in the header: ``` GET https://api.countrystatecity.in/v1/countries/NG/states Headers: X-CSCAPI-KEY: YOUR_KEY ``` This returns all Nigerian states as a JSON array. To get LGAs for a specific state: ``` GET https://api.countrystatecity.in/v1/countries/NG/states/LA/cities Headers: X-CSCAPI-KEY: YOUR_KEY ``` Returns all cities in Lagos State. **Option 2: npm Package (No API Call Required)** CountryStateCity is also available as an npm package (`csc-js`) that bundles the entire database locally: ``` npm install country-state-city ``` ```javascript import { Country, State, City } from 'country-state-city'; const nigerianStates = State.getStatesOfCountry('NG'); const lagosCities = City.getCitiesOfState('NG', 'LA'); ``` This approach is fully offline — no API key, no rate limits, no network calls. The data is bundled with your application. This is ideal for forms and dropdowns where you need instant local lookup without network latency. **Pricing and Rate Limits** - **Free API Plan**: 100 requests per hour with an API key. Suitable for moderate production use; cache responses on the client side to stay within limits. - **npm Package**: Completely free, no limits, no API key. The entire database is included in the package (~1-2MB). - **No Credit Card Required**: The free plan is free forever with no payment required. For most Nigerian applications that use the data for dropdown population (which loads once and caches), the free API tier or the npm package will be more than sufficient. **Authentication** API authentication uses a custom header: `X-CSCAPI-KEY: YOUR_KEY`. Unlike many APIs that use query parameter authentication, CountryStateCity uses headers for cleaner URLs. The npm package requires no authentication at all. **Data Quality and Coverage** CountryStateCity is an open-source project actively maintained on GitHub. The Nigerian data is comprehensive: - All 36 states are present with correct ISO codes - FCT (Federal Capital Territory) is correctly listed separately - All 774 LGAs are catalogued as cities within their respective states - Major Nigerian cities include coordinates for mapping use Accuracy is generally high for administrative boundaries. However, as with any community-maintained dataset, there may be occasional discrepancies in transliterations of local place names or boundary changes following administrative reorganizations. **Use Case: Nigeria Registration Form** A common challenge in Nigerian SaaS applications is building registration forms with valid state and LGA dropdowns. Hard-coding these lists creates maintenance overhead (LGA boundaries sometimes change), and asking users to type free-text creates data quality issues. CountryStateCity solves this cleanly: 1. On page load, fetch all Nigerian states from CountryStateCity 2. Populate the "State" dropdown 3. When the user selects a state, fetch the LGAs for that state 4. Populate the "LGA" dropdown dynamically This creates a clean, validated, always-up-to-date address form without any custom data management. **Use Case: Multi-Country International Forms** For Nigerian platforms expanding internationally or serving the diaspora, CountryStateCity eliminates the need to maintain custom country/state/city lists for every market. A single integration covers all 250 countries, making international checkout forms, shipping address forms, and user registration forms easy to build and maintain. **Use Case: Analytics and Reporting** Nigerian businesses with location-based data (field sales tracking, delivery routing, customer distribution mapping) can use CountryStateCity's standardized state and LGA codes to normalize location data collected from multiple sources, enabling clean aggregation and reporting by administrative region. **Compliance Considerations** CountryStateCity returns administrative boundary data — countries, states, cities. This data itself is not personal information and does not raise NDPR or GDPR compliance concerns. When used in conjunction with user location data (i.e., storing which LGA a specific user is in), standard data minimization principles apply. **Company Background** CountryStateCity is an open-source project started by developer Darshan Gada and maintained on GitHub with contributions from developers worldwide. It has accumulated thousands of GitHub stars and is widely used in the developer community. The npm package has millions of weekly downloads, making it one of the most trusted geographic reference datasets available as a developer tool. The REST API wrapper is provided as an additional convenience for non-JavaScript environments. **Alternatives** - **REST Countries API**: Countries only (no states/cities) - **GeoNames**: More comprehensive but complex and requires attribution - **Google Places API**: Real-time and accurate but paid and requires Google billing - **OpenStreetMap / Nominatim**: Best for geocoding but overkill for simple dropdown population CountryStateCity strikes the ideal balance of simplicity, completeness, and zero cost — making it the default choice for Nigerian developers building any form that requires country/state/LGA selection.

NumlookupAPI is a phone number lookup and validation API providing real-time carrier identification, line type detection, geographic location data, and number format normalization for global phone numbers including Nigerian (+234) numbers. Operated by EverAPI (everapihq), the platform offers a developer-friendly integration path with a free trial requiring no credit card, paid plans from $9.99/month, and a 99.99% uptime SLA on all paid tiers. The API is designed for businesses that need to validate phone numbers at point of entry, enrich CRM contact data, or screen registrations for invalid or suspicious numbers — without the complexity of a full communications platform. ## What the API Does A single NumlookupAPI call accepts a phone number and returns: - **Validity**: Whether the number is a valid, recognized phone number. - **Number (E.164)**: The number in international E.164 format. - **Carrier**: The mobile network operator (e.g., MTN Nigeria, Airtel Nigeria, Globacom, 9mobile). - **Line type**: Mobile, landline, VoIP, or unknown. - **Location**: Country and sub-national region associated with the number prefix. - **Country code**: ISO 2-letter country code (NG for Nigerian numbers). The API integrates with CRM systems, marketing platforms, and custom applications for automated phone number quality management. ## How Developers Use It GET request to the NumlookupAPI endpoint with the phone number and API key. The response is a JSON object with all available metadata. SDKs and client libraries are available for popular languages through the GitHub repository (everapihq/numlookupapi). Integration is straightforward and can be completed in under an hour. ## Pricing & Fees - **Free trial**: Available with no credit card required for initial testing. - **Paid plans**: Start at $9.99/month providing 7,000 API requests per month. - **Custom plans**: Available for businesses requiring more than 300,000 requests per month. - All paid plans include unlimited API connections (no concurrent request limit) and the 99.99% uptime guarantee. ## Authentication API key authentication. The key is passed as a parameter in the API request. Keys are issued immediately after registration. ## Rate Limits Rate limits are based on monthly request quotas per plan tier. Paid plans come with unlimited concurrent API connections — requests are processed without queuing. Monthly quotas reset each billing cycle. ## Compliance NumlookupAPI processes phone numbers for validation and lookup purposes. Data handling policies are consistent with standard API service agreements. For Nigerian deployments, the carrier and format data returned supports phone number verification as part of broader user onboarding flows. ## Challenges & Gotchas for Nigerian Developers 1. **No SIM Swap detection**: NumlookupAPI provides carrier and line type data but does not offer SIM Swap detection for fraud prevention. Use Twilio Lookup for SIM Swap signals. 2. **Carrier accuracy with MNP**: Nigerian mobile number portability can cause carrier misidentification after a user switches networks. The API reflects original carrier assignment. 3. **7,000 requests at $9.99**: This is a reasonable starting volume but will be exhausted quickly for apps with active daily registrations. Plan your tier based on expected daily validation volume. 4. **USD billing**: NumlookupAPI charges in USD. Nigerian developers need a USD-capable payment method. 5. **Limited documentation depth**: As a smaller API provider, documentation and community support resources are more limited than Twilio or Abstract API. ## Company Background NumlookupAPI is operated by EverAPI (everapihq), a developer-focused API company providing a portfolio of data enrichment and validation APIs. The platform is available as an open-source client library on GitHub and through the Rapid API marketplace in addition to the main website. ## Frequently Asked Questions **Q: Does NumlookupAPI support Nigerian phone numbers?** A: Yes. Nigerian numbers (+234) are supported with carrier identification for MTN, Airtel, Glo, and 9mobile. **Q: Is a credit card required to try the API?** A: No. A free trial is available without credit card details. **Q: What is the uptime guarantee?** A: Paid plans include a 99.99% uptime SLA over the trailing 12-month period. **Q: How many requests does the entry-level plan include?** A: The $9.99/month plan includes 7,000 API requests per month.