Generate a list of all U.S. ZIP Codes up to a radius distance of 200 miles around a central target ZIP Code. Also obtain latitude, longitude, and distance from the target for each ZIP Code in the radius area.

Request Details

Example Request Url
https://geodata.cdxtech.com/api/georadius?key={key}&zipcode={zipcode}&milage={milage}&format={format}

Description Required Default Value Example
key Authentication Key key=dd76pxfi4feydh4bz_dtrjyf6flu4-987asdjhajkd555usds28ad984yhz
zipcode Zipcode Reference zipcode=07869
mileage Miles from radius mileage=5
distanceUnit Distance measurement miles distanceunit=miles (supported distanceUnits: miles, kilometers, nauticalmiles)
format Output Formatting json format=json (supported formats: json, xml, csv)

Coding Examples

Here are some coding examples to get you started. Please feel free to contact support if you need additional assistance.



string key = "{your-key}";
string zipCode = "07869";
string mileage = "3";
string format = "json";

using (HttpClient client = new HttpClient())
{
    client.BaseAddress = new Uri("https://geodata.cdxtech.com");
    
    StringBuilder url = new StringBuilder("/api/georadius?");
    url.Append("key=").Append(key);
    url.Append("&zipcode=").Append(zipCode);
    url.Append("&mileage=").Append(mileage);
    url.Append("&format=").Append(format);
    
    message = client.GetAsync(url.ToString()).Result;
}



import requests

def get_georadius(api_key, zipcode, mileage, response_format="json"):
    """Fetch radius-based distance data using the API."""
    base_url = "https://geodata.cdxtech.com"
    endpoint = "/api/georadius"
    url = f"{base_url}{endpoint}"
    params = {
        "key": api_key,
        "zipcode": zipcode,
        "mileage": mileage,
        "format": response_format,
    }
    response = requests.get(url, params=params)
    response.raise_for_status()
    try:
        return response.json()
    except ValueError:
        return response.text

if __name__ == "__main__":
    key = "{your-key}"
    zipcode = "07869"
    mileage = "3"
    fmt = "json"
    data = get_georadius(key, zipcode, mileage, fmt)
    import json
    if isinstance(data, (dict, list)):
        print(json.dumps(data, indent=2))
    else:
        print(data)



// Cargo.toml
// [dependencies]
// reqwest = { version = "0.11", features = ["blocking", "json"] }
// serde = { version = "1.0", features = ["derive"] }
// serde_json = "1.0"

use std::error::Error;

fn get_georadius(
    api_key: &str,
    zipcode: &str,
    mileage: &str,
    response_format: &str,
) -> Result> {
    let client = reqwest::blocking::Client::new();
    let resp = client
        .get("https://geodata.cdxtech.com/api/georadius")
        .query(&[
            ("key", api_key),
            ("zipcode", zipcode),
            ("mileage", mileage),
            ("format", response_format),
        ])
        .send()?
        .error_for_status()?;
    let json: serde_json::Value = resp.json()?;
    Ok(json)
}

fn main() -> Result<(), Box> {
    let api_key = "{your-key}";
    let zipcode = "07869";
    let mileage = "3";
    let fmt = "json";

    match get_georadius(api_key, zipcode, mileage, fmt) {
        Ok(data) => println!("Response JSON:\n{}", serde_json::to_string_pretty(&data)?),
        Err(err) => eprintln!("Error fetching data: {}", err),
    }

    Ok(())
}



async function getGeoradius({ key, zipcode, mileage, format = "json" }) {
    const baseUrl = "https://geodata.cdxtech.com";
    const endpoint = "/api/georadius";
    const params = new URLSearchParams({ key, zipcode, mileage, format });
    const url = `${baseUrl}${endpoint}?${params.toString()}`;
    const response = await fetch(url);
    if (!response.ok) {
        throw new Error(`HTTP error! Status: ${response.status}`);
    }
    const text = await response.text();
    try {
        return JSON.parse(text);
    } catch {
        return text;
    }
}

// Example usage:
(async () => {
    const key = "{your-key}";
    const zipcode = "07869";
    const mileage = "3";
    const format = "json";
    try {
        const data = await getGeoradius({ key, zipcode, mileage, format });
        console.log("Response:", data);
    } catch (err) {
        console.error("Error fetching data:", err);
    }
})();



Dim key As String = "{your-key}"
Dim zipcode As String = "07869"
Dim mileage As String = "3"
Dim format As String = "json"

