artists

Show an existing artist or prepare to create a new one

Changed on

Redirects to the artist with the given name if one exists, otherwise returns an unsaved artist carrying the normalized name.

get/artists/show_or_new.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/artists/show_or_new.json
  • Auth: one of:
    • none
    • HTTP basic
    • API key in query parameter login and API key in query parameter api_key

Query parameters

namestring

The artist name to look up or create

Response

An unsaved artist carrying the normalized name

idinteger required

The unique ID of the artist

namestring required

The artist's tag name

creator_idinteger required

The ID of the user who created the artist entry

is_activeboolean required

Whether the artist is active

is_lockedboolean required

Whether the artist page is locked for editing

other_namesstring[] required

Alternative names for the artist

group_namestring required

The name of the artist group or circle

linked_user_idinteger nullable required

The ID of the linked user account

created_atstring date-time required

The time when the artist was created

updated_atstring date-time required

The last time the artist was updated

Changes