{ "openapi": "3.0.1", "info": { "title": "Clutch Scraper - Companies, Ratings, Reviews & Pricing", "description": "Scrape Clutch company directories and profiles. Get names, ratings, review counts, hourly rate, min project size, employees, location, services, full reviews with reviewer details and per-criterion scores. Search and URL mode, 40+ fields per company.", "version": "1.1", "x-build-id": "SrgrDwy3Z8dnVeiUZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~clutch-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-clutch-directory-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/abotapi~clutch-directory-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-clutch-directory-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/abotapi~clutch-directory-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-clutch-directory-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to start the scrape. 'search' builds a directory URL from the filters below (or runs Clutch's own keyword search when 'Keyword search' is filled). 'url' takes the exact Clutch directory URLs you paste.", "default": "search" }, "searchQuery": { "title": "Keyword search (optional)", "type": "string", "description": "Keyword search: optional. Search Clutch by keyword or company name instead of browsing a directory -- the same as typing into Clutch's own search box (for example 'shopify', 'react native', 'BairesDev'). Walks every results page Clutch offers (4 companies per page) up to Max records. When set, the directory filters below (directory, location, company size, related service, hourly rate, project budget, industry, client focus, focus area, specialization, verified/guarantee only, sort) are ignored -- Clutch's search page has none -- and the run log says so. Min rating and Min reviews still apply. Leave empty to browse a directory with filters." }, "directory": { "title": "Directory", "type": "string", "description": "Directory: which Clutch directory to scrape in search mode. Accepts a plain category name ('Web Developers', 'SEO', 'Mobile App Development') or a Clutch directory slug directly, including a nested one like 'developers/php'. Live-verified slugs: 'web-developers', 'web-designers', 'developers', 'agencies', 'seo-firms', 'app-developers', 'it-services', 'pr-firms', 'call-centers', 'bpo', 'accounting', 'translation'. Any other slug is still tried as-is, but a bad one now gets a loud warning in the run log instead of a silent empty result.", "default": "web-developers" }, "location": { "title": "Location", "type": "string", "description": "Location: optional location to narrow results -- any country, region or city name as Clutch spells it ('United States', 'Germany', 'London', 'Munich', 'Sao Paulo', 'Tokyo'). Common countries and a few major cities resolve offline; any other name is looked up on Clutch's own location search and the run log shows the place it matched. A name Clutch does not know stops the run with a clear message instead of guessing. A 2-letter Clutch path code ('us', 'de') also works. Leave empty for worldwide." }, "agencySize": { "title": "Company size", "type": "string", "description": "Company size: optional filter -- one of Clutch's own buckets: 'Freelancer', '2 - 9', '10 - 49', '50 - 249', '250 - 999', '1,000 - 9,999' or '10,000+' employees (underscore or plain forms like '50_-_249' / '50-249' also work; the thousands comma is added automatically if left out -- Clutch's own filter silently ignores an un-comma'd '1000 - 9999'). Leave empty for any size." }, "relatedServices": { "title": "Related service", "type": "string", "description": "Related service: optional filter -- a plain name ('Mobile App Development', 'SEO', 'Ecommerce Development', 'Public Relations') or the raw Clutch value directly, for example 'field_pp_sl_ecommerce'. An unrecognised name is still sent as-is, but Clutch silently ignores a value it does not recognise (the run log warns when this happens). Leave empty for all services." }, "hourlyRateRange": { "title": "Hourly rate", "enum": [ "0-25", "25-49", "50-99", "100-149", "150-199", "200-300", "300" ], "type": "string", "description": "Hourly rate: optional filter -- only companies in this average hourly-rate range (Clutch's own filter). Leave empty for any rate." }, "clientBudget": { "title": "Your project budget", "enum": [ "5000", "10000", "25000", "50000", "75000", "100000", "250000" ], "type": "string", "description": "Project budget: optional filter -- only companies whose minimum project size fits under this budget (Clutch's own 'Client budget' filter). Leave empty for any budget." }, "industry": { "title": "Industry focus", "type": "string", "description": "Industry focus: optional filter -- only companies that serve this industry -- a plain name as Clutch shows it ('eCommerce', 'Financial services', 'Medical', 'Real estate', 'Education', 'Retail', 'Manufacturing', 'Automotive', ...) or the raw Clutch value such as 'field_pp_if_ecommerce'. An unrecognised name is still sent as-is, but Clutch silently ignores it (the run log warns). Leave empty for all industries." }, "clientType": { "title": "Client focus", "enum": [ "small_business", "midmarket", "enterprise" ], "type": "string", "description": "Optional filter -- only companies that focus on this client size (Clutch's own 'Client focus' filter): small businesses (under $10M revenue), midmarket ($10M - $1B) or enterprise (over $1B). Leave empty for any." }, "focusArea": { "title": "Focus area", "type": "string", "description": "Optional filter -- a technology or focus area exactly as Clutch lists it for this directory ('WordPress CMS', 'JavaScript', 'Android App Development', 'Shopify', ...), or the raw Clutch value such as 'field_pp_fw_wordpress'. Looked up in Clutch's own filter list for the directory; a name it does not offer is reported in the run log and not applied. Leave empty for all." }, "specialization": { "title": "Specialization", "type": "string", "description": "Optional filter -- a company specialization as Clutch lists it ('Accessibility', 'Multicultural', 'Diversity & Inclusion', ...), or the raw value such as 'field_accessibility'. Looked up in Clutch's own filter list for the directory; a name it does not offer is reported and not applied. Leave empty for all." }, "verifiedOnly": { "title": "Verified companies only", "type": "boolean", "description": "Only companies that carry Clutch's verification badge (Clutch's own 'Verification' filter).", "default": false }, "clutchGuaranteeOnly": { "title": "Clutch Guarantee companies only", "type": "boolean", "description": "Only companies that offer the Clutch Guarantee (Clutch's own filter).", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "default", "review_rating", "reviews", "company_name", "date", "clutch_rank", "verified" ], "type": "string", "description": "Sort by: result ordering. Search mode only -- this reorders the results the site returns, so it has no equivalent in URL mode.", "default": "default" }, "urls": { "title": "Clutch URLs (directory, profile or search page)", "type": "array", "description": "Paste one or more Clutch URLs. Multi-URL supported. Filter fields above are ignored. Supported shapes: a directory listing (.../web-developers, legacy .../directory/), a nested directory (.../developers/php, .../consulting/ai/deployment), a country- or city-scoped directory (.../us/web-developers, .../web-developers/chicago, .../au/web-developers/sydney, .../web-developers/uk), a directory with filter query params and/or a page number (results continue from that page), a company profile (.../profile/, also its review pages ?page=N#reviews and its /portfolio link -- returned as ONE fully enriched record, reviews from page 1), Clutch's own keyword-search page (.../search?q=...), Clutch's Markdown copy of any of these (.md), and the www host / http:// / utm_* tracking params (normalised automatically). Guides, articles, the home page and other clutch.co hosts (redirect links, the review form) are skipped with a warning naming the URL, and a dead slug or 404 gets a loud warning -- never a silent empty result.", "default": [ "https://clutch.co/web-developers", "https://clutch.co/developers/php", "https://clutch.co/us/web-developers", "https://clutch.co/web-developers/chicago", "https://clutch.co/web-developers?agency_size=10+-+49&page=1", "https://clutch.co/profile/railsware", "https://clutch.co/profile/railsware?page=1#reviews", "https://clutch.co/search?q=web+design", "https://clutch.co/directory/mobile-application-developers.md", "https://www.clutch.co/web-developers?utm_source=newsletter" ], "items": { "type": "string" } }, "minRating": { "title": "Min rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only keep companies with at least this overall rating (0 to 5). Applied after fetching, so it narrows results in BOTH search mode and URL mode." }, "minReviews": { "title": "Min reviews", "minimum": 0, "type": "integer", "description": "Only keep companies with at least this many reviews. Applied after fetching, so it narrows results in BOTH search mode and URL mode." }, "fetchDetails": { "title": "Fetch full profile details (richer records)", "type": "boolean", "description": "Open each company profile to add founding year, languages, locations, reviews (up to Max reviews, quote, feedback, summary, reviewer details, per-criterion scores, project size and length) and the rating breakdown. Adds one HTTP request per record, plus one more per extra review page (see Max reviews).", "default": true }, "maxReviews": { "title": "Max reviews per company", "minimum": 0, "type": "integer", "description": "How many reviews to return per company, in the order Clutch lists them (Clutch shows ~10-11 per profile page, so the default 20 reads one extra review page when a company has more). Only applies when Fetch full profile details is on, in both search mode and URL mode (incl. a pasted company-profile URL). 0 returns no reviews. The number actually returned is in reviewsDelivered. Reviews are included in the existing profile-enrichment charge -- no extra charge per review.", "default": 20 }, "includePortfolio": { "title": "Include portfolio, key clients & awards", "type": "boolean", "description": "Also read each company's Portfolio & Awards section: portfolio projects (title, image, services), key clients, Clutch award badges and industry recognitions. Only applies when Fetch full profile details is on. Adds one or two requests per company; no extra charge. Off by default.", "default": false }, "maxPages": { "title": "Max pages per list", "minimum": 0, "type": "integer", "description": "How many result pages to read per directory URL. Does NOT cap the run. Leave at 0 to walk the whole catalogue — the run stops on its own at the site's last page or a repeat-page guard, not an artificial page cap. The run is bounded by Max records, which is the cap. Set this only if you want to additionally limit how many pages are read per directory.", "default": 0 }, "maxListings": { "title": "Max records", "minimum": 0, "type": "integer", "description": "THE cap for the run: stop after this many records (default 20). Set to 0 for unlimited.", "default": 20 }, "proxy": { "title": "Proxy", "type": "object", "description": "Network connection. The default works on all plans and is recommended. You can switch to a different proxy option for heavier runs.", "default": { "useApifyProxy": true } }, "resumeFromRunId": { "title": "Resume from a previous run (delta)", "type": "string", "description": "Optional. ID of a previous run of this actor (or a dataset ID). Companies already in that dataset are skipped, so this run returns only NEW companies (a delta). Combine both runs' datasets for the full set. For a recurring monitoring schedule, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental mode (recurring monitoring)", "type": "boolean", "description": "When ON, this actor remembers the companies from its last run of the SAME search (see State key) and tags each company NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED, so a daily/weekly schedule returns only what changed. Off by default: every run returns the full result set with no change tracking, exactly as before. Combine with resumeFromRunId only to bootstrap a monitoring campaign from one prior run's dataset, not on every scheduled run.", "default": false }, "stateKey": { "title": "State key (optional)", "type": "string", "description": "Only used when Incremental mode is ON. Leave empty to auto-derive the tracked scope from your search filters (directory, location, company size, related service, sort, min rating, min reviews, URLs, fetch details) — two different filter setups then never share a baseline. Set an explicit value to intentionally share state across otherwise-different filter setups, or to run multiple separate monitoring campaigns." }, "emitUnchanged": { "title": "Also return unchanged companies", "type": "boolean", "description": "Only used when Incremental mode is ON. Off by default: companies with no changes since the last run are suppressed (not returned, not billed). Turn ON to also return every UNCHANGED company each run — this returns and BILLS more rows.", "default": false }, "emitExpired": { "title": "Also return expired companies", "type": "boolean", "description": "Only used when Incremental mode is ON. Off by default. Turn ON to emit a row (changeType EXPIRED) for companies that were in the previous run's tracked set but are no longer found — only on a run that completes a full, uncapped, non-resumed scan of the tracked search. This returns and BILLS extra rows.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Only used when Incremental mode is ON. Output field names (or dotted paths, e.g. \"metadata.scraped_at\") that should NOT make a company count as UPDATED. The directory-rank fields (position, metadata.position, listing.position) and this page's own URL (sourceUrl, metadata.seed_url) are always ignored, since they shift whenever any other company is added, removed, or reordered on the page, not because this company actually changed. Add a field here if changes to it are not relevant to you — it is still returned in the output, just excluded from change detection.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON. The complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }