Art Institute Tour Guide · Acciones GPT

{
  "openapi": "3.1.0",
  "info": {
    "title": "Art Institute of Chicago API",
    "description": "API for accessing the Art Institute of Chicago's collections.",
    "version": "v1.0.0"
  },
  "servers": [
    {
      "url": "https://api.artic.edu/api/v1"
    }
  ],
  "paths": {
    "/artworks": {
      "get": {
        "summary": "List Artworks",
        "description": "Retrieve a list of artworks sorted by last updated date.",
        "operationId": "listArtworks",
        "parameters": [
          {
            "name": "ids",
            "in": "query",
            "description": "Comma-separated list of artwork IDs.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of results to return per page.",
            "schema": {
              "type": "integer",
              "default": 12
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number of results.",
            "schema": {
              "type": "integer",
              "default": 1
            }
          },
          {
            "name": "fields",
            "in": "query",
            "description": "Comma-separated list of fields to return for each artwork.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "description": "Comma-separated list of subresources to embed in response.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A list of artworks."
          }
        }
      }
    },
    "/artworks/{id}": {
      "get": {
        "summary": "Get Artwork Metadata",
        "description": "Retrieve metadata for a specific artwork, including the image_id.",
        "operationId": "getArtworkMetadata",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Identifier of the artwork.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "fields",
            "in": "query",
            "required": false,
            "description": "Comma-separated list of fields to include in the response, typically 'id', 'title', 'image_id'.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Artwork metadata including image_id.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "title": {
                          "type": "string"
                        },
                        "image_id": {
                          "type": "string",
                          "default": "2d484387-2509-5e8e-2c43-22f9981972eb"
                        }
                      }
                    },
                    "config": {
                      "type": "object",
                      "properties": {
                        "iiif_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/artworks/search": {
      "get": {
        "summary": "Search Artworks",
        "description": "Search for artworks based on criteria.",
        "operationId": "searchArtworks",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "description": "Search query.",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/artworks/{id}/manifest.json": {
      "get": {
        "summary": "Get Artwork Manifest",
        "description": "Retrieve IIIF Presentation API format representation of an artwork.",
        "operationId": "getArtworkManifest",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Identifier of the artwork.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "IIIF Presentation API format of the specified artwork."
          }
        }
      }
    }
  }
}