Geoapify

Geoapify Reverse Geocoding API

Resolve coordinates to addresses.

GitHub OpenAPI
Business capability
Geocoding AE-120.10

Operations 1

GET /geocode/reverse Reverse geocode coordinates #

Documentation

📖
Documentation
https://apidocs.geoapify.com/docs/geocoding/reverse-geocoding/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/geoapify/openapi/geoapify-reverse-geocoding-api-openapi.yml
⚙
OpenAPI
https://apidocs.geoapify.com/assets/openapi/specs/reverse-geocoding/reverse-geocoding-api-openapi-specs.json

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/geoapify/json-schema/geoapify-reverse-geocoding-xml-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/geoapify/json-schema/geoapify-geocoding-json-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/geoapify/json-schema/geoapify-reverse-geocoding-feature-collection-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/geoapify:geoapify-reverse-geocoding-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

geoapify-reverse-geocoding-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Geoapify Reverse Geocoding API
  version: 1.1.2
  description: Resolve geographic coordinates to addresses and places.
  contact:
    name: Geoapify
    url: https://geoapify.com
    email: info@geoapify.com
servers:
- url: https://api.geoapify.com/v1
  description: Default API endpoint.
- url: https://api-eu.geoapify.com/v1
  description: EU-focused endpoint. Geoapify service processing uses EU infrastructure.
security:
- ApiKeyInQuery: []
- ApiKeyInHeader: []
tags:
- name: Reverse Geocoding
  description: Resolve coordinates to addresses.
