Developers
Menu
GEThttps://streetartcities.com/api/artists

Find artists by name, or list the artists with markers in a city or country. Results are a lighter version of what Get an artist gives you.

Query parameters

qstring· max length: 200

Words to look for in the artist's name and other names

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

Only artists with markers in this city, like amsterdam

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

Only artists with markers in this country, like NL

sortstring

relevance when you pass q, otherwise popular (most artworks first). oldest lists the first added first

Allowed values:relevancepopularoldest

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 artists that match

itemsarray ArtistSummary[]required
pagenumberrequired
perPagenumberrequired
totalnumberrequired

How many artists match, over all pages

400 Invalid request

errorobjectrequired

401 Not logged in

errorobjectrequired

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

errorobjectrequired