# What is Demographics?
Demographics is a service of relevant socio-economic and demographic data represented by 100 meter grids.
The main source of information is the 2017 Census at a block level of detail. Said information was additionally processed using geostatistical methods to achieve an easy-to-use representation in grids that allow a simple way to complement the analysis of any other variable that can be represented geographically. This will allow you to use it in your information models in any line of business.
# Important
This document describes the Demographics API web service. It is intended for website and mobile developers who want to use Demographics data in maps provided by one of the Geodir platform APIs.
Before you start developing with the Demographics API, review the authentication requirements (you need an API key).
# Demographics API
The following Demographics requests are available:
- Demographics LatLon returns the variables with socioeconomic and demographic information of the requested latitude, longitude location.
- Demographics con direccion returns the variables with socioeconomic and demographic information of the requested address (domicile).
Each of the services is accessed as an HTTP request and returns a JSON or XML response. All requests to a Demographics service must use the https:// protocol and include an API key.
The Demographics API uses a Unique Identifier Code (grid_code) to uniquely identify an area of information.
# Demographics API Request Format
A Demographics API request has the following form:
https://apis.geodir.co/demographics/v1/outputFormat?parameters
where outputFormat can be any of the following values:
- json (recommended) indicates output in JavaScript Object Notation (JSON); either
- xml indicates output in XML
Security is important and HTTPS is recommended whenever possible, especially for applications that include sensitive user data, such as a user's location, in requests. Using HTTPS encryption makes your application more secure and more resistant to eavesdropping or tampering.
Note: URLs must be properly encoded (See best practices) to be valid and are limited to 8000 characters for all web services. Keep this limit in mind when creating your URLs. Please note that different browsers, proxies and servers may also have different URL character limits.
Some parameters are required while others are optional. As is standard in URLs, parameters are separated by the ampersand character (&).
# Terms of Use Restrictions
For information on the terms of use, see the Demographics API Policies and the License Restrictions section of the Geodir Platform Terms of Service.