# Redirect to an artist's image

Source: https://docs.musicnerd.net/api-reference/lookups/artist-image

Redirect to an artist's image

## GET /api/artist/{id}/image

Full OpenAPI specification: https://docs.musicnerd.net/spec/artist-lookups.json

## Authentication

This operation's specification permits a request without authentication.

[Authentication guide](https://docs.musicnerd.net/authentication)

## Operation and referenced schemas

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Music Nerd API: artist lookups",
    "version": "1.0.0",
    "description": "Public lookups: an artist by Spotify ID or Instagram handle, an artist's X handle, artist search, track links, the contributor leaderboard and an artist's image. No credentials. Each endpoint answers in its own shape, with plain-text errors, not this API's `{ status }` envelope."
  },
  "servers": [
    {
      "url": "https://musicnerd-api.vercel.app",
      "description": "Production"
    },
    {
      "url": "https://musicnerd-api-staging.vercel.app",
      "description": "Staging (staging database)"
    }
  ],
  "paths": {
    "/api/artist/{id}/image": {
      "get": {
        "summary": "Redirect to an artist's image",
        "description": "Redirects (307) to the artist's image: their own upload, otherwise their Spotify portrait, then their Deezer portrait. Any other answer has an empty body.",
        "operationId": "artistImage",
        "security": [],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "307": {
            "description": "Redirect to the image, with `Cache-Control: public, max-age=3600`.",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                },
                "description": "The image URL (`https` only)."
              }
            }
          },
          "400": {
            "description": "`id` is not a UUID."
          },
          "404": {
            "description": "No such artist, or no usable image."
          },
          "503": {
            "description": "The database could not be read."
          }
        }
      }
    }
  }
}
```
