GlobeAPI— documentation

Documentation · v1

GlobeAPI reference.

60 documented endpoints across flights, hotels, places, AI, voice, moderation, trip planning, geocoding, routing and weather. Availability, access requirements and response codes are shown on every endpoint. No signup required to read any of this.

Quickstart

Authenticate, then call.

REST endpoints use X-API-Key. Embedded widgets use X-Widget-Key and widget scopes. Access remains subject to each endpoint’s published plan and availability.

To test a server-side REST integration before production approval, create a Test key with the required REST scopes, your website’s exact origin, and your server’s IP on its allowlists. Send that origin in the request’s Origin header. Read-only routes such as weather, currency, places, and AI chat return X-GoGlobe-Test-Mode: true. Booking routes remain unavailable in Test mode. Keep this REST key on your server; a widget key does not gain REST scopes automatically.

Base URL: https://goglobe.live
Authentication: Send REST keys in X-API-Key from your server. Use X-Widget-Key for allowlisted widget embeds. Keep REST keys out of client-side code.
Responses: Successful requests return the same envelope: status plus data. Errors return status, code and detail.
Limits and safe retries: Each endpoint lists its request limit. For operations that accept an Idempotency-Key, reuse the same key only when retrying the identical request.

Get your API key

Any request — authentication

curl "https://goglobe.live/api/v1/places/search?query=coffee%20shop&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

Your first call

curl "https://goglobe.live/api/v1/cities/search?query=tokyo&limit=3" \
  -H "X-API-Key: YOUR_API_KEY"

API reference · 60 endpoints

Every endpoint, in full.

52 live · 5 managed · 3 coming soon

Places

Search PlacesLive API

GET/api/v1/places/search

Place-type search around a point.

Limit · 30 req/min

Parameters

querystringrequired

Type of place to find — e.g. "coffee shop", "restaurant", "museum", "park". Short single-concept terms work best.

latnumberoptional

Optional latitude to anchor the search. When supplied with lng, search runs within ~50 km using the search_tags GIN index.

lngnumberoptional

Optional longitude to anchor the search.

limitintegeroptional

Number of results (1-20, default 10)

curl "https://goglobe.live/api/v1/places/search?query=coffee%20shop&lat=53.3498&lng=-6.2603&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/places/search"
params = {"query": "coffee shop", "lat": "53.3498", "lng": "-6.2603", "limit": "10"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/places/search?query=coffee%20shop&lat=53.3498&lng=-6.2603&limit=10", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "place_id": "gg_IRL_node_1234567",
      "source": "goglobe",
      "name": "The Woollen Mills",
      "latitude": 53.3465,
      "longitude": -6.2586,
      "category": "restaurant",
      "subcategories": [
        "amenity",
        "restaurant"
      ],
      "address": "42 Ormond Quay Lower, Dublin",
      "country_code": "IRL",
      "locality": "Dublin"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 10
  }
}

Places NearbyLive API

GET/api/v1/places/nearby

Find places near a specific coordinate.

Limit · 30 req/min

Parameters

latnumberrequired

Latitude

lngnumberrequired

Longitude

radiusintegeroptional

Radius in metres (m). Default 1000 m (1 km). Max 50000 m (50 km).

categorystringoptional

Filter by broad or specific category, such as cafe, restaurant, museum, pharmacy or hotel.

limitintegeroptional

Max results (1-15, default 10). Use /places/search for larger sets.

curl "https://goglobe.live/api/v1/places/nearby?lat=53.3498&lng=-6.2603&radius=1000" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/places/nearby"
params = {"lat": "53.3498", "lng": "-6.2603", "radius": "1000"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/places/nearby?lat=53.3498&lng=-6.2603&radius=1000", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "place_id": "gg_IRL_node_9876543",
      "source": "goglobe",
      "name": "Kaph",
      "primary_category": "cafe",
      "main_category": "cafe",
      "subcategories": [],
      "address": "31 Drury St, Dublin",
      "distance_m": 120
    }
  ],
  "meta": {
    "total": 1,
    "radius_m": 1000
  }
}

Place Details (coming soon)Coming soon503 until released

GET/api/v1/places/details

In active rebuild — GoGlobe-validated enrichment is being prepared. The endpoint currently returns 503 and is not billed; use /places/search and /places/nearby in the meantime.

Limit · 30 req/min

Parameters

place_idstringrequired

The opaque gg_* place_id returned by /search or /nearby.

Not callable yet

This endpoint is documented for forward planning. It currently returns the availability response below and is not billable.

Response · 503 Service Unavailable

{
  "status": "error",
  "code": "coming_soon",
  "detail": "This endpoint is coming soon and is not billable while in this state."
}

Places AutocompleteLive API

GET/api/v1/places/autocomplete

Real-time typeahead suggestions for place-name forms.

Limit · 60 req/min

Parameters

querystringrequired

Partial text the user has typed

latnumberoptional

Bias toward this coordinate

lngnumberoptional

Bias toward this coordinate

countrystringoptional

Optional ISO-3 country filter. Must match the country of the lat/lng — e.g. "IRL" for Dublin, "ESP" for Madrid. Leave blank for global.

limitintegeroptional

1–15, default 8

curl "https://goglobe.live/api/v1/places/autocomplete?query=temp&lat=53.3498&lng=-6.2603&limit=8" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/places/autocomplete"
params = {"query": "temp", "lat": "53.3498", "lng": "-6.2603", "limit": "8"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/places/autocomplete?query=temp&lat=53.3498&lng=-6.2603&limit=8", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "place_id": "gg_IRL_way_76592311",
      "source": "goglobe",
      "name": "Temple Bar",
      "category": "attraction",
      "locality": "Dublin",
      "country_code": "IRL",
      "latitude": 53.3450846,
      "longitude": -6.2605819
    }
  ],
  "meta": {
    "total": 1,
    "query": "temp"
  }
}

Search Cities & AirportsLive API

GET/api/v1/cities/search

Search for cities and airports worldwide.

Limit · 30 req/min

Parameters

querystringrequired

City or airport name

countrystringoptional

Filter by ISO-3 country code (e.g., "ESP" for Spain)

excludeAirportsbooleanoptional

Exclude airport results

curl "https://goglobe.live/api/v1/cities/search?query=Dublin&excludeAirports=false" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/cities/search"
params = {"query": "Dublin", "excludeAirports": "false"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/cities/search?query=Dublin&excludeAirports=false", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "country": "Ireland",
      "cities": [
        {
          "name": "Dublin",
          "lat": 53.3498,
          "lng": -6.2603
        }
      ],
      "airports": [
        {
          "iata": "DUB",
          "name": "Dublin Airport",
          "lat": 53.4264
        }
      ]
    }
  ]
}

Flights & Hotels

Search FlightsManaged integration

POST/api/v1/flights/search

Search for flight offers across 600+ airlines.

Limit · 10 req/minIdempotency · optional

Flight and hotel inventory is activated as a managed GlobeAPI integration. We handle the connection, booking controls and launch path with you.

Email [email protected]View integration overview →

Parameters

originstringrequired

Origin city name or IATA code

destinationstringrequired

Destination city name or IATA code

departure_datestringrequired

Departure date (YYYY-MM-DD)

return_datestringoptional

Return date for round trip (must be after departure_date)

adultsintegeroptional

Number of adult passengers (default 1)

childrenintegeroptional

Number of child passengers aged 2-11 (default 0)

infantsintegeroptional

Number of infant passengers under 2 (default 0)

cabin_classstringoptional

economy, premium_economy, business, first

Access by integration

This travel capability is configured with GoGlobe as part of a managed integration. The request shape is shown at left for planning, but it is not a self-serve API call.

Request integration access →

Response · 503 Service Unavailable

{
  "status": "error",
  "code": "coming_soon",
  "detail": "This capability is available through a managed GlobeAPI integration. Contact support to discuss access."
}

Book FlightManaged integration

POST/api/v1/flights/book

Not yet generally available — creates a flight booking from a selected offer once your account is enabled for ticket issuance.

Limit · 5 req/minIdempotency · required

Flight and hotel inventory is activated as a managed GlobeAPI integration. We handle the connection, booking controls and launch path with you.

Email [email protected]View integration overview →

Parameters

offer_idstringrequired

The offer ID from search results

passengersarrayrequired

Array of passenger details (JSON)

paymentobjectrequired

Payment information (JSON)

Access by integration

This travel capability is configured with GoGlobe as part of a managed integration. The request shape is shown at left for planning, but it is not a self-serve API call.

Request integration access →

Response · 503 Service Unavailable

{
  "status": "error",
  "code": "coming_soon",
  "detail": "This capability is available through a managed GlobeAPI integration. Contact support to discuss access."
}

Live Flight PositionLive API

GET/api/v1/flights/live

Real-time position for an in-flight aircraft by callsign (e.g.

Limit · 60 req/min

Parameters

callsignstringoptional

Flight callsign (preferred when known)

icao24stringoptional

ICAO24 transponder hex

curl "https://goglobe.live/api/v1/flights/live?callsign=BAW249&icao24=a8fd3c" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/flights/live"
params = {"callsign": "BAW249", "icao24": "a8fd3c"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/flights/live?callsign=BAW249&icao24=a8fd3c", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "icao24": "a8fd3c",
      "callsign": "AAL1002",
      "registration": "N123AA",
      "aircraft_type": "B738",
      "aircraft_description": "BOEING 737-800",
      "latitude": 39.9356,
      "longitude": -85.638,
      "baro_altitude_ft": 35000,
      "ground_speed_kts": 502,
      "heading_deg": 145.87,
      "on_ground": false,
      "source": "adsb"
    }
  ],
  "meta": {
    "total": 1,
    "source": "goglobe"
  }
}

Aircraft in BBoxLive API

GET/api/v1/flights/live/bbox

All live aircraft inside a lat/lng bounding box.

Limit · 20 req/min

Parameters

laminnumberrequired

Lower latitude bound

lominnumberrequired

Lower longitude bound

lamaxnumberrequired

Upper latitude bound

lomaxnumberrequired

Upper longitude bound

limitintegeroptional

1-500, default 100

curl "https://goglobe.live/api/v1/flights/live/bbox?lamin=45.0&lomin=-10.0&lamax=55.0&lomax=5.0&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/flights/live/bbox"
params = {"lamin": "45.0", "lomin": "-10.0", "lamax": "55.0", "lomax": "5.0", "limit": "100"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/flights/live/bbox?lamin=45.0&lomin=-10.0&lamax=55.0&lomax=5.0&limit=100", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "icao24": "4ca7b4",
      "callsign": "RYR2A",
      "latitude": 51.48,
      "longitude": -0.46,
      "baro_altitude_ft": 37000,
      "ground_speed_kts": 452,
      "heading_deg": 89,
      "on_ground": false,
      "origin_country": "Ireland",
      "source": "adsb"
    }
  ],
  "meta": {
    "total": 1,
    "source": "goglobe"
  }
}

Aircraft LookupLive API

GET/api/v1/flights/aircraft

Live state for a single aircraft by ICAO24 transponder hex.

Limit · 60 req/min

Parameters

icao24stringrequired

ICAO24 transponder hex (lowercase)

curl "https://goglobe.live/api/v1/flights/aircraft?icao24=a8fd3c" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/flights/aircraft"
params = {"icao24": "a8fd3c"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/flights/aircraft?icao24=a8fd3c", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "icao24": "a8fd3c",
    "callsign": "AAL1002",
    "registration": "N123AA",
    "aircraft_type": "B738",
    "aircraft_description": "BOEING 737-800",
    "latitude": 39.9356,
    "longitude": -85.638,
    "baro_altitude_ft": 35000,
    "ground_speed_kts": 502,
    "heading_deg": 145,
    "source": "adsb"
  },
  "meta": {
    "source": "goglobe"
  }
}

US Airport DelaysLive API

GET/api/v1/airports/delays

Live airport-level delay status sourced from the FAA National Airspace System status feed.

Limit · 30 req/min

Parameters

airportstringoptional

ICAO or IATA airport code (optional)

curl "https://goglobe.live/api/v1/airports/delays?airport=KJFK" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/airports/delays"
params = {"airport": "KJFK"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/airports/delays?airport=KJFK", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "airport_iata": "JFK",
      "type": "arrival_delay",
      "reason": "WEATHER / LOW CEILINGS",
      "avg_delay": "45 minutes",
      "trend": "Increasing"
    }
  ],
  "meta": {
    "total": 1,
    "airport": "KJFK",
    "source": "goglobe",
    "coverage": "US airports only"
  }
}

Flight StatusLive API

GET/api/v1/flights/status

Live flight status derived from our own ADS-B stack — route, live position, altitude, speed, registration and aircraft type. Observation, not airline schedule data: scheduled times, gates and terminals are not available.

Limit · 20 req/min

Parameters

flight_numberstringrequired

Flight number, e.g. "BA117" (IATA) or "BAW117" (ICAO). 3-8 characters.

datestringoptional

ISO date (YYYY-MM-DD). Defaults to today. Live tracking reflects current observation only — this does NOT retrieve historical flights, and a past date returns a warning in meta.

curl "https://goglobe.live/api/v1/flights/status?flight_number=BA249&date=2026-10-14" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/flights/status"
params = {"flight_number": "BA249", "date": "2026-10-14"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/flights/status?flight_number=BA249&date=2026-10-14", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "flight_number": "BA249",
    "callsign": "BAW249",
    "status": "in_air",
    "airline": "British Airways",
    "aircraft": {
      "icao24": "4008f3",
      "registration": "G-VIIA",
      "type": "B772"
    },
    "route": {
      "origin": "LHR",
      "destination": "GRU"
    },
    "position": {
      "lat": 51.12,
      "lng": -1.04,
      "altitude_ft": 37000,
      "ground_speed_kt": 486,
      "heading": 218,
      "vertical_rate_fpm": 0,
      "squawk": "2456",
      "on_ground": false,
      "observed_at": "2026-10-14T14:12:00+00:00"
    },
    "coverage": {
      "scheduled_times": false,
      "gate": false,
      "terminal": false,
      "live_position": true,
      "route": true,
      "note": "Derived from ADS-B observation. Scheduled times, gates and terminals require airline schedule data and are not included."
    }
  },
  "meta": {
    "source": "goglobe",
    "date": "2026-10-14"
  }
}

Search Hotels (Widget)Live API

POST/api/v1/widget/hotels/search

Search the Hotels widget feed. Use a widget key with widget:hotels scope. Radius defaults to 30 km (1–100 km). Results are sorted and filtered before paging; follow next_cursor with the same search fields. Test results cannot be booked. Legacy city, check_in and check_out names are temporarily accepted with a deprecation warning.

Limit · 40+ req/min by planScopes · widget:hotels

Parameters

destinationstringrequired

City name or choose coordinates

check_in_datestringrequired

Check-in date (YYYY-MM-DD)

check_out_datestringrequired

Check-out date (YYYY-MM-DD)

adultsintegeroptional

Number of adults (default 2)

roomsintegeroptional

Number of rooms (default 1)

radius_kmnumberoptional

Search radius in km (1–100, default 30)

sortstringoptional

picks, price, rating or distance

cursorstringoptional

Opaque next_cursor from a previous response

curl -X POST "https://goglobe.live/api/v1/widget/hotels/search" \
  -H "X-Widget-Key: YOUR_WIDGET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "destination": "Paris",
  "check_in_date": "2026-11-13",
  "check_out_date": "2026-11-16",
  "adults": 2,
  "rooms": 1,
  "radius_km": 30,
  "sort": "distance",
  "limit": 12
}'

import requests

WIDGET_KEY = "YOUR_WIDGET_KEY"
url = "https://goglobe.live/api/v1/widget/hotels/search"
body = {'destination': 'Paris', 'check_in_date': '2026-11-13', 'check_out_date': '2026-11-16', 'adults': 2, 'rooms': 1, 'radius_km': 30, 'sort': 'distance'}
r = requests.post(url, json=body, headers={"X-Widget-Key": WIDGET_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/widget/hotels/search", {
  method: "POST",
  headers: {
    "X-Widget-Key": "YOUR_WIDGET_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "destination": "Paris",
  "check_in_date": "2026-11-13",
  "check_out_date": "2026-11-16",
  "adults": 2,
  "rooms": 1,
  "radius_km": 30,
  "sort": "distance"
})
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "hotels": [],
    "total": 0,
    "has_more": false,
    "next_cursor": null,
    "test_mode": true
  }
}

Hotels REST SearchManaged integration

POST/api/v1/hotels/search

Hotel search and booking are available on request through a managed GlobeAPI integration. This standalone REST endpoint is not a self-serve call; contact support to scope access for your product.

Limit · 10 req/minIdempotency · optional

Flight and hotel inventory is activated as a managed GlobeAPI integration. We handle the connection, booking controls and launch path with you.

Email [email protected]View integration overview →

Parameters

destinationstringrequired

City name

check_in_datestringrequired

Check-in date (YYYY-MM-DD)

check_out_datestringrequired

Check-out date (YYYY-MM-DD)

adultsintegeroptional

Number of adults (default 2)

roomsintegeroptional

Number of rooms (default 1)

Access by integration

This travel capability is configured with GoGlobe as part of a managed integration. The request shape is shown at left for planning, but it is not a self-serve API call.

Request integration access →

Response · 503 Service Unavailable

{
  "status": "error",
  "code": "coming_soon",
  "detail": "This capability is available through a managed GlobeAPI integration. Contact support to discuss access."
}

ADS-B Firehose (SSE stream)Live API

GET/api/v1/firehose/adsb

Real-time Server-Sent Events stream of live aircraft positions worldwide.

Limit · 1 concurrent connection per API key

Parameters

laminnumberoptional

Lower latitude bound (optional bbox filter; all 4 bounds required together)

lominnumberoptional

Lower longitude bound

lamaxnumberoptional

Upper latitude bound

lomaxnumberoptional

Upper longitude bound

categorystringoptional

'commercial' (the global fleet — the default) | 'all' (alias of 'commercial') | 'mil' | 'ladd' | 'pia'. Frames are labelled with the resolved category, so passing 'all' returns category: 'commercial'.

curl -N "https://goglobe.live/api/v1/firehose/adsb?lamin=45.0&lomin=-10.0&lamax=55.0&lomax=5.0&category=mil" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/firehose/adsb"
params = {"lamin": "45.0", "lomin": "-10.0", "lamax": "55.0", "lomax": "5.0", "category": "mil"}
with requests.get(url, params=params, headers={"X-API-Key": API_KEY}, stream=True) as r:
    for line in r.iter_lines(decode_unicode=True):
        if line:
            print(line)

