{ "openapi": "3.0.1", "info": { "title": "Artsper.com Artist & Artwork Scraper", "description": "Artsper.com artist & artwork scraper with real per-artist rollup stats (avg price, medium mix, sold count) from each artist's full catalog, plus delta mode.", "version": "0.1", "x-build-id": "EdThHNbZsyi0KTR8Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/artsiom_k~artsper-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-artsiom_k-artsper-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/artsiom_k~artsper-scraper/runs": { "post": { "operationId": "runs-sync-artsiom_k-artsper-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/artsiom_k~artsper-scraper/run-sync": { "post": { "operationId": "run-sync-artsiom_k-artsper-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", "properties": { "entityType": { "title": "Entity type", "enum": [ "artworks", "artists" ], "type": "string", "description": "Scrape artworks or artist profiles. Each produces a different output shape (see dataset_schema.json).", "default": "artworks" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of specific Artsper artist or artwork URLs, or a category/search catalog URL (e.g. https://www.artsper.com/fr/oeuvres-d-art-contemporain/peinture), to scrape directly instead of discovering via the full site sitemap — use whichever kind matches entityType. A catalog URL is paginated to completion but is never treated as a full, delisting-aware scan (see Incremental mode below); the unfiltered catalog also self-caps at 100 pages regardless of true match count, so narrow with a category/filter for large result sets. For artists specifically, consider artistUrls below instead: it checks each URL against the site's artist sitemap and gets its own persisted tracking across repeat runs.", "items": { "type": "string" } }, "artistUrls": { "title": "Artist URL list (artists only, verified)", "type": "array", "description": "Paste a list of specific Artsper artist URLs (one per line — paste a .txt file's contents directly, no upload needed) to scrape exactly those artists and their artworks, instead of crawling the full site. Each URL is checked against the real artist sitemap first (found/not-found is logged; not-found ones are skipped) unless verifyArtistUrls is off. Unlike startUrls, this list gets its own persisted tracking scope — re-running the same list on a schedule gives real new/changed/delisted detection for just those artists. Ignored when entityType is \"artworks\" or startUrls is set.", "items": { "type": "string" } }, "verifyArtistUrls": { "title": "Verify artist URL list against sitemap", "type": "boolean", "description": "When artistUrls is set, check each URL against the real artist sitemap before scraping (adds one full sitemap walk, roughly a minute, regardless of list size) and skip any not found. Turn off to scrape the list as given, unverified.", "default": true }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after pushing this many dataset items. Defaults to 50 — a fast, cheap preview, and what keeps an unconfigured run within Apify's automated 5-minute QA check. A full, uncapped sitemap crawl covers the entire site — hundreds of thousands of artworks, or the full artist directory — raise this or clear it (set to null) for that.", "default": 50 }, "mode": { "title": "Incremental mode", "enum": [ "auto", "full", "incremental" ], "type": "string", "description": "\"auto\" (recommended): full scan on the first run for a given entityType/scope, incremental (new/changed only) afterwards. \"full\": always push every item and refresh the baseline — schedule this periodically to catch delistings. \"incremental\": always push only new/changed items. Only a plain, unscoped sitemap crawl (no startUrls) or a verified artistUrls list can detect delistings or update the baseline — see docs/incremental-mode.md.", "default": "auto" }, "impersonate": { "title": "TLS impersonation target", "type": "string", "description": "curl_cffi browser TLS-impersonation target. Artsper.com's Cloudflare protection challenges plain (non-impersonated) requests, so this defaults to \"chrome\" internally — override only if that stops working." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Leave off — this Actor clears Cloudflare fine without one, and neither Apify Proxy group tested during development actually helped: Residential wasn't provisioned on the account tested (immediate HTTP 403), and the datacenter group available was reputation-blocked outright by Cloudflare (also HTTP 403, worse than no proxy). A large artist rollup may still hit occasional rate-limiting either way — see the README's Known gaps.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }