Skip to content

Local Profiles

Stable
Available in the US and Canada

GET v3/profiles

Use this endpoint to retrieve the Local Profiles of a specific location using an identifier. Local Profiles can be retrieved by supplying the specific geog_id, or by supplying a lat and lng coordinate pair as arguments. See below for examples.

V3 Header Request Parameters

This API uses JWT token based authentication. This JWT Bearer token is what is used to populate the Authorization header below.

Instructions on how to retrieve this token can be found at Accessing the API → V3 API Authorization.

HeaderStatusDescription
AuthorizationrequiredYour bearer token retrieved from our authorization API, ex. Bearer eyJhbGci...
AcceptrequiredThe datatype to request, this API will return application/json.

V3 Calling with a geog_id

GET v3/profiles/{geog_id}
ParameterStatusDescription
geog_idrequired*An identifier that we provide for you to request a specific profile (see the Specifying neighbourhoods section). Accepted values are g10_*, g20_* and g30_*. Other values will result with a 404 (not found) status code.

V3 Calling with lat and lng

GET v3/profiles?lat={lat}&lng={lng}
ParameterStatusDescription
latrequired*A decimal number between -90 and 90, representing the latitude.
lngrequired*A decimal number between -180 and 180, representing the longitude.
localeoptionalString value representing the language to return the profiles in.
Available:en (English), fr (French)
Default: en
* If a geog_id path parameter is provided, the lat and lng arguments are optional, and vice versa.

V3 NodeJS example

require('node-fetch')('https://api.locallogic.co/v3/profiles/g20_f25dyhf3?' + new URLSearchParams({
locale: 'en',
}), {
method: 'GET',
headers: {
Accept: 'application/json',
Authorization: 'Bearer eyJhbGciOiJ...'
}
})
.then(response => response.json())
.then(body => {
console.log(body)
})
.catch(error => {
console.log(error)
})

V3 200 - Response example

{
"data": {
"profiles": {
"transport": "This part of the city is a very pleasant part of Montréal for cyclists and pedestrians. Cycling is convenient in Ville-Marie because there...",
"services": "In Ville-Marie, families will typically be able to reach daycares and schools on foot. In addition to public schools, there are private elementary and...",
"character": "Ville-Marie offers a variety of experiences for home buyers who enjoy a vibrant atmosphere and spending time in green spaces. There are a large number of vibrant spots in this area to explore..."
},
"id": "g20_f25dyhf3",
"bounding_box": {
"west": -73.60695342963047,
"east": -73.51738361127795,
"south": 45.48710983364872,
"north": 45.53938230417042
},
"centroid": {
"lng": -73.56099384933795,
"lat": 45.5097221239011
},
"intro": "Ville-Marie is a neighbourhood within Montréal, Quebec.",
"name": "Ville-Marie"
},
"meta": {
"sections": {
"transport": "Transportation",
"services": "Services",
"character": "Character",
"housing": "Housing"
}
}
}

Important: Make sure to display information under data.attributes.* as HTML.

GET v1/profiles/{geog_id}

⚠️ The v1/profiles API is deprecated.

Use this endpoint to retrieve the Local Profiles of a specific location using an identifier.

GET /profiles/{geog_id}

V1 Path Request Parameters

ParameterStatusDescription
geog_idrequiredAn identifier that we provide for you to request a specific profile (see the Specifying neighbourhoods section)

V1 QueryString Request Parameters

ParameterStatusDescription
keyrequiredThe ApiKey provided for you
localeoptionalString value representing the language to return the profiles in.
Available:en (English), fr (French)
Default: en

V1 NodeJS example

require('request')({
method: 'GET',
url: 'https://api.locallogic.co/v1/profiles/g20_f25dyhf3',
qs: {
key: 'YOUR_API_KEY',
locale: 'en',
}
}, function (err, response, body) {
// See response example
})

V1 200 - Response example

{
"data": {
"attributes": {
"transport": "This part of the city is a very pleasant part of Montréal for cyclists and pedestrians. Cycling is convenient in Ville-Marie because there...",
"services": "In Ville-Marie, families will typically be able to reach daycares and schools on foot. In addition to public schools, there are private elementary and...",
"character": "Ville-Marie offers a variety of experiences for home buyers who enjoy a vibrant atmosphere and spending time in green spaces. There are a large number of vibrant spots in this area to explore..."
},
"id": "g20_f25dyhf3"
},
"meta": {
"name": "Ville-Marie",
"intro": "Ville-Marie is a neighbourhood within Montréal, Quebec.",
"sections": {
"transport": "Transportation",
"services": "Services",
"character": "Character",
"housing": "Housing"
}
}
}

Important: Make sure to display information under data.attributes.* as HTML.

© Local Logic 2023