{ "openapi": "3.0.1", "info": { "title": "Clutch.co Agency Directory Scraper — B2B Leads & Company Data", "description": "Turn the Clutch.co agency directory into B2B leads for lead generation: 19 always-present company data fields, public client reviews, the agency's real website, and an optional AI ICP-fit score. $2.50/1,000, 98.1% complete. Never charged for an empty or blocked result. JSON/CSV, API, schedule.", "version": "0.1", "x-build-id": "k6JObd7z5oR5LI9I0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dc83~clutch-b2b-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dc83-clutch-b2b-intelligence", "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/dc83~clutch-b2b-intelligence/runs": { "post": { "operationId": "runs-sync-dc83-clutch-b2b-intelligence", "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/dc83~clutch-b2b-intelligence/run-sync": { "post": { "operationId": "run-sync-dc83-clutch-b2b-intelligence", "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": { "categoryOrSearchUrls": { "title": "Category / search URLs", "type": "array", "description": "Clutch.co category or search listing URLs. Each is expanded (with pagination) into individual agency profile URLs. Use a specific category (e.g. https://clutch.co/agencies/digital-marketing) rather than the bare /agencies index — a category paginates into hundreds of profiles, while the index page surfaces only a short curated set and does not page.", "default": [], "items": { "type": "string" } }, "profileUrls": { "title": "Direct profile URLs (optional)", "type": "array", "description": "Optional direct Clutch.co agency profile URLs to scrape in addition to (or instead of) the listing URLs.", "default": [], "items": { "type": "string" } }, "maxAgencies": { "title": "Max agencies", "minimum": 1, "type": "integer", "description": "Maximum number of agency profiles to scrape in a single run. The default of 5 is a deliberately tiny smoke-test run (seconds, $0.0125) so a first try costs almost nothing — raise it for a real harvest; there is no upper cap beyond your own run budget.", "default": 5 }, "includeReviews": { "title": "Include public reviews", "type": "boolean", "description": "Scrape the publicly rendered review blocks for each agency. No logins, no closed data.", "default": true }, "agencyIntelligence": { "title": "AI agency-intelligence (premium, paid event)", "type": "boolean", "description": "Enable the premium AI scoring artifact ('who to act on first'). Billed as a separate paid event ONLY when a valid artifact is produced — never on an empty result. Off by default. Requires 'Include reviews': the artifact grounds every evidence quote in the scraped review text, so with reviews off most agencies yield no artifact (and are not charged).", "default": false }, "icpDescription": { "title": "Your ideal-customer profile (ICP)", "type": "string", "description": "Describe the buyer you are looking for — industry, company size, budget, region, the work you need done. Used ONLY by the AI agency-intelligence event to score 'icpFit'. Leave empty and icpFit is returned as null rather than guessed; the rest of the artifact still works." }, "contactEmail": { "title": "Contact email", "type": "string", "description": "Please put a real address here. It is sent in the scraper's User-Agent so the target site can reach whoever is running the scrape — this actor is a polite, identifiable client, and that is part of how it stays welcome. Left as the placeholder, the run still works, but nobody can be reached.", "default": "you@example.com" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Defaults to Apify Proxy RESIDENTIAL pinned to the US: our reliability testing found residential stays ahead of Clutch's anti-bot, while datacenter draws far more blocks (fewer results, no charge for the blocked ones), and Clutch is US-centric — non-US exit IPs get blocked site-wide, so the country is pinned to US. RESIDENTIAL is available on every Apify plan, including Free. You can change the tier or country here if you prefer.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "webhookUrls": { "title": "Webhook URLs (optional)", "type": "array", "description": "Optional URLs to POST each scraped result to as it is produced (best-effort, non-fatal).", "default": [], "items": { "type": "string" } } } }, "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 } } } } } } } } } }