PlaceILive.com API
PlaceILive.com API gives you access our collected data about the properties around the world and get Life Quality Index for the neighbourhoods. You can use API in the following cases:
- Integrate LQI into your website
- Add LQI for any property listing
- Enable search for properties by the address or by the geolocation and get LQI
PlaceILive.com is supported in New York, Chicago, San Francisco, Berlin & London for now.
Getting Started
Before you get started, keep in mind the API is an early version. In order to be updated about our planned changes, improvements and development of our API, please, drop us a message at info@placeilive.com.
In order to use the our API and access you must agree with PlaceILive.com API Terms of use.
All data requests are done via HTTP. The host name of the API: https://api.placeilive.com/
LQI Icon
Icon allows you to embed Life Quality Index in your website.
The icon is 107px width and 104px height.
In order to render the icon the address must be passed as q parameter.
Here is the following snippet with
address '430 Michigan, 60605, Chicago' used as an example.
<script type="text/javascript" src="https://api.placeilive.com/v1/lqi_icon.js?q=Michigan%20430,%2060605,%20Chicago"></script>
The outcome:
Data API Calls
The API calls are made to https://api.placeilive.com/v1/. v1 is the version of the API. Currently latest version is 1.
Searching for houses
GET Request:
https://api.placeilive.com/v1/houses/search?q=Behrenstrasse%204
Result:
[
{
id: 219089,
address: "Behrenstraße 4, Mitte, Berlin, DE",
profileUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_4-YNquw",
lat: "52.51505997",
lng: "13.38337051",
lqi: {
value: 74,
icon: "https://api.placeilive.com/api-assets/lqi_icons/lqi74.png",
label: "Good"
},
lqi_category: [
{
type: "Transportation",
value: 97,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_transport_green.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_4-YNquw#h-data_group_Transportation"
},
{
type: "Daily Life",
value: 78,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_daily_green.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_4-YNquw#h-data_group_Daily_Life"
},
{
type: "Safety",
value: 46,
label: "Average",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_safety_orange.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_4-YNquw#h-data_group_Safety"
},
{
type: "Health",
value: 52,
label: "Average",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_health_orange.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_4-YNquw#h-data_group_Health"
},
{
type: "Sports And Leisure",
value: 96,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_sport_green.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_4-YNquw#h-data_group_Sports_and_Leisure"
},
{
type: "Entertainment",
value: 98,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_entertainment_green.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_4-YNquw#h-data_group_Entertainment"
},
{
type: "Community",
value: 46,
label: "Average",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_community_orange.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_4-YNquw#h-data_group_Community"
}
]
},
{
id: 218981,
address: "Behrenstraße 2, Mitte, Berlin, DE",
profileUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_2-xs7lw",
lat: "52.51501520",
lng: "13.38303475",
lqi: {
value: 74,
icon: "https://api.placeilive.com/api-assets/lqi_icons/lqi74.png",
label: "Good"
},
lqi_category: [
{
type: "Transportation",
value: 98,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_transport_green.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_2-xs7lw#h-data_group_Transportation"
},
{
type: "Daily Life",
value: 78,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_daily_green.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_2-xs7lw#h-data_group_Daily_Life"
},
{
type: "Safety",
value: 46,
label: "Average",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_safety_orange.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_2-xs7lw#h-data_group_Safety"
},
{
type: "Health",
value: 53,
label: "Average",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_health_orange.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_2-xs7lw#h-data_group_Health"
},
{
type: "Sports And Leisure",
value: 97,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_sport_green.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_2-xs7lw#h-data_group_Sports_and_Leisure"
},
{
type: "Entertainment",
value: 98,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_entertainment_green.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_2-xs7lw#h-data_group_Entertainment"
},
{
type: "Community",
value: 46,
label: "Average",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_community_orange.png",
dataGroupUrl: "https://berlin.placeilive.com/Mitte/Behrenstrasse_2-xs7lw#h-data_group_Community"
}
]
}
]
Searching for houses by geolocation
GET Request:
https://api.placeilive.com/v1/houses/search?ll=37.77147445,-122.454656213
Result:
[
{
id: 209970,
address: "Stanyan St 501, 94122, San Francisco, US",
profileUrl: "https://sanfrancisco.placeilive.com/San_Francisco_94122/94117_Stanyan_St_501-Ih5Qw",
lat: "37.77197536",
lng: "-122.45480092",
lqi: {
value: 89,
icon: "https://api.placeilive.com/api-assets/lqi_icons/lqi89.png",
label: "Good"
},
lqi_category: [
{
type: "Transportation",
value: 81,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_transport_green.png",
dataGroupUrl: "https://sanfrancisco.placeilive.com/San_Francisco_94122/94117_Stanyan_St_501-Ih5Qw#h-data_group_Transportation"
},
{
type: "Daily Life",
value: 83,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_daily_green.png",
dataGroupUrl: "https://sanfrancisco.placeilive.com/San_Francisco_94122/94117_Stanyan_St_501-Ih5Qw#h-data_group_Daily_Life"
},
{
type: "Safety",
value: 85,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_safety_green.png",
dataGroupUrl: "https://sanfrancisco.placeilive.com/San_Francisco_94122/94117_Stanyan_St_501-Ih5Qw#h-data_group_Safety"
},
{
type: "Health",
value: 61,
label: "Average",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_health_orange.png",
dataGroupUrl: "https://sanfrancisco.placeilive.com/San_Francisco_94122/94117_Stanyan_St_501-Ih5Qw#h-data_group_Health"
},
{
type: "Sports And Leisure",
value: 95,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_sport_green.png",
dataGroupUrl: "https://sanfrancisco.placeilive.com/San_Francisco_94122/94117_Stanyan_St_501-Ih5Qw#h-data_group_Sports_and_Leisure"
},
{
type: "Entertainment",
value: 88,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_entertainment_green.png",
dataGroupUrl: "https://sanfrancisco.placeilive.com/San_Francisco_94122/94117_Stanyan_St_501-Ih5Qw#h-data_group_Entertainment"
},
{
type: "Community",
value: 94,
label: "Good",
icon: "https://api.placeilive.com/api-assets/lqi_category_icons/lqi_community_green.png",
dataGroupUrl: "https://sanfrancisco.placeilive.com/San_Francisco_94122/94117_Stanyan_St_501-Ih5Qw#h-data_group_Community"
}
]
}
]
All other API calls are in development. If you need to try early version feel free to contacts us at info@placeilive.com.
Error codes
Few examples of error codes that you can get when accessing API:
| Response HTTP Status Code | Explanation message |
| 404 | No results found |
| 400 | Could not parse supplied WGS84 coordinates |
| 400 | Did not GET a valid request |
API for Research
If you find that our aggregated and calculated data can be useful for research, please, contact us on info@placeilive.com and we will try help.