{ "openapi": "3.0.1", "info": { "title": "Figma Community Scraper", "description": "A specialized web scraper that extracts comprehensive metadata from Figma Community files, including templates, plugins, and design resources. This actor enables designers, design ops teams, and researchers to discover, analyze, and track popular design resources at scale.", "version": "0.0", "x-build-id": "NLmQRgLdeowakmGxK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eliaalberti~figma-community-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eliaalberti-figma-community-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/eliaalberti~figma-community-scraper/runs": { "post": { "operationId": "runs-sync-eliaalberti-figma-community-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/eliaalberti~figma-community-scraper/run-sync": { "post": { "operationId": "run-sync-eliaalberti-figma-community-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": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "List of search terms to find Figma Community files (e.g., 'mobile app design', 'dashboard UI')", "default": [ "dashboard design" ], "items": { "type": "string" } }, "resourceType": { "title": "1️⃣ Resource Type", "enum": [ "all", "files", "plugins", "widgets", "figjam" ], "type": "string", "description": "Filter by type of resource", "default": "all" }, "priceFilter": { "title": "2️⃣ Price Filter", "enum": [ "all", "free", "paid" ], "type": "string", "description": "Filter by price model", "default": "all" }, "officialOnly": { "title": "3️⃣ Official Figma Content Only", "type": "boolean", "description": "Only show official Figma templates and resources", "default": false }, "minLikes": { "title": "4️⃣ Minimum Likes", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only include files with at least this many likes", "default": 0 }, "maxLikes": { "title": "4️⃣ Maximum Likes", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only include files with at most this many likes (0 = no limit)", "default": 0 }, "minViews": { "title": "5️⃣ Minimum Views/Users", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Only include files with at least this many views/users", "default": 0 }, "maxViews": { "title": "5️⃣ Maximum Views/Users", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Only include files with at most this many views/users (0 = no limit)", "default": 0 }, "creatorWhitelist": { "title": "6️⃣ Creator Whitelist (Include Only)", "type": "array", "description": "Only include files from these creators (usernames). Leave empty to include all.", "default": [], "items": { "type": "string" } }, "creatorBlacklist": { "title": "6️⃣ Creator Blacklist (Exclude)", "type": "array", "description": "Exclude files from these creators (usernames)", "default": [], "items": { "type": "string" } }, "publishedWithinDays": { "title": "7️⃣ Published Within Days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only include files published within the last X days (0 = no limit)", "default": 0 }, "category": { "title": "Category Filter", "enum": [ "all", "mobile", "web", "illustration", "design-systems", "wireframes", "icons" ], "type": "string", "description": "Filter results by category", "default": "all" }, "sortBy": { "title": "Sort Results By", "enum": [ "popular", "recent" ], "type": "string", "description": "How to sort the search results", "default": "popular" }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of files to scrape (total across all queries). Free tier: 50 max.", "default": 50 }, "includeCreatorDetails": { "title": "Include Creator Details", "type": "boolean", "description": "Extract additional information about file creators", "default": true } } }, "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 } } } } } } } } } }