const r = await fetch("https://goglobe.live/api/v1/firehose/adsb?lamin=45.0&lomin=-10.0&lamax=55.0&lomax=5.0&category=mil", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

event: aircraft_batch
data: {"aircraft":[{"icao24":"a8fd3c","callsign":"AAL1002","latitude":39.94,"longitude":-85.64,"baro_altitude_ft":35000,"ground_speed_kts":502,"heading_deg":145,"on_ground":false}],"ts":1745347200,"category":"commercial"}

: heartbeat

Aircraft Trail (last 10 min)Live API

GET/api/v1/firehose/aircraft/{icao24}/track

Last ~10 minutes of position points for a single aircraft, served from the in-memory track buffer. Useful for plotting recent flight path on a map. Requires Firehose subscription.

Limit · 60 req/min

Parameters

icao24stringrequired

ICAO 24-bit hex code, case-insensitive. Substituted into the path.

curl "https://goglobe.live/api/v1/firehose/aircraft/4CAA6F/track" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/firehose/aircraft/4CAA6F/track"
r = requests.get(url, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/firehose/aircraft/4CAA6F/track", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "icao24": "4caa6f",
    "points": [
      {
        "lat": 53.342,
        "lng": -6.25,
        "alt": 32000,
        "hdg": 87.4,
        "gs": 458,
        "ts": 1714658400
      },
      {
        "lat": 53.341,
        "lng": -6.244,
        "alt": 32000,
        "hdg": 87.5,
        "gs": 459,
        "ts": 1714658405
      }
    ],
    "duration_sec": 600
  }
}

Firehose Status (Public)Live API

GET/api/v1/firehose/status

Public status / SLA endpoint — uptime + per-category health. No authentication required so prospective merchants can verify reliability before subscribing. SLA target 99.5%.

Limit · 60 req/min

curl "https://goglobe.live/api/v1/firehose/status"

import requests
r = requests.get("https://goglobe.live/api/v1/firehose/status")
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/firehose/status");
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "operational",
  "checked_at": "2026-10-14T22:00:00Z",
  "categories": {
    "commercial": {
      "status": "operational",
      "aircraft_count": 2405,
      "latency_ms": 2447,
      "last_healthy_at": "2026-10-14T22:00:00Z"
    },
    "mil": {
      "status": "operational",
      "aircraft_count": 89,
      "latency_ms": 909,
      "last_healthy_at": "2026-10-14T22:00:00Z"
    },
    "ladd": {
      "status": "operational",
      "aircraft_count": 12,
      "latency_ms": 865,
      "last_healthy_at": "2026-10-14T22:00:00Z"
    },
    "pia": {
      "status": "operational",
      "aircraft_count": 2,
      "latency_ms": 1322,
      "last_healthy_at": "2026-10-14T22:00:00Z"
    }
  },
  "uptime": {
    "last_24h": 99.97,
    "last_7d": 99.86,
    "last_30d": 99.78,
    "sla_target": 99.5
  },
  "incidents_last_30d": 2
}

Aviation WeatherLive API

GET/api/v1/aviation/weather

METAR (current observation) and TAF (forecast) for any ICAO airport.

Limit · 30 req/min

Parameters

icaostringrequired

ICAO airport code (4 letters, e.g. EIDW=Dublin, KJFK=New York JFK)

curl "https://goglobe.live/api/v1/aviation/weather?icao=EIDW" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/aviation/weather"
params = {"icao": "EIDW"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/weather?icao=EIDW", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "icao": "EIDW",
    "metar": {
      "raw": "EIDW 251800Z 18012KT 9999 SCT025 BKN035 12/09 Q1018",
      "observed_at": "2026-04-25T18:00:00Z",
      "temp_c": 12,
      "dewpoint_c": 9,
      "wind_dir_deg": 180,
      "wind_speed_kt": 12,
      "visibility_sm": 6.21,
      "altimeter_hpa": 1018,
      "flight_category": "VFR"
    },
    "taf": {
      "raw": "EIDW 251700Z 2518/2624 18012KT 9999 SCT020",
      "issue_time": "2026-04-25T17:00:00Z"
    }
  }
}

Discover Hotels (DB)Managed integration

GET/api/v1/hotels/discover

Find hotels, hostels, apartments and other accommodation near a point in our places DB. No live availability or pricing; the Hotels widget provides the current bookable flow.

Limit · 60 req/min

Flight and hotel inventory is activated as a managed GlobeAPI integration. We handle the connection, booking controls and launch path with you.

Email [email protected]View integration overview →

Parameters

latnumberrequired

Latitude

lngnumberrequired

Longitude

radiusintegeroptional

Search radius in metres (m). Range 100–50000 m (= up to 50 km). Default 5000 m (5 km).

limitintegeroptional

Max results (1-15, default 10)

categorystringoptional

Optional category filter. One of: alpine_hut, apartment, bed_and_breakfast, camp_site, caravan_site, chalet, guest_house, hostel, hotel, motel, resort

qstringoptional

Optional free-text keyword search against name

Access by integration

This travel capability is configured with GoGlobe as part of a managed integration. The request shape is shown at left for planning, but it is not a self-serve API call.

Request integration access →

Response · 503 Service Unavailable

{
  "status": "error",
  "code": "coming_soon",
  "detail": "This capability is available through a managed GlobeAPI integration. Contact support to discuss access."
}

Geocoding

Reverse GeocodeLive API

GET/api/v1/geocode/reverse

Convert a lat/lng pair into a human-readable address.

Limit · 30 req/min

Parameters

latnumberrequired

Latitude

lngnumberrequired

Longitude

curl "https://goglobe.live/api/v1/geocode/reverse?lat=53.3498&lng=-6.2603" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/geocode/reverse"
params = {"lat": "53.3498", "lng": "-6.2603"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/geocode/reverse?lat=53.3498&lng=-6.2603", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "display_name": "Trinity College, College Green, Dublin 2, Ireland",
    "street": "College Green",
    "city": "Dublin",
    "region": "Leinster",
    "country": "Ireland",
    "postal_code": "D02",
    "lat": 53.3438,
    "lng": -6.2546
  },
  "meta": {
    "source": "goglobe"
  }
}

Forward GeocodeLive API

GET/api/v1/geocode/forward

Convert an address or landmark name to coordinates.

Limit · 30 req/min

Parameters

addressstringrequired

Full or partial address, landmark name, or POI

countrystringoptional

ISO-3166 alpha-3 country filter

limitintegeroptional

1–10, default 5

curl "https://goglobe.live/api/v1/geocode/forward?address=Trinity%20College%20Dublin&country=IRL&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/geocode/forward"
params = {"address": "Trinity College Dublin", "country": "IRL", "limit": "5"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/geocode/forward?address=Trinity%20College%20Dublin&country=IRL&limit=5", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "place_id": "gg_place_311466843",
      "source": "goglobe",
      "name": "Trinity College Dublin",
      "latitude": 53.3437375,
      "longitude": -6.2544619,
      "formatted_address": "College Green, Dublin",
      "country_code": "IRL",
      "locality": "Dublin",
      "postal_code": null,
      "category": "amenity",
      "precision": "poi"
    }
  ],
  "meta": {
    "total": 1,
    "query": "Trinity College Dublin"
  }
}

Timezone LookupLive API

GET/api/v1/timezone

Return the IANA timezone at any lat/lng plus current UTC offset (DST-aware) and local time.

Limit · 60 req/min

Parameters

latnumberrequired

Latitude (-90 to 90)

lngnumberrequired

Longitude (-180 to 180)

curl "https://goglobe.live/api/v1/timezone?lat=53.3498&lng=-6.2603" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/timezone"
params = {"lat": "53.3498", "lng": "-6.2603"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/timezone?lat=53.3498&lng=-6.2603", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "timezone": "Europe/Dublin",
    "utc_offset_seconds": 3600,
    "utc_offset": "+01:00",
    "dst_active": true,
    "current_time": "2026-10-14T14:32:50+01:00"
  }
}

Hotels

Book HotelManaged integration

POST/api/v1/hotels/book

Hotel booking is available on request through a managed GlobeAPI integration.

Limit · 10 req/min

Flight and hotel inventory is activated as a managed GlobeAPI integration. We handle the connection, booking controls and launch path with you.

Email [email protected]View integration overview →

Parameters

rate_idstringrequired

Room rate identifier from /hotels/search

guestobjectrequired

Primary guest details

Access by integration

This travel capability is configured with GoGlobe as part of a managed integration. The request shape is shown at left for planning, but it is not a self-serve API call.

Request integration access →

Response · 503 Service Unavailable

{
  "status": "error",
  "code": "coming_soon",
  "detail": "This capability is available through a managed GlobeAPI integration. Contact support to discuss access."
}

Travel AI

AI Travel ChatLive API

POST/api/v1/ai/chat

Text-based AI travel assistant powered by Seol AI.

Limit · 10 req/min

Parameters

messagestringrequired

User message or travel question

curl -X POST "https://goglobe.live/api/v1/ai/chat" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "message": "Name the top 3 restaurants in Dublin, Ireland — one short line each."
}'

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/ai/chat"
body = {'message': 'Name the top 3 restaurants in Dublin, Ireland — one short line each.'}
r = requests.post(url, json=body, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/ai/chat", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "message": "Name the top 3 restaurants in Dublin, Ireland — one short line each."
})
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "response": "Here are the top restaurants near the Eiffel Tower:\\n\\n1. **Le Jules Verne** — Michelin-starred dining on the second floor...",
    "tokens_used": 342,
    "model": "seol-v3"
  }
}

