{ "openapi": "3.0.1", "info": { "title": "Fourthwall Scraper [$2.80/1KšŸ’°] | Creator Storefronts", "description": "Extract Fourthwall creator storefronts ā€” profile, bio, socials, membership tiers, contact email and full product catalog. Discover creator shops automatically. Pay per storefront or product.", "version": "0.1", "x-build-id": "gQ4iJyKYpHr0xMPNC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~fourthwall-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-fourthwall-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/ahmed_jasarevic~fourthwall-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-fourthwall-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/ahmed_jasarevic~fourthwall-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-fourthwall-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": { "startUrls": { "title": "Storefront URLs to scrape", "type": "array", "description": "Fourthwall creator storefronts to scrape. Accepts full URLs (e.g. https://disguisedtoast.shop, https://shop.fourthwall.com) or bare handles/domains (e.g. disguisedtoast.shop). Each storefront produces one row in the Storefronts dataset with its profile, tiers and contact email.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "discoverStorefronts": { "title": "Discover storefronts from Fourthwall showcase pages", "type": "boolean", "description": "If true, crawls Fourthwall's public showcase pages (fourthwall.com/get-inspired and fourthwall.com/creators) and mines them for real creator storefront URLs to add to the queue. Set to false to only scrape the URLs you supplied.", "default": true }, "discoveryUrls": { "title": "Custom discovery pages", "type": "array", "description": "Additional pages (e.g. a list page or blog post) to mine for Fourthwall storefront links. Only used when 'Discover storefronts from Fourthwall showcase pages' is enabled.", "default": [ { "url": "https://fourthwall.com/get-inspired" }, { "url": "https://fourthwall.com/creators" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxStorefronts": { "title": "Max storefronts", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of creator storefronts to fully profile in one run.", "default": 20 }, "maxProductsPerStorefront": { "title": "Max products per storefront (0 = all)", "type": "integer", "description": "Cap on products extracted per storefront. Product name/price/URL come from the storefront's /collections/all page (1 request). Values > 0 additionally open that many individual product pages to enrich descriptions, SKUs, brands and variant-level pricing. Use 0 for the cheapest run.", "default": 0 }, "includeProducts": { "title": "Include product catalog", "type": "boolean", "description": "Scrape the storefront product catalog (name, price, availability, image) into the separate Products dataset. Costs one extra request per storefront. Turn off for the cheapest run, which still returns the full profile, tiers and contact email.", "default": true }, "includeMembersOnlyContent": { "title": "Include members-only content", "type": "boolean", "description": "For storefronts that sell membership tiers, also scrape the supporter posts and the members-only video catalog. Costs 2 extra requests, and only for stores that actually have tiers. Posts and videos are attached to the storefront row.", "default": true }, "maxRequestsPerCrawl": { "title": "Max requests per run", "minimum": 10, "maximum": 2000, "type": "integer", "description": "Hard safety cap on total HTTP requests for this run. Storefronts whose child pages were cut off by this cap are still pushed, flagged with `partial: true`.", "default": 400 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 } } } } } } } } } }