How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

APIFreaks - API Hub for Developers GeoDB APIs API

The GeoDB APIs API from APIFreaks - API Hub for Developers — 8 operation(s) for geodb apis.

APIFreaks - API Hub for Developers GeoDB APIs API is one of 27 APIs that APIFreaks - API Hub for Developers publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include GeoDB APIs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

This API exposes 8 operations across 8 paths, and defines 13 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.apifreaks.com/v1.0.

8 operations 8 paths 13 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.apifreaks.com/v1.0/
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

APIFreaks - API Hub for Developers GeoDB APIs API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-apiKey (ApiKeyAuthHeader). An API key is passed in the query as apiKey (ApiKeyAuthQuery). By default, every request must be authenticated.

  • ApiKeyAuthHeader — Pass your API key via the X-apiKey request header.
  • ApiKeyAuthQuery — Pass your API key via the apiKey query parameter.

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

GeoDB APIs 8
GET
/geo/admin-unit/details
Retrieve detailed information about a specific administrative unit
getAdminUnitDetails 3 params → 200400404
GET
/geo/admin-levels
Retrieve administrative level types for a country
getAdminLevels 2 params → 200400404
GET
/geo/admin-units
Retrieve administrative units for a country with optional level filtering
getAdminUnits 3 params → 200400404
GET
/geo/cities
Retrieve cities for a country with optional admin unit filtering
getCities 3 params → 200400404
GET
/geo/country/details
Retrieve comprehensive metadata for a specific country
getCountryDetails 2 params → 200400
GET
/geo/countries
Retrieve a list of countries with optional region or subregion filtering
getCountries 3 params → 200400
GET
/geo/regions
Retrieve all geographical regions
getRegions 1 param → 200
GET
/geo/subregions
Retrieve subregions for a specific geographical region
getSubregionsByRegion 2 params → 200400404

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are CountryDetailsResponse (15 properties), CountryItem (7 properties), AdminUnitDetailsResponse (6 properties), ErrorResponse (5 properties). Each schema is shown below with its type and property counts.

CountriesResponse
object
Response containing the list of countries matching the applied region/subregion filters (or all 250 when unfiltered).
1 property 1 required
AdminLevelsResponse
object
Response containing the distinct administrative level types defined for the requested country.
1 property 1 required
AdminUnitsResponse
object
Response containing the administrative units for the requested country, optionally filtered by adminlevel.
1 property 1 required
AdminUnit_2
object
An object describing the administrative unit the city belongs to.
3 properties 3 required
ErrorResponse
object
Standard error envelope returned by the API on failed requests.
5 properties 1 required
AdminUnit
object
An administrative unit object.
3 properties 3 required
CitiesResponse
object
Response containing every city for the requested country (optionally filtered by adminunit), returned unpaginated in a single array.
1 property 1 required
CityItem
object
A city object containing name, coordinates, admin unit, and country code.
5 properties 5 required
SubregionsResponse
object
Response containing subregion names for the requested region, or all subregions across every region when unfiltered.
1 property 1 required
CountryItem
object
A country object containing ISO codes, capital, and region information.
7 properties 7 required
AdminUnitDetailsResponse
object
Detailed information for a single administrative unit resolved from a country code and admin unit code.
6 properties 5 required
CountryDetailsResponse
object
Comprehensive metadata for a single country resolved from an ISO 3166-1 alpha-2 code.
15 properties 15 required
RegionsResponse
object
Response containing the flat list of geographical regions supported by the GeoDB service.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

apifreaks-api-hub-for-developers-geodb-apis-api-openapi.yml Raw ↑

Other APIs APIFreaks - API Hub for Developers publishes across the network.

APIFreaks MCP Server
APIFreaks - API Hub for Developers Commodity APIs API
APIFreaks - API Hub for Developers Currency APIs API
APIFreaks - API Hub for Developers DNS APIs API
APIFreaks - API Hub for Developers Domain APIs API
APIFreaks - API Hub for Developers Email Validation APIs API
APIFreaks - API Hub for Developers Financial APIs API
APIFreaks - API Hub for Developers Flags APIs API
APIFreaks - API Hub for Developers General APIs API
APIFreaks - API Hub for Developers Geocoder APIs API
APIFreaks - API Hub for Developers IP Geolocation APIs API
APIFreaks - API Hub for Developers Other APIs API
Where this information came from

This is an independent, third-party profile of APIFreaks - API Hub for Developers GeoDB APIs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.