We are creating the largest openly licensed database of reviews linked to OpenStreetMap places. Help us by writing reviews directly or importing them from other sources.
The database consist of reviews under different licenses. Reviews from Mangrove are under CC BY 4.0. Reviews from lib.reviews are under CC BY-SA 4.0. Reviews directly submited to Heexy Maps and reviews imported from Google Maps and Mapy.com are under CC BY-SA 4.0 with an additional permission to use the data to contribute to OpenStreetMap.
We use a combination of user reports, automatic and manual detection mechanisms.
No, but it may be in the future.
All data (request and response) is encoded with the application/json format.
GET https://reviewsapi.heexy.org/place/1273751181
The numerical part is Mapbox-like OpenStreetMap ID of the place. This ID can change as OpenStreetMap is updated. Click here for more information.[
{
"id": "28999b54-994e-4371-8ff6-235ff15babb6",
"author": {
"id": null,
"name": null,
"avatar_url": null
},
"text": "Great place to work and to live!",
"rating": 1,
"language": null,
"images": [
"https://files.mangrove.reviews/6vhzdqyFYHr2g4112NH7KNSF7iUcPdHCRtTvs159rhE"
],
"source": "mangrove",
"created_at": "2020-10-19T05:57:36"
}
]
POST https://reviewsapi.heexy.org/submit
Request headers
Content-Type: application/json Authorization: Bearer 206021f2-81cb-44c2-a616-d84d470ae9feYou will need to submit the access token recieved from OAuth 2.0 flow via the authorization header. Client secrets and documentation are currently only provided on request. Contact us on Discord for more information.
{
"place_id": "1273751181",
"text": "Great place!",
"rating": 0.8,
"language": "en",
"images": [
"https://example.com/image.png"
]
}
Images is an array of up to 15 URLs pointing to a image of the place.
Text is an optional string of up to 3000 characters with the opinion of the author.
Rating is a number between 0 and 1 with 1 being the best experience and 0 the worst.
Language can only be present when the text is specified and is a two letter ISO 639 language code.201 Created
{ "id": "0b213df6-f1b7-4a12-b78b-350a62d9b122" }
DELETE https://reviewsapi.heexy.org/remove
Request headers
Content-Type: application/json Authorization: Bearer 206021f2-81cb-44c2-a616-d84d470ae9feYou will need to submit the access token recieved from OAuth 2.0 flow via the authorization header. Client secrets and documentation are currently only provided on request. Contact us on Discord for more information.
{
"id": "0b213df6-f1b7-4a12-b78b-350a62d9b122"
}
Only the original author can delete the review.204 No Content