API Documentation

Map API v1

Need Help?

Try PlaygroundView DashboardManage API Keys

API Documentation

Complete guide to using the Map API for geocoding and location services

API Versioning

All API endpoints are versioned to ensure backward compatibility and allow for future improvements.

Current Version: v1

Base URL: https://geo.geofinder.live

Path format: /api/v1/ (e.g. /api/v1/autocomplete)

Future versions (v2, v3, etc.) will be available when needed, allowing you to migrate at your own pace while maintaining access to older versions.

Direct API

All requests go directly to the API at https://geo.geofinder.live. There is no frontend proxy — you call the API with your API key and secret key. Endpoints are versioned under /api/v1/ (autocomplete, place-details, directions, distance-matrix).

  • Base URL: https://geo.geofinder.live
  • Authentication: Send X-API-Key and X-Secret-Key headers with every request.
  • Credits: Usage is tracked per API key; check your dashboard for remaining credits.

Quick Start

  1. Register an account at /register
  2. Login to get your JWT token
  3. Create an API key from the API Keys page
  4. Use your API key and secret key to call https://geo.geofinder.live/api/v1/* directly
  5. Try requests live in the Playground — no code required; test success and error responses side by side.

Typical Workflow

  1. Search for places: Use /api/v1/autocomplete with a query to get suggestions
  2. Get place details: Use the id from autocomplete results as autocomplete_id in /api/v1/place-details
  3. Calculate distance: Use autocomplete IDs directly in /api/v1/distance-matrix with origin_autocomplete_id and destination_autocomplete_id
  4. Get distance with routes: Use /api/v1/directions with address1 and address2 to get multiple route options with traffic information
  5. Use place_id: Once you have a place_id, you can directly query place details using it

Example: Search for "New York" and "Los Angeles" → Get autocomplete suggestions → Use the id values as origin_autocomplete_id and destination_autocomplete_id in distance-matrix API → Get distance and travel time. The API automatically handles missing coordinates!

Available Endpoints

GET/api/v1/autocomplete
GET/api/v1/place-details
GET/api/v1/directions
GET/api/v1/distance-matrix

Try the API

Use the Playground to call any endpoint in the browser with your API keys and see success or error responses. Or download the Postman collection for use in your own environment.

  • Playground — Test in-browser; responses shown side by side
  • Postman — Pre-configured headers and example requests
  • Environment variables for easy configuration
Open PlaygroundDownload Postman Collection