{ "openapi": "3.0.1", "info": { "title": "Clutch.co Agency & B2B Company Scraper", "description": "Extract B2B agencies from Clutch.co with ratings, hourly rates, project minimums, team size, verified location and website. Optional profile pass adds founding year, social links, registered entity and full reviews.", "version": "1.0", "x-build-id": "iPakVtgaJMFgVravk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~clutch-agency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-clutch-agency-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/sian.agency~clutch-agency-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-clutch-agency-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/sian.agency~clutch-agency-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-clutch-agency-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "operation": { "title": "🎯 What do you want to scrape?", "enum": [ "directorySearch", "companyProfile" ], "type": "string", "description": "Directory Search reads a Clutch directory page and returns every company on it - the cheap bulk path, billed per listing. Company Profile additionally fetches each company's own page for founding year, social links, the registered business entity, all office locations and its service catalogue; that costs one extra request per company and is billed at the profile rate. Leave it on Directory Search when you only need leads.", "default": "directorySearch" }, "searchUrls": { "title": "🔗 Clutch directory URLs", "type": "array", "description": "One or more Clutch directory pages to read, copied straight from your browser. Any directory works - a service line such as https://clutch.co/agencies/creative, a location such as https://clutch.co/us/agencies/digital-marketing, or a filtered view. Every company listed on the page is returned. Pagination is followed automatically until Max results is reached.", "default": [ "https://clutch.co/agencies/creative" ], "items": { "type": "string" } }, "companyUrls": { "title": "🏢 Company profile URLs", "type": "array", "description": "Optional. Specific Clutch profile URLs such as https://clutch.co/profile/vsa-partners, scraped directly without going through a directory. Use this when you already know which companies you want. These always run the full profile pass, so they are billed as Company Profile rows.", "default": [], "items": { "type": "string" } }, "includeReviews": { "title": "⭐ Include full reviews", "type": "boolean", "description": "Adds every published client review - title, author, date, score and body text - to each row. Only Company Profile mode carries reviews, so switching this on selects that mode automatically. It adds no extra request beyond that mode's profile fetch.", "default": false }, "maxResults": { "title": "🔢 Max results", "type": "integer", "description": "Stop after this many companies. A Clutch directory page holds 36-49 companies, so 100 reads two to three pages. Set it to 0 to take every company in the directory - some run to 260+ pages, so pair 0 with a narrow directory URL rather than a broad one.", "default": 100 }, "minRating": { "title": "⭐ Minimum rating", "type": "integer", "description": "Skip companies rated below this, on Clutch's 0-5 scale. Leave at 0 to keep everything. Filtering happens before any profile page is fetched, so raising this genuinely reduces what you are billed rather than just hiding rows.", "default": 0 } } }, "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 } } } } } } } } } }