Search

Full-text search across galleries, artists, artworks, and events.

Search Entities

GET /v1/search

Search across all entity types or filter by type.

Required scope: search:read (available on all key types, including search keys)

Query Parameters

Parameter	Required	Description
`q`	✅	Search query
`type`		Filter by entity type: `galleries`, `artists`, `artworks`, `events`
`page`		Page number (default: 1)
`limit`		Results per page (default: 50)

Examples

Search everything:

curl "https://api.artland.com/v1/search?q=abstract" \
  -H "Authorization: Bearer ak_liv...n**Search only artists:**

```bash
curl "https://api.artland.com/v1/search?q=richter&type=artists" \
  -H "Authorization: Bearer ak_liv...n**Search only galleries:**

```bash
curl "https://api.artland.com/v1/search?q=zurich&type=galleries" \
  -H "Authorization: Bearer ak_liv...n### Response

```json
{
  "results": [
    {
      "type": "gallery",
      "id": 1,
      "name": "Gagosian",
      "slug": "gagosian",
      "description": "Contemporary art gallery..."
    },
    {
      "type": "artist",
      "id": 42,
      "name": "Gerhard Richter",
      "slug": "gerhard-richter",
      "description": "German visual artist..."
    }
  ],
  "total": 15,
  "page": 1
}

Result Types

Each result includes a type field indicating the entity type:

Type	Description
`gallery`	Art gallery
`artist`	Artist
`artwork`	Artwork
`event`	Exhibition, opening, talk, or workshop