paths:
  /geocode/reverse:
    get:
      tags:
      - Reverse Geocoding
      operationId: reverseGeocode
      summary: Reverse geocode coordinates
      description: 'Finds the nearest address or place for geographic coordinates.


        - Provide both `lat` and `lon`.

        - Use `type` to request a specific location type.

        - Use `limit` to control the number of returned results.


        **Example:** `lat=42.365344&lon=-71.052655`'
      parameters:
      - name: lat
        in: query
        required: true
        description: 'Latitude. Example location: Old Saint Stephens Church, 24 Clark Street, Boston, Massachusetts.'
        schema:
          type: number
          minimum: -90
          maximum: 90
        example: 42.365344
      - name: lon
        in: query
        required: true
        description: Longitude for the same example location.
        schema:
          type: number
          minimum: -180
          maximum: 180
        example: -71.052655
      - name: limit
        in: query
        required: false
        description: Maximum number of results.
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 1
      - name: type
        in: query
        required: false
        description: Requested result type.
        schema:
          type: string
          enum:
          - country
          - state
          - city
          - postcode
          - street
          - amenity
          - locality
          - building
      - name: countrycodes
        in: query
        required: false
        description: ISO 3166-1 alpha-2 country filters.
        schema:
          type: array
          maxItems: 10
          items:
            type: string
            enum:
            - ad
            - ae
            - af
            - ag
            - ai
            - al
            - am
            - an
            - ao
            - ap
            - aq
            - ar
            - as
            - at
            - au
            - aw
            - az
            - ba
            - bb
            - bd
            - be
            - bf
            - bg
            - bh
            - bi
            - bj
            - bm
            - bn
            - bo
            - br
            - bs
            - bt
            - bv
            - bw
            - by
            - bz
            - ca
            - cc
            - cd
            - cf
            - cg
            - ch
            - ci
            - ck
            - cl
            - cm
            - cn
            - co
            - cr
            - cu
            - cv
            - cx
            - cy
            - cz
            - de
            - dj
            - dk
            - dm
            - do
            - dz
            - ec
            - ee
            - eg
            - eh
            - er
            - es
            - et
            - eu
            - fi
            - fj
            - fk
            - fm
            - fo
            - fr
            - ga
            - gb
            - gd
            - ge
            - gf
            - gg
            - gh
            - gi
            - gl
            - gm
            - gn
            - gp
            - gq
            - gr
            - gs
            - gt
            - gu
            - gw
            - gy
            - hk
            - hm
            - hn
            - hr
            - ht
            - hu
            - id
            - ie
            - im
            - il
            - in
            - io
            - iq
            - ir
            - is
            - it
            - je
            - jm
            - jo
            - jp
            - ke
            - kg
            - kh
            - ki
            - km
            - kn
            - kp
            - kr
            - kw
            - ky
            - kz
            - la
            - lb
            - lc
            - li
            - lk
            - lr
            - ls
            - lt
            - lu
            - lv
            - ly
            - ma
            - mc
            - md
            - me
            - mg
            - mh
            - mk
            - ml
            - mm
            - mn
            - mo
            - mp
            - mq
            - mr
            - ms
            - mt
            - mu
            - mv
            - mw
            - mx
            - my
            - mz
            - na
            - nc
            - ne
            - nf
            - ng
            - ni
            - nl
            - 'no'
            - np
            - nr
            - nu
            - nz
            - om
            - pa
            - pe
            - pf
            - pg
            - ph
            - pk
            - pl
            - pm
            - pr
            - ps
            - pt
            - pw
            - py
            - qa
            - re
            - ro
            - rs
            - ru
            - rw
            - sa
            - sb
            - sc
            - sd
            - se
            - sg
            - sh
            - si
            - sj
            - sk
            - sl
            - sm
            - sn
            - so
            - sr
            - st
            - sv
            - sy
            - sz
            - tc
            - td
            - tf
            - tg
            - th
            - tj
            - tk
            - tm
            - tn
            - to
            - tr
            - tt
            - tv
            - tw
            - tz
            - ua
            - ug
            - um
            - us
            - uy
            - uz
            - va
            - vc
            - ve
            - vg
            - vi
            - vn
            - vu
            - wf
            - ws
            - ye
            - yt
            - za
            - zm
            - zw
      - name: lang
        in: query
        required: false
        description: Result language.
        schema:
          type: string
          enum:
          - ab
          - aa
          - af
          - ak
          - sq
          - am
          - ar
          - an
          - hy
          - as
          - av
          - ae
          - ay
          - az
          - bm
          - ba
          - eu
          - be
          - bn
          - bh
          - bi
          - bs
          - br
          - bg
          - my
          - ca
          - ch
          - ce
          - ny
          - zh
          - cv
          - kw
          - co
          - cr
          - hr
          - cs
          - da
          - dv
          - nl
          - en
          - eo
          - et
          - ee
          - fo
          - fj
          - fi
          - fr
          - ff
          - gl
          - ka
          - de
          - el
          - gn
          - gu
          - ht
          - ha
          - he
          - hz
          - hi
          - ho
          - hu
          - ia
          - id
          - ie
          - ga
          - ig
          - ik
          - io
          - is
          - it
          - iu
          - ja
          - jv
          - kl
          - kn
          - kr
          - ks
          - kk
          - km
          - ki
          - rw
          - ky
          - kv
          - kg
          - ko
          - ku
          - kj
          - la
          - lb
          - lg
          - li
          - ln
          - lo
          - lt
          - lu
          - lv
          - gv
          - mk
          - mg
          - ms
          - ml
          - mt
          - mi
          - mr
          - mh
          - mn
          - na
          - nv
          - nb
          - nd
          - ne
          - ng
          - nn
          - 'no'
          - ii
          - nr
          - oc
          - oj
          - cu
          - om
          - or
          - os
          - pa
          - pi
          - fa
          - pl
          - ps
          - pt
          - qu
          - rm
          - rn
          - ro
          - ru
          - sa
          - sc
          - sd
          - se
          - sm
          - sg
          - sr
          - gd
          - sn
          - si
          - sk
          - sl
          - so
          - st
          - es
          - su
          - sw
          - ss
          - sv
          - ta
          - te
          - tg
          - th
          - ti
          - bo
          - tk
          - tl
          - tn
          - to
          - tr
          - ts
          - tt
          - tw
          - ty
          - ug
          - uk
          - ur
          - uz
          - ve
          - vi
          - vo
          - wa
          - cy
          - wo
          - fy
          - xh
          - yi
          - yo
          - za
          default: en
      - name: format
        in: query
        required: false
        description: Response format.
        schema:
          type: string
          enum:
          - json
          - geojson
          - xml
          default: geojson
      responses:
        '200':
          description: Geocoding results.
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/ReverseGeocodingFeatureCollection'
              example:
                type: FeatureCollection
                features:
                - type: Feature
                  properties:
                    datasource:
                      sourcename: openstreetmap
                      attribution: © OpenStreetMap contributors
                      license: Open Database License
                      url: https://www.openstreetmap.org/copyright
                    name: Old Saint Stephens Church
                    country: United States
                    country_code: us
                    state: Massachusetts
                    county: Suffolk County
                    city: Boston
                    postcode: 02109
                    suburb: North End
                    street: Clark Street
                    housenumber: '24'
                    iso3166_2: US-MA
                    lon: -71.0526773
                    lat: 42.3653541
                    state_code: MA
                    distance: 0
                    result_type: amenity
                    formatted: Old Saint Stephens Church, 24 Clark Street, Boston, MA 02109, United States of America
                    address_line1: Old Saint Stephens Church
                    address_line2: 24 Clark Street, Boston, MA 02109, United States of America
                    timezone:
                      name: America/New_York
                      offset_STD: -05:00
                      offset_DST: -04:00
                      offset_STD_seconds: -18000
                      offset_DST_seconds: -14400
                      abbreviation_STD: EST
                      abbreviation_DST: EDT
                    plus_code: 87JC9W8W+4W
                    plus_code_short: 8W+4W, 02109 Boston, United States
                    rank:
                      importance: 0.14389741120638372
                      popularity: 8.536661234137748
                    place_id: 51762f9c105fc351c059d17a53ecc32e4540f00102f901ddf3530e00000000c002019203194f6c64205361696e74205374657068656e7320436875726368
                  geometry:
                    type: Point
                    coordinates:
                    - -71.0526773
                    - 42.3653541
                  bbox:
                  - -71.0529219
                  - 42.3651972
                  - -71.0524232
                  - 42.365485
                query:
                  lat: 42.365344
                  lon: -71.052655
                  plus_code: 87JC9W8W+4W
            application/json:
              schema:
                $ref: '#/components/schemas/GeocodingJsonResponse'
              example:
                results:
                - datasource:
                    sourcename: openstreetmap
                    attribution: © OpenStreetMap contributors
                    license: Open Database License
                    url: https://www.openstreetmap.org/copyright
                  name: Old Saint Stephens Church
                  country: United States
                  country_code: us
                  state: Massachusetts
                  county: Suffolk County
                  city: Boston
                  postcode: 02109
                  suburb: North End
                  street: Clark Street
                  housenumber: '24'
                  iso3166_2: US-MA
                  lon: -71.0526773
                  lat: 42.3653541
                  state_code: MA
                  distance: 0
                  result_type: amenity
                  formatted: Old Saint Stephens Church, 24 Clark Street, Boston, MA 02109, United States of America
                  address_line1: Old Saint Stephens Church
                  address_line2: 24 Clark Street, Boston, MA 02109, United States of America
                  timezone:
                    name: America/New_York
                    offset_STD: -05:00
                    offset_DST: -04:00
                    offset_STD_seconds: -18000
                    offset_DST_seconds: -14400
                    abbreviation_STD: EST
                    abbreviation_DST: EDT
                  plus_code: 87JC9W8W+4W
                  plus_code_short: 8W+4W, 02109 Boston, United States
                  rank:
                    importance: 0.14389741120638372
                    popularity: 8.536661234137748
                  place_id: 51762f9c105fc351c059d17a53ecc32e4540f00102f901ddf3530e00000000c002019203194f6c64205361696e74205374657068656e7320436875726368
                  bbox:
                    lon1: -71.0529219
                    lat1: 42.3651972
                    lon2: -71.0524232
                    lat2: 42.365485
                query:
                  lat: 42.365344
                  lon: -71.052655
                  plus_code: 87JC9W8W+4W
            application/xml:
              schema:
                $ref: '#/components/schemas/ReverseGeocodingXmlResponse'
              example:
                results:
                - datasource:
                    sourcename: openstreetmap
                    attribution: © OpenStreetMap contributors
                    license: Open Database License
                    url: https://www.openstreetmap.org/copyright
                  name: Old Saint Stephens Church
                  country: United States
                  country_code: us
                  state: Massachusetts
                  county: Suffolk County
                  city: Boston
                  postcode: 02109
                  suburb: North End
                  street: Clark Street
                  housenumber: '24'
                  iso3166_2: US-MA
                  lon: -71.0526773
                  lat: 42.3653541
                  state_code: MA
                  distance: 0
                  result_type: amenity
                  formatted: Old Saint Stephens Church, 24 Clark Street, Boston, MA 02109, United States of America
                  address_line1: Old Saint Stephens Church
                  address_line2: 24 Clark Street, Boston, MA 02109, United States of America
                  timezone:
                    name: America/New_York
                    offset_STD: -05:00
                    offset_DST: -04:00
                    offset_STD_seconds: -18000
                    offset_DST_seconds: -14400
                    abbreviation_STD: EST
                    abbreviation_DST: EDT
                  plus_code: 87JC9W8W+4W
                  plus_code_short: 8W+4W, 02109 Boston, United States
                  rank:
                    importance: 0.14389741120638372
                    popularity: 8.536661234137748
                  place_id: 51762f9c105fc351c059d17a53ecc32e4540f00102f901ddf3530e00000000c002019203194f6c64205361696e74205374657068656e7320436875726368
                  bbox:
                    lon1: -71.0529219
                    lat1: 42.3651972
                    lon2: -71.0524232
                    lat2: 42.365485
                query:
                  lat: 42.365344
                  lon: -71.052655
                  plus_code: 87JC9W8W+4W
        '400':
          description: Missing or invalid reverse geocoding coordinates or parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayError'
              example:
                statusCode: 400
                error: Bad Request
                message: '"lat" is required'
        '401':
          description: Missing or invalid Geoapify API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayError'
              example:
                statusCode: 401
                error: Unauthorized
                message: Invalid apiKey
        '429':
          description: Rate limit or quota exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayError'
              example:
                statusCode: 429
                error: Too Many Requests
                message: Quota exceeded
        '500':
          description: Internal gateway error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayError'
              example:
                statusCode: 500
                error: Internal Server Error
                message: Request failed, please try again later
