Developers
Menu
Artists API

List an artist's markers

GEThttps://streetartcities.com/api/artists/{artistId}/markers

The artist's artworks and other markers. Takes the same options and gives the same results as Search markers.

Path parameters

artistIdstringrequired

Query parameters

qstring· max length: 200

Words to look for in the title, artists, address and tags

countrystring· pattern: ^[A-Za-z]{2}$

Two-letter country code, like NL

citystring· pattern: ^[\w-]+$

City ID, like amsterdam

typestring· pattern: ^[\w-]+$

Marker type, like artwork or legal_wall

statusstring· default: active

active by default. Use removed for artworks that are gone, or all for everything

Allowed values:activeinProgressremovedall

tagstring· max length: 100

Only markers with this tag

artiststring· pattern: ^[\w-]+$

Only markers by this artist, like banksy

latnumber· >= -90· <= 90

Latitude, to find markers near a spot (use with lng)

lngnumber· >= -180· <= 180

Longitude, to find markers near a spot (use with lat)

radiusnumber· > 0· <= 100· default: 5

How far from lat and lng to look, in km (5 by default)

sortstring

distance when you pass lat and lng, otherwise relevance when you pass q, and newest when you don't

Allowed values:relevancedistancenewestoldest

formatstring· default: json

geojson gives a GeoJSON FeatureCollection instead

Allowed values:jsongeojson

updatedSincestring· date-time· pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

Only what changed since this time, like 2026-09-01T00:00:00Z

pageinteger· >= 1· <= 9007199254740991· default: 1

Which page of results, starting at 1

perPageinteger· >= 1· <= 100· default: 20

How many results per page (20 by default, at most 100)

Requirements

Needs an access token. When using OAuth, the token needs the artists:read scope.

Responses

200 The artist's markers

itemsarray Marker[]required
pagenumberrequired
perPagenumberrequired
totalnumberrequired

How many markers match, over all pages

400 Invalid request

errorobjectrequired

401 Not logged in

errorobjectrequired

403 The app doesn't have the artists:read scope

errorobjectrequired

404 Not found

errorobjectrequired