Seol VisionLive API

POST/api/v1/ai/vision

Analyze travel photos with Seol AI.

Limit · 5 req/min

Parameters

imagefilerequired

Image file to analyze (max 35MB)

messagestringoptional

Optional question/instruction about the image

curl -X POST "https://goglobe.live/api/v1/ai/vision" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "message=What landmark is this?"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/ai/vision"
files = {"image": open("/path/to/file.jpg", "rb")}
data = {'message': 'What landmark is this?'}
r = requests.post(url, files=files, data=data, headers={"X-API-Key": API_KEY})
print(r.json())

const fd = new FormData();
fd.append("message", "What landmark is this?");
const r = await fetch("https://goglobe.live/api/v1/ai/vision", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: fd
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "description": "The image shows the Eiffel Tower in Paris, France, photographed from the Champ de Mars.",
    "landmark": "Eiffel Tower",
    "city": "Paris",
    "country": "France",
    "tokens_used": 1842,
    "model": "seol-vision-v3"
  }
}

Seol VideoLive API

POST/api/v1/ai/video

Analyze travel videos with Seol AI.

Limit · 3 req/min

Parameters

videofilerequired

Video file to analyze (max 80MB)

messagestringoptional

Optional question/instruction about the video

curl -X POST "https://goglobe.live/api/v1/ai/video" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "message=What places are shown?"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/ai/video"
files = {"image": open("/path/to/file.jpg", "rb")}
data = {'message': 'What places are shown?'}
r = requests.post(url, files=files, data=data, headers={"X-API-Key": API_KEY})
print(r.json())

const fd = new FormData();
fd.append("message", "What places are shown?");
const r = await fetch("https://goglobe.live/api/v1/ai/video", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: fd
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "description": "The video shows a walking tour through the Gothic Quarter in Barcelona...",
    "frames_analyzed": 12,
    "locations": [
      "Gothic Quarter",
      "La Rambla"
    ],
    "city": "Barcelona",
    "tokens_used": 48200,
    "model": "seol-vision-v3"
  }
}

Analyze ContentLive API

POST/api/v1/moderation/analyze

AI-powered content moderation for travel photos and UGC. Billed €1 / 1K images per category (option) selected — à la carte, pick any subset. child_safety always runs for legal compliance but is only billed if you request it. (The Súil widget uses the same rate but always adds and bills child_safety.)

Limit · 15 req/min

Parameters

photofilerequired

One or more photo OR video files to analyze (max 100MB each, maximum 250 files per request). Photos: JPEG/PNG/WebP. Videos: MP4/MOV/WebM/AVI/MKV (max 5min). Mix photos+videos in one batch.

categoriesarrayoptional

Each selected category runs as a separate model pass and counts as ONE AI call PER ITEM against your quota (videos cost 2× — they sample 10 frames). 10 categories: NSFW (Falconsai — suggestive), Nudity (NudeNet — explicit body parts), Violence (graphic violence), Weapons (firearms/blades), Child Safety (CSAM/age detection), Deepfake (face swaps), AI Generated (synthetic imagery), Hate Symbols (extremist iconography), Offensive Text (slurs/threats via OCR), Sensitive Documents (IDs, cards, phone numbers via OCR). If omitted, the FULL pipeline runs — 9 GPU stages covering all 10 categories (AI Generated shares the Deepfake stage) — billed as 9 stages per item (= €0.009 per photo, €0.018 per video at €0.001/stage — i.e. €1 / 1K images per option). Tip: select only the categories you actually need to cut cost. Note: the embeddable Súil Content widget (the drop-in JS widget) forces child_safety on regardless of selection — that policy does NOT apply to this direct API endpoint, where you control every category.

curl -X POST "https://goglobe.live/api/v1/moderation/analyze" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "photo=@/path/to/file.jpg" \
  -F 'categories=["nsfw","nudity","violence","weapons","deepfake"]' \
  -F 'thresholds={"nsfw":0.30,"violence":0.10}'

import requests, json

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/moderation/analyze"
files = {"photo": open("/path/to/file.jpg", "rb")}
data = {
  "categories":  json.dumps(["nsfw", "nudity", "violence", "weapons", "deepfake"]),
  # Optional — override our defaults. Omit to use GoGlobe-tuned values.
  "thresholds":  json.dumps({"nsfw": 0.30, "violence": 0.10}),
}
r = requests.post(url, files=files, data=data, headers={"X-API-Key": API_KEY})
print(r.json())

const fd = new FormData();
fd.append("photo", fileBlob, "file.jpg");
fd.append("categories", JSON.stringify(["nsfw", "nudity", "violence", "weapons", "deepfake"]));
// Optional — per-request threshold overrides.
fd.append("thresholds", JSON.stringify({ nsfw: 0.30, violence: 0.10 }));
const r = await fetch("https://goglobe.live/api/v1/moderation/analyze", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: fd
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "files": [
      {
        "filename": "beach.jpg",
        "kind": "photo",
        "status_code": 200,
        "billed_calls": 2,
        "result": {
          "moderation_id": 1776415525,
          "status": "ACCEPTED",
          "categories": [],
          "severity": "NONE",
          "reason": "Content meets all policy requirements"
        }
      },
      {
        "filename": "trip_clip.mp4",
        "kind": "video",
        "status_code": 200,
        "billed_calls": 4,
        "result": {
          "status": "REJECTED",
          "severity": "HIGH",
          "categories": [
            "NSFW_SUGGESTIVE"
          ],
          "reason": "Suggestive content detected at 45% mark",
          "frames_analyzed": 10,
          "frames": [
            {
              "frame_index": 1,
              "frame_position_pct": 5,
              "status_code": 200,
              "result": {
                "status": "ACCEPTED",
                "severity": "NONE"
              }
            },
            {
              "frame_index": 5,
              "frame_position_pct": 45,
              "status_code": 200,
              "result": {
                "status": "REJECTED",
                "severity": "HIGH",
                "categories": [
                  "NSFW_SUGGESTIVE"
                ]
              }
            }
          ]
        }
      }
    ],
    "summary": {
      "files_processed": 2,
      "videos_processed": 1,
      "photos_processed": 1,
      "categories_per_file": [
        "nsfw",
        "violence"
      ],
      "total_billed_calls": 6,
      "video_multiplier": 2,
      "frames_per_video": 10
    }
  },
  "meta": {
    "items": 2,
    "categories_requested": [
      "nsfw",
      "violence"
    ],
    "total_billed_calls": 6,
    "video_multiplier": 2
  }
}

Eist Voice TranscribeLive API

POST/api/v1/voice/transcribe

Speech-to-text transcription powered by Whisper.

Limit · 10 req/min

Parameters

audiofilerequired

Audio file (webm, wav, mp3, m4a, ogg)

languagestringoptional

Language code (passed through to Whisper for auto-detection hints)

curl -X POST "https://goglobe.live/api/v1/voice/transcribe" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "language=en"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/voice/transcribe"
files = {"image": open("/path/to/file.jpg", "rb")}
data = {'language': 'en'}
r = requests.post(url, files=files, data=data, headers={"X-API-Key": API_KEY})
print(r.json())

const fd = new FormData();
fd.append("language", "en");
const r = await fetch("https://goglobe.live/api/v1/voice/transcribe", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: fd
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "transcription": "I want to visit the Eiffel Tower in Paris",
    "language": "en",
    "tokens": 12,
    "billing_model": "per-second",
    "cost_currency": "EUR",
    "cost_amount": 0.0144,
    "cost_eur": 0.0144
  }
}

TranslateComing soon503 until released

POST/api/v1/translate

Translate text into 30+ languages through GoGlobe.

Limit · 20 req/min

Parameters

textstringrequired

Source text (max 5000 chars)

target_langstringrequired

Target ISO-639 (e.g. EN, DE, JA, FR, ES, IT, PT)

source_langstringoptional

Source ISO-639. Omit for auto-detect.

Not callable yet

This endpoint is documented for forward planning. It currently returns the availability response below and is not billable.

Response · 503 Service Unavailable

{
  "status": "error",
  "code": "coming_soon",
  "detail": "This endpoint is coming soon and is not billable while in this state."
}

Planner

Generate Trip PlanLive API

POST/api/v1/trips/plan

Structured trip itinerary generation.

Limit · 5 req/min

Parameters

destinationstringrequired

Destination city or country

duration_daysintegerrequired

Trip duration in days (1-14)

country_codestringoptional

ISO-3166 alpha-3 country code (e.g., ESP, USA, VEN). When set, destination is resolved within that country only. Returns 400 if destination not found in the specified country.

max_distance_kmnumberoptional

Hard cap on activity radius from destination centroid (0-200 km). Default 25 km for city queries; 75 km if country_code is set without specific city. Activities beyond this radius are filtered out.

travelersintegeroptional

Number of travelers

stylesarrayoptional

Trip styles — any of: relaxing, adventure, cultural, historical, romantic, family, food, nightlife, nature, beach, shopping, spiritual, photography, wellness

descriptionstringoptional

Optional free-text extras (e.g. "travelling with kids, love coffee shops"). Runs through AI for soft category overrides.

preferencesarrayoptional