components:
  schemas:
    GenericGeometry:
      type: object
      additionalProperties: true
      required:
      - type
      - coordinates
      properties:
        type:
          type: string
          enum:
          - LineString
          - Polygon
          - MultiPoint
          - MultiLineString
          - MultiPolygon
        coordinates:
          type: array
          items: {}
    GeocodingProperties:
      type: object
      properties:
        name:
          type: string
        continent:
          type: string
        country:
          type: string
        country_code:
          type: string
        region:
          type: string
        state:
          type: string
        state_code:
          type: string
        state_COG:
          type: string
        department_COG:
          type: string
        state_district:
          type: string
        province:
          type: string
        department:
          type: string
        arrondissement:
          type: string
        county:
          type: string
        county_code:
          type: string
        county_district:
          type: string
        city:
          type: string
        city_district:
          type: string
        postcode:
          type: string
        postal_code:
          type: string
        openGeoDB:postal_codes:
          type: string
        district:
          type: string
        suburb:
          type: string
        municipality:
          type: string
        commune:
          type: string
        subdistrict:
          type: string
        city_block:
          type: string
        neighbourhood:
          type: string
        quarter:
          type: string
        section:
          type: string
        sector:
          type: string
        subdivision:
          type: string
        croft:
          type: string
        allotments:
          type: string
        residental:
          type: string
        farm:
          type: string
        farmyard:
          type: string
        industrial:
          type: string
        commercial:
          type: string
        retail:
          type: string
        borough:
          type: string
        town:
          type: string
        township:
          type: string
        village:
          type: string
        hamlet:
          type: string
        locality:
          type: string
        isolated_dwelling:
          type: string
        street:
          type: string
        road:
          type: string
        footway:
          type: string
        pedestrian:
          type: string
        path:
          type: string
        housenumber:
          type: string
        house_number:
          type: string
        house_name:
          type: string
        old_name:
          type: string
        other:
          type: string
        formatted:
          type: string
        address_line1:
          type: string
        address_line2:
          type: string
        unlocode:
          type: string
        iso3166_2:
          type: string
        iso3166_2_sublevel:
          type: string
        iso3166_sublevel:
          type: string
        plus_code:
          type: string
        plus_code_short:
          type: string
        postcodes:
          type: array
          items:
            type: string
        other_names:
          type: object
          additionalProperties:
            type: string
        population:
          type: number
        lon:
          type: number
          minimum: -180
          maximum: 180
        lat:
          type: number
          minimum: -90
          maximum: 90
        parent_as_place_id:
          type: boolean
        timezone:
          $ref: '#/components/schemas/TimezoneOutput'
        NUTS_3:
          type: string
        result_type:
          type: string
          enum:
          - unknown
          - amenity_name
          - amenity
          - building
          - street
          - postcode
          - suburb
          - district
          - city
          - county
          - state
          - country
        distance:
          type: number
        datasource:
          $ref: '#/components/schemas/PublicDatasource'
        rank:
          $ref: '#/components/schemas/GeocodingRank'
        category:
          type: string
        categories:
          type: array
          items:
            type: string
        place_id:
          type: string
          minLength: 3
          maxLength: 2048
        bbox:
          type: object
          required:
          - lon1
          - lat1
          - lon2
          - lat2
          properties:
            lon1:
              type: number
              minimum: -180
              maximum: 180
            lat1:
              type: number
              minimum: -90
              maximum: 90
            lon2:
              type: number
              minimum: -180
              maximum: 180
            lat2:
              type: number
              minimum: -90
              maximum: 90
    GeometryCollection:
      type: object
      required:
      - type
      - geometries
      properties:
        type:
          const: GeometryCollection
        geometries:
          type: array
          items:
            oneOf:
            - $ref: '#/components/schemas/PointGeometry'
            - $ref: '#/components/schemas/GenericGeometry'
            - $ref: '#/components/schemas/GeometryCollection'
    GeocodingRank:
      type: object
      properties:
        confidence:
          type: number
        confidence_city_level:
          type: number
        confidence_street_level:
          type: number
        confidence_building_level:
          type: number
        match_type:
          type: string
          enum:
          - full_match
          - inner_part
          - match_by_building
          - match_by_street
          - match_by_postcode
          - match_by_city_or_disrict
          - match_by_country_or_state
        importance:
          type: number
        popularity:
          type: number
    Feature:
      type: object
      additionalProperties: true
      required:
      - type
      - properties
      - geometry
      properties:
        type:
          const: Feature
        properties:
          $ref: '#/components/schemas/GeocodingProperties'
        geometry:
          oneOf:
          - $ref: '#/components/schemas/PointGeometry'
          - $ref: '#/components/schemas/GenericGeometry'
          - $ref: '#/components/schemas/GeometryCollection'
        bbox:
          type: array
          minItems: 4
          maxItems: 6
          items:
            type: number
    GatewayError:
      type: object
      required:
      - statusCode
      - error
      - message
      properties:
        statusCode:
          type: integer
          description: HTTP status code returned by the gateway.
        error:
          type: string
          description: Standard HTTP error name.
        message:
          type: string
          description: Human-readable explanation of the error.
    PublicDatasource:
      type: object
      properties:
        sourcename:
          type: string
        attribution:
          type: string
        license:
          type: string
        url:
          type: string
          format: uri
    FeatureCollection:
      type: object
      additionalProperties: true
      required:
      - type
      - features
      properties:
        type:
          const: FeatureCollection
        features:
          type: array
          items:
            $ref: '#/components/schemas/Feature'
    ReverseGeocodingFeatureCollection:
      allOf:
      - $ref: '#/components/schemas/FeatureCollection'
      - type: object
        required:
        - query
        properties:
          query:
            $ref: '#/components/schemas/ReverseGeocoderQuery'
    GeocodingJsonResponse:
      type: object
      required:
      - results
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/GeocodingProperties'
        query:
          anyOf:
          - $ref: '#/components/schemas/TextGeocoderQuery'
          - $ref: '#/components/schemas/ReverseGeocoderQuery'
    ReverseGeocoderQuery:
      type: object
      properties:
        lat:
          type: number
          minimum: -90
          maximum: 90
        lon:
          type: number
          minimum: -180
          maximum: 180
        plus_code:
          type: string
        text:
          type: string
        postcode:
          type: string
        city:
          type: string
        state:
          type: string
        country:
          type: string
    ParsedAddress:
      type: object
      properties:
        po_box:
          type: string
        unit:
          type: string
        house:
          type: string
        housenumber:
          type: string
        street:
          type: string
        suburb:
          type: string
        postcode:
          type: string
        district:
          type: string
        city:
          type: string
        county:
          type: string
        state:
          type: string
        region:
          type: string
        country:
          type: string
        expected_type:
          type: string
          enum:
          - unknown
          - amenity_name
          - amenity
          - building
          - street
          - postcode
          - suburb
          - district
          - city
          - county
          - state
          - country
    PointGeometry:
      type: object
      required:
      - type
      - coordinates
      properties:
        type:
          const: Point
        coordinates:
          $ref: '#/components/schemas/Position'
    TimezoneOutput:
      type: object
      required:
      - name
      - offset_STD
      - offset_DST
      - offset_STD_seconds
      - offset_DST_seconds
      properties:
        name:
          type: string
        name_alt:
          type: string
        country_codes:
          type: array
          items:
            type: string
        offset_STD:
          type: string
        offset_DST:
          type: string
        offset_STD_seconds:
          type: number
        offset_DST_seconds:
          type: number
        abbreviation_STD:
          type: string
        abbreviation_DST:
          type: string
    Position:
      type: array
      minItems: 2
      maxItems: 3
      prefixItems:
      - type: number
        minimum: -180
        maximum: 180
      - type: number
        minimum: -90
        maximum: 90
      - type: number
      items:
        not: {}
    ReverseGeocodingXmlResponse:
      type: object
      required:
      - results
      xml:
        name: root
      properties:
        results:
          type: array
          xml:
            name: results
            wrapped: false
          items:
            $ref: '#/components/schemas/GeocodingProperties'
            xml:
              name: results
        query:
          $ref: '#/components/schemas/ReverseGeocoderQuery'
          xml:
            name: query
    TextGeocoderQuery:
      type: object
      properties:
        lat:
          type: number
          minimum: -90
          maximum: 90
        lon:
          type: number
          minimum: -180
          maximum: 180
        plus_code:
          type: string
        text:
          type: string
        postcode:
          type: string
        city:
          type: string
        state:
          type: string
        country:
          type: string
        housenumber:
          type: string
        street:
          type: string
        parsed:
          $ref: '#/components/schemas/ParsedAddress'
        categories:
          type: array
          items:
            type: object
            required:
            - keys
            - label
            properties:
              keys:
                type: array
                items:
                  type: string
              label:
                type: string
  securitySchemes:
    ApiKeyInQuery:
      type: apiKey
      in: query
      name: apiKey
      description: Geoapify API key query parameter. Recommended authentication method for public APIs. API keys in URLs can be logged; use x-api-key for server-to-server clients.
    ApiKeyInHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: Geoapify API key header. Supported as an alternative authentication method for public APIs.
x-provenance:
  method: harvested
  publisher: Geoapify
  source: https://apidocs.geoapify.com/assets/openapi/specs/reverse-geocoding/reverse-geocoding-api-openapi-specs.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)