Help - Spotzi Webservice


Spotzi API


The Spotzi webservice is a collection of services that allows the user to automatically request or update the datasets that are available in their Spotzi Mapbuilder Account. Once datasets are bought from the Spotzi Datashop or are imported through the Spotzi Mapbuilder they are immediately accessible by the Spotzi Webservice. The Spotzi Webservice allows you to automate your workflows and connect your Spotzi Account to other services.

There are four types of request that can be done with the Spotzi Webservice, namely:

Each of these requests are described in the corresponding articles in the Help Centre. The Spotzi webservice is available for all premium and enterprise users by the Spotzi Webservice App. This documentation shows the possibilities and restrictions of the Spotzi Webservice.

Base URL

A typical web service request is generally of the following form:



The parameters that are appended to the Base URL of the Spotzi Webservice consist of the parameter name followed by the parameter value. The different parameters are split by the & sign. A typical parameter if generally of the following form:


In the table below you will find an overview of the required parameters.

q = The request query that has to be executed


userName = A valid username

EXAMPLE: demouser

userKey = A valid apikey

EXAMPLE: 1973b5f4b6d0eda968092eecb8362d589ac9a496

format = The desired response format (see Response formats)

EXAMPLE: application/json

Response formats

The following response formats are available within the Spotzi Webservice.

Name Type HTTP content type
CSV File/text text/csv
JSON Text application/json
XML Text text/xml





A typical web service request with all parameters looks as follows:

You can find example for each of the possible request types in the corresponding article.

Please note that you will need Spotzi Studio to be able to use the Spotzi Webservice.

Related blog posts

Interested in our solutions? Please contact our sales team.

Whether you are new to data analytics or already an expert. We offer solutions for everyone. You don’t need to be a data expert to work with Spotzi Location. For more tailor made solutions we offer Spotzi Studio. With this plan you cannot only manage the data yourself but also connect to our API and manage users for the dashboards you create. Or work with our Market Ready Dashboards and drive on autopilot.