Dim message As HttpResponseMessage = Nothing

Using client As New HttpClient()
    client.BaseAddress = New Uri("https://geodata.cdxtech.com")
    
    Dim url As New StringBuilder("/api/georadius?")
    url.Append("key=").Append(key)
    url.Append("&zipcode=").Append(zipCode)
    url.Append("&mileage=").Append(mileage)
    url.Append("&format=").Append(format)

    message = client.GetAsync(url.ToString()).Result
End Using

The following is for the VBA-WEB Excel template available at http://vba-tools.github.io/VBA-Web/



Dim Client As New WebClient
Dim Request As New WebRequest
Dim key As String
Dim zipcode As String
Dim mileage As String
Dim format As String

key = "{your-key}"
zipcode = "07869"
mileage = "3"
format = "json"

Client.BaseUrl = "https://geodata.cdxtech.com/api/"

Request.Method = WebMethod.HttpGet
Request.ResponseFormat = WebFormat.Json
Request.Resource = "georadius?key={key}&zipcode={zipCode}&mileage={mileage}&format={format}"
Request.AddUrlSegment "key", key
Request.AddUrlSegment "zipCode", zipcode 
Request.AddUrlSegment = "mileage", mileage
Request.AddUrlSegment "format", format 
    
Set Response = Client.Execute(Request)

Output Examples

Here are some output data examples. You can also use the Report Generator tab to export specific data files.



{
    "service": "GeoRadius",
    "url": "https://geodata.cdxtech.com/api/georadius?key={your-key}&zipcode=07869&mileage=3&format=json",
    "status": "Success",
    "tokenCharge": 3,
    "message": null,
    "totalResults": 4,
    "results": [{
        "coordinates": {
            "zipCode": "07869",
            "latitude": 40.842115,
            "longitude": -74.58229
        },
        "distance": 0.0,
        "distanceUnit": "miles"
    },
    {
        "coordinates": {
            "zipCode": "07970",
            "latitude": 40.810961,
            "longitude": -74.575269
        },
        "distance": 2.1835,
        "distanceUnit": "miles"
    },
    {
        "coordinates": {
            "zipCode": "07845",
            "latitude": 40.8225,
            "longitude": -74.6264
        },
        "distance": 2.6746,
        "distanceUnit": "miles"
    },
    {
        "coordinates": {
            "zipCode": "07803",
            "latitude": 40.880137,
            "longitude": -74.600716
        },
        "distance": 2.7978,
        "distanceUnit": "miles"
    }],
    "usage": {
        "used": 100,
        "remaining": 1000
    },
    "duration": 0.3449712,
    "timeStamp": "2017-02-02T12:09:46.6319649-05:00"
}



<Root>
  <Service>GeoRadius</Service>
  <Url>https://geodata.cdxtech.com/api/georadius?key={your-key}&zipcode=07869&mileage=3&format=xml</Url>
  <Status>Success</Status>
  <TokenCharge>3</TokenCharge>
  <Message />
  <TotalResults>4</TotalResults>
  <Results>
    <Coordinates>
      <ZipCode>07869</ZipCode>
      <Latitude>40.842115</Latitude>
      <Longitude>-74.58229</Longitude>
    </Coordinates>
    <Distance>0</Distance>
    <DistanceUnit>miles</DistanceUnit>
  </Results>
  <Results>
    <Coordinates>
      <ZipCode>07970</ZipCode>
      <Latitude>40.810961</Latitude>
      <Longitude>-74.575269</Longitude>
    </Coordinates>
    <Distance>2.1835</Distance>
    <DistanceUnit>miles</DistanceUnit>
  </Results>
  <Results>
    <Coordinates>
      <ZipCode>07845</ZipCode>
      <Latitude>40.8225</Latitude>
      <Longitude>-74.6264</Longitude>
    </Coordinates>
    <Distance>2.6746</Distance>
    <DistanceUnit>miles</DistanceUnit>
  </Results>
  <Results>
    <Coordinates>
      <ZipCode>07803</ZipCode>
      <Latitude>40.880137</Latitude>
      <Longitude>-74.600716</Longitude>
    </Coordinates>
    <Distance>2.7978</Distance>
    <DistanceUnit>miles</DistanceUnit>
  </Results>
  <Usage>
    <Used>100</Used>
    <Remaining>1000</Remaining>
  </Usage>
  <Duration>0.3692129</Duration>
  <TimeStamp>2017-02-02T12:09:49.9879674-05:00</TimeStamp>
</Root>