{ "openapi": "3.0.1", "info": { "title": "Agency Leads Scraper for DesignRush - Emails, Phones & Reviews", "description": "Scrape DesignRush agencies by category, niche and location (country, US state, city): direct emails and phones, website, address and offices, team size, rates, budgets, services, industries, clients, key people, ratings and reviews. Independent tool, not affiliated with DesignRush.", "version": "0.1", "x-build-id": "ZpJL8rU4FrmCl6Gny" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~designrush-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~designrush-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-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/scrapesage~designrush-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-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": { "categoryPicks": { "title": "Categories", "type": "array", "description": "Pick one or more DesignRush agency categories. Each category is scraped as its own list, once for every location below. Leave this empty to use the box below instead (niches, names or list URLs). With nothing filled in at all, a small sample run returns the top Digital Marketing agencies.", "items": { "type": "string", "enum": [ "digital-marketing", "search-engine-optimization", "website-design-development", "web-development-companies", "social-media-marketing", "paid-media-pay-per-click", "mobile-app-design-development", "software-development", "logo-branding", "ad-agencies", "public-relations", "content-marketing", "email-marketing", "ecommerce", "ecommerce-seo-marketing", "ui-ux-design", "ai-companies", "aeo", "it-services", "managed-service-providers", "cybersecurity", "cloud-consulting", "video-production", "video-marketing", "creative-agencies", "digital-agencies", "design-agencies", "graphic-design", "logo-design", "package-design", "print-design-companies", "product-design", "wordpress-web-design", "digital-strategy-agencies", "media-buying-agencies", "reputation-management-companies", "conversion-optimization", "affiliate-marketing", "event-marketing", "direct-marketing", "market-research", "business-consulting", "big-data-analytics-companies", "blockchain-development-companies", "software-testing-companies", "devops-consulting", "crm-consulting", "erp-consulting", "ecm-consulting", "compliance-solutions-companies", "iot-companies", "wearable-technology", "ar-vr", "staff-augmentation", "bpo", "call-centers", "phone-answering-services", "outsourced-customer-support", "hr-outsourcing", "accounting", "translation-services", "transcription-services", "audio-production", "logistics", "engineering", "investment" ], "enumTitles": [ "Digital Marketing Agencies (digital-marketing)", "SEO Agencies (search-engine-optimization)", "Web Design Companies (website-design-development)", "Web Development Companies (web-development-companies)", "Social Media Marketing Companies (social-media-marketing)", "PPC Agencies (paid-media-pay-per-click)", "Mobile App Development Companies (mobile-app-design-development)", "Software Development Companies (software-development)", "Branding Agencies (logo-branding)", "Advertising Agencies (ad-agencies)", "Public Relations Firms (public-relations)", "Content Marketing Agencies (content-marketing)", "Email Marketing Agencies (email-marketing)", "eCommerce Development Companies (ecommerce)", "eCommerce Marketing Agencies (ecommerce-seo-marketing)", "UI/UX Design Agencies (ui-ux-design)", "AI Companies (ai-companies)", "Answer Engine Optimization Agencies (aeo)", "IT Services Companies (it-services)", "Managed Service Providers (managed-service-providers)", "Cybersecurity Companies (cybersecurity)", "Cloud Consulting Companies (cloud-consulting)", "Video Production Companies (video-production)", "Video Marketing Services (video-marketing)", "Creative Agencies (creative-agencies)", "Digital Agencies (digital-agencies)", "Design Agencies (design-agencies)", "Graphic Design Companies (graphic-design)", "Logo Design Companies (logo-design)", "Packaging Design Companies (package-design)", "Print Design Companies (print-design-companies)", "Product Design Companies (product-design)", "WordPress Web Design Companies (wordpress-web-design)", "Digital Strategy Agencies (digital-strategy-agencies)", "Media Buying Agencies (media-buying-agencies)", "Reputation Management Companies (reputation-management-companies)", "Conversion Rate Optimization Services (conversion-optimization)", "Affiliate Marketing Companies (affiliate-marketing)", "Event Marketing Agencies (event-marketing)", "Direct Marketing Companies (direct-marketing)", "Market Research Companies (market-research)", "Business Consulting Firms (business-consulting)", "Big Data Analytics Companies (big-data-analytics-companies)", "Blockchain Development Companies (blockchain-development-companies)", "Software Testing Companies (software-testing-companies)", "DevOps Consulting Companies (devops-consulting)", "CRM Consultants (crm-consulting)", "ERP Consultants (erp-consulting)", "ECM Consultants (ecm-consulting)", "IT Compliance Solution Companies (compliance-solutions-companies)", "IoT Companies (iot-companies)", "Wearable Technology Companies (wearable-technology)", "VR & Augmented Reality Companies (ar-vr)", "Staff Augmentation Services (staff-augmentation)", "BPO Companies (bpo)", "Call Center Companies (call-centers)", "Phone Answering Services (phone-answering-services)", "Outsourced Customer Support Companies (outsourced-customer-support)", "HR Outsourcing Companies (hr-outsourcing)", "Accounting Firms (accounting)", "Translation Companies (translation-services)", "Transcription Services (transcription-services)", "Audio Production Companies (audio-production)", "Logistics Companies (logistics)", "Engineering Companies (engineering)", "Investment (investment)" ] } }, "categories": { "title": "More categories, niches or list URLs", "type": "array", "description": "Type a category or niche the way it appears in a DesignRush list URL (designrush.com/agency/), for example digital-marketing/dental, ecommerce/shopify or search-engine-optimization/real-estate. A plain name such as SEO, Web Design or Dental Marketing also works, and so does a pasted list URL. An entry DesignRush does not have stops the run before anything is billed and names the closest matches.", "items": { "type": "string" } }, "locations": { "title": "Locations (optional)", "type": "array", "description": "Narrow every category to a country, a US state or a city, for example United States, uk, Germany, California, TX, Chicago, Austin, TX or London. DesignRush has its own list for most category and location pairs; where it has none, the closest broader list is read and only agencies located there are kept. Two-letter codes are read as countries (de = Germany, in = India); write a US state by name or after a city. Leave empty for the worldwide lists.", "items": { "type": "string" } }, "startUrls": { "title": "Agency profile or list URLs (optional)", "type": "array", "description": "DesignRush agency profile pages (https://www.designrush.com/agency/profile/) are read one by one. DesignRush list pages (for example https://www.designrush.com/agency/digital-marketing/us, including a sort order you picked on the site) are read like a category.", "items": { "type": "string" } }, "urlsFromFile": { "title": "Import URLs from a file", "type": "string", "description": "Paste a list of URLs (one per line), OR one link to a .txt/.csv file, Google Sheet or Google Drive file containing them. Lets you import many Start URLs at once instead of typing each. Google Sheet/Drive share links are handled automatically." }, "sortBy": { "title": "Sort by", "enum": [ "featured", "organic", "topRated", "mostReviews", "hourlyRateHighToLow", "hourlyRateLowToHigh" ], "type": "string", "description": "The order DesignRush lists agencies in, and so which agencies a capped run gets first. Top rated and the hourly-rate orders only include agencies that have a rating or a published rate.", "default": "featured" }, "maxResults": { "title": "Max agencies (total)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total cap on agency records in this run, shared fairly between all category and location lists. Review records do not count toward it.", "default": 100 }, "maxResultsPerCategory": { "title": "Max agencies per list", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Optional cap for each single category or category and location list (0 = only the total cap applies). DesignRush shows 50 agencies per page; the biggest categories list close to 20,000 agencies.", "default": 0 }, "includeProfileDetails": { "title": "Include full profile details", "type": "boolean", "description": "Open each agency's profile page for the direct contact email and phone, full address and other offices, website, year founded, budget, the full service list, industries, client types, areas of expertise, clients, portfolio, team members, press mentions, awards and social links. This is where the lead data lives - keep it on for lead generation. Turn it off for fast list-only runs (name, location, team size, rate, ratings, services and the website on country lists).", "default": true }, "includeReviews": { "title": "Include client reviews", "type": "boolean", "description": "Also output one record per client review (type \"review\"): reviewer, their title and company, star rating, date, project name and type, client company size and industry, the six DesignRush sub-ratings and the review text. Opens the profile page.", "default": false }, "maxReviewsPerAgency": { "title": "Max reviews per agency", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on review records per agency when \"Include client reviews\" is on (newest first).", "default": 20 }, "reviewSources": { "title": "Review sources", "enum": [ "all", "designrush", "google" ], "type": "string", "description": "DesignRush shows its own verified client reviews and, for some agencies, reviews imported from Google.", "default": "all" }, "enrichContactEmails": { "title": "Enrich contacts from the agency website", "type": "boolean", "description": "Visit each agency's own website (home page plus up to two contact or about pages) for extra public email addresses and phone numbers. Billed only when it finds a contact the DesignRush profile did not already have.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only keep agencies with at least this average DesignRush rating (0-5). 0 = no filter. Agencies without reviews have no rating and are left out when this is set.", "default": 0 }, "minReviews": { "title": "Minimum review count", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only keep agencies with at least this many DesignRush client reviews. 0 = no filter.", "default": 0 }, "withEmailOnly": { "title": "Only agencies with an email", "type": "boolean", "description": "Only keep agencies that have a contact email (from the profile or the website enrichment). Opens profile pages.", "default": false }, "withWebsiteOnly": { "title": "Only agencies with a website", "type": "boolean", "description": "Only keep agencies that have their own website.", "default": false }, "deduplicateAgencies": { "title": "Deduplicate agencies", "type": "boolean", "description": "Keep each agency once per run, even when it ranks in several categories or locations (it is kept under the first list that found it).", "default": true }, "monitorMode": { "title": "Monitor mode (only new agencies)", "type": "boolean", "description": "Watch your lists for agencies DesignRush adds. The first run delivers the lists like a normal run and remembers every agency listed at that moment; later runs read the lists again and deliver only agencies that were not listed before. Each run reads every page of each list, so monitor narrow lists (a category in a country, state or city). Pair it with Apify Schedules.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that remembers the monitored lists. Use a distinct name per saved task so their histories stay separate.", "default": "designrush-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "Maximum agency profiles read in parallel.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave as is: DesignRush is read through Apify datacenter proxies, with Apify residential proxies as an automatic fallback for any page that is refused. Pick your own proxies only if you need to.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }