API doc
Artworks
GET /api/artsPaginated list of artworks (20 per page), with filters on name, a tag, or a geolocated selection. Can also return a random selection.
| Parameter | Description |
|---|---|
| lng | Result language ("fr" or "en") (e.g.: fr) |
| offset | Pagination offset (20 results per page) (e.g.: 20) |
| name | Filter on the artwork's or artist's name |
| tag | Filter on a tag slug |
| random | Presence of the parameter = random order |
| geolocation | Presence of the parameter = only return geolocated artworks |
Artists
GET /api/artistsList of artists, with filters on name, gender, nationality, or a period (birth/death years).
| Parameter | Description |
|---|---|
| lng | Result language ("fr" or "en") (e.g.: fr) |
| gender | Filter on the artist's gender |
| name | Filter on first or last name |
| nationality | Country slug, or "world" for all countries |
| years | Period, formatted "start,end" (e.g.: 1800,1900) |
Collection
GET /api/collectionMain entry point for retrieving artworks in a specific context: an artist's or movement's full collection, famous artworks, a historical figure, a tag, or the featured talents' artworks.
| Parameter | Description |
|---|---|
| lng | Result language ("fr" or "en") (e.g.: fr) |
| type | Collection type: "artist", "movement", "famousart", "histocharacters", "tag" or "talentsart" (e.g.: artist) |
| slug | Artist, movement, or tag slug (depending on type) |
| name | Filter on name (artworks or historical figures) |
| alone | Presence of the parameter = return a single artwork only |
| id | Artwork id (used with "alone") |
| aloneartistslug | Restricts a movement or tag to a single artist |
| years | Historical period, formatted "start,end" (historical figures) |