# Clutch Scraper Ppe (`silentflow/clutch-scraper-ppe`) Actor Extract agencies & service providers from Clutch.co. Pay per result โ€” proxies included. Get ratings, full-text reviews (background, challenge, solution, results), service lines, office locations, legal entity, credit report, and AI review insights. Any category or profile URL. - **URL**: https://apify.com/silentflow/clutch-scraper-ppe.md - **Developed by:** [SilentFlow](https://apify.com/silentflow) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 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.co Scraper - Pay Per Result by [SilentFlow](https://apify.com/silentflow) **Pay only for the data you get!** Proxies included, no compute costs. Extract companies, agencies, and service providers from Clutch.co, including ratings, reviews, hourly rates, project sizes, services, team sizes, client reviews, service line breakdown, legal entity data, credit reports, AI review insights, and contact details from any category, country, or profile page. ### โœจ Why use this scraper? - ๐Ÿ’ฐ **Pay per result**: No compute costs, only pay for the companies you actually receive - ๐ŸŒ **Proxies included**: Residential proxies included, no separate configuration needed - ๐Ÿš€ **No login required**: Scrape any public Clutch.co page without an account - ๐Ÿ“Š **Most complete data on the market**: 38 company fields + 23 review fields, more than any other Clutch scraper - โญ **Full review detail**: Background, challenge, solution, and results sections extracted in full, unique to this scraper - ๐Ÿค– **AI review insights**: Clutch's AI-generated top mentions and highlights for each company - ๐Ÿข **All office locations**: Every company office with address, phone, and headcount - ๐Ÿ›๏ธ **Legal & credit data**: Business entity registration and Creditsafe credit risk assessment - ๐ŸŽฌ **Company video**: YouTube/Vimeo embed URL when available - ๐Ÿ—‚๏ธ **Service line metadata**: Group, slug, and Clutch page URL for each service, ideal for category analysis - ๐Ÿ’ผ **Portfolio projects**: Extract the company's case study portfolio with project details ### ๐ŸŽฏ Use cases | Industry | Application | |----------|-------------| | **Procurement** | Find and vet software development or marketing agencies before hiring | | **Market Research** | Analyze the competitive landscape for digital agencies in your region | | **Lead Generation** | Build a list of qualified agencies with contact info, phone, and website | | **Investment** | Research the agency market, size, pricing, legal status, and credit risk | | **Directory Building** | Create a curated list of top agencies by category or location | | **Benchmarking** | Compare hourly rates, team sizes, and ratings across categories | | **Review Analysis** | Aggregate full review text (background, challenge, solution, results) for AI analysis | | **Sentiment Analysis** | Use AI-generated review highlights and top mentions per company | ### ๐Ÿ“ฅ Input parameters #### URL Scraping | Parameter | Type | Description | |-----------|------|-------------| | `startUrls` | array | Clutch.co category or profile page URLs to scrape | Supported URL formats: - Category pages: `https://clutch.co/agencies/digital-marketing` - Country/region pages: `https://clutch.co/us/agencies/digital-marketing` - Profile pages: `https://clutch.co/profile/webfx` #### Search | Parameter | Type | Description | |-----------|------|-------------| | `searches` | array | Keywords to search on Clutch.co (e.g. `"SEO agency"`, `"React developers"`) | #### Limits | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxItems` | integer | 100 | Maximum number of companies to extract | | `maxPages` | integer | 10 | Maximum listing pages to scrape per URL | #### Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `includeDetails` | boolean | false | Visit each company's profile page for tagline, description, social links, year founded, website, service lines, audience charts, locations, legal entity, credit report, languages, video URL, and AI review insights. Each profile visit counts as one additional result | | `includeReviews` | boolean | false | Extract client reviews with full text: background, challenge, solution, results, ratings, reviewer details, and project info. Each review page counts as one additional result | | `maxReviewPages` | integer | 3 | How many review pages to fetch per company (~11 reviews per page). Only used when `includeReviews` is enabled | | `includePortfolio` | boolean | false | Extract the company's portfolio (case studies) with title, services, client, project size, and description | | `includePortfolioDetails` | boolean | false | Visit each portfolio item's page for the full project description. Requires `includePortfolio: true` | ### ๐Ÿ“Š Output data #### Company example ```json { "id": "33049", "slug": "webfx", "url": "https://clutch.co/profile/webfx", "name": "WebFX", "logoUrl": "https://img.shgstatic.com/clutch-static-prod/image/scale/50x50/s3fs-public/logos/webfx.jpg", "rating": 4.9, "reviewCount": 441, "minProjectSize": "$1,000+", "hourlyRate": "Undisclosed", "employees": "401 - 500", "yearFounded": "1995", "isPremier": true, "isVerified": true, "phone": "888-601-5359", "website": "https://www.webfx.com", "city": "Harrisburg", "state": "PA", "country": "United States", "address": "1705 N Front St", "postalCode": "17102", "tagline": "Digital Marketing That Drives Revenueยฎ", "description": "WebFX is a full-service Internet marketing agency...", "socialLinks": [ { "platform": "linkedin", "url": "https://www.linkedin.com/company/webfx" }, { "platform": "x", "url": "https://twitter.com/webfx" } ], "services": [ { "name": "Search Engine Optimization", "percent": 70 }, { "name": "Pay Per Click", "percent": 10 } ], "serviceLines": [ { "name": "Search Engine Optimization", "slug": "field_pp_sl_seo", "group": "group_pp_group_dm", "groupName": "Digital marketing", "mainPageUrl": "seo-firms", "mainPageCanonicalId": 1012000000000, "percent": 70 } ], "chartPie": { "serviceProvided": { "legendTitle": "Service Lines", "slices": [ { "name": "Search Engine Optimization", "percent": 70, "url": "https://clutch.co/seo-firms" } ] }, "focus": { "legendTitle": "Focus", "charts": { "group_pp_seo_group": { "legendTitle": "SEO Focus", "slices": [ { "name": "On site optimization", "percent": 30 } ] } } }, "industries": { "legendTitle": "Industries", "slices": [ { "name": "Business services", "percent": 15 }, { "name": "Manufacturing", "percent": 15 } ] }, "clients": { "legendTitle": "Clients", "slices": [ { "name": "Midmarket ($10M - $1B)", "percent": 50 } ] } }, "locations": [ { "isHeadquarters": true, "isVerified": true, "name": "Headquarters", "address": "1705 N Front St", "city": "Harrisburg", "state": "PA", "country": "United States", "postalCode": "17102", "phone": "888-601-5359", "employees": "401 - 500" } ], "businessEntity": { "name": "WebFX, Inc.", "source": "Creditsafe", "jurisdiction": "Pennsylvania, United States", "dateOfFormation": "1996-01-01", "status": "Active", "lastUpdated": "January 2, 2025" }, "creditReport": { "riskAssessment": "Low Risk", "source": "Creditsafe", "lastUpdated": "September 29, 2020" }, "languages": ["English"], "videoUrl": "https://www.youtube.com/embed/IEqcVXJePNc", "reviewInsights": { "topMentions": [ { "name": "Communicative", "count": 37 }, { "name": "Knowledgeable", "count": 29 } ], "highlights": [ { "title": "Proactive communication", "description": "Clients consistently praise WebFX for their proactive communication and regular reporting." } ] }, "reviews": [ { "id": "213001", "title": "SEO Strategy for Luxury Architectural Products Company", "rating": 5.0, "metrics": { "quality": 5.0, "schedule": 5.0, "cost": 5.0, "willingToRefer": 5.0 }, "quote": "They have skillfully mastered the art of keeping clients informed.", "summary": "WebFX provides SEO services for an architectural products company...", "feedback": "The client has seen a surge in website traffic...", "background": "I am the CEO of Jonite. Our company manufactures luxury architectural products.", "challenge": "Increase organic traffic by at least 20%. Increase conversion rate.", "solution": "WebFX provided SEO and content marketing services including keyword research and link building.", "results": "The partnership with WebFX brought about a noticeable improvement in organic traffic.", "date": "Jun 30, 2023", "isFeatured": false, "isVerified": true, "reviewerName": "Lexter Chen", "reviewerPosition": "CEO, Jonite", "reviewerIndustry": "Manufacturing", "reviewerLocation": "Singapore", "reviewerClientSize": "51-200 Employees", "reviewType": "Online Review", "projectServices": ["Search Engine Optimization"], "projectSize": "Confidential", "projectLength": "Jan. 2022 - Ongoing" } ], "rank": 1, "scrapedAt": "2026-02-28T10:00:00Z", "dataType": "company" } ```` ### ๐Ÿ—‚๏ธ Data fields #### Company fields | Category | Fields | Requires | |----------|--------|---------| | **Identity** | `id`, `slug`, `url`, `name`, `logoUrl`, `rank` | listing or profile URL | | **Ratings** | `rating`, `reviewCount` | listing or profile URL | | **Pricing** | `minProjectSize`, `hourlyRate` | listing or profile URL | | **Company Info** | `employees`, `yearFounded`, `isPremier`, `isVerified` | listing or profile URL | | **Contact** | `phone`, `website` | listing or profile URL | | **Location (HQ)** | `city`, `state`, `country`, `address`, `postalCode` | listing or profile URL | | **Services** | `services[]` (name + percent) | listing or profile URL | | **Tagline & Description** | `tagline`, `description` | `includeDetails: true` | | **Social Links** | `socialLinks[]` (platform + url) | `includeDetails: true` | | **Service Lines** | `serviceLines[]` (slug, group, groupName, mainPageUrl, percent) | `includeDetails: true` | | **Audience Charts** | `chartPie` (serviceProvided, focus, industries, clients) | `includeDetails: true` | | **All Locations** | `locations[]` (address, phone, employees per office) | `includeDetails: true` | | **Legal Entity** | `businessEntity` (name, jurisdiction, formation date, status) | `includeDetails: true` | | **Credit Report** | `creditReport` (riskAssessment, source, lastUpdated) | `includeDetails: true` | | **Languages** | `languages[]` | `includeDetails: true` | | **Video** | `videoUrl` (YouTube/Vimeo embed) | `includeDetails: true` | | **AI Review Insights** | `reviewInsights` (topMentions, highlights) | `includeDetails: true` | | **Portfolio** | `portfolio[]` (title, services, client, projectSize, description) | `includePortfolio: true` | | **Reviews** | `reviews[]` | `includeReviews: true` | #### Review fields | Category | Fields | |----------|--------| | **Identity** | `id`, `title` | | **Ratings** | `rating`, `metrics` (quality, schedule, cost, willingToRefer) | | **Text** | `quote`, `summary`, `feedback` | | **Full Detail** | `background`, `challenge`, `solution`, `results` | | **Meta** | `date`, `isFeatured`, `isVerified` | | **Reviewer** | `reviewerName`, `reviewerPosition`, `reviewerIndustry`, `reviewerLocation`, `reviewerClientSize`, `reviewType` | | **Project** | `projectServices[]`, `projectSize`, `projectLength` | ### ๐Ÿš€ Examples #### Scrape a category listing ```json { "startUrls": [ { "url": "https://clutch.co/agencies/digital-marketing" } ], "maxItems": 100, "maxPages": 2 } ``` #### Scrape with full profile details ```json { "startUrls": [ { "url": "https://clutch.co/agencies/digital-marketing" } ], "maxItems": 50, "includeDetails": true, "includeReviews": true, "maxReviewPages": 2 } ``` #### Scrape a specific company profile ```json { "startUrls": [ { "url": "https://clutch.co/profile/webfx" } ], "includeDetails": true, "includeReviews": true, "maxReviewPages": 5, "includePortfolio": true } ``` #### Scrape agencies in a specific country ```json { "startUrls": [ { "url": "https://clutch.co/gb/agencies/digital-marketing" }, { "url": "https://clutch.co/au/agencies/seo" } ], "maxItems": 200, "includeDetails": true } ``` #### Search by keyword ```json { "searches": ["React Native developers", "e-commerce SEO agency"], "maxItems": 100, "maxPages": 3 } ``` ### ๐Ÿ’ป Integrations #### Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run_input = { "startUrls": [{"url": "https://clutch.co/agencies/digital-marketing"}], "maxItems": 100, "maxPages": 2, "includeDetails": True, "includeReviews": True, } run = client.actor("silentflow/clutch-scraper-ppe").call(run_input=run_input) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["name"], item["rating"], item["hourlyRate"]) ``` #### JavaScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('silentflow/clutch-scraper-ppe').call({ startUrls: [{ url: 'https://clutch.co/agencies/digital-marketing' }], maxItems: 100, maxPages: 2, includeDetails: true, includeReviews: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(({ name, rating, hourlyRate }) => { console.log(name, rating, hourlyRate); }); ``` ### ๐Ÿ“ˆ Performance & limits | Metric | Value | |--------|-------| | Companies per listing page | Up to 80 | | Typical speed (listing only) | ~500 companies/minute | | With `includeDetails` | ~50โ€“80 companies/minute | | With `includeDetails` + `includeReviews` | ~40โ€“60 companies/minute | | Reviews per page | ~11 reviews | | Proxies | Residential (included) | | Pagination format | `?page=N` (Clutch native) | ### ๐Ÿ’ก Tips for best results 1. **Start with a small test**: Run with `maxItems: 20` first to verify the output matches your needs 2. **Enable profile details selectively**: `includeDetails: true` fetches one extra request per company, enable only when you need the full dataset 3. **Control review depth**: Use `maxReviewPages: 1` for a quick sample (~11 reviews), increase for full review history 4. **Combine URL and search**: Use `startUrls` for specific categories and `searches` for keyword-based discovery 5. **Country pages**: Use `https://clutch.co/us/agencies/...` or `/gb/`, `/au/`, `/ca/`, `/in/` to filter by country 6. **Paginate efficiently**: Clutch shows up to 80 companies per page, `maxPages: 25` gives up to 2,000 companies per URL ### โ“ FAQ **Q: What does "pay per result" mean?** A: You are charged per company extracted, not per compute time. There are no charges for failed requests or empty pages. **Q: Are proxies included?** A: Yes. Residential proxies are included in the per-result price, no separate proxy configuration needed. **Q: Do I need a Clutch.co account?** A: No. All data is extracted from publicly visible pages, no login or account required. **Q: What is the difference between `services` and `serviceLines`?** A: `services` comes from the listing page and contains name + percentage. `serviceLines` comes from the profile page and adds group, slug, and Clutch page URL for each service line. Requires `includeDetails: true`. **Q: What are `background`, `challenge`, `solution`, and `results` in reviews?** A: These are the four detailed sections of each Clutch review, the full written content from the client. They give much deeper insight than the summary alone. Requires `includeReviews: true`. **Q: What is `reviewInsights`?** A: Clutch's AI-generated analysis of the company's reviews: `topMentions` lists the most frequently mentioned keywords with their count, and `highlights` are AI-written insight bullets. Requires `includeDetails: true`. **Q: What is `businessEntity` and `creditReport`?** A: When available, Clutch displays verified legal registration data and a Creditsafe credit risk assessment. These only appear for companies that have gone through Clutch's verification process, typically US-registered businesses. **Q: How many companies can I scrape from a single category?** A: Clutch shows up to 80 companies per page. With `maxPages: 25`, you can extract up to 2,000 companies per category URL. **Q: Can I scrape agencies from a specific country?** A: Yes. Use country-specific URLs such as `https://clutch.co/us/agencies/digital-marketing` or `https://clutch.co/gb/agencies/seo`. **Q: What happens if the scraper can't load a page?** A: The scraper automatically retries. If all attempts fail, that page is skipped at no charge. ### ๐Ÿ“ฌ Support Need help or have a feature request? Contact us through the Apify platform. Check out our other scrapers: [SilentFlow on Apify](https://apify.com/silentflow) # Actor input Schema ## `startUrls` (type: `array`): Clutch.co category or profile page URLs to scrape. ## `searches` (type: `array`): Keywords to search on Clutch.co (e.g. 'SEO agency', 'mobile app development'). ## `maxItems` (type: `integer`): Maximum number of companies to extract. ## `maxPages` (type: `integer`): Maximum number of listing pages to scrape per URL. ## `includeDetails` (type: `boolean`): Visit each company's profile page for additional data: tagline, description, social links, year founded, website, service lines, chart breakdown (industries, clients, focus), all office locations, legal entity, credit report, languages, video URL, and AI review insights. Each company profile counts as one additional result. ## `includeReviews` (type: `boolean`): Scrape client reviews from each company's profile page. Each review includes ratings, reviewer details, project info, and written feedback. Each review page counts as one additional result. ## `maxReviewPages` (type: `integer`): Maximum number of review pages to scrape per company (each page has ~11 reviews). Only applies when includeReviews is enabled. ## `includePortfolio` (type: `boolean`): Fetch the company's portfolio projects (title, image, services). Adds 1 request per company. Each portfolio request counts as one additional result. ## `includePortfolioDetails` (type: `boolean`): Fetch full details for each portfolio item: client name, project size, and description. Requires includePortfolio. Adds 1 request per portfolio item. ## Actor input object example ```json { "startUrls": [ { "url": "https://clutch.co/agencies/digital-marketing" } ], "searches": [ "web development agency" ], "maxItems": 100, "maxPages": 10, "includeDetails": false, "includeReviews": false, "maxReviewPages": 3, "includePortfolio": false, "includePortfolioDetails": false } ``` # Actor output Schema ## `results` (type: `string`): Complete company data including: name, rating, reviewCount, minProjectSize, hourlyRate, employees, city, state, country, phone, website, services, serviceLines, chartPie, reviews, socialLinks, isPremier, isVerified, url. ## `resultsCSV` (type: `string`): Company data in CSV format. ## `resultsExcel` (type: `string`): Company data in Excel format. # 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/agencies/digital-marketing" } ], "searches": [ "web development agency" ] }; // Run the Actor and wait for it to finish const run = await client.actor("silentflow/clutch-scraper-ppe").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/agencies/digital-marketing" }], "searches": ["web development agency"], } # Run the Actor and wait for it to finish run = client.actor("silentflow/clutch-scraper-ppe").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/agencies/digital-marketing" } ], "searches": [ "web development agency" ] }' | apify call silentflow/clutch-scraper-ppe --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=silentflow/clutch-scraper-ppe", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Clutch Scraper Ppe", "description": "Extract agencies & service providers from Clutch.co. Pay per result โ€” proxies included. Get ratings, full-text reviews (background, challenge, solution, results), service lines, office locations, legal entity, credit report, and AI review insights. Any category or profile URL.", "version": "1.0", "x-build-id": "jKEd7pjVUc5sCColV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~clutch-scraper-ppe/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-clutch-scraper-ppe", "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/silentflow~clutch-scraper-ppe/runs": { "post": { "operationId": "runs-sync-silentflow-clutch-scraper-ppe", "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/silentflow~clutch-scraper-ppe/run-sync": { "post": { "operationId": "run-sync-silentflow-clutch-scraper-ppe", "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": "Clutch.co category or profile page URLs to scrape.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searches": { "title": "Search queries", "type": "array", "description": "Keywords to search on Clutch.co (e.g. 'SEO agency', 'mobile app development').", "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of companies to extract.", "default": 100 }, "maxPages": { "title": "Max pages", "minimum": 1, "type": "integer", "description": "Maximum number of listing pages to scrape per URL.", "default": 10 }, "includeDetails": { "title": "Include profile details", "type": "boolean", "description": "Visit each company's profile page for additional data: tagline, description, social links, year founded, website, service lines, chart breakdown (industries, clients, focus), all office locations, legal entity, credit report, languages, video URL, and AI review insights. Each company profile counts as one additional result.", "default": false }, "includeReviews": { "title": "Include client reviews", "type": "boolean", "description": "Scrape client reviews from each company's profile page. Each review includes ratings, reviewer details, project info, and written feedback. Each review page counts as one additional result.", "default": false }, "maxReviewPages": { "title": "Max review pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of review pages to scrape per company (each page has ~11 reviews). Only applies when includeReviews is enabled.", "default": 3 }, "includePortfolio": { "title": "Include portfolio", "type": "boolean", "description": "Fetch the company's portfolio projects (title, image, services). Adds 1 request per company. Each portfolio request counts as one additional result.", "default": false }, "includePortfolioDetails": { "title": "Include portfolio details", "type": "boolean", "description": "Fetch full details for each portfolio item: client name, project size, and description. Requires includePortfolio. Adds 1 request per portfolio item.", "default": false } } }, "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 } } } } } } } } } } ```