REST API · Yearly subscription

Geo API for
automotive retail

Geocoding, dealer search, distance & shipping estimates — production-ready, credit-based billing, no seat fees.

geocode-address.js
// Geocode any address to lat/lng
const resp = await fetch('https://geoservice.example/api/v1/geocode/address', {
  method: 'POST',
  headers: {
    'Content-Type':  'application/json',
    'Authorization': `Bearer ${GEO_API_KEY}`,
  },
  body: JSON.stringify({ address: '123 Main St, Toledo, OH 43615' }),
});
const { data } = await resp.json();
// → { lat: 41.6528, lng: -83.5379, displayName: '...' }
Capabilities

Everything your dealership stack needs

From raw geocoding to enriched dealer profiles — purpose-built for the automotive vertical.

📍
Geocoding
Resolve any address, zip code, city, or dealer name to precise lat/lng coordinates. Handles typos, abbreviations, and partial matches.
📏
Distance & Shipping
Haversine great-circle distance between any two points. Address-to-address distance in one call. Tiered open-carrier shipping estimates in dollars.
🏢
Dealer Search
OSM-powered dealership discovery by city, state, and brand. Enriched profiles layer in phone, website, and ratings via a multi-source waterfall.
🔄
Multi-provider fallback
Geocodio, HERE, Google, LocationIQ, and TomTom — tried in priority order with automatic failover, budget gates, and stale-cache safety nets.
Pricing

Simple, predictable pricing

One plan. No seat fees. No surprise tier upgrades. Pay yearly, use credits, top up at $0.01/credit if you go over.

Yearly Plan
$99 / year
Billed annually. Cancel any time.
  • 50,000 credits included
  • $0.01 per credit above 50,000
  • All endpoints included
  • Unlimited API keys
  • 10 free sandbox runs/day
  • Multi-provider fallback
Get started

No free trial · Active subscription required for API access

Quick start

Up and running in minutes

Three steps from sign-up to your first API response.

Step 1
Subscribe
Sign in with SSO and activate the yearly plan from your dashboard. 50,000 credits land in your account immediately.
Step 2
Create an API key
Go to Dashboard → Setup → API Keys. Generate a named key — the raw gsk_… value is shown once, so copy it immediately.
Step 3
Make your first call
Pass Authorization: Bearer gsk_… in the header of any POST /api/v1/* request. Try the Sandbox tab first — 10 free runs per day, no key required. For bulk work, upload a CSV file in the Sandbox and download results; bulk runs always charge real credits.
find-dealer-profiles.js 10 credits
const resp = await fetch('https://geoservice.example/api/v1/find-dealer-profiles', {
  method: 'POST',
  headers: {
    'Content-Type':  'application/json',
    'Authorization': `Bearer ${process.env.GEO_API_KEY}`,
  },
  body: JSON.stringify({ city: 'Toledo', state: 'OH', brand: 'subaru' }),
});
const { ok, data } = await resp.json();
// data → [{ name, address, lat, lng, phone, website, rating }, ...]
API Reference

Endpoints

All endpoints are POST, authenticated with Authorization: Bearer gsk_…, and return { ok, data } JSON.

📍 Geocoding
POST /api/v1/geocode/address Free-form address → lat/lng 1 cr
POST /api/v1/geocode/zip Zip code → centroid lat/lng + city/state 1 cr
POST /api/v1/geocode/city City + state → center coordinates 1 cr
POST /api/v1/geocode/dealer Dealer name + city/state → POI coordinates 1 cr
POST /api/v1/resolve-coords Validate existing lat/lng or geocode address 1 cr
📏 Distance & Shipping
POST /api/v1/haversine Great-circle miles between two coordinate pairs 1 cr
POST /api/v1/address-distance Distance between any two free-form locations 2 cr
POST /api/v1/estimate-shipping Open-carrier transport cost from distance in miles 3 cr
🏢 Dealer Search
POST /api/v1/find-dealerships OSM dealer search by city, state, brand 5 cr
POST /api/v1/find-dealer-profiles Enriched profiles — phone, website, ratings 10 cr
POST /api/v1/find-by-category Any OSM POI type near a city (gas stations, tire shops…) 1 cr