Find an API

Search public APIs with auth details & Postman guides

← All APIs

Gisgraphy webservices

gisgraphy · Location

Location No Auth Free & Open location

Since 2006, [Gisgraphy](http://www.gisgraphy.com) is a free, open source framework that offers the possibility to do geolocalisation and geocoding via Java APIs or REST webservices. Because geocoding is nothing without data, it provides an easy to use importer that will automatically download and import the necessary (free) data to your local database ([OpenStreetMap](http://www.openstreetmap.org/), [Geonames](http://www.geonames.org/) and [Quattroshapes](http://www.quattroshapes.com/): more tha

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET split a raw address into several parts

The address parser and address standardizer, are part of the Gisgraphy project (free open source worldwide geocoder). Address parsing is the process of dividing a single address string into its individual component parts. Please visit [http://www.address-parser.net](http://www.address-parser.net) fo

https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/addressparser/parse?format=XML&indent=false&address=example&country=US&geocode=false&callback=example&standardize=false

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/addressparser/parse?format=XML&indent=false&address=example&country=US&geocode=false&callback=example&standardize=false"
import requests
params = {
    "format": "XML",
    "indent": "false",
    "address": "example",
    "country": "US",
    "geocode": "false",
    "callback": "example",
    "standardize": "false"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/addressparser/parse",
    params=params,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/addressparser/parse');
url.searchParams.set('format', 'XML');
url.searchParams.set('indent', 'false');
url.searchParams.set('address', 'example');
url.searchParams.set('country', 'US');
url.searchParams.set('geocode', 'false');
url.searchParams.set('callback', 'example');
url.searchParams.set('standardize', 'false');

const response = await fetch(url); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/addressparser/parse")
	q := baseURL.Query()
	q.Set("format", "XML")
	q.Set("indent", "false")
	q.Set("address", "example")
	q.Set("country", "US")
	q.Set("geocode", "false")
	q.Set("callback", "example")
	q.Set("standardize", "false")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/addressparser/parse")
uri.query = URI.encode_www_form({
  "format" => "XML",
  "indent" => "false",
  "address" => "example",
  "country" => "US",
  "geocode" => "false",
  "callback" => "example",
  "standardize" => "false"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/addressparser/parse?" . http_build_query([
    "format" => "XML",
    "indent" => "false",
    "address" => "example",
    "country" => "US",
    "geocode" => "false",
    "callback" => "example",
    "standardize" => "false"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET search for places by text around a GPS point

The full text service allows you to search for features / places / street and do autocompletion . you can : Specify one or more words search on part of the name (auto completion / suggestion) Search for text or zip code Specify a GPS restriction (promote nearest, not sorted but has an impact on the

https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/fulltext/search?q=test&to=10&lat=51.5074&lng=1&from=1&lang=en&style=MEDIUM&format=XML&indent=false&radius=10000&country=US&suggest=false&callback=example&spellchecking=example&allwordsrequired=false

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/fulltext/search?q=test&to=10&lat=51.5074&lng=1&from=1&lang=en&style=MEDIUM&format=XML&indent=false&radius=10000&country=US&suggest=false&callback=example&spellchecking=example&allwordsrequired=false"
import requests
params = {
    "q": "test",
    "to": "10",
    "lat": "51.5074",
    "lng": "1",
    "from": "1",
    "lang": "en",
    "style": "MEDIUM",
    "format": "XML",
    "indent": "false",
    "radius": "10000",
    "country": "US",
    "suggest": "false",
    "callback": "example",
    "spellchecking": "example",
    "allwordsrequired": "false"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/fulltext/search",
    params=params,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/fulltext/search');
url.searchParams.set('q', 'test');
url.searchParams.set('to', '10');
url.searchParams.set('lat', '51.5074');
url.searchParams.set('lng', '1');
url.searchParams.set('from', '1');
url.searchParams.set('lang', 'en');
url.searchParams.set('style', 'MEDIUM');
url.searchParams.set('format', 'XML');
url.searchParams.set('indent', 'false');
url.searchParams.set('radius', '10000');
url.searchParams.set('country', 'US');
url.searchParams.set('suggest', 'false');
url.searchParams.set('callback', 'example');
url.searchParams.set('spellchecking', 'example');
url.searchParams.set('allwordsrequired', 'false');

const response = await fetch(url); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/fulltext/search")
	q := baseURL.Query()
	q.Set("q", "test")
	q.Set("to", "10")
	q.Set("lat", "51.5074")
	q.Set("lng", "1")
	q.Set("from", "1")
	q.Set("lang", "en")
	q.Set("style", "MEDIUM")
	q.Set("format", "XML")
	q.Set("indent", "false")
	q.Set("radius", "10000")
	q.Set("country", "US")
	q.Set("suggest", "false")
	q.Set("callback", "example")
	q.Set("spellchecking", "example")
	q.Set("allwordsrequired", "false")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/fulltext/search")
uri.query = URI.encode_www_form({
  "q" => "test",
  "to" => "10",
  "lat" => "51.5074",
  "lng" => "1",
  "from" => "1",
  "lang" => "en",
  "style" => "MEDIUM",
  "format" => "XML",
  "indent" => "false",
  "radius" => "10000",
  "country" => "US",
  "suggest" => "false",
  "callback" => "example",
  "spellchecking" => "example",
  "allwordsrequired" => "false"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/fulltext/search?" . http_build_query([
    "q" => "test",
    "to" => "10",
    "lat" => "51.5074",
    "lng" => "1",
    "from" => "1",
    "lang" => "en",
    "style" => "MEDIUM",
    "format" => "XML",
    "indent" => "false",
    "radius" => "10000",
    "country" => "US",
    "suggest" => "false",
    "callback" => "example",
    "spellchecking" => "example",
    "allwordsrequired" => "false"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET Geocode an address

The Gisgraphy geocoding service allows you to transform postal addresses or other descriptions (a street, a city, a postal code, a country, or a combination) of a location into a (latitude, longitude) coordinate.

https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/geocoding/geocode?to=10&from=1&format=XML&indent=false&postal=example&address=example&country=US&callback=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/geocoding/geocode?to=10&from=1&format=XML&indent=false&postal=example&address=example&country=US&callback=example"
import requests
params = {
    "to": "10",
    "from": "1",
    "format": "XML",
    "indent": "false",
    "postal": "example",
    "address": "example",
    "country": "US",
    "callback": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/geocoding/geocode",
    params=params,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/geocoding/geocode');
url.searchParams.set('to', '10');
url.searchParams.set('from', '1');
url.searchParams.set('format', 'XML');
url.searchParams.set('indent', 'false');
url.searchParams.set('postal', 'example');
url.searchParams.set('address', 'example');
url.searchParams.set('country', 'US');
url.searchParams.set('callback', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/geocoding/geocode")
	q := baseURL.Query()
	q.Set("to", "10")
	q.Set("from", "1")
	q.Set("format", "XML")
	q.Set("indent", "false")
	q.Set("postal", "example")
	q.Set("address", "example")
	q.Set("country", "US")
	q.Set("callback", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/geocoding/geocode")
uri.query = URI.encode_www_form({
  "to" => "10",
  "from" => "1",
  "format" => "XML",
  "indent" => "false",
  "postal" => "example",
  "address" => "example",
  "country" => "US",
  "callback" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/gisgraphy.com/4.0.0/geocoding/geocode?" . http_build_query([
    "to" => "10",
    "from" => "1",
    "format" => "XML",
    "indent" => "false",
    "postal" => "example",
    "address" => "example",
    "country" => "US",
    "callback" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗
  1. See official documentation for authentication and setup.

What can you build with Gisgraphy webservices?

Gisgraphy webservices is a Location API. Developers commonly use location APIs for:

  • tracking assets and vehicles in real time
  • building delivery and logistics apps
  • finding nearby businesses or services
  • geo-fencing and location-based notifications
  • address validation and autocomplete

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Gisgraphy webservices is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