Please note, we are in the process of retiring the public api. The public api, as well as its documentation and playground, will remain available until July 28th, 2025. This change will not affect integration partners using our partner api.


If you're an Artsy partner gallery, reach out to your Artsy Liaison or contact our Support team for assistance.

Public API Documentation > Resources > Profiles

Profiles API

A public profile provides information about a partner or a user.

Retrieving Profiles

Retrieve profiles by following the profiles link from root.

curl -v "https://api.artsy.net/api/profiles" -H "X-XAPP-Token: XAPP_TOKEN"

The response is a paginated result with embedded profiles.

Retrieving a Profile

Users can retrieve a specific profile by ID by rendering the "profile" link template from root.

curl -v "https://api.artsy.net/api/profiles/{id}" -H "X-XAPP-Token: XAPP_TOKEN"

Profile JSON Format

error: the server responded with status 404

Links

Key Target
self The profile resource.
permalink An external location on the artsy.net website.
owner Profile owner (user, fair, etc).
cover_image A cover image.
image:self Curied image location.
website Official website.

Example

{
  "id": "5159dac69a608324390001e5",
  "created_at": "2013-04-01T19:06:46+00:00",
  "updated_at": "2022-02-16T22:02:30+00:00",
  "handle": "ngadc",
  "location": "",
  "description": "The National Gallery of Art preserves, collects, exhibits, and fosters understanding of works of art at the highest possible museum and scholarly standards.",
  "image_versions": [
    "large",
    "square140",
    "square",
    "untouched-png"
  ],
  "_links": {
    "thumbnail": {
      "href": "https://d32dm0rphc51dk.cloudfront.net/YFzRuHBJA6lpANqDum6oCw/square.jpg"
    },
    "image": {
      "href": "https://d32dm0rphc51dk.cloudfront.net/YFzRuHBJA6lpANqDum6oCw/{image_version}.jpg",
      "templated": true
    },
    "self": {
      "href": "https://api.artsy.net/api/profiles/5159dac69a608324390001e5"
    },
    "permalink": {
      "href": "https://www.artsy.net/ngadc"
    },
    "website": {
      "href": "http://www.nga.gov/"
    },
    "cover_image": {
      "href": "https://api.artsy.net/api/images/53bea7f972616931b4230000"
    },
    "owner": {
      "href": "https://api.artsy.net/api/partners/4f99c7b793ab4b0001000179"
    }
  }
}