Bullseye Locations API

The Bullseye Locations Developer Hub

Welcome to the Bullseye Locations developer hub. You'll find comprehensive guides and documentation to help you start working with Bullseye Locations as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Introduction

This document is a guide to the web services made available to Bullseye clients. Our web services are implemented as REST services, written in C# under .Net. They are easily accessed via .Net/C#, PHP, or any other language/platform that supports REST web services.

All methods accept a client ID and API key. They will be assigned to you. The methods will return status code 401, unauthorized, if the ID and/or API key are incorrect. In addition, as an alternative, the Location and Lead Web Service methods will allow you to first authenticate the client ID and API key, then pass the the authetication key to any of the available methods in either service.

There are two types of API keys: SEARCH keys and ADMIN keys. A search key can only be used with the search service. An admin key can be used with the search service as well as the user and location services. The purpose of this distinction is for security. The search service cannot be used to alter data, only retrieve it. The additional user and location services available to the admin key can be used to alter data, so the ADMIN API key should be guarded more closely.

The REST services return JSON, and accept their parameters on the query string (or via JSON).

We also have a number of SOAP web services available, though we are in the process of deprecating our SOAP API.