Legacy alias — merges recognised pill names into styles, the rest into description. Prefer the structured fields above.

curl -X POST "https://goglobe.live/api/v1/trips/plan" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "destination": "Barcelona",
  "duration_days": 5,
  "travelers": 2,
  "styles": [
    "cultural",
    "food"
  ],
  "description": "love coffee shops, budget-conscious",
  "preferences": [
    "culture",
    "food"
  ]
}'

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/trips/plan"
body = {'destination': 'Barcelona', 'duration_days': 5, 'travelers': 2, 'styles': ['cultural', 'food'], 'description': 'love coffee shops, budget-conscious', 'preferences': ['culture', 'food']}
r = requests.post(url, json=body, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/trips/plan", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "destination": "Barcelona",
  "duration_days": 5,
  "travelers": 2,
  "styles": [
    "cultural",
    "food"
  ],
  "description": "love coffee shops, budget-conscious",
  "preferences": [
    "culture",
    "food"
  ]
})
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "plan_id": "gg_tp_x7b4n1",
    "destination": "Barcelona",
    "duration": "5 days",
    "days": [
      {
        "day": 1,
        "title": "Gothic Quarter & La Rambla",
        "activities": [
          "..."
        ]
      }
    ]
  }
}

Media

Global ImagesLive API

GET/api/v1/images/search

Browse 2.5 million curated destination photos across 195 countries.

Limit · 30 req/min

Parameters

countrystringrequired

ISO3 country code (e.g., FRA, IRL, USA)

limitintegeroptional

Number of results (1-100, default 20)

offsetintegeroptional

Pagination offset

curl "https://goglobe.live/api/v1/images/search?country=IRL&limit=10&offset=0" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/images/search"
params = {"country": "IRL", "limit": "10", "offset": "0"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/images/search?country=IRL&limit=10&offset=0", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "GG_Q12345",
        "title": "Trinity College Dublin",
        "thumbnail_url": "/api/serve-image/GG_Q12345.jpg",
        "coordinates": {
          "lat": 53.3438,
          "lng": -6.2546
        }
      }
    ],
    "pagination": {
      "total": 20745,
      "limit": 10,
      "offset": 0
    }
  }
}

Trip Planner ImagesLive API

GET/api/v1/images/trip-planner

Place photos from trip itineraries.

Limit · 30 req/min

Parameters

countrystringoptional

ISO3 country code (provide this OR lat+lng)

latnumberoptional

Latitude (use with lng instead of country)

lngnumberoptional

Longitude (use with lat instead of country)

limitintegeroptional

Number of results (1-100)

curl "https://goglobe.live/api/v1/images/trip-planner?country=IRL&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/images/trip-planner"
params = {"country": "IRL", "limit": "10"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/images/trip-planner?country=IRL&limit=10", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "tp_12345",
        "title": "Portrane Beach",
        "photo_url": "/api/serve-trip-planner-photo/goglobe/12345_1.jpg",
        "coordinates": {
          "lat": 53.4967,
          "lng": -6.1105
        }
      }
    ],
    "pagination": {
      "total": 1234,
      "limit": 10,
      "offset": 0
    }
  }
}

Destination PhotosLive API

GET/api/v1/photos/destinations

Royalty-free destination photos by query.

Limit · 20 req/min

Parameters

querystringrequired

Search term (city, landmark, theme)

per_pageintegeroptional

1-30, default 10

pageintegeroptional

1-10, default 1

orientationstringoptional

landscape | portrait | squarish

curl "https://goglobe.live/api/v1/photos/destinations?query=Dublin&per_page=10&page=1&orientation=landscape" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/photos/destinations"
params = {"query": "Dublin", "per_page": "10", "page": "1", "orientation": "landscape"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/photos/destinations?query=Dublin&per_page=10&page=1&orientation=landscape", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "abc123",
        "description": "Ha'penny Bridge at sunset",
        "width": 6000,
        "height": 4000,
        "color": "#f59e0b",
        "url_thumb": "https://goglobe.live/images/abc123?w=200",
        "url_regular": "https://goglobe.live/images/abc123?w=1080",
        "photographer": "Jane Doe",
        "photographer_url": null,
        "photo_url": "https://goglobe.live/images/abc123"
      }
    ],
    "meta": {
      "total": 247,
      "total_pages": 25,
      "page": 1,
      "per_page": 10
    }
  }
}

Weather

Weather ForecastLive API

GET/api/v1/weather/forecast

Hourly + daily forecast for any coordinate worldwide.

Limit · 60 req/min

Parameters

latnumberrequired

Latitude (-90..90)

lngnumberrequired

Longitude (-180..180)

daysintegeroptional

Forecast horizon (1-16, default 7)

curl "https://goglobe.live/api/v1/weather/forecast?lat=53.3498&lng=-6.2603&days=7" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/weather/forecast"
params = {"lat": "53.3498", "lng": "-6.2603", "days": "7"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/weather/forecast?lat=53.3498&lng=-6.2603&days=7", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "latitude": 53.3498,
    "longitude": -6.2603,
    "timezone": "Europe/Dublin",
    "elevation": 25,
    "hourly": {
      "time": [
        "2026-10-14T00:00"
      ],
      "temperature_2m": [
        9.4
      ],
      "precipitation": [
        0
      ]
    },
    "daily": {
      "time": [
        "2026-10-14"
      ],
      "temperature_2m_max": [
        13.1
      ],
      "temperature_2m_min": [
        5.2
      ],
      "precipitation_sum": [
        0.5
      ],
      "sunrise": [
        "2026-10-14T06:08"
      ],
      "sunset": [
        "2026-10-14T20:34"
      ]
    }
  }
}

Historical WeatherLive API

GET/api/v1/weather/historical

Daily weather records from 1940 to today for any coordinate.

Limit · 20 req/min

Parameters

latnumberrequired

Latitude

lngnumberrequired

Longitude

start_datestringrequired

ISO date (>= 1940-01-01). Must be in the past — this is an archive, not a forecast.

end_datestringrequired

ISO date, after start_date and still in the past.

curl "https://goglobe.live/api/v1/weather/historical?lat=53.3498&lng=-6.2603&start_date=2025-09-14&end_date=2025-10-14" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/weather/historical"
params = {"lat": "53.3498", "lng": "-6.2603", "start_date": "2025-09-14", "end_date": "2025-10-14"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/weather/historical?lat=53.3498&lng=-6.2603&start_date=2025-09-14&end_date=2025-10-14", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "latitude": 53.3498,
    "longitude": -6.2603,
    "timezone": "Europe/Dublin",
    "daily": {
      "time": [
        "2025-09-14"
      ],
      "temperature_2m_max": [
        21.4
      ],
      "temperature_2m_min": [
        13.2
      ],
      "temperature_2m_mean": [
        17.1
      ],
      "precipitation_sum": [
        2.1
      ]
    }
  }
}

Air QualityLive API

GET/api/v1/weather/air-quality

Current PM2.5, PM10, ozone, nitrogen dioxide, European AQI and US AQI snapshot for a coordinate.

Limit · 60 req/min

Parameters

latnumberrequired

Latitude

lngnumberrequired

Longitude

curl "https://goglobe.live/api/v1/weather/air-quality?lat=53.3498&lng=-6.2603" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/weather/air-quality"
params = {"lat": "53.3498", "lng": "-6.2603"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/weather/air-quality?lat=53.3498&lng=-6.2603", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "latitude": 53.3498,
    "longitude": -6.2603,
    "current": {
      "pm10": 12.4,
      "pm2_5": 7.1,
      "european_aqi": 35,
      "us_aqi": 41,
      "ozone": 78,
      "nitrogen_dioxide": 11,
      "measured_at": "2026-10-14T18:00"
    }
  }
}

Reference

List CountriesLive API

GET/api/v1/countries

Machine-readable list of all ISO-3166 countries supported by GoGlobe APIs.

Limit · 60 req/min

Parameters

regionstringoptional

Filter by region (e.g., "Europe", "Asia", "Africa", "Americas", "Oceania", "Antarctica")

qstringoptional

Case-insensitive name substring filter (max 100 results)

curl "https://goglobe.live/api/v1/countries?region=Europe&q=Spain"   -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get("https://goglobe.live/api/v1/countries?region=Europe&q=Spain", headers={"X-API-Key": "YOUR_API_KEY"})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/countries?region=Europe&q=Spain", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "iso2": "ES",
      "iso3": "ESP",
      "name": "Spain",
      "region": "Europe",
      "currency": "EUR"
    },
    {
      "iso2": "FR",
      "iso3": "FRA",
      "name": "France",
      "region": "Europe",
      "currency": "EUR"
    },
    {
      "iso2": "IE",
      "iso3": "IRL",
      "name": "Ireland",
      "region": "Europe",
      "currency": "EUR"
    },
    {
      "iso2": "IT",
      "iso3": "ITA",
      "name": "Italy",
      "region": "Europe",
      "currency": "EUR"
    },
    {
      "iso2": "PT",
      "iso3": "PRT",
      "name": "Portugal",
      "region": "Europe",
      "currency": "EUR"
    }
  ],
  "meta": {
    "total": 50,
    "version": "iso-3166:2026-05",
    "region_filter": "Europe",
    "name_filter": null
  }
}

Country MetadataLive API

GET/api/v1/countries/{code}

ISO-3166 country metadata: capital, currencies, languages, calling codes, timezones, flag URLs, neighbours, population, area.

