{ "openapi": "3.0.1", "info": { "title": "99designs Designer Portfolio & Stats Finder", "description": "Browse 99designs designer profiles by keyword and category, or fetch specific designers by URL or ID, with experience level, portfolio stats, and contest record.", "version": "1.1", "x-build-id": "NxtRxcaaBWBJ2HayS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xyrelith-data~99designs-designer-portfolio-and-stats-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xyrelith-data-99designs-designer-portfolio-and-stats-finder", "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/xyrelith-data~99designs-designer-portfolio-and-stats-finder/runs": { "post": { "operationId": "runs-sync-xyrelith-data-99designs-designer-portfolio-and-stats-finder", "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/xyrelith-data~99designs-designer-portfolio-and-stats-finder/run-sync": { "post": { "operationId": "run-sync-xyrelith-data-99designs-designer-portfolio-and-stats-finder", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "browse", "profiles" ], "type": "string", "description": "Search the directory, or read specific designer profiles.", "default": "browse" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword to match designer skills and portfolios (mode=browse). Leave empty to browse all designers." }, "categories": { "title": "Design categories", "uniqueItems": true, "type": "array", "description": "Only include designers who work in these design categories (mode=browse). Leave empty for every category.", "items": { "type": "string", "enum": [ "logo", "logo-design", "brand-identity-pack", "social-media-pack", "logo-website", "logo-business-card-design", "brand-guide", "business-card-design", "stationery-design", "logo-brand-guide", "logo-product-packaging", "brand-starter-pack", "brand-launch-pack", "website-app-design", "web-design", "wordpress-theme-design", "landing-page-design", "icon-button-design", "mobile-app-design", "facebook-cover-design", "social-media-page-design", "banner-ad-design", "other-website-app-design", "squarespace", "square-online-store", "nationbuilder", "web-builder", "wix-website", "business-advertising", "postcard-flyer-design", "poster-design", "infographic-design", "brochure-design", "car-truck-van-wrap-design", "signage-design", "email-design", "prezi-design", "powerpoint-template-design", "menu-design", "other-business-advertising", "zoom-background-design", "facebook-ad", "album-cover-design", "podcast-cover-design", "clothing-merchandise-design", "t-shirt-design", "clothing-apparel-design", "merchandise-design", "cup-mug-design", "sticker-design", "other-clothing-merchandise-design", "art-illustration", "illustrations", "card-invitation-design", "character-mascot-design", "tattoo-design", "3d-design", "other-art-illustration", "packaging-label-design", "product-packaging-design", "product-label-design", "other-packaging-label-design", "book-magazine-design", "book-cover-design", "magazine-cover-design", "typesetting", "typesetting-with-imagery", "other-book-magazine-design", "other", "other-design", "web-design-coded", "flash-animation", "custom-wordpress-themes", "other-design-tasks", "buttons-icons", "twitter-background-design", "quickbooks-form-design", "app-design", "print-design", "flash-banner-design" ], "enumTitles": [ "Logo & identity", "Logo design", "Logo & brand identity pack", "Logo & social media pack", "Logo & hosted website", "Logo & business card", "Brand guide", "Business card", "Stationery", "Logo & brand guide", "Logo & product packaging", "Brand starter pack", "Brand launch pack", "Web & app design", "Web page design", "WordPress theme design", "Landing page design", "Icon or button", "App design", "Facebook cover", "Social media page", "Banner ad", "Other web or app design", "Squarespace website", "Square Online Store", "NationBuilder", "Website builder", "Wix website", "Business & advertising", "Postcard, flyer or print", "Poster", "Infographic", "Brochure", "Car, truck or van wrap", "Signage", "Email", "Prezi design", "PowerPoint template", "Menu", "Other business or advertising", "Zoom background design", "Facebook ad", "Album Cover", "Podcast", "Clothing & merchandise", "T-shirt", "Clothing or apparel", "Merchandise", "Cup or mug", "Sticker", "Other clothing or merchandise", "Art & illustration", "Illustration or graphics", "Card or invitation", "Character or mascot", "Tattoo", "3D", "Other art or illustration", "Packaging & label", "Product packaging", "Product label", "Other packaging or label", "Book & magazine", "Book cover", "Magazine cover", "Typesetting", "Typesetting with imagery", "Other book or magazine", "Other", "Other design", "Web Page Design (Coded)", "Flash Animation", "Custom Wordpress Themes", "Other Graphic Design", "Button or icon", "Twitter background design", "Quickbooks form design", "App", "Print or packaging design", "Flash banner" ] }, "default": [] }, "designerLevels": { "title": "Designer levels", "uniqueItems": true, "type": "array", "description": "Only include designers at these experience levels (mode=browse). Leave empty for all levels.", "items": { "type": "string", "enum": [ "TOP", "MID", "ENTRY" ], "enumTitles": [ "Top Level", "Mid Level", "Entry Level" ] }, "default": [] }, "languages": { "title": "Designer languages", "uniqueItems": true, "type": "array", "description": "Only include designers who speak these languages (mode=browse). Leave empty for all languages.", "items": { "type": "string", "enum": [ "zh", "nl", "en", "fr", "de", "id", "it", "ja", "ko", "pt", "es" ], "enumTitles": [ "Chinese", "Dutch", "English", "French", "German", "Indonesian", "Italian", "Japanese", "Korean", "Portuguese", "Spanish" ] }, "default": [] }, "industries": { "title": "Industries", "uniqueItems": true, "type": "array", "description": "Only include designers with portfolio work in these industries (mode=browse). Leave empty for every industry.", "items": { "type": "string", "enum": [ "business", "food", "medical", "retail", "technology", "advocacy", "accounting", "agriculture", "animals", "architectural", "art", "attorney", "automotive", "bar", "children", "cleaning", "communications", "community", "computer", "construction", "cosmetics", "dating", "education", "entertainment", "environment", "fashion", "floral", "games", "home", "industrial", "internet", "landscaping", "photography", "physical", "politics", "realestate", "religious", "restaurant", "security", "spa", "sports", "travel", "wedding" ], "enumTitles": [ "Business & consulting", "Food & drink", "Medical & pharmaceutical", "Retail", "Technology", "Advocacy", "Accounting & financial", "Agriculture", "Animal & pet", "Architectural", "Art & design", "Attorney & law", "Automotive", "Bar & nightclub", "Childcare", "Cleaning & maintenance", "Communications", "Community & non-profit", "Computer", "Construction", "Cosmetics & beauty", "Dating", "Education", "Entertainment & the arts", "Environmental", "Fashion", "Floral", "Games & recreational", "Home furnishing", "Industrial", "Internet", "Landscaping", "Photography", "Physical fitness", "Political", "Real estate & mortgage", "Religious", "Restaurant", "Security", "Spa & esthetics", "Sport", "Travel & hotel", "Wedding service" ] }, "default": [] }, "certifications": { "title": "Certifications", "uniqueItems": true, "type": "array", "description": "Only include designers who hold these 99designs certifications (mode=browse). Leave empty for all certifications.", "items": { "type": "string", "enum": [ "print-basics", "jimdo", "squarespace", "prezi", "square-online-store", "square-online-store-web", "brand-guide", "nationbuilder", "product-packaging", "facebook-ad", "wix-website", "ceros" ], "enumTitles": [ "Print basics", "Jimdo", "Squarespace", "Prezi", "Square Online Store", "Square Online Store Web", "Brand guide", "NationBuilder", "Product packaging", "Facebook Ad", "Wix", "Ceros" ] }, "default": [] }, "profileUrls": { "title": "Profile URLs, slugs or IDs", "type": "array", "description": "Designer profile URLs, slugs or numeric IDs (mode=profiles). Subpage URLs are accepted and reduced to the profile.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max designers", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of designers to return (1–1000 per run). 99designs caps a single search at 10,000 results; split broad searches by category, level, language, industry or certification.", "default": 20 }, "includeProfileDetails": { "title": "Include full profile details", "type": "boolean", "description": "When on, each search result is opened to add bio, country, stats, languages, certifications, availability and portfolio. Turn off for faster, lighter search-only records.", "default": true }, "maxDesignsPerProfile": { "title": "Portfolio designs per designer", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many portfolio designs to include per designer (0–100). 0 leaves the portfolio out; more than 12 adds extra requests.", "default": 12 } } }, "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 } } } } } } } } } }