geocode

Forward geocoding - free-text address or place name...

Forward geocoding — free-text address or place name → latitude/longitude plus structured address components (houseNumber, road, suburb, city, county, state, postcode, country, countryCode). Query: q (2-500 chars), limit (1-10, default 5), country (optional 2-letter ISO 3166-1 bias). Underlying data is OpenStreetMap (ODbL). Sister: /api/geocode/reverse.

get/api/geocode/address

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/geocode/address
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

qstring required

Free-text search query.

limitinteger

Maximum number of results to return.

countrystring

Country name or ISO country code.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.