{
  "openapi": "3.0.1",
  "info": {
    "title": "SaatchiArt.com Artist & Artwork Scraper",
    "description": "SaatchiArt.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": "l3pdfXdekEEXN9lnq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/artsiom_k~saatchiart-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-artsiom_k-saatchiart-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~saatchiart-scraper/runs": {
      "post": {
        "operationId": "runs-sync-artsiom_k-saatchiart-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~saatchiart-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-artsiom_k-saatchiart-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"
          },
          "category": {
            "title": "Category (artworks only)",
            "enum": [
              "",
              "painting",
              "photography",
              "sculpture",
              "drawing",
              "printmaking",
              "mixed-media",
              "collage",
              "installation"
            ],
            "type": "string",
            "description": "Restrict artwork discovery to one category via SaatchiArt's browse API — cheaper than a full sitemap crawl, but the browse API caps its reported result count at 10,000 regardless of a category's true size (a broad category like \"photography\" has hundreds of thousands of artworks). A run only counts as a complete, delta-trackable scan when the category (combined with the filters below, if any) narrows below that cap — check the run log for \"exhaustive\" vs \"capped, narrow further\". Leave category empty to crawl the full site sitemap instead (always exhaustive, but slower — every artwork's detail page is fetched individually). Ignored when entityType is \"artists\" or startUrls is set.",
            "default": ""
          },
          "availability": {
            "title": "Availability (artworks only, category mode)",
            "enum": [
              "avail",
              "sold",
              "reserved",
              "unavail",
              ""
            ],
            "type": "string",
            "description": "Narrows a category browse by listing status. Only applies when category is set (ignored for a full sitemap crawl, which always returns every status). Leave as \"avail\" (the default) unless you specifically want sold/reserved/unavailable pieces too — including them only widens the result count, working against the 10,000-result cap.",
            "default": "avail"
          },
          "subject": {
            "title": "Subject (artworks only, category mode)",
            "type": "string",
            "description": "Narrows a category browse to one subject, e.g. \"floral\", \"landscape\", \"abstract\", \"portrait\". Only applies when category is set. Combine with mediums/styles/country to get a specific-enough query to drop under the 10,000-result cap and become exhaustive — see the category field's description."
          },
          "mediums": {
            "title": "Medium (artworks only, category mode)",
            "type": "string",
            "description": "Narrows a category browse to one medium, e.g. \"oil\", \"acrylic\", \"watercolor\", \"black & white\" (for photography). Only applies when category is set."
          },
          "styles": {
            "title": "Style (artworks only, category mode)",
            "type": "string",
            "description": "Narrows a category browse to one style, e.g. \"realism\", \"abstract expressionism\", \"minimalism\". Only applies when category is set."
          },
          "country": {
            "title": "Artist country (artworks only, category mode)",
            "type": "string",
            "description": "Narrows a category browse to artists based in one country, e.g. \"united states\", \"sweden\". Only applies when category is set."
          },
          "startUrls": {
            "title": "Start URLs (artworks only)",
            "type": "array",
            "description": "Optional list of specific SaatchiArt artwork URLs (e.g. https://www.saatchiart.com/art/.../view) to scrape directly, instead of discovering via sitemap or category. Overrides category when set. Ignored when entityType is \"artists\".",
            "items": {
              "type": "string"
            }
          },
          "artistIds": {
            "title": "Artist IDs (artworks only)",
            "type": "array",
            "description": "Optional list of SaatchiArt artist ids (the artist_id field on an artwork record, or the artist record's own external_id) — fetches every artwork for exactly these artists (sold pieces included) instead of a category/sitemap crawl. Overrides category when set (startUrls still takes priority over this). Pair with an entityType=\"artists\" run using minSoldArtworks to first collect the artist ids you want, e.g. everyone with at least one sale. Gets its own delta-mode tracking scope. Ignored when entityType is \"artists\".",
            "items": {
              "type": "string"
            }
          },
          "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 for that.",
            "default": 50
          },
          "minSoldArtworks": {
            "title": "Minimum sold artworks (artists only)",
            "minimum": 0,
            "type": "integer",
            "description": "Only push artist records with at least this many sold artworks (rollup field sold_artworks). Set to 1 to skip artists who have never sold anything — useful if you only care about active sellers and want to save on results. Artists are still fully tracked internally either way (delta baseline, delisted-detection), so this only filters what gets pushed to the dataset, not the incremental logic. Ignored when entityType is \"artworks\".",
            "default": 0
          },
          "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 category, no startUrls) can detect delistings or update the baseline.",
            "default": "auto"
          },
          "impersonate": {
            "title": "TLS impersonation target",
            "type": "string",
            "description": "curl_cffi browser TLS-impersonation target. SaatchiArt blocks plain (non-impersonated) requests, so this defaults to \"firefox\" internally — override only if that stops working."
          },
          "concurrency": {
            "title": "Concurrency (artists only)",
            "minimum": 1,
            "maximum": 15,
            "type": "integer",
            "description": "How many artist profiles to fetch (and compute the full rollup for) in parallel. Only applies to entityType=\"artists\" — artwork discovery stays sequential. Defaults to 10. Load-tested live against saatchiart.com: clean through 15 (~99% success), real HTTP 429 rate-limiting above that (94% failure at 20) — capped at 15 for this reason, raising it further will not help.",
            "default": 10
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy configuration. Leave off unless you start seeing blocks from your own IP reputation; if so, try residential rather than datacenter groups.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}