Skip to main content

Search API

The Search API allows you to search across artists, festivals, and genres.

Search for artists, festivals, and genres.

Endpoint: GET /search

Query Parameters:

  • for (required): Search query string

Response:

{
  "artists": [
    {
      "id": "artist-id",
      "name": "Artist Name",
      "photo": "https://example.com/photo.jpg",
      "bio": "Artist biography",
      "genres": [
        {
          "id": "genre-id",
          "name": "Electronic"
        }
      ]
    }
  ],
  "festivals": [
    {
      "id": "festival-id",
      "name": "Summer Music Festival",
      "photo": "https://example.com/photo.jpg",
      "description": "A great music festival",
      "venue": "Central Park",
      "start_time": "2024-07-01T00:00:00Z",
      "end_time": "2024-07-03T23:59:59Z"
    }
  ],
  "genres": [
    {
      "id": "genre-id",
      "name": "Electronic"
    }
  ],
  "query": "electronic"
}

Example:

curl -X GET "https://api.festivalism.com/search?for=electronic"

The search performs:

  1. Artists by name: Searches for artists matching the query
  2. Festivals by name: Searches for festivals matching the query
  3. Artists by genre: Finds artists tagged with genres matching the query
  4. Festivals by genre: Finds festivals with gigs from artists tagged with matching genres