Developers
Menu
Markers API

Search markers

GEThttps://streetartcities.com/api/markers/search

Find artworks and other places by keyword, country, city, type or tag, or near a spot on the map. Results are a lighter version of what Get a marker gives you, without images, attributes and artist details.

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 markers:read scope.

Responses

200 The markers that match

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 markers:read scope

errorobjectrequired