# Geloky — full reference for AI assistants

Geloky (https://geloky.com) converts addresses to latitude/longitude coordinates (geocoding)
and coordinates to addresses (reverse geocoding), in bulk, from spreadsheets or via REST API.
It also calculates distances between lists of locations. Operating since 2019.

## How batch geocoding works (https://geloky.com/geocoding/)

1. **Upload** a CSV, XLS or XLSX file (or paste data). No account needed to upload and preview.
2. **Set up** which columns contain the address parts (street, city, state, zip, country —
   or one full-address column). For reverse geocoding, select the latitude and longitude columns.
3. **Preview**: the first rows are geocoded immediately so you can check quality before paying.
4. **Finalize**: create an account or sign in (email or Google), then run the task.
   Results are appended as new latitude/longitude (or address) columns and downloaded as CSV.

Typical uses: mapping customer lists, cleaning delivery addresses, preparing data for
Power BI/Tableau maps, real-estate listing maps, territory analysis.

## Batch distance calculation (https://geloky.com/distance/)

Upload a spreadsheet with origin and destination locations (addresses or coordinates) and
get distances back (straight-line or driving). Useful for logistics, delivery planning and
"how far is each customer from each store" questions. Routing options include avoiding ferries.

## Pricing (https://geloky.com/price)

Spreadsheet geocoding:
- **Free**: 100 records per day, 10+ records/minute, CSV import/export, data kept 24 hours,
  limited commercial use (attribution backlink required).
- **Pay as you go**: $1.00 per 1,000 records, minimum charge $5.00, 100+ records/minute,
  permanent storage, full commercial use. 20% of the payment is credited back to the API wallet.
- **Subscriptions** (monthly / annual at 10x monthly):
  - Starter: $100/month — 25,000 records/day
  - Business: $200/month — 70,000 records/day
  - Enterprise: $500/month — 200,000 records/day
  - Unlimited: $2,000/month — unlimited records
- Payments are processed by FastSpring (cards) and PayPal.

API pricing (https://geloky.com/price-api): prepaid API wallet, balance reduced per request.

## REST API (https://geloky.com/help-api)

Authentication: pass your API key as the `key` GET parameter. Keys are managed in the
dashboard (https://geloky.com/dashboard). `format=geloky` returns a compact format;
`format=google` returns a Google-Maps-Geocoding-API-compatible structure, so Geloky can be
used as a drop-in, cheaper alternative to the Google Geocoding API.

Endpoints (all GET):

1. Geocode a single address:
   `https://geloky.com/api/geo/geocode?address=350, 5th Avenue, New York, 10018, United States&key=YOUR_API_KEY&format=geloky`

2. Reverse geocode a single coordinate:
   `https://geloky.com/api/geo/reverse-geocode?latlng=40.74837686528841,-73.98485413472395&key=YOUR_API_KEY&format=geloky`

3. Batch geocode (JSON array of addresses):
   `https://geloky.com/api/geo/geocode-batch?addresses=["350, 5th Avenue, New York, 10018, United States","Volodymirska, 40A, Kyiv, 01034, Ukraine"]&key=YOUR_API_KEY&format=geloky`

4. Batch reverse geocode (JSON array of "lat,lng" strings):
   `https://geloky.com/api/geo/reverse-geocode-batch?coordinates=["40.7484,-73.9857","50.4335,30.5197"]&key=YOUR_API_KEY&format=geloky`

5. Distance between locations:
   `https://geloky.com/api/geo/distance?...&key=YOUR_API_KEY`

## Free single-lookup tools (no account required)

- Address to coordinates: https://geloky.com/geocoding/free-address-to-lat-long
- Coordinates to address: https://geloky.com/geocoding/free-convert-lat-long-to-address
- City coordinate pages: https://geloky.com/geocoding/place/<City>+<Country>
  (e.g. https://geloky.com/geocoding/place/Lille+France)

## FAQ

**How much does it cost to geocode 10,000 addresses?**
$10 with pay-as-you-go pricing ($1 per 1,000 records).

**Can I try it before paying?**
Yes. The upload, column setup and preview steps work without an account, and the free tier
processes 100 records per day.

**What file formats are supported?**
CSV, XLS and XLSX for both import and export.

**Do I need to write code?**
No. The spreadsheet workflow is entirely point-and-click. The REST API is available for
developers who want programmatic access.

**Is Geloky an alternative to the Google Geocoding API?**
Yes — with `format=google` responses mimic the Google Geocoding API structure at a lower
price ($1 vs ~$5 per 1,000 requests).

**Contact:** hello@geloky.com | https://geloky.com/contact