{
  "openapi": "3.0.1",
  "info": {
    "title": "Clutch.co Scraper",
    "description": "Scrape business listings from Clutch.co directory pages. Extract company names, emails, ratings, reviews, project sizes, hourly rates, employee counts, locations, services, phone numbers, and websites.",
    "version": "1.0",
    "x-build-id": "enWHxhbMHg6pSBlkM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/morkerr~clutch-co-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-morkerr-clutch-co-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/morkerr~clutch-co-scraper/runs": {
      "post": {
        "operationId": "runs-sync-morkerr-clutch-co-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/morkerr~clutch-co-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-morkerr-clutch-co-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": {
          "categories": {
            "title": "Pick Categories",
            "type": "array",
            "description": "Select one or more categories to scrape.",
            "items": {
              "type": "string",
              "enum": [
                "https://clutch.co/agencies",
                "https://clutch.co/agencies/digital",
                "https://clutch.co/agencies/digital-strategy",
                "https://clutch.co/agencies/digital-marketing",
                "https://clutch.co/agencies/social-media-marketing",
                "https://clutch.co/agencies/content-marketing",
                "https://clutch.co/agencies/email",
                "https://clutch.co/agencies/inbound-marketing",
                "https://clutch.co/agencies/direct-marketing",
                "https://clutch.co/agencies/app-marketing",
                "https://clutch.co/agencies/event",
                "https://clutch.co/agencies/experiential",
                "https://clutch.co/agencies/creative",
                "https://clutch.co/pr-firms",
                "https://clutch.co/agencies/video-production",
                "https://clutch.co/agencies/branding",
                "https://clutch.co/agencies/naming",
                "https://clutch.co/agencies/ppc",
                "https://clutch.co/seo-firms",
                "https://clutch.co/agencies/sem",
                "https://clutch.co/agencies/conversion-optimization",
                "https://clutch.co/agencies/market-research",
                "https://clutch.co/agencies/media-buying",
                "https://clutch.co/it-services/marketing-automation",
                "https://clutch.co/web-developers",
                "https://clutch.co/developers",
                "https://clutch.co/directory/mobile-application-developers",
                "https://clutch.co/directory/iphone-application-developers",
                "https://clutch.co/directory/android-application-developers",
                "https://clutch.co/developers/ecommerce",
                "https://clutch.co/developers/artificial-intelligence",
                "https://clutch.co/developers/blockchain",
                "https://clutch.co/developers/virtual-reality",
                "https://clutch.co/developers/internet-of-things",
                "https://clutch.co/developers/ruby-rails",
                "https://clutch.co/developers/shopify",
                "https://clutch.co/developers/wordpress",
                "https://clutch.co/developers/drupal",
                "https://clutch.co/developers/magento",
                "https://clutch.co/developers/dot-net",
                "https://clutch.co/web-developers/php",
                "https://clutch.co/app-developers/wearables",
                "https://clutch.co/developers/testing",
                "https://clutch.co/agencies/design",
                "https://clutch.co/agencies/digital-design",
                "https://clutch.co/web-designers",
                "https://clutch.co/agencies/ui-ux",
                "https://clutch.co/agencies/packaging-design",
                "https://clutch.co/agencies/print-design",
                "https://clutch.co/agencies/graphic-designers",
                "https://clutch.co/agencies/logo-designers",
                "https://clutch.co/agencies/product-design",
                "https://clutch.co/agencies/design/interior",
                "https://clutch.co/it-services",
                "https://clutch.co/it-services/analytics",
                "https://clutch.co/it-services/staff-augmentation",
                "https://clutch.co/it-services/cybersecurity",
                "https://clutch.co/it-services/cloud",
                "https://clutch.co/it-services/msp",
                "https://clutch.co/call-centers",
                "https://clutch.co/call-centers/answering-services",
                "https://clutch.co/call-centers/telemarketing",
                "https://clutch.co/bpo",
                "https://clutch.co/hr",
                "https://clutch.co/hr/staffing",
                "https://clutch.co/hr/recruiting",
                "https://clutch.co/hr/consultants",
                "https://clutch.co/hr/executive-search",
                "https://clutch.co/hr/peo",
                "https://clutch.co/hr/outsourcing",
                "https://clutch.co/consulting",
                "https://clutch.co/accounting",
                "https://clutch.co/accounting/payroll",
                "https://clutch.co/translation",
                "https://clutch.co/transcription",
                "https://clutch.co/real-estate",
                "https://clutch.co/law",
                "https://clutch.co/logistics/supply-chain-management",
                "https://clutch.co/logistics/fulfillment-services",
                "https://clutch.co/logistics/freight-forwarders"
              ],
              "enumTitles": [
                "Advertising (Advertising & Marketing)",
                "Full Service Digital (Advertising & Marketing)",
                "Digital Strategy (Advertising & Marketing)",
                "Digital Marketing (Advertising & Marketing)",
                "Social Media Marketing (Advertising & Marketing)",
                "Content Marketing (Advertising & Marketing)",
                "Email Marketing (Advertising & Marketing)",
                "Inbound Marketing (Advertising & Marketing)",
                "Direct Marketing (Advertising & Marketing)",
                "Mobile & App Marketing (Advertising & Marketing)",
                "Event Marketing (Advertising & Marketing)",
                "Experiential Marketing (Advertising & Marketing)",
                "Creative (Advertising & Marketing)",
                "Public Relations (Advertising & Marketing)",
                "Video Production (Advertising & Marketing)",
                "Branding (Advertising & Marketing)",
                "Naming (Advertising & Marketing)",
                "PPC (Advertising & Marketing)",
                "SEO (Advertising & Marketing)",
                "SEM (Advertising & Marketing)",
                "Conversion Optimization (Advertising & Marketing)",
                "Market Research (Advertising & Marketing)",
                "Media Planning and Buying (Advertising & Marketing)",
                "Marketing Automation (Advertising & Marketing)",
                "Web Developers (Development)",
                "Software Developers (Development)",
                "Mobile App Development (Development)",
                "iPhone App Development (Development)",
                "Android App Development (Development)",
                "eCommerce (Development)",
                "Artificial Intelligence (Development)",
                "Blockchain (Development)",
                "AR/VR (Development)",
                "IoT (Development)",
                "Ruby on Rails (Development)",
                "Shopify (Development)",
                "WordPress Developers (Development)",
                "Drupal (Development)",
                "Magento (Development)",
                ".NET Developers (Development)",
                "PHP (Development)",
                "Wearables (Development)",
                "Software Testing (Development)",
                "Design (Design & Production)",
                "Digital Design (Design & Production)",
                "Web Design (Design & Production)",
                "User Experience (Design & Production)",
                "Packaging Design (Design & Production)",
                "Print Design (Design & Production)",
                "Graphic Design (Design & Production)",
                "Logo Design (Design & Production)",
                "Product Design (Design & Production)",
                "Interior Design (Design & Production)",
                "IT Services (IT Services)",
                "BI and Big Data (IT Services)",
                "Staff Augmentation (IT Services)",
                "Cybersecurity (IT Services)",
                "Cloud Consulting (IT Services)",
                "Managed Service Providers (IT Services)",
                "Call Centers (Business Services)",
                "Answering Services (Business Services)",
                "Telemarketing (Business Services)",
                "BPO (Business Services)",
                "Human Resources (Business Services)",
                "HR Staffing (Business Services)",
                "HR Recruiting (Business Services)",
                "HR Consulting (Business Services)",
                "Executive Search (Business Services)",
                "PEO (Business Services)",
                "HR Outsourcing (Business Services)",
                "Consulting (Business Services)",
                "Accounting (Business Services)",
                "Payroll Processing (Business Services)",
                "Translation (Business Services)",
                "Transcription (Business Services)",
                "Real Estate (Business Services)",
                "Legal (Business Services)",
                "Logistics & Supply Chain (Business Services)",
                "Fulfillment (Business Services)",
                "Freight Forwarding (Business Services)"
              ]
            },
            "default": [
              "https://clutch.co/agencies/digital"
            ]
          },
          "location": {
            "title": "Location Filter (see examples below)",
            "type": "string",
            "description": "Filter results by location. Use bracket notation for multiple locations.\n\nSingle location:\n  London, England\n  New York, United States\n\nMultiple locations (same category):\n  [London, England] [New York, United States] [Chicago]\n\nLeave empty for all locations.",
            "default": ""
          },
          "categoryUrls": {
            "title": "Or Enter Custom URLs Manually",
            "type": "string",
            "description": "Additional Clutch.co directory URLs (one per line). Useful if the category you need isn't listed in the dropdown above.\n\nWithout location (scrapes all listings):\n  https://clutch.co/web-developers\n  https://clutch.co/developers/artificial-intelligence\n\nWith location (scope to a specific area):\n  https://clutch.co/us/ny/new-york/web-developers\n  https://clutch.co/uk/england/london/app-developers\n\nTip: The Location Filter field above also applies to these custom URLs.",
            "default": ""
          },
          "maxPagesPerCategory": {
            "title": "Max Pages per Category",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Number of pagination pages to scrape per category (each page shows ~50 listings). Set to 0 for unlimited — scrapes all available pages until no more exist.",
            "default": 3
          },
          "minRating": {
            "title": "Minimum Rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Only include companies with at least this star rating (e.g. 4.0, 3.5). Set to 0 to include all.",
            "default": 0
          },
          "excludeFeatured": {
            "title": "Exclude Featured",
            "type": "boolean",
            "description": "Skip promoted/sponsored listings at the top of each page.",
            "default": false
          },
          "scrapeEmails": {
            "title": "Scrape Emails from Websites",
            "type": "boolean",
            "description": "When enabled, visits each company's website to extract email addresses. This significantly increases run time (several seconds per website).",
            "default": false
          },
          "pageTimeout": {
            "title": "Page Load Timeout (ms)",
            "minimum": 5000,
            "type": "integer",
            "description": "Maximum time to wait for each directory page to fully load.",
            "default": 60000
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Proxy settings for the scraper. Apify proxy recommended to avoid IP blocking.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "BUYPROXIES94952"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}