Limit · 60 req/min

Parameters

codestringrequired

ISO-3166 alpha-2 (IE) or alpha-3 (IRL)

curl "https://goglobe.live/api/v1/countries/{code}" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/countries/{code}"
r = requests.get(url, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/countries/{code}", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "code_alpha2": "IE",
    "code_alpha3": "IRL",
    "name_common": "Ireland",
    "name_official": "Republic of Ireland",
    "capital": "Dublin",
    "region": "Europe",
    "subregion": "Northern Europe",
    "population": 4994724,
    "area_km2": 70273,
    "languages": [
      "English",
      "Irish"
    ],
    "currencies": [
      {
        "code": "EUR",
        "name": "Euro",
        "symbol": "€"
      }
    ],
    "calling_codes": [
      "+353"
    ],
    "timezones": [
      "UTC"
    ],
    "borders": [
      "GBR"
    ],
    "flag_png": "https://flagcdn.com/w320/ie.png",
    "flag_svg": "https://flagcdn.com/ie.svg"
  }
}

Currency RatesLive API

GET/api/v1/currency/rates

Latest ECB reference exchange rates against any base currency.

Limit · 60 req/min

Parameters

basestringoptional

Base ISO-4217 (default EUR)

symbolsstringoptional

Comma-separated targets (optional). Leave blank for all.

curl "https://goglobe.live/api/v1/currency/rates?base=EUR&symbols=USD,GBP,JPY" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/currency/rates"
params = {"base": "EUR", "symbols": "USD,GBP,JPY"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/currency/rates?base=EUR&symbols=USD,GBP,JPY", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "base": "EUR",
    "date": "2026-10-14",
    "rates": {
      "USD": 1.0823,
      "GBP": 0.8517,
      "JPY": 167.42
    }
  }
}

Currency ConvertLive API

GET/api/v1/currency/convert

Convert an amount between two ISO-4217 currencies using ECB latest rates.

Limit · 60 req/min

Parameters

amountnumberrequired

Source amount (>0)

fromstringrequired

Source ISO-4217

tostringrequired

Target ISO-4217

curl "https://goglobe.live/api/v1/currency/convert?amount=100&from=USD&to=EUR" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/currency/convert"
params = {"amount": "100", "from": "USD", "to": "EUR"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/currency/convert?amount=100&from=USD&to=EUR", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "amount_from": 100,
    "from": "USD",
    "amount_to": 92.4,
    "to": "EUR",
    "rate": 0.924,
    "date": "2026-10-14"
  }
}

Sunrise / SunsetLive API

GET/api/v1/almanac/sunrise-sunset

Sunrise, sunset, civil/nautical/astronomical twilight, day length for any coordinate and date.

Limit · 60 req/min

Parameters

latnumberrequired

Latitude

lngnumberrequired

Longitude

datestringoptional

ISO date (default: today)

curl "https://goglobe.live/api/v1/almanac/sunrise-sunset?lat=64.1466&lng=-21.9426&date=2026-10-14" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/almanac/sunrise-sunset"
params = {"lat": "64.1466", "lng": "-21.9426", "date": "2026-10-14"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/almanac/sunrise-sunset?lat=64.1466&lng=-21.9426&date=2026-10-14", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "date": "2026-10-14",
    "utc": {
      "sunrise": "2026-10-14T02:55:00+00:00",
      "sunset": "2026-10-14T23:04:00+00:00",
      "solar_noon": "2026-10-14T13:00:00+00:00"
    },
    "local": {
      "sunrise": "2026-10-14T02:55:00+00:00",
      "sunset": "2026-10-14T23:04:00+00:00",
      "timezone": "Atlantic/Reykjavik"
    },
    "day_length_seconds": 72540
  }
}

Discover

Discover ArticleLive API

GET/api/v1/discover/article

Short article extract, thumbnail and coordinates for any topic — landmarks, neighbourhoods, events.

Limit · 60 req/min

Parameters

titlestringoptional

Topic title (spaces or underscores both OK). One of `title` or `query` is required.

querystringoptional

Alias for `title`. One of `title` or `query` is required.

langstringoptional

Language code (default en)

curl "https://goglobe.live/api/v1/discover/article?title=Trinity%20College%20Dublin&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/discover/article"
params = {"title": "Trinity College Dublin", "lang": "en"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/discover/article?title=Trinity%20College%20Dublin&lang=en", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "title": "Trinity College Dublin",
    "description": "Sole college of the University of Dublin",
    "extract": "The College of the Holy and Undivided Trinity of Queen Elizabeth near Dublin, branded by the board as Trinity College...",
    "thumbnail": "https://goglobe.live/images/destinations/trinity-college.jpg",
    "coordinates": {
      "lat": 53.3444,
      "lng": -6.2577
    },
    "page_url": "https://goglobe.live/destinations/trinity-college-dublin"
  }
}

Discover NearbyLive API

GET/api/v1/discover/nearby

Notable articles within radius of a coordinate — landmarks, museums, monuments, neighbourhoods.

Limit · 60 req/min

Parameters

latnumberrequired

Latitude

lngnumberrequired

Longitude

radius_mintegeroptional

Search radius in metres (m). Range 10–10000 m (= up to 10 km). Default 2000 m (2 km).

limitintegeroptional

1-50, default 20

langstringoptional

Language code (default en)

curl "https://goglobe.live/api/v1/discover/nearby?lat=53.3498&lng=-6.2603&radius_m=2000&limit=20&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/discover/nearby"
params = {"lat": "53.3498", "lng": "-6.2603", "radius_m": "2000", "limit": "20", "lang": "en"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/discover/nearby?lat=53.3498&lng=-6.2603&radius_m=2000&limit=20&lang=en", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "items": [
      {
        "title": "Spire of Dublin",
        "page_id": 1234567,
        "lat": 53.3498,
        "lng": -6.2603,
        "distance_m": 5,
        "page_url": "https://goglobe.live/destinations/spire-of-dublin"
      }
    ],
    "meta": {
      "total": 1,
      "radius_m": 2000,
      "lang": "en"
    }
  }
}

Marine

Marine POIsLive API

GET/api/v1/marine/poi

Lighthouses, marinas, harbours, anchorages, ferry terminals, buoys and wrecks near a coordinate.

Limit · 20 req/min

Parameters

latnumberrequired

Latitude

lngnumberrequired

Longitude

radius_mintegeroptional

Search radius in metres (m). Range 10–50000 m (= up to 50 km). Default 5000 m (5 km).

countrystringoptional

Filter by ISO-3 country code (e.g., "ESP" for Spain)

typestringoptional

limitintegeroptional

1-200, default 50

curl "https://goglobe.live/api/v1/marine/poi?lat=53.3498&lng=-6.2603&radius_m=5000&type=all&limit=50" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
url = "https://goglobe.live/api/v1/marine/poi"
params = {"lat": "53.3498", "lng": "-6.2603", "radius_m": "5000", "type": "all", "limit": "50"}
r = requests.get(url, params=params, headers={"X-API-Key": API_KEY})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/marine/poi?lat=53.3498&lng=-6.2603&radius_m=5000&type=all&limit=50", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await r.json();
console.log(data);

Response · 200 OK

{
  "status": "success",
  "data": {
    "items": [
      {
        "place_id": "gg_marine_123456",
        "lat": 53.345,
        "lng": -6.252,
        "name": "Dublin Port Marina",
        "type": "marina",
        "tags": {
          "leisure": "marina",
          "seamark:name": "Dublin Marina"
        }
      },
      {
        "place_id": "gg_marine_789012",
        "lat": 53.3438,
        "lng": -6.2484,
        "name": "Poolbeg Lighthouse",
        "type": "lighthouse",
        "tags": {
          "man_made": "lighthouse",
          "seamark:type": "light_major"
        }
      }
    ],
    "meta": {
      "total": 2,
      "radius_m": 5000,
      "type": "all"
    }
  }
}

Trains

Train Stations NearbyComing soon503 until released

GET/api/v1/trains/stations/nearby

Coming soon — rail is not a launched GoGlobe product yet. When it ships this finds train stations near a point from our own places database, as a pure DB query with no upstream API.

Limit · 60 req/min

Parameters

latnumberrequired

Latitude (-90 to 90)

lngnumberrequired

Longitude (-180 to 180)

radiusintegeroptional

Search radius in metres (m). Range 100–50000 m (= up to 50 km). Default 5000 m (5 km).

countrystringoptional

Filter by ISO-3 country code (e.g., "ESP" for Spain)

limitintegeroptional

Max results (1-15, default 10 — capped to prevent enumeration)

qstringoptional

Optional name keyword search (ILIKE)

Not callable yet

This endpoint is documented for forward planning. It currently returns the availability response below and is not billable.

Response · 503 Service Unavailable

{
  "status": "error",
  "code": "coming_soon",
  "detail": "This endpoint is coming soon and is not billable while in this state."
}

Routing

DirectionsLive API

POST/api/v1/routing/directions

Turn-by-turn directions between two points. Real per-profile routing for driving, walking, and cycling.

Limit · 60 req/min

Parameters

profilestringrequired

Travel profile: driving | cycling | walking

coordinatesarrayrequired

Array of [lng, lat] pairs (start, end, optional waypoints)

curl -X POST "https://goglobe.live/api/v1/routing/directions" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile":"walking","coordinates":[[-6.2603,53.3322],[-6.2585,53.3380]]}'

