Geocode up to 10,000 addresses

POST/v1/geocode/batch

One unit is metered per address. Results come back in the same order as the input. A batch larger than
what is left on your key is refused whole (429 allowance_exceeded) and costs nothing.

REQUEST BODY · APPLICATION/JSON · REQUIRED

{
  "addresses": [
    "1600 Pennsylvania Ave NW, Washington, DC 20500",
    "100 S French St, Wilmington, DE 19801"
  ],
  "fields": ""
}

In the full reference

REQUEST

curl -X POST "https://api.geocode.net/v1/geocode/batch" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "addresses": [
    "1600 Pennsylvania Ave NW, Washington, DC 20500",
    "100 S French St, Wilmington, DE 19801"
  ],
  "fields": ""
}'

import requests

r = requests.post("https://api.geocode.net/v1/geocode/batch", headers={"X-API-Key": "YOUR_KEY"}, json={
    "addresses": [
        "1600 Pennsylvania Ave NW, Washington, DC 20500",
        "100 S French St, Wilmington, DE 19801"
    ],
    "fields": ""
})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())

const r = await fetch("https://api.geocode.net/v1/geocode/batch", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
  "addresses": [
    "1600 Pennsylvania Ave NW, Washington, DC 20500",
    "100 S French St, Wilmington, DE 19801"
  ],
  "fields": ""
})
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());

RESPONSE

200Successful Response

{
  "results": [
    {
      "query": "1600 Pennsylvania Ave NW, Washington, DC 20500",
      "results": [
        {
          "formatted": "1600 Pennsylvania Ave NW, Washington, DC 20500",
          "components": {
            "number": "1600",
            "street": "Pennsylvania",
            "suffix": "Ave",
            "postdirectional": "NW",
            "city": "Washington",
            "county": "District of Columbia",
            "state": "DC",
            "zip": "20500",
            "country": "US"
          },
          "location": {
            "lat": 38.897675,
            "lng": -77.036545
          },
          "accuracy": 1.0,
          "accuracy_type": "rooftop",
          "source": "nad"
        }
      ]
    },
    {
      "query": "100 S French St, Wilmington, DE 19801",
      "results": [
        {
          "formatted": "100 S French ST, Wilmington, DE 19801",
          "components": {
            "number": "100",
            "predirectional": "S",
            "street": "French",
            "suffix": "ST",
            "city": "Wilmington",
            "county": "New Castle",
            "state": "DE",
            "zip": "19801",
            "country": "US"
          },
          "location": {
            "lat": 39.7367,
            "lng": -75.550995
          },
          "accuracy": 0.9,
          "accuracy_type": "rooftop",
          "source": "nad"
        }
      ]
    }
  ]
}

Try it — sign in first