{ "openapi": "3.0.1", "info": { "title": "Art Institute of Chicago Scraper", "description": "Scrape the Art Institute of Chicago's open collection of 110,000+ artworks via their free public API. Search by keyword, browse by department or artwork type, or look up artworks by artist. Returns rich metadata including title, artist, department, date, medium, dimensions, style, and more", "version": "1.0", "x-build-id": "mHfhsr86Y8m9a9olz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~artic-chicago-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-artic-chicago-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~artic-chicago-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-artic-chicago-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~artic-chicago-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-artic-chicago-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byDepartment", "byArtworkType", "byArtist" ], "type": "string", "description": "What to fetch from the Art Institute of Chicago collection.", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Keyword to search (used in mode=search and mode=byArtist).", "default": "impressionism" }, "department": { "title": "Department", "enum": [ "PC-1", "PC-3", "PC-4", "PC-5", "PC-7", "PC-8", "PC-9", "PC-10", "PC-11", "PC-12", "PC-13", "PC-14", "PC-838" ], "type": "string", "description": "Museum department to browse (mode=byDepartment).", "default": "PC-10" }, "artworkType": { "title": "Artwork type", "enum": [ "1", "14", "18", "23", "11", "35", "36", "37", "42", "12", "31", "33", "16" ], "type": "string", "description": "Type of artwork to browse (mode=byArtworkType).", "default": "1" }, "styleTitle": { "title": "Style / movement", "type": "string", "description": "Filter by art style or movement (e.g. Impressionism, Baroque, Surrealism)." }, "placeOfOrigin": { "title": "Place of origin", "type": "string", "description": "Filter by country or region of origin (e.g. France, Japan, United States)." }, "dateStartMin": { "title": "Date start (min year)", "minimum": -5000, "maximum": 2100, "type": "integer", "description": "Only include artworks created from this year onwards (e.g. 1800)." }, "dateStartMax": { "title": "Date start (max year)", "minimum": -5000, "maximum": 2100, "type": "integer", "description": "Only include artworks created up to this year (e.g. 1900)." }, "isPublicDomain": { "title": "Public domain only", "type": "boolean", "description": "Only return artworks that are in the public domain.", "default": false }, "isOnView": { "title": "On view only", "type": "boolean", "description": "Only return artworks currently on display at the museum.", "default": false }, "hasImage": { "title": "Has image only", "type": "boolean", "description": "Only return artworks that have an associated image ID.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of artwork records to return.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }