{
  "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": "0.0",
    "x-build-id": "wyNYWVbumyt6r3nJQ"
  },
  "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/web-developers",
              "https://clutch.co/developers/ecommerce",
              "https://clutch.co/developers/artificial-intelligence"
            ]
          },
          "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.\nExamples:\nhttps://clutch.co/web-developers\nhttps://clutch.co/developers/artificial-intelligence",
            "default": ""
          },
          "location": {
            "title": "Location Filter",
            "type": "string",
            "description": "Filter results by location. Enter a US city (e.g., 'New York City'), US state (e.g., 'Texas'), or country (e.g., 'United Kingdom'). Leave empty for all locations.",
            "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": 10
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}