ZIP Code in Radius

Implementation Guide

Introduction

Please see the Overview Page to review account setup, authentication instructions, and other common API features.

Planning local and targeted marketing campaigns? Searchbug® has the perfect tool to help you identify key areas for your outreach. The ZIP Code in Radius API provides essential details like the state, city, and county, along with its population, number of businesses, and the distance.

When you enter a ZIP Code, the API searches for surrounding ZIP Codes within your specified radius. The results include each ZIP Code, its distance from the main ZIP Code, and the corresponding details mentioned above.

Are you curious how to easily integrate this into your existing systems? This API Documentation is here to guide you!

This guide includes:

  1. Sending Request
  2. Receiving Results

Sending Request

The request should be sent to Searchbug using the following URL using the POST method:

https://data.searchbug.com/api/search.aspx

Search Parameters

You can submit your request via:

  • POST Header: Parameters sent as custom headers
  • POST Body: Parameters sent as form-data
Parameter Value Example Description
CO_CODE 3453167 Required. Your account number
PASS H4z865i3$1 API Key or account password (not needed if using Bearer Token)
TYPE api_zipradius Required. Use api_zipradius for this API.
ZIP 92612 Zip Code of the residence
DIST 5 Radius in miles (e.g. 5)
FORMAT JSON Optional. The default is XML. To get results in JSON format, pass FORMAT=JSON

Receiving Results

Here is an example in XML format: 


<?xml version="1.0" encoding="ISO-8859-1" standalone="true"?>
<Results>
    - <Set>
        <Dist>2.979</Dist>
        <City>IRVINE</City>
        <State>CA</State>
        <Zip>92612</Zip>
        <Population>31306</Population>
        <NumberOfBusinesses>1950</NumberOfBusinesses>
        <NumberOfEmployees>42370</NumberOfEmployees>
    </set>
    - <Set>
        <Dist>2.981</Dist>
        <City>IRVINE</City>
        <State>CA</State>
        <Zip>92617</Zip>
        <Population>11478</Population>
        <NumberOfBusinesses>92</NumberOfBusinesses>
        <NumberOfEmployees>0</NumberOfEmployees>
    </Set>
    <Set>
        <Dist>2.997</Dist>
        <City>NEWPORT COAST</City>
        <State>CA</State>
        <Zip>92657</Zip>
        <Population>11545</Population>
        <NumberOfBusinesses>290</NumberOfBusinesses>
        <NumberOfEmployees>3030</NumberOfEmployees>
</Set>

Example of the results in JSON Format 

                             
{
    "Status": "Success",
    "Data": { 
        "Set": [
        {
            "Dist": "2.979",
            "City": "IRVINE", 
            "State": "CA",
            "Zip": "92612", 
            "Population": "31306",
            "NumberOfBusinesses": "1950",
            "NumberOf Employees": "42370"
        },
        {
            "Dist": "2.981",
            "City": "IRVINE",
            "State": "CA",
            "Zip": "92617",
            "Population": "11478",
            "NumberOfBusinesses": "92",
            "NumberOf Employees": "0"
        },
        {
            "Dist": "2.997",
            "City": "NEWPORT COAST",
            "State": "CA",
            "Zip": "92657",
            "Population": "11545",
            "NumberOfBusinesses": "290",
            "NumberOf Employees": "3030"
        },
        {
            "Dist": "3.071",
            "City": "IRVINE",
            "State": "CA",
            "Zip": "92697",
            "Population": "0",
            "NumberOfBusinesses": "37",
            "NumberOf Employees": "287"
        },
        {
            "Dist": "4.557",
            "City": "IRVINE",
            "State": "CA",
            "Zip": "92604",
            "Population": "27605",
            "NumberOfBusinesses": "825",
            "NumberOf Employees": "7030"
        },
        {
            "Dist": "4.588",
            "City": "NEWPORT BEACH",
            "State": "CA",
            "Zip": "92660",
            "Population": "36122",
            "NumberOfBusinesses": "3651",
            "NumberOf Employees": "48638"
        }
    ]
  },
  "Error": ""
}

For further technical details and customer support, please chat with us, email us, or call us (800) 990-2939.

For sales and pricing information please contact sales@searchbug.com.