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:

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.