{ "openapi": "3.0.1", "info": { "title": "DesignRush B2B Agency Scraper", "description": "DesignRush scraper & API: find marketing, design and development agencies by category and location and export agency name, rating and reviews, hourly rate, min budget, team size, location and website. B2B agency discovery and lead generation — fast, no login.", "version": "0.0", "x-build-id": "0OFRYvtj67l5rnGmp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~designrush-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-designrush-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/haketa~designrush-scraper/runs": { "post": { "operationId": "runs-sync-haketa-designrush-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/haketa~designrush-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-designrush-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": "Start URLs", "type": "array", "description": "Any DesignRush URL — category page (/agency/web-design-companies), country / state page (/agency/web-design-companies/us, /agency/digital-marketing/california), or profile (/agency/profile/). Mixed types OK.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categorySlugs": { "title": "Category Slugs", "type": "array", "description": "Discover agencies from these category pages. Examples: web-design-companies, digital-marketing, branding-agencies, seo-agency, mobile-app-design-companies, ui-ux-design, packaging-design, ecommerce-development.", "default": [], "items": { "type": "string" } }, "locationSlugs": { "title": "Country / Region Slugs", "type": "array", "description": "Restrict discovery to these countries/states/cities. Examples: us, california, new-york, florida, texas. Leave empty for global. Each combination is paginated separately.", "default": [], "items": { "type": "string" } }, "agencySlugs": { "title": "Individual Agency Slugs", "type": "array", "description": "Scrape specific agency profiles directly. Slug = path after /agency/profile/. Example: digital-silk.", "default": [], "items": { "type": "string" } }, "scrapeReviews": { "title": "Scrape Verified Reviews", "type": "boolean", "description": "Include full client reviews (rating, body, reviewer, date) from each profile. Reviews are embedded in profile JSON-LD so no extra request — keep ON for richer data.", "default": true }, "scrapeProfileDetails": { "title": "Scrape Full Profile Details", "type": "boolean", "description": "Visit each profile page to extract founded year, team size, hourly rate, minimum budget, services, industries, clients, portfolio. Turn OFF for ultra-fast listing-only bulk discovery.", "default": true }, "awardWinnersOnly": { "title": "Award Winners Only", "type": "boolean", "description": "Filter to agencies that hold a DesignRush Design Award badge.", "default": false }, "minRating": { "title": "Minimum Rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop agencies below this rating (0–5). 0 = no filter.", "default": 0 }, "minReviews": { "title": "Minimum Reviews", "minimum": 0, "type": "integer", "description": "Drop agencies with fewer verified reviews than this. 0 = no filter.", "default": 0 }, "maxRecords": { "title": "Max Records", "minimum": 0, "type": "integer", "description": "Total cap on records to push. 0 = unlimited.", "default": 100 }, "maxPagesPerCategory": { "title": "Max Pages Per Category", "minimum": 1, "type": "integer", "description": "Pagination depth per category/location combo (~50 listings per page).", "default": 3 }, "requestDelay": { "title": "Request Delay (ms)", "minimum": 0, "type": "integer", "description": "Delay between requests. Higher = friendlier to Cloudflare.", "default": 1000 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel request count. Keep low (1–3) to avoid Cloudflare challenges.", "default": 2 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Default: NO proxy. DesignRush's Cloudflare blocks Apify's Datacenter and Residential proxy IP pools but allows Apify's direct compute IPs through. Only enable a proxy if you're hitting per-IP rate limits on huge runs (then prefer Residential)." } } }, "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 } } } } } } } } } }