We are committed to being Open, as in Open Source and Open Data. We offer a standard API and a GeoJSON API.
There is currently no API key or authentication required for either.
Please let us know if you have any feedback, or what you're going to use it for.
The Standard REST API
The API is very simple, and is just a large json dataset of all artworks with all the data. It is available at https://streetartaberdeen.org/art_api.json. You might argue that it's not really an API, but rather just a large blob of JSON, and I suppose you'd be right, but it's just version one really.
A snippet of what it'll typically look like...
{
"success": true,
"message": "Thanks for downloading the Street Art Aberdeen data, 1317 items, data generated at Saturday 19th of November 2022 04:52:23 PM",
"data":[
{
"id": 110,
"title": "Near 59 Rosemount Pl, Aberdeen AB25 2XL, UK",
"description": "",
"created": "2022-01-14 13:27:11",
"modified": "2022-02-10 17:01:26",
"url": "https:\/\/streetartaberdeen.org\/gallery\/face-2",
"image": "https:\/\/streetartaberdeen.org\/images\/image-field-file_id110_2022-01-14_13-27-11_7377.jpeg",
"small_image": "https:\/\/streetartaberdeen.org\/images\/small_image-field-file_id110_2022-01-14_13-27-11_7377.jpeg",
"large_image": "https:\/\/streetartaberdeen.org\/images\/large_image-field-file_id110_2022-01-14_13-27-11_7377.jpeg",
"lat_lon": "57.15063735857732,-2.1123543764504116",
"lat": "57.15063735857732",
"lon": "-2.1123543764504116",
"year_created": "2021",
"medium": "Spray",
"state": null,
"tags": [
"skeps",
"Reckless",
"Mounthooly",
"Plske",
"Mush",
"One Love"
]
},
{
"id": 111,
"title": "Near 5WPG+CC Aberdeen, UK",
"description": "",
"created": "2022-01-14 13:27:50",
"modified": "2022-01-14 13:27:50",
"url": "https:\/\/streetartaberdeen.org\/gallery\/pipe",
"image": "https:\/\/streetartaberdeen.org\/images\/image-field-file_id111_2022-01-14_13-27-51_4476.jpeg",
"small_image": "https:\/\/streetartaberdeen.org\/images\/small_image-field-file_id111_2022-01-14_13-27-51_4476.jpeg",
"large_image": "https:\/\/streetartaberdeen.org\/images\/large_image-field-file_id111_2022-01-14_13-27-51_4476.jpeg",
"lat_lon": "57.18611717683364,-2.0739796052484705",
"lat": "57.18611717683364",
"lon": "-2.0739796052484705",
"year_created": "Unknown",
"medium": "Spray",
"state": null,
"tags": [
"Mounthooly"
]
}
]
}
The GeoJSON API
The GeoJSON API is very simple, and is just a large json dataset of all artworks with all the data, in the GeoJSON format. It is available at https://streetartaberdeen.org/art_geojson_api.json.
A snippet of what it'll typically look like...
{
"type": "FeatureCollection",
"features":[
{
"title": "Near 59 Rosemount Pl, Aberdeen AB25 2XL, UK",
"description": "",
"created": "2022-01-14 13:27:11",
"modified": "2023-02-12 15:52:34",
"url": "https:\/\/streetartaberdeen.org\/gallery\/face-2",
"image": "https:\/\/streetartaberdeen.org\/images\/orig_images\/image-field-file_id110_2022-01-14_13-27-11_7377.jpeg",
"small_image": "https:\/\/streetartaberdeen.org\/images\/small_images\/small_image-field-file_id110_2022-01-14_13-27-11_7377.jpeg",
"large_image": "https:\/\/streetartaberdeen.org\/images\/large_images\/large_image-field-file_id110_2022-01-14_13-27-11_7377.jpeg",
"year_created": "2021",
"medium": "Spray",
"state": "Gone",
"tags": [
"skeps",
"Reckless",
"Mounthooly",
"Plske",
"Mush",
"One Love"
],
"geometry": {
"coordinates": [
"-2.1123543764504116",
"57.15063735857732"
],
"type": "Point"
}
},
{
"title": "Near 5WPG+CC Aberdeen, UK",
"description": "",
"created": "2022-01-14 13:27:50",
"modified": "2022-01-14 13:27:50",
"url": "https:\/\/streetartaberdeen.org\/gallery\/pipe",
"image": "https:\/\/streetartaberdeen.org\/images\/orig_images\/image-field-file_id111_2022-01-14_13-27-51_4476.jpeg",
"small_image": "https:\/\/streetartaberdeen.org\/images\/small_images\/small_image-field-file_id111_2022-01-14_13-27-51_4476.jpeg",
"large_image": "https:\/\/streetartaberdeen.org\/images\/large_images\/large_image-field-file_id111_2022-01-14_13-27-51_4476.jpeg",
"year_created": "Unknown",
"medium": "Spray",
"state": null,
"tags": [
"Mounthooly"
],
"geometry": {
"coordinates": [
"-2.0739796052484705",
"57.18611717683364"
],
"type": "Point"
}
}
]
}
References
For more info on OpenData, see...
References used while creating the API...
- jsonapi.org
- restfulapi.net
- geojson.org
- Lorna Mitchell's excellent book, PHP Web Services
- Phil Sturgeon's also excellent book, Build APIs you won't hate