Skip to main content
GET
https://connect.jobo.world
/
api
/
locations
/
geocode
curl "https://connect.jobo.world/api/locations/geocode?location=San+Francisco%2C+CA" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "input": "San Francisco, CA",
  "succeeded": true,
  "locations": [
    {
      "city": "San Francisco",
      "region": "California",
      "country": "United States",
      "latitude": 37.7749,
      "longitude": -122.4194,
      "display_name": "San Francisco, California, US",
      "country_code": "US"
    }
  ],
  "method": "pattern_parse"
}
​
location
string
required
Raw location string. Supports cities, states, countries, ISO codes (alpha-2 and alpha-3), airport codes, city aliases, compound expressions (e.g., “US or Canada”), region aliases (EMEA, APAC), and remote keywords. The input is automatically cleaned, normalized, and disambiguated.
​
input
string
The original input string (trimmed).
​
succeeded
boolean
Whether the geocoding was successful.
​
locations
object[]
Array of resolved locations, each containing: - city (string | null) — City name, or null for country/region-level results - region (string | null) — State, province, or region name - country (string) — Full country name (e.g., “United States”, “Germany”) - latitude (number) — WGS 84 latitude coordinate - longitude (number) — WGS 84 longitude coordinate - display_name (string) — Human-readable display string (e.g., “San Francisco, California, US”) - country_code (string) — ISO 3166-1 alpha-2 country code (e.g., “US”, “DE”)
​
method
string
Resolution method used: cache, remote_keyword, pattern_parse, geocoder, or llm. See Resolution Pipeline for details on each tier.
​
error
string
Error message if geocoding failed. Only present when succeeded is false.

​
Compound Location Splitting

When the input contains compound separators (or, and, &), the endpoint automatically splits the string and resolves each part independently. The response contains multiple entries in the locations array. For example, "US or Canada" is split into "US" and "Canada", each resolved through the pipeline. Similarly, "New York and San Francisco" produces two separate location results. See the Compound Location response example below for the full output format. 
curl "https://connect.jobo.world/api/locations/geocode?location=San+Francisco%2C+CA" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "input": "San Francisco, CA",
  "succeeded": true,
  "locations": [
    {
      "city": "San Francisco",
      "region": "California",
      "country": "United States",
      "latitude": 37.7749,
      "longitude": -122.4194,
      "display_name": "San Francisco, California, US",
      "country_code": "US"
    }
  ],
  "method": "pattern_parse"
}