Time Zone from ZIP Code

Implementation Guide

Introduction

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

Calling outside permitted hours is a major violation of TCPA regulations, and it could lead to costly lawsuits. Protect your business with Searchbug’s ZIP Code to Timezone API, specifically built to help telemarketers stay compliant and contact people during only allowed hours.

Still manually checking customer time zones? It’s time to upgrade! This API seamlessly integrates into your CRM, automatically adding accurate time zone information and eliminating guesswork, so you can focus on effective and compliant outreach. It also reports if Daylight Savings is observed and the city and state.

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_ziptz Required. Use api_ziptz for this API
ZIP 90210 Zip Code of the residence
FORMAT JSON Optional. The default is XML. To get results in JSON format, pass FORMAT=JSON
REF CUST001 Optional. Used for API usage tracking per application or customer (100 char max).

Receiving Results

The results are returned in the XML format. Here is an example: 


<?xml version="1.0" encoding="ISO-8859-1" standalone="true"?>
- <RESULTS>
    - <ZIPCODE>
        <ZIP>90210</ZIP>
        <TIMEZONE>Pacific Daylight Time (PDT)</TIMEZONE>
        <OFFSET>7</OFFSET>
        <DAYLIGHTSAVING>Y</DAYLIGHTSAVING>
        <CITY>BEVERLY HILLS</CITY>
        <STATE>CA</STATE>
        <CURRENTTIME>CA</CURRENTTIME>
    - </ZIPCODE>
    <STATS>
        <DATE>06/13/2014</DATE>
        <DAILY>1</DAILY>
        <MONTHLY>1</MONTHLY>
    </STATS>    
</RESULTS>

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.