# Clutch Scraper Pro (`procoders/clutch-scraper-pro`) Actor The most comprehensive and reliable Clutch scraper on Apify marketplace just by Link. Extract complete company profiles with 50+ data fields, including reviews, intelligent deduplication, KV caching, and blazing-fast performance. - **URL**: https://apify.com/procoders/clutch-scraper-pro.md - **Developed by:** [Procoders](https://apify.com/procoders) (community) - **Categories:** Lead generation, Integrations, Jobs - **Stats:** 21 total users, 0 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: No ratings yet ## Pricing from $0.90 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ๐Ÿ† Clutch Scraper Pro - Most Complete Data Extraction [![Apify Actor](https://img.shields.io/badge/Apify-Actor-green)](https://apify.com/actors) [![TypeScript](https://img.shields.io/badge/TypeScript-4.9+-blue)](https://www.typescriptlang.org/) [![License](https://img.shields.io/badge/License-ISC-yellow.svg)](https://opensource.org/licenses/ISC) The most comprehensive and reliable Clutch scraper on Apify marketplace. Extract complete company profiles with **70+ data fields** including pricing information, detailed business metrics, enhanced review analysis, **LinkedIn company pages**, business verification details, credit reports, and social media links. Features intelligent deduplication, KV caching, and blazing-fast performance. ### ๐Ÿš€ Why Choose This Scraper? #### โœจ Why Choose This Scraper? - **70+ Data Fields**: The most complete profile coverage on Clutch including pricing & business details - **Comprehensive Business Data**: Min project size, hourly rates, employee count, founding year ๐Ÿ†• - **Enhanced Review Analysis**: Project summaries, feedback analysis, detailed ratings breakdown ๐Ÿ†• - **Client Testimonials**: Complete "What Clients Have Said" sections with pricing insights ๐Ÿ†• - **LinkedIn Company Pages**: Smart extraction of real LinkedIn company URLs (not policy links) - **Business Verification**: Complete Business Entity details, Credit Risk Assessment, legal filings - **Social Media Links**: LinkedIn, Facebook, X (Twitter), Instagram from official social sections - **Intelligent Deduplication**: Removes duplicates across list pages and runs - **Real Domain Extraction**: Optional redirect following for accurate domains - **KV Profile Cache**: Reuse parsed detail pages across runs to save time and CUs - **Apify Proxy Support**: Use residential/datacenter groups and optional country pinning - **Review Sorting**: relevance, recent, ratingHighToLow, ratingLowToHigh - **Robust Error Handling**: Retries, timeouts, and safe fallbacks - **Detailed Statistics**: Duplicates, errors, speed, runtime summary - **Multiple Export Formats**: CSV, Excel, JSON, XML with clean, flat columns - **Blazing Fast**: 90+ companies/minute in LIST_DETAIL in real-world runs #### ๐Ÿ“Š Data Fields Extracted ##### Company Information - Company name, logo, tagline - Clutch URL and website URL - Real domain (with redirect following option) - Rating and reviews count - Verification status (VERIFIED, PREMIER VERIFIED) - Founded year - Timezone - Full description ##### Business Details ๐Ÿ†• - **Min project size**: Minimum project budget requirement ($USD) - **Hourly rate range**: From/to hourly rates ($USD/hr) - **Employees count**: Team size range (e.g., "50-249", "2-9") - **Year founded**: Company establishment year - **Most common project size**: Typical project budget based on reviews - **Client testimonials**: "What Clients Have Said" summary with pricing insights - **Multiple locations**: Complete address information with country/region ##### Service Breakdown - Services with percentages - Focus areas with percentages - Industries served with percentages - Client focus (size/type) with percentages ##### Social Media & Contact - **LinkedIn Company Pages**: Smart URL extraction (e.g., `/company/acme-corp/`) - **Facebook Pages**: Official business pages - **X (Twitter)**: Company Twitter handles - **Instagram**: Business Instagram accounts - Real website domains (with redirect resolution) ##### Verification & Trust - **Business Entity**: Legal name, status, jurisdiction, formation date, entity ID - **Credit Report Results**: International Credit Risk Assessment, source, last updated - **Verification Status**: VERIFIED, PREMIER VERIFIED, GOLD VERIFIED badges - **Legal Filings**: Bankruptcy, tax liens, judgments, collections count - **Last Updated**: When verification data was last refreshed ##### Reviews (Optional) - Review title and rating - Review date and comments - Reviewer details - Project services, size, and length - Quality, schedule, cost ratings - Willingness to refer rating ##### Additional Data - Multiple office addresses - Portfolio items - Custom fields via extension function ### ๐ŸŽฏ Scraping Modes | Mode | Description | Best For | |------|-------------|----------| | `LIST` | Extract company data from listing pages only | Quick overview, basic info | | `LIST_DETAIL` | Extract from listings + full detail pages | Complete profiles with all data | | `LIST_WEBSITES` | Optimized mode - details only for missing websites | Fast extraction with websites | ### ๐Ÿ”ง Input Configuration ```json { "startUrls": [ { "url": "https://clutch.co/us/agencies/digital-strategy" } ], "scrapeMode": "LIST_DETAIL", "maxResults": 300, "includeReviews": true, "maxReviewsPerCompany": 5, "includePortfolio": true, "exportFormat": "CSV", "followRedirects": true, "clearDataset": true } ```` #### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `startUrls` | Array | Required | Clutch.co URLs to scrape (list or profile pages) | | `scrapeMode` | String | `LIST_DETAIL` | Scraping mode: `LIST`, `LIST_DETAIL`, `LIST_WEBSITES` | | `includeReviews` | Boolean | `false` | Extract company reviews | | `maxReviewsPerCompany` | Number | `10` | Maximum reviews per company | | `reviewSortBy` | String | `relevance` | Sort reviews: `relevance`, `recent`, `ratingHighToLow`, `ratingLowToHigh` | | `includePortfolio` | Boolean | `true` | Extract portfolio items | | `maxResults` | Number | - | Maximum total companies to extract | | `maxPagesPerSearch` | Number | - | Maximum pages per search URL | | `maxRequestsPerCrawl` | Number | `0` | Maximum total requests (0 = unlimited) | | `exportFormat` | String | `JSON` | Export format: `JSON`, `CSV`, `EXCEL`, `XML` | | `followRedirects` | Boolean | `false` | Follow redirects to get real domains | | `useApifyProxy` | Boolean | `false` | Use Apify Proxy | | `apifyProxyGroups` | Array | `["RESIDENTIAL"]` | Proxy groups to use | | `apifyProxyCountry` | String | `-` | Proxy country code (e.g., `US`) | | `useHeadless` | Boolean | `true` | Run browser in headless mode | | `clearDataset` | Boolean | `false` | Clear dataset before run | | `extendOutputFunction` | String | - | Custom JS function to extend output | | `useProfileCache` | Boolean | `false` | Use KV cache for detail pages | | `profileCacheTtlDays` | Number | `0` | Cache TTL in days (0 = never expire) | | `profileCacheVersion` | String | `""` | Bump to invalidate old cache | #### ๐Ÿš€ Performance - In a recent LIST\_DETAIL benchmark on `https://clutch.co/us/agencies/digital-strategy` with reviews enabled (max 5 per company), the scraper achieved: - **Average speed**: ~**90 companies/minute** - **Total unique companies**: **9,750** - **Runtime**: ~**108 minutes** - Settings: `scrapeMode=LIST_DETAIL`, `includeReviews=true`, `reviewSortBy=recent`, `maxReviewsPerCompany=5`, `exportFormat=CSV` Actual speed depends on filters, network, anti-bot pressure, and selected options (reviews/portfolio/proxy). ### ๐Ÿ“ˆ Performance & Statistics After each run, you'll see detailed statistics: ``` ================================================================================ SCRAPING COMPLETED SUCCESSFULLY ================================================================================ ๐Ÿ“Š SUMMARY STATISTICS: โ€ข Total unique companies collected: 275 โ€ข Total companies processed (with duplicates): 436 โ€ข Duplicates removed: 161 โ€ข Runtime: 3m 51s โ€ข Average speed: 71 companies/minute ๐Ÿ” SCRAPING DETAILS: โ€ข Scrape mode: LIST_DETAIL โ€ข Reviews included: Yes (max 3 per company) โ€ข Export format: CSV โ€ข Exported file: clutch-export-2024-01-15.csv โœ… NO ERRORS DETECTED ๐ŸŽฏ PERFORMANCE METRICS: โ€ข Average time per company: 842ms โ€ข Total runtime: 231614ms ================================================================================ ``` ### ๐Ÿ’พ Output Formats #### CSV Export - Perfectly formatted with all fields as columns - Special handling for arrays (services, industries, etc.) - HTML entities decoded and cleaned - Review and portfolio data in indexed columns #### Output Schema (CSV/JSON) Below is the complete list of fields the scraper can output and how they appear in CSV (flattened) vs JSON (nested): - **Top-level fields** (LIST and LIST\_DETAIL) - `companyName` (string) - `clutchUrl` (string) - `websiteUrl` (string) - `domain` (string, without `www.`) - `logoUrl` (string) - `tagline` (string) - `rating` (number) - `reviewsCount` (number) - `verificationStatus` (string: `VERIFIED` | `PREMIER VERIFIED` | `GOLD VERIFIED` | empty) - `minProjectSize` (number, e.g., 25000) ๐Ÿ†• - `hourlyRateFrom` (number) ๐Ÿ†• - `hourlyRateTo` (number) ๐Ÿ†• - `employees` (string, e.g., "50-249", "2-9") ๐Ÿ†• - `yearFounded` (number, e.g., 2015) ๐Ÿ†• - `location` (string) - **Social Media Links** ๐Ÿ†• - JSON: `socialLinks: { linkedIn, facebook, x, instagram }` - CSV: `socialLinks_linkedIn`, `socialLinks_facebook`, `socialLinks_x`, `socialLinks_instagram` - **Services (list page chips)** - JSON: `services: [{ name: string, percent|percentage: number }]` - CSV: `services_{Service_Name}` = numeric percentage - **Focus Areas (detail)** - JSON: `focusAreas: [{ name: string, percentage: number }]` - CSV: `focusAreas_{Area_Name}` = numeric percentage - **Industries (detail)** - JSON: `industries: [{ name: string, percentage: number }]` - CSV: `industries_{Industry_Name}` = numeric percentage - **Client Focus (detail)** - JSON: `clientFocus: [{ name: string, percentage: number }]` - CSV: `clientFocus_{Client_Type}` = numeric percentage - **Most Common Project Size (detail)** - JSON: `mostCommonProjectSize` (number) - CSV: `mostCommonProjectSize` - **Client Testimonials (detail)** ๐Ÿ†• - JSON: `clientTestimonial` (string, "What Clients Have Said" section) - CSV: `clientTestimonial` - **Timezone (detail)** - JSON: `timezone` (string) - CSV: `timezone` - **Full Description (detail)** - JSON: `fullDescription` (string) - CSV: `fullDescription` - **Addresses (detail)** - JSON: `addresses: [{ title, street, locality, region, postalCode, country, phone }]` - CSV: `addresses_0_title`, `addresses_0_street`, `addresses_0_locality`, `addresses_0_region`, `addresses_0_postalCode`, `addresses_0_country`, `addresses_0_phone`, ... (indexed per address) - **Portfolio (detail, optional)** - JSON: `portfolio: [{ image, description }]` - CSV: `portfolio_0_image`, `portfolio_0_description`, `portfolio_1_image`, ... - **Reviews (detail, optional)** ๐Ÿ†• Enhanced - JSON per review item: - `name` (string) - `rating` (number) - `date` (string) - `comments` (string; main review quote) - `projectSummary` (string; detailed project description) ๐Ÿ†• - `feedbackSummary` (string; results and outcomes summary) ๐Ÿ†• - `detailedRatings` (array; Quality, Schedule, Cost ratings with comments) ๐Ÿ†• - `fullReview` (string; complete review text) ๐Ÿ†• - `reviewerName` (string) - `reviewerPosition` (string) - `projectServices` (string; semicolon-separated) - `projectSize` (string) - `projectLength` (string) - CSV (indexed and flattened): - `review_0_name`, `review_0_rating`, `review_0_date`, `review_0_comments`, `review_0_projectSummary`, `review_0_feedbackSummary`, `review_0_detailedRatings_0_category`, `review_0_detailedRatings_0_rating`, `review_0_detailedRatings_0_comment`, `review_0_fullReview`, `review_0_reviewerName`, `review_0_reviewerPosition`, `review_0_projectServices`, `review_0_projectSize`, `review_0_projectLength`, ... - **Verification Details (detail)** ๐Ÿ†• - JSON: `verificationDetails: { verificationStatus, businessEntity: { name, status, jurisdictionOfFormation, ID, source, lastUpdated, dateOfFormation }, paymentLegalFilings: { bankruptcy, taxLienFilings, judgementFilings, collectionsCount, source, lastUpdated, fullBusinessCreditReport } }` - CSV (flattened): - `verificationDetails_verificationStatus` - `verificationDetails_businessEntity_name`, `verificationDetails_businessEntity_status`, `verificationDetails_businessEntity_jurisdictionOfFormation`, `verificationDetails_businessEntity_ID`, `verificationDetails_businessEntity_source`, `verificationDetails_businessEntity_lastUpdated`, `verificationDetails_businessEntity_dateOfFormation` - `verificationDetails_paymentLegalFilings_bankruptcy`, `verificationDetails_paymentLegalFilings_taxLienFilings`, `verificationDetails_paymentLegalFilings_judgementFilings`, `verificationDetails_paymentLegalFilings_collectionsCount`, `verificationDetails_paymentLegalFilings_source`, `verificationDetails_paymentLegalFilings_lastUpdated`, `verificationDetails_paymentLegalFilings_fullBusinessCreditReport` - **Credit Report Results (detail)** ๐Ÿ†• - JSON: `creditReportResults: { internationalCreditRiskAssessment, source, lastUpdated }` - CSV: `creditReportResults_internationalCreditRiskAssessment`, `creditReportResults_source`, `creditReportResults_lastUpdated` - **Verification Last Updated** ๐Ÿ†• - JSON/CSV: `verificationLastUpdated` (string, e.g., "August 8, 2025") Notes: - ๐Ÿ†• **Social media extraction** from official "Connect with \[Company] on Social" sections - ๐Ÿ†• **Business verification data** including legal entity details and credit assessments - CSV ัะบัะฟะพั€ั‚ ะฐะฒั‚ะพะผะฐั‚ะธั‡ะตัะบะธ ะดะตะบะพะดะธั€ัƒะตั‚ HTML-ััƒั‰ะฝะพัั‚ะธ ะธ ั‡ะธัั‚ะธั‚ ะปะธัˆะฝะธะต ะฟั€ะพะฑะตะปั‹ - ะกะฟะธัะบะธ (reviews, portfolio, addresses) ะธะฝะดะตะบัะธั€ัƒัŽั‚ัั: `_0_`, `_1_`, ... - ะŸั€ะพั†ะตะฝั‚ะฝั‹ะต ะฟะพะปั ัะพั…ั€ะฐะฝััŽั‚ัั ั‡ะธัะปะพะผ; ั„ะธะปัŒั‚ั€ะฐั†ะธั ะฟะพ ะฝะธะผ ะฒ ั‚ะฐะฑะปะธั†ะฐั… ะฟั€ะพัั‚ะฐ #### JSON Output Complete nested structure with all relationships preserved. ### ๐Ÿ› ๏ธ Advanced Usage #### Extract Companies with Specific Filters ```json { "startUrls": [ { "url": "https://clutch.co/agencies/digital-marketing?employees=10%20-%2049" } ], "scrapeMode": "LIST_DETAIL", "includeReviews": true, "followRedirects": true, "maxResults": 100 } ``` #### Custom Data Extension ```json { "extendOutputFunction": "($, data) => ({ customScore: data.rating * data.reviewsCount, scrapedAt: new Date().toISOString(), hasPortfolio: data.portfolio?.length > 0 })" } ``` ### ๐Ÿ› Error Handling The scraper includes robust error handling: - Continues on individual page failures - Retries failed requests up to 3 times - Handles frame detachment errors - Manages navigation timeouts - Provides detailed error statistics ### ๐Ÿ”„ Deduplication Intelligent deduplication ensures you only get unique companies: - Tracks companies globally across all pages - Removes duplicates automatically - Reports exact number of duplicates removed - Maintains data quality and accuracy ### ๐Ÿค Support - ๐Ÿ“ง Email: support@your-email.com - ๐Ÿ› Issues: [GitHub Issues](https://github.com/your-repo/issues) - ๐Ÿ“– Documentation: [Full Docs](https://docs.your-site.com) ### ๐Ÿ“„ License ISC License - feel free to use in your projects! *** **Note**: This scraper is not affiliated with Clutch.co. Please respect their Terms of Service and use responsibly. # Actor input Schema ## `startUrls` (type: `array`): List of Clutch.co URLs to scrape. Supports: company profiles (/profile/company-name), listing pages (/web-developers), filtered searches ## `scrapeMode` (type: `string`): Choose the depth of data extraction. LIST\_DETAIL gives you all 50+ fields including reviews, industries, client focus, etc. ## `includeReviews` (type: `boolean`): Extract client reviews from company profiles (only in LIST\_DETAIL mode) ## `maxReviewsPerCompany` (type: `integer`): Limit the number of reviews to extract per company (0 = unlimited) ## `reviewSortBy` (type: `string`): Choose the order in which to scrape reviews ## `includePortfolio` (type: `boolean`): Extract portfolio items and case studies from company profiles ## `maxResults` (type: `integer`): Total number of unique companies to extract after deduplication (0 = unlimited). Note: Clutch shows duplicates across pages, so you may need to process more pages to reach your target. ## `maxPagesPerSearch` (type: `integer`): Maximum number of listing pages to process per search URL ## `maxRequestsPerCrawl` (type: `integer`): Maximum total HTTP requests (for debugging or limiting scope) ## `useHeadless` (type: `boolean`): Run browser in headless mode (faster) or with GUI (for debugging) ## `followRedirects` (type: `boolean`): When domain extraction fails (e.g., ppc.clutch.co), follow the actual redirect to find the real company website. This is slower but gives accurate domains. ## `exportFormat` (type: `string`): Choose the output format. CSV/Excel include all fields as columns with perfect formatting, arrays expanded to separate columns (e.g., services\_SEO: 25%) ## `deduplicateResults` (type: `boolean`): Remove duplicate companies from results (based on URL) ## `clearDataset` (type: `boolean`): Remove all previous results before starting (useful for development) ## `extendOutputFunction` (type: `string`): Custom JavaScript function to add extra data to each result. Receives ($, data) parameters. ## `excludePortfolio` (type: `boolean`): Legacy parameter - use includePortfolio instead ## `useApifyProxy` (type: `boolean`): Enable Apify proxy to avoid blocking. Requires Apify account with proxy access. ## `apifyProxyGroups` (type: `array`): Apify proxy groups to use. Common options: RESIDENTIAL, DATACENTER ## `apifyProxyCountry` (type: `string`): Country code for proxy location (e.g., 'US', 'GB', 'DE'). Leave empty for automatic selection. ## `useProfileCache` (type: `boolean`): Cache parsed detail profiles in Key-Value Store to avoid re-parsing across runs. ## `profileCacheTtlDays` (type: `integer`): Number of days after which cached profiles are considered stale (0 = never expire). ## `profileCacheVersion` (type: `string`): Bump this string to invalidate previously cached items after schema changes. ## Actor input object example ```json { "startUrls": [ { "url": "https://clutch.co/profile/smartsites" }, { "url": "https://clutch.co/web-developers/freelance" }, { "url": "https://clutch.co/us/developers/reactjs?hourly_rate=100-149" } ], "scrapeMode": "LIST_DETAIL", "includeReviews": false, "maxReviewsPerCompany": 10, "reviewSortBy": "relevance", "includePortfolio": true, "maxResults": 0, "maxPagesPerSearch": 0, "maxRequestsPerCrawl": 0, "useHeadless": true, "followRedirects": false, "exportFormat": "JSON", "deduplicateResults": true, "clearDataset": false, "extendOutputFunction": "($, data) => {\n return {\n // customField: 'value',\n // timestamp: new Date().toISOString()\n };\n}", "excludePortfolio": false, "useApifyProxy": false, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US", "useProfileCache": false, "profileCacheTtlDays": 0, "profileCacheVersion": "" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://clutch.co/web-developers" } ], "extendOutputFunction": ($, data) => { return { // customField: 'value', // timestamp: new Date().toISOString() }; }, "apifyProxyGroups": [ "RESIDENTIAL" ] }; // Run the Actor and wait for it to finish const run = await client.actor("procoders/clutch-scraper-pro").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://clutch.co/web-developers" }], "extendOutputFunction": """($, data) => { return { // customField: 'value', // timestamp: new Date().toISOString() }; }""", "apifyProxyGroups": ["RESIDENTIAL"], } # Run the Actor and wait for it to finish run = client.actor("procoders/clutch-scraper-pro").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://clutch.co/web-developers" } ], "extendOutputFunction": "($, data) => {\\n return {\\n // customField: '\''value'\'',\\n // timestamp: new Date().toISOString()\\n };\\n}", "apifyProxyGroups": [ "RESIDENTIAL" ] }' | apify call procoders/clutch-scraper-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=procoders/clutch-scraper-pro", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Clutch Scraper Pro", "description": "The most comprehensive and reliable Clutch scraper on Apify marketplace just by Link. Extract complete company profiles with 50+ data fields, including reviews, intelligent deduplication, KV caching, and blazing-fast performance.", "version": "0.0", "x-build-id": "q1JpU13lOQDU7dhv5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/procoders~clutch-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-procoders-clutch-scraper-pro", "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/procoders~clutch-scraper-pro/runs": { "post": { "operationId": "runs-sync-procoders-clutch-scraper-pro", "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/procoders~clutch-scraper-pro/run-sync": { "post": { "operationId": "run-sync-procoders-clutch-scraper-pro", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Clutch.co URLs to scrape. Supports: company profiles (/profile/company-name), listing pages (/web-developers), filtered searches", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "scrapeMode": { "title": "Scraping Mode", "enum": [ "LIST", "LIST_DETAIL", "LIST_WEBSITES" ], "type": "string", "description": "Choose the depth of data extraction. LIST_DETAIL gives you all 50+ fields including reviews, industries, client focus, etc.", "default": "LIST_DETAIL" }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "description": "Extract client reviews from company profiles (only in LIST_DETAIL mode)", "default": false }, "maxReviewsPerCompany": { "title": "Max Reviews Per Company", "minimum": 0, "maximum": 100, "type": "integer", "description": "Limit the number of reviews to extract per company (0 = unlimited)", "default": 10 }, "reviewSortBy": { "title": "Sort Reviews By", "enum": [ "relevance", "recent", "ratingHighToLow", "ratingLowToHigh" ], "type": "string", "description": "Choose the order in which to scrape reviews", "default": "relevance" }, "includePortfolio": { "title": "Include Portfolio", "type": "boolean", "description": "Extract portfolio items and case studies from company profiles", "default": true }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Total number of unique companies to extract after deduplication (0 = unlimited). Note: Clutch shows duplicates across pages, so you may need to process more pages to reach your target.", "default": 0 }, "maxPagesPerSearch": { "title": "Max Pages Per Search", "minimum": 0, "type": "integer", "description": "Maximum number of listing pages to process per search URL", "default": 0 }, "maxRequestsPerCrawl": { "title": "Max Requests Per Crawl", "minimum": 0, "type": "integer", "description": "Maximum total HTTP requests (for debugging or limiting scope)", "default": 0 }, "useHeadless": { "title": "Use Headless Browser", "type": "boolean", "description": "Run browser in headless mode (faster) or with GUI (for debugging)", "default": true }, "followRedirects": { "title": "Follow Redirects for Real Domains", "type": "boolean", "description": "When domain extraction fails (e.g., ppc.clutch.co), follow the actual redirect to find the real company website. This is slower but gives accurate domains.", "default": false }, "exportFormat": { "title": "Export Format", "enum": [ "JSON", "CSV", "EXCEL", "XML" ], "type": "string", "description": "Choose the output format. CSV/Excel include all fields as columns with perfect formatting, arrays expanded to separate columns (e.g., services_SEO: 25%)", "default": "JSON" }, "deduplicateResults": { "title": "Deduplicate Results", "type": "boolean", "description": "Remove duplicate companies from results (based on URL)", "default": true }, "clearDataset": { "title": "Clear Dataset Before Run", "type": "boolean", "description": "Remove all previous results before starting (useful for development)", "default": false }, "extendOutputFunction": { "title": "Extend Output Function", "type": "string", "description": "Custom JavaScript function to add extra data to each result. Receives ($, data) parameters." }, "excludePortfolio": { "title": "Exclude Portfolio (Deprecated)", "type": "boolean", "description": "Legacy parameter - use includePortfolio instead", "default": false }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Enable Apify proxy to avoid blocking. Requires Apify account with proxy access.", "default": false }, "apifyProxyGroups": { "title": "Proxy Groups", "type": "array", "description": "Apify proxy groups to use. Common options: RESIDENTIAL, DATACENTER", "default": [ "RESIDENTIAL" ], "items": { "type": "string" } }, "apifyProxyCountry": { "title": "Proxy Country", "type": "string", "description": "Country code for proxy location (e.g., 'US', 'GB', 'DE'). Leave empty for automatic selection." }, "useProfileCache": { "title": "Use Profile Cache", "type": "boolean", "description": "Cache parsed detail profiles in Key-Value Store to avoid re-parsing across runs.", "default": false }, "profileCacheTtlDays": { "title": "Cache TTL (days)", "type": "integer", "description": "Number of days after which cached profiles are considered stale (0 = never expire).", "default": 0 }, "profileCacheVersion": { "title": "Cache Version", "type": "string", "description": "Bump this string to invalidate previously cached items after schema changes.", "default": "" } } }, "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 } } } } } } } } } } ```