2 Best APIs for Timezone Data in Nigeria

IPstack is a leading IP geolocation API operated by APILayer, designed to provide developers with fast, accurate, and granular location intelligence based on IP addresses. Since its launch, IPstack has served millions of developers worldwide and has become one of the most popular geolocation APIs due to its generous free tier, comprehensive data modules, and developer-friendly documentation. **What IPstack Does** At its core, IPstack converts a raw IP address into a rich set of geographic and network data. A single API call returns the visitor's continent, country, region, city, ZIP/postal code, latitude, and longitude. But the platform goes significantly further with five distinct data modules that make it one of the most comprehensive IP intelligence APIs available. The five modules are: 1. **Location Module**: Returns continent name and code, country name and ISO code, region name and code, city, zip/postal code, latitude, longitude, and a flag image URL for the detected country. 2. **Currency Module**: Returns the local currency code (e.g., NGN for Nigeria), currency symbol, and name — essential for dynamic pricing and localized checkout flows. 3. **Timezone Module**: Returns the timezone identifier (e.g., Africa/Lagos), UTC offset, current local time, and whether DST is active — enabling you to schedule events and communications at correct local times. 4. **Connection Module**: Returns the ASN (Autonomous System Number), ISP name, and connection type (WiFi, Cable, DSL, Cellular) — valuable for adapting content delivery strategies to a user's network type. 5. **Security Module**: Returns flags for proxy usage, Tor exit nodes, crawler detection, and whether the IP belongs to a known hosting provider — enabling lightweight fraud prevention checks at the gateway layer. **How Developers Use IPstack** Integrating IPstack is straightforward. You register for a free API key at ipstack.com and make a GET request: ``` GET http://api.ipstack.com/{ip}?access_key=YOUR_KEY ``` The response is a JSON object. For paid plans, you switch to HTTPS: ``` GET https://api.ipstack.com/{ip}?access_key=YOUR_KEY&modules=location,currency,security ``` You can request multiple modules in a single call using the `modules` query parameter. You can also look up your own requester's IP by using `check` as the IP value: ``` GET https://api.ipstack.com/check?access_key=YOUR_KEY ``` IPstack is available in REST format and responses include standard JSON. The API is stateless, requires no SDK (though community SDKs exist for Python, PHP, Node.js, and others), and works seamlessly from any backend or serverless function. **Pricing** IPstack operates on a freemium model: - **Free Tier**: A set number of monthly requests at no cost. HTTPS is not available on the free tier — requests must be made over HTTP. - **Professional Plan**: Starts at $9.99/month. HTTPS enabled. Access to more monthly requests and all five data modules. - **Enterprise Plans**: Higher volume tiers up to $99.99/month with elevated monthly request caps, priority support, and dedicated infrastructure. - **Annual Billing**: Opting for annual billing gives you two months free across all paid plans. The HTTP-only limitation on the free tier is a notable constraint for production applications that require secure data transmission — all production deployments should be on at least the Professional plan. **Authentication** IPstack uses an API access key delivered as a query parameter: `?access_key=YOUR_KEY`. This is the same authentication pattern used across the APILayer ecosystem (e.g., Numverify). The key is tied to your account and rate-limit counters track usage per key. Store your access key in environment variables and never expose it in client-side code. **Rate Limits and Uptime** IPstack advertises a 99.9% uptime SLA. Rate limits vary by plan tier — free plan users have the lowest monthly caps, while enterprise plans offer higher volumes with burst capacity. For applications requiring very high-throughput geolocation (millions of requests per month), APILayer offers custom enterprise contracts. **Coverage and Accuracy** IPstack's database covers 200,000+ cities globally, including Nigerian cities such as Lagos, Abuja, Kano, Port Harcourt, Ibadan, Benin City, and others. Country-level accuracy is very high (99%+), while city-level accuracy depends on ISP database freshness. For Nigerian users on major ISPs (MTN, Airtel, Glo, 9mobile), coverage is generally reliable at the city level. **Nigeria-Specific Considerations** Nigerian developers should be aware of the following when integrating IPstack: - **Currency Detection**: IPstack will correctly return NGN (Nigerian Naira) for Nigerian IPs, making it ideal for dynamic currency display in e-commerce. - **Timezone**: Returns Africa/Lagos (UTC+1) for Nigerian IPs — correct for all of Nigeria, which operates on a single timezone. - **Connection Type**: Nigeria's mobile-heavy internet landscape means most users will show Cellular connection types via MTN, Airtel, Glo, and 9mobile. This insight can be used to serve lighter-weight media to mobile data users. - **Security Module**: The proxy/VPN detection capabilities are valuable in Nigeria's fintech space, where fraud prevention at the network level adds an additional security layer before heavier KYC checks. - **Free Tier HTTP Limitation**: During development and testing, the HTTP-only free tier is sufficient. For production Nigerian apps handling payment flows or user data, upgrade to HTTPS on a paid plan. **Compliance and Data Privacy** IPstack processes IP addresses, which in some jurisdictions are considered personal data under privacy regulations such as GDPR and Nigeria's NDPR (Nigeria Data Protection Regulation). Developers should: - Not log IP geolocation data unnecessarily - Disclose IP-based geolocation in their privacy policies - Use IPstack data for legitimate product improvement, not surveillance - Review APILayer's data processing agreement for enterprise deployments **Company Background** IPstack is a product of APILayer, a Vienna-based API marketplace that acquired and operates multiple APIs including Numverify (phone validation), MailboxLayer (email validation), CurrencyLayer (forex rates), and others. APILayer positions itself as an affordable, reliable API aggregator for small to medium development teams. The IPstack product has been active since 2013 and has served billions of API calls. **Alternatives** Comparable APIs include IPinfo (which offers a more generous free tier at 50,000 requests/month and includes ASN data), IP-API (free for non-commercial use), and MaxMind GeoIP2 (the industry standard for enterprise accuracy). IPstack's key advantage is its breadth of modules and its integration with the APILayer billing ecosystem. **Frequently Asked Questions** *Can I geolocate multiple IPs in a single request?* Bulk lookup is available on higher-tier plans via batch endpoint. *Is the free tier suitable for production use in Nigeria?* Not recommended due to HTTP-only limitation. Use paid plans for any production environment. *How do I detect Nigerian users specifically?* Check the `country_code` field in the response for `NG` and the `currency.code` for `NGN`. *Does IPstack support IPv6?* Yes, both IPv4 and IPv6 lookups are supported. IPstack is a reliable, affordable choice for Nigerian developers and businesses needing IP-based location intelligence, currency detection, and basic security screening without building or maintaining their own geolocation infrastructure.

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.