{ "openapi": "3.0.1", "info": { "title": "Unsplash Scraper | All-In-One", "description": "Extract Unsplash photos, illustrations, collections, and creator profiles at scale with rich image metadata, download links, engagement metrics, and photographer data. Built for enterprise-grade visual intelligence, content sourcing, asset research, and automated data pipelines.", "version": "0.0", "x-build-id": "FEJR8hXpojEN0TZuF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~unsplash-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-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/fatihtahta~unsplash-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-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/fatihtahta~unsplash-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-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": "Add Search Terms", "type": "array", "description": "Enter one or more search terms such as nature, office workspace, or black background. Broader terms collect wider result sets, while specific phrases produce more targeted records.", "items": { "type": "string" } }, "category": { "title": "Choose Search Category", "enum": [ "photos", "illustrations", "collections", "users" ], "type": "string", "description": "Select which Unsplash search area should be used for keyword searches. This only affects records collected from search terms, not direct profile or collection URLs.", "default": "photos" }, "sort_by": { "title": "Choose Search Sort Order", "enum": [ "relevance", "newest", "curated" ], "type": "string", "description": "Choose how keyword photo and illustration searches should be ordered. Relevance is best for general discovery, newest is useful for fresh content, and curated emphasizes editorially selected results where available.", "default": "relevance" }, "orientation": { "title": "Filter by Image Orientation", "enum": [ "landscape", "portrait", "square" ], "type": "string", "description": "Limit keyword photo and illustration searches to a specific image layout. Use this when your downstream workflow needs landscape, portrait, or square assets." }, "license": { "title": "Filter by License Type", "enum": [ "unsplash_plus", "free" ], "type": "string", "description": "Limit keyword photo and illustration searches by Unsplash license grouping. Use this when you need to separate free results from Unsplash Plus content." }, "style": { "title": "Filter by Illustration Style (only applicable to illustrations searches)", "uniqueItems": true, "type": "array", "description": "Select one or more illustration styles for keyword searches in the Illustrations category. Leave empty to keep illustration discovery broader.", "items": { "type": "string", "enum": [ "3d", "hand_drawn", "line_art", "flat" ], "enumTitles": [ "3D | dimensional style", "Hand-drawn | sketch style", "Line art | outline style", "Flat | simplified style" ] } }, "start_url": { "title": "Add Unsplash URLs", "type": "array", "description": "Enter full Unsplash URLs, one per line. https://unsplash.com/@marekpiwnicki 0r https://unsplash.com/collections/1319040/nature.", "items": { "type": "string" } }, "limit": { "title": "Set Maximum Results per Target", "minimum": 1, "type": "integer", "description": "Set the maximum number of photo records to save for each URL or search term. Leave empty when you want the actor to continue collecting available records until the target is exhausted or the run stops." } } }, "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 } } } } } } } } } }