{
  "openapi": "3.0.1",
  "info": {
    "title": "Unsplash Scraper: Photos, Views, Downloads & Photographers",
    "description": "Unsplash photos past the 4,000-result limit of one search, each with views, downloads and 30 days of daily statistics. Plus EXIF camera data, location, tags, topics and photographer profiles with their totals. Search by keyword, photographer, collection, topic, photo ID or link. No login.",
    "version": "0.0",
    "x-build-id": "XDh5bCjjrj5CWoxzu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/clearpath~unsplash-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-clearpath-unsplash-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/clearpath~unsplash-scraper/runs": {
      "post": {
        "operationId": "runs-sync-clearpath-unsplash-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/clearpath~unsplash-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-clearpath-unsplash-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": {
          "queries": {
            "title": "Search terms",
            "type": "array",
            "description": "Keywords to search on Unsplash, one search per term. A search continues past the 4,000 results Unsplash shows for one search when <b>Maximum results per input</b> allows it.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Maximum results per input",
            "minimum": 0,
            "type": "integer",
            "description": "How many photos to save for each search term, photographer, collection, topic or link. <code>0</code> saves everything Unsplash has for it. Photo IDs count as one input together. Each saved photo is one billed result.",
            "default": 100
          },
          "startUrls": {
            "title": "Unsplash links",
            "type": "array",
            "description": "Paste unsplash.com pages: a search (<code>/s/photos/coffee?orientation=portrait</code>, filters in the link are kept), a photo, a photographer (<code>/@username</code>), a collection (<code>/collections/…</code>) or a topic (<code>/t/wallpapers</code>).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "usernames": {
            "title": "Photographers",
            "type": "array",
            "description": "Unsplash usernames or profile links. Saves the photographer's portfolio, ordered by <b>Portfolio order</b>.",
            "items": {
              "type": "string"
            }
          },
          "collectionIds": {
            "title": "Collections",
            "type": "array",
            "description": "Collection IDs or collection links, e.g. <code>FonJbd-xMR8</code>.",
            "items": {
              "type": "string"
            }
          },
          "topics": {
            "title": "Topics",
            "type": "array",
            "description": "Topic slugs or topic links, e.g. <code>wallpapers</code>, <code>nature</code>, <code>3d-renders</code>.",
            "items": {
              "type": "string"
            }
          },
          "photoIds": {
            "title": "Photo IDs",
            "type": "array",
            "description": "Photo IDs, slugs or photo links, e.g. <code>zEdCT0qrodE</code>.",
            "items": {
              "type": "string"
            }
          },
          "portfolioOrder": {
            "title": "Portfolio order",
            "enum": [
              "latest",
              "oldest",
              "popular",
              "views",
              "downloads"
            ],
            "type": "string",
            "description": "Order of a photographer's photos."
          },
          "topicOrder": {
            "title": "Topic order",
            "enum": [
              "latest",
              "oldest",
              "popular"
            ],
            "type": "string",
            "description": "Order of a topic's photos."
          },
          "assetType": {
            "title": "Search for",
            "enum": [
              "photos",
              "illustrations"
            ],
            "type": "string",
            "description": "Photos or illustrations. Applies to search terms; a pasted search link keeps its own choice."
          },
          "orderBy": {
            "title": "Sort by",
            "enum": [
              "relevant",
              "latest"
            ],
            "type": "string",
            "description": "Most relevant or newest first."
          },
          "license": {
            "title": "License",
            "enum": [
              "all",
              "free",
              "plus"
            ],
            "type": "string",
            "description": "All photos, only free photos (Unsplash License), or only Unsplash+ photos."
          },
          "orientation": {
            "title": "Orientation",
            "enum": [
              "any",
              "landscape",
              "portrait",
              "squarish"
            ],
            "type": "string",
            "description": "Shape of the photo."
          },
          "color": {
            "title": "Color",
            "enum": [
              "any",
              "black_and_white",
              "black",
              "white",
              "yellow",
              "orange",
              "red",
              "purple",
              "magenta",
              "green",
              "teal",
              "blue"
            ],
            "type": "string",
            "description": "Dominant color, or black and white."
          },
          "contentFilter": {
            "title": "Content safety",
            "enum": [
              "low",
              "high"
            ],
            "type": "string",
            "description": "<b>Standard</b> is Unsplash's default. <b>Strict</b> also hides photos Unsplash marks as possibly sensitive."
          },
          "includePhotoDetails": {
            "title": "Include photo details",
            "type": "boolean",
            "description": "Total views and downloads, camera (EXIF), location, tags and topics for every photo.",
            "default": true
          },
          "includeStatistics": {
            "title": "Include 30-day statistics",
            "type": "boolean",
            "description": "Views and downloads per day for the last 30 days, with 30-day totals. Unsplash does not publish these for Unsplash+ photos.",
            "default": true
          },
          "includePhotographerDetails": {
            "title": "Include photographer profile",
            "type": "boolean",
            "description": "The photographer's badge, interests, Unsplash+ status, total views and downloads, and their views and downloads per day for the last 30 days. Fetched once per photographer.",
            "default": true
          },
          "includeSponsored": {
            "title": "Include sponsored photos",
            "type": "boolean",
            "description": "Unsplash places an advertiser's photo in search results about every seventh place. These ignore your filters and sort order, so they are left out unless this is on. Included ones carry <code>isSponsored</code> and the sponsor's name.",
            "default": false
          },
          "feedback": {
            "title": "Feedback to the maintainers",
            "type": "string",
            "description": "For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}