import requests
API_KEY = "YOUR_API_KEY"
r = requests.post("https://goglobe.live/api/v1/routing/directions",
    headers={"X-API-Key": API_KEY},
    json={"profile":"walking","coordinates":[[-6.2603,53.3322],[-6.2585,53.3380]]})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/routing/directions", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ profile: "walking", coordinates: [[-6.2603,53.3322],[-6.2585,53.3380]] })
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "distance_m": 4280,
    "duration_s": 645,
    "geometry": {
      "type": "LineString",
      "coordinates": []
    },
    "steps": []
  }
}

MatrixLive API

POST/api/v1/routing/matrix

Many-to-many distance/duration matrix. Billed per source×destination cell — perfect for delivery routing or trip optimisation.

Limit · 20 req/min

Parameters

profilestringrequired

Travel profile

sourcesarrayrequired

Array of [lng, lat] origin points

destinationsarrayrequired

Array of [lng, lat] destination points

curl -X POST "https://goglobe.live/api/v1/routing/matrix" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile":"driving","sources":[[-6.26,53.33]],"destinations":[[-6.27,53.34],[-6.28,53.35]]}'

import requests
r = requests.post("https://goglobe.live/api/v1/routing/matrix",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"profile":"driving","sources":[[-6.26,53.33]],"destinations":[[-6.27,53.34],[-6.28,53.35]]})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/routing/matrix", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ profile: "driving", sources: [[-6.26,53.33]], destinations: [[-6.27,53.34],[-6.28,53.35]] })
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "durations": [
      [
        645,
        1320
      ]
    ],
    "distances": [
      [
        4280,
        8910
      ]
    ]
  }
}

IsochronesLive API

POST/api/v1/routing/isochrones

Areas reachable within N seconds — "what's a 15-minute walk from here?" Returns GeoJSON polygons.

Limit · 20 req/min

Parameters

profilestringrequired

Travel profile

locationsarrayrequired

Array of [lng, lat] origin points

range_secondsarrayrequired

Array of travel-time bands in seconds (s). E.g. [300, 600, 900] = polygons reachable within 5, 10, 15 minutes.

curl -X POST "https://goglobe.live/api/v1/routing/isochrones" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile":"walking","locations":[[53.33,-6.26]],"range_seconds":[900,1800]}'

import requests
r = requests.post("https://goglobe.live/api/v1/routing/isochrones",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"profile":"walking","locations":[[53.33,-6.26]],"range_seconds":[900,1800]})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/routing/isochrones", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ profile: "walking", locations: [[53.33,-6.26]], range_seconds: [900,1800] })
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "type": "FeatureCollection",
    "features": []
  }
}

Snap to RoadLive API

POST/api/v1/routing/snap

Snap noisy GPS coordinates to the nearest road. Cleans GPS traces before processing.

Limit · 60 req/min

Parameters

profilestringrequired

Travel profile

locationsarrayrequired

Array of [lng, lat] points to snap

radiusintegeroptional

Max snap radius in metres (m). Default 100 m. Larger values snap to roads farther from the input coordinate.

curl -X POST "https://goglobe.live/api/v1/routing/snap" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile":"driving","locations":[[53.331,-6.261],[53.339,-6.258]],"radius_m":350}'

import requests
r = requests.post("https://goglobe.live/api/v1/routing/snap",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"profile":"driving","locations":[[53.331,-6.261],[53.339,-6.258]],"radius_m":350})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/routing/snap", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ profile: "driving", locations: [[53.331,-6.261]], radius_m: 350 })
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "locations": [
      {
        "location": [
          2.3522,
          48.8566
        ],
        "snapped_distance_m": 4.2
      }
    ]
  }
}

Route OptimizationLive APIBeta

POST/api/v1/routing/optimization

Vehicle Routing Problem solver — schedule jobs across vehicles respecting time windows, capacities, skills.

Limit · 5 req/minIdempotency · optional

Parameters

jobsarrayrequired

Array of jobs with id and [lng, lat] location

vehiclesarrayrequired

Array of vehicles with start point and constraints

curl -X POST "https://goglobe.live/api/v1/routing/optimization" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobs":[{"id":1,"location":[-6.26,53.33]},{"id":2,"location":[-6.27,53.34]}],"vehicles":[{"id":1,"start":[-6.26,53.33],"end":[-6.26,53.33]}]}'

import requests
r = requests.post("https://goglobe.live/api/v1/routing/optimization",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "jobs": [{"id":1,"location":[-6.26,53.33]},{"id":2,"location":[-6.27,53.34]}],
        "vehicles": [{"id":1,"start":[-6.26,53.33],"end":[-6.26,53.33]}],
    })
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/routing/optimization", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    jobs: [{id:1, location:[-6.26,53.33]}, {id:2, location:[-6.27,53.34]}],
    vehicles: [{id:1, start:[-6.26,53.33], end:[-6.26,53.33]}],
  })
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "routes": [],
    "summary": {
      "cost": 0,
      "distance_m": 0,
      "duration_s": 0
    }
  }
}

ElevationLive API

POST/api/v1/routing/elevation

Enrich a 2D line or point with elevation (Z values). Accepts polyline, encodedpolyline, or GeoJSON.

Limit · 30 req/min

Parameters

geometryobjectrequired

GeoJSON LineString OR encoded polyline string OR list of [lng,lat] pairs.

format_instringoptional

Input geometry format: polyline | geojson | encodedpolyline5. Default polyline.

format_outstringoptional

Output geometry format: geojson | polyline | encodedpolyline5. Default geojson.

curl -X POST "https://goglobe.live/api/v1/routing/elevation" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format_in":"polyline","format_out":"geojson","geometry":[[8.34,38.11],[12.64,37.65]]}'

import requests
r = requests.post("https://goglobe.live/api/v1/routing/elevation",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"format_in":"polyline","format_out":"geojson","geometry":[[8.34,38.11],[12.64,37.65]]})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/routing/elevation", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ format_in: "polyline", format_out: "geojson", geometry: [[8.34,38.11],[12.64,37.65]] })
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "geometry": {
      "type": "LineString",
      "coordinates": [
        [
          2.3522,
          48.8566,
          35
        ],
        [
          2.2945,
          48.8584,
          41
        ]
      ]
    }
  }
}

POIsLive API

POST/api/v1/routing/pois

Find points of interest around a bounding box, polygon or buffered point using GoGlobe geographic data.

Limit · 30 req/min

Parameters

geometryobjectrequired

Search area. Either an explicit {"bbox": [west, south, east, north]} — honoured verbatim — or a GeoJSON Point / LineString / Polygon with [lng, lat] coordinates, which gets a 2 km buffer by default ("buffer" in metres overrides it, capped at 20 km).

limitintegeroptional

Max POIs to return. Default 10, hard cap 15 — values above 15 are clamped, not rejected.

filtersobjectoptional

Optional category filter object. It narrows the matching places returned for the search area.

curl -X POST "https://goglobe.live/api/v1/routing/pois" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"geometry":{"bbox":[-6.30,53.32,-6.25,53.36]},"limit":20}'

import requests
r = requests.post("https://goglobe.live/api/v1/routing/pois",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"geometry":{"bbox":[-6.30,53.32,-6.25,53.36]},"limit":20})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/routing/pois", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ geometry: { bbox: [-6.30,53.32,-6.25,53.36] }, limit: 20 })
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            2.35,
            48.859
          ]
        },
        "properties": {
          "name": "Café de Flore",
          "category": "cafe"
        }
      }
    ]
  }
}

Aviation Intelligence

TFR Point CheckLive API

GET/api/v1/aviation/tfr-check

Check if a geographic point is within a Temporary Flight Restriction (TFR).

Limit · 100 req/minScopes · flights

Parameters

latnumberrequired

Latitude (WGS84)

lngnumberrequired

Longitude (WGS84)

icao24stringoptional

Optional ICAO24 to cross-check active presence

curl "https://goglobe.live/api/v1/aviation/tfr-check?lat=51.5074&lng=-0.1278&icao24=a80210"   -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get("https://goglobe.live/api/v1/aviation/tfr-check?lat=51.5074&lng=-0.1278&icao24=a80210", headers={"X-API-Key": "YOUR_API_KEY"})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/tfr-check?lat=51.5074&lng=-0.1278&icao24=a80210", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "in_breach": false,
    "tfrs": [
      {
        "tfr_id": "TFR-2025-001",
        "name": "Royal Wedding Airspace Restriction",
        "type": "VIP_MOVEMENT",
        "polygon_geojson": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -0.13,
                51.5
              ],
              [
                -0.12,
                51.5
              ],
              [
                -0.12,
                51.51
              ],
              [
                -0.13,
                51.51
              ],
              [
                -0.13,
                51.5
              ]
            ]
          ]
        },
        "effective_from": "2026-10-14T08:00:00Z",
        "effective_until": "2026-10-14T18:00:00Z",
        "altitude_floor_ft": 0,
        "altitude_ceiling_ft": 5000
      }
    ]
  }
}

Aircraft Conflict DetectionLive API

GET/api/v1/aviation/conflict-check

Detect proximate aircraft pairs within a geographic bounding box.

Limit · 30 req/minScopes · flights

Parameters

laminnumberrequired

Min latitude

lamaxnumberrequired

Max latitude

lominnumberrequired

Min longitude

lomaxnumberrequired

Max longitude

curl "https://goglobe.live/api/v1/aviation/conflict-check?lamin=51.0&lamax=52.0&lomin=-1.0&lomax=0.0"   -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get("https://goglobe.live/api/v1/aviation/conflict-check?lamin=51.0&lamax=52.0&lomin=-1.0&lomax=0.0", headers={"X-API-Key": "YOUR_API_KEY"})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/conflict-check?lamin=51.0&lamax=52.0&lomin=-1.0&lomax=0.0", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "pairs": [
      {
        "ac1": {
          "icao24": "a80210",
          "callsign": "BA123",
          "lat": 51.5,
          "lng": -0.1,
          "alt_ft": 35000
        },
        "ac2": {
          "icao24": "a80211",
          "callsign": "FR456",
          "lat": 51.501,
          "lng": -0.101,
          "alt_ft": 35100
        },
        "separation_nm": 0.08,
        "separation_ft": 100,
        "severity": "warning"
      }
    ],
    "analyzed_count": 24
  }
}

Aircraft Trajectory ReplayLive API

GET/api/v1/aviation/replay

Retrieve full flight trajectory (track, altitude, speed, heading) for a single aircraft over a time window.

Limit · 20 req/minScopes · flights

Parameters

icao24stringrequired

ICAO24 address (6 hex digits)

fromstringrequired

Start time (ISO8601). Must be in the past and within the last 30 days.

tostringoptional

End time (ISO8601, defaults to from+1h)

curl "https://goglobe.live/api/v1/aviation/replay?icao24=a80210&from=2026-10-13T12%3A00%3A00Z&to=2026-10-13T13%3A00%3A00Z"   -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get("https://goglobe.live/api/v1/aviation/replay?icao24=a80210&from=2026-10-13T12%3A00%3A00Z&to=2026-10-13T13%3A00%3A00Z", headers={"X-API-Key": "YOUR_API_KEY"})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/replay?icao24=a80210&from=2026-10-13T12%3A00%3A00Z&to=2026-10-13T13%3A00%3A00Z", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "icao24": "a80210",
    "registration": "N12345",
    "points": [
      {
        "ts": "2026-10-13T12:00:00Z",
        "lat": 51.4,
        "lng": -0.15,
        "alt_ft": 5000,
        "speed_kts": 380,
        "heading": 45
      },
      {
        "ts": "2026-10-13T12:05:00Z",
        "lat": 51.41,
        "lng": -0.14,
        "alt_ft": 5500,
        "speed_kts": 400,
        "heading": 50
      },
      {
        "ts": "2026-10-13T13:00:00Z",
        "lat": 51.5,
        "lng": -0.1,
        "alt_ft": 35000,
        "speed_kts": 480,
        "heading": 60
      }
    ],
    "stats": {
      "start_lat": 51.4,
      "start_lng": -0.15,
      "end_lat": 51.5,
      "end_lng": -0.1,
      "max_alt_ft": 35000,
      "total_distance_nm": 42.3,
      "duration_sec": 3600
    }
  }
}

Sanctions CheckLive API

GET/api/v1/aviation/sanctions-check

Check if an aircraft is on OFAC SDN or EU consolidated sanctions lists.

Limit · 30 req/minScopes · flights

Parameters

icao24stringoptional

Aircraft ICAO24 hex code (6 digits, e.g. a80210)

registrationstringoptional

Aircraft tail number (e.g. N12345 or 9H-QBK)

operatorstringoptional

Operator ICAO code (3 letters, e.g. UAE)

curl "https://goglobe.live/api/v1/aviation/sanctions-check?icao24=a80210&registration=N12345&operator=UAE"   -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get("https://goglobe.live/api/v1/aviation/sanctions-check?icao24=a80210&registration=N12345&operator=UAE", headers={"X-API-Key": "YOUR_API_KEY"})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/sanctions-check?icao24=a80210&registration=N12345&operator=UAE", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "is_sanctioned": true,
    "lists": [
      "OFAC SDN",
      "EU Consolidated"
    ],
    "match_type": "registration",
    "match_details": {
      "list": "OFAC SDN",
      "program": "SDGT",
      "name": "REGISTRATION MATCHED ON CONSOLIDATED LIST"
    }
  }
}

VIP Aircraft ListLive API

GET/api/v1/aviation/vip-list

Query government, royal, and VIP aircraft by ICAO24, or paginate the entire VIP callsign database.

Limit · 60 req/minScopes · flights

Parameters

icao24stringoptional

Specific ICAO24 hex to lookup (optional; omit to list)

limitintegeroptional

Pagination limit (1-500, default 100)

offsetintegeroptional

Pagination offset (default 0)

curl "https://goglobe.live/api/v1/aviation/vip-list?limit=100&offset=0"   -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get("https://goglobe.live/api/v1/aviation/vip-list?limit=100&offset=0", headers={"X-API-Key": "YOUR_API_KEY"})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/vip-list?limit=100&offset=0", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "icao24": "000001",
      "registration": null,
      "operator": null,
      "country": "US",
      "category": "Government"
    }
  ],
  "meta": {
    "total": 2847,
    "limit": 100,
    "offset": 0
  }
}

Aviation IncidentsLive API

GET/api/v1/aviation/incidents

Fetch historical aviation incidents (accidents, serious incidents) by aircraft registration or operator.

Limit · 20 req/minScopes · flights

Parameters

registrationstringoptional

Aircraft tail number (e.g. N12345)

operatorstringoptional

Operator ICAO code (3 letters, e.g. UAL)

curl "https://goglobe.live/api/v1/aviation/incidents?registration=N12345&operator=UAL"   -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get("https://goglobe.live/api/v1/aviation/incidents?registration=N12345&operator=UAL", headers={"X-API-Key": "YOUR_API_KEY"})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/incidents?registration=N12345&operator=UAL", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": [
    {
      "date": "2015-08-24T10:22:00Z",
      "location": "Shenzhen, China",
      "severity": "critical",
      "narrative": "Aircraft crashed during approach. 154 fatalities.",
      "ntsb_url": "https://ntsb.gov/Events/Pages/event_2015_08_24.aspx"
    }
  ],
  "meta": {
    "total": 1
  }
}

Operator Risk ScoreLive API

GET/api/v1/aviation/operator-risk

Compute risk score for an airline operator (0-100) based on safety record, sanctions flags, and fleet composition.

Limit · 30 req/minScopes · flights

Parameters

operatorstringrequired

Operator ICAO code (3 letters, e.g. BAW for British Airways)

curl "https://goglobe.live/api/v1/aviation/operator-risk?operator=BAW"   -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get("https://goglobe.live/api/v1/aviation/operator-risk?operator=BAW", headers={"X-API-Key": "YOUR_API_KEY"})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/operator-risk?operator=BAW", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "operator": "British Airways",
    "score": 15,
    "components": {
      "sanctions": false,
      "recent_incidents": 0,
      "flag_of_convenience": false,
      "fleet_age_avg": 9.5
    },
    "summary": "Operator BAW has risk score 15/100. 0 incidents in 5 years. No sanctions issues."
  }
}

Aircraft WatchlistLive API

POST/api/v1/aviation/watchlist

Create and manage per-merchant aircraft watchlists with webhook delivery on matches.

Limit · 20 req/minScopes · flights

Parameters

namestringrequired

Human-readable name for the watchlist entry (e.g. "Airbus A380s")

match_typestringrequired

Type of match: icao24 | registration | operator | tail_prefix

match_valuestringrequired

Value to match (e.g. A0B1C2 for ICAO24, N1234 for registration)

notify_on_seenbooleanoptional

Fire webhook when aircraft enters our coverage (default true)

notify_on_sanctionsbooleanoptional

Fire on sanctions flag (default false)

notify_on_tfr_breachbooleanoptional

Fire on TFR breach (default false)

notify_on_emergency_squawkbooleanoptional

Fire on emergency squawk 7500/7600/7700 (default false)

curl -X POST "https://goglobe.live/api/v1/aviation/watchlist"   -H "X-API-Key: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"name":"Boeing 747s","match_type":"icao24","match_value":"A0B1C2","notify_on_seen":true,"notify_on_sanctions":false,"notify_on_tfr_breach":false,"notify_on_emergency_squawk":false}'

import requests

r = requests.post("https://goglobe.live/api/v1/aviation/watchlist",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"name":"Boeing 747s","match_type":"icao24","match_value":"A0B1C2","notify_on_seen":true,"notify_on_sanctions":false,"notify_on_tfr_breach":false,"notify_on_emergency_squawk":false})
print(r.json())

const r = await fetch("https://goglobe.live/api/v1/aviation/watchlist", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"name":"Boeing 747s","match_type":"icao24","match_value":"A0B1C2","notify_on_seen":true,"notify_on_sanctions":false,"notify_on_tfr_breach":false,"notify_on_emergency_squawk":false})
});
console.log(await r.json());

Response · 200 OK

{
  "status": "success",
  "data": {
    "id": 123,
    "merchant_id": 456,
    "name": "Boeing 747s",
    "match_type": "icao24",
    "match_value": "A0B1C2",
    "notify_on_seen": true,
    "notify_on_sanctions": false,
    "notify_on_tfr_breach": false,
    "notify_on_emergency_squawk": false,
    "webhook_url": null,
    "webhook_secret": null,
    "created_at": "2026-10-07T10:00:00Z",
    "updated_at": "2026-10-07T10:00:00Z",
    "status": "active"
  }
}