{ "openapi": "3.0.1", "info": { "title": "Poly Haven Scraper — Free CC0 3D Assets, HDRIs & Textures", "description": "Scrape Poly Haven's free CC0 library of HDRIs, PBR textures, and 3D models. Browse by category, search by keyword, or look up assets by ID. Returns full metadata plus direct download links for every resolution/format. No API key or login required.", "version": "1.0", "x-build-id": "rflTCvPpSqFvrzGsx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~polyhaven-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-polyhaven-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~polyhaven-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-polyhaven-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~polyhaven-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-polyhaven-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": { "mode": { "title": "Mode", "enum": [ "browse", "search", "byId", "listCategories" ], "type": "string", "description": "How to find assets.", "default": "browse" }, "assetType": { "title": "Asset type", "enum": [ "hdris", "textures", "models", "all" ], "type": "string", "description": "Which Poly Haven catalog to browse/search/list categories for. Ignored in mode=byId (the type is detected automatically from each asset).", "default": "hdris" }, "hdriCategory": { "title": "HDRI category (assetType=hdris/all)", "enum": [ "natural light", "outdoor", "nature", "urban", "low contrast", "high contrast", "morning-afternoon", "partly cloudy", "indoor", "skies", "medium contrast", "clear", "artificial light", "sunrise-sunset", "midday", "overcast", "studio", "pure skies", "night" ], "type": "string", "description": "Optional category filter used when browsing/searching HDRIs. Leave blank for no filter." }, "textureCategory": { "title": "Texture category (assetType=textures/all)", "enum": [ "outdoor", "man made", "floor", "wall", "natural", "plaster-concrete", "terrain", "rock", "dirty", "brick", "concrete", "wood", "indoor", "sand", "clean", "fabric", "road", "cobblestone", "plaster", "aerial", "metal", "bark", "roofing", "asphalt", "tiles", "raw wood", "gravel", "sandstone", "snow", "cotton", "stretchy", "leather", "denim", "wool", "fleece", "knitted", "fur", "hessian", "industrial", "crepe", "jacquard", "food", "satin", "carpet", "corduroy", "suede", "woven", "velvet" ], "type": "string", "description": "Optional category filter used when browsing/searching textures. Leave blank for no filter." }, "modelCategory": { "title": "Model category (assetType=models/all)", "enum": [ "props", "nature", "industrial", "furniture", "decorative", "tools", "containers", "plants", "rocks", "seating", "ground cover", "electronics", "lighting", "table", "structures", "appliances", "trees", "food", "shelves", "rigged", "dishes", "buildings", "office", "vases", "wall decoration", "flowers", "potted plants", "instrument", "ships", "grass", "bed", "books", "weapons", "firearms", "succulent", "creature" ], "type": "string", "description": "Optional category filter used when browsing/searching models. Leave blank for no filter." }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Keyword matched against each asset's name, tags, categories, and description.", "default": "wood" }, "assetIds": { "title": "Asset IDs (mode=byId)", "type": "array", "description": "Poly Haven asset IDs to look up directly (the slug from a polyhaven.com/a/{id} URL), e.g. \"aarfontein_dirt_road\" or \"ArmChair_01\".", "default": [], "items": { "type": "string" } }, "includeDownloadLinks": { "title": "Include download links", "type": "boolean", "description": "Fetch and include direct CC0 download URLs (all resolutions/formats) for each asset. Adds one extra request per asset.", "default": true }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of records to return.", "default": 30 } } }, "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 } } } } } } } } } }