# GoodFirms Scraper (`crawlerbros/goodfirms-scraper`) Actor

Scrape GoodFirms with the leading B2B software and IT services directory with 150,000+ verified company profiles. Browse companies by service category, search by keyword, or fetch a specific company profile. Returns ratings, reviews, pricing, location, team size, and more.

- **URL**: https://apify.com/crawlerbros/goodfirms-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Developer tools, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## GoodFirms Scraper

Extract company profiles from [GoodFirms](https://www.goodfirms.co/) — the leading B2B research, ratings, and reviews platform with 150,000+ verified company profiles across IT services, software development, and digital marketing.

### What You Get

Each company record returns:

| Field | Description |
|---|---|
| `title` | Company name |
| `url` | GoodFirms profile URL |
| `slug` | URL slug (e.g. `sdlc-corp`) |
| `entityId` | GoodFirms internal entity ID |
| `logoUrl` | Company logo image URL |
| `rating` | GoodFirms rating (1–5 scale) |
| `reviewCount` | Number of verified client reviews |
| `hourlyRate` | Hourly rate range (e.g. `$25 - $49/hr`) |
| `employees` | Employee count range (e.g. `250 - 999`) |
| `founded` | Year founded |
| `location` | Headquarters city and country |
| `shortDescription` | Brief company description |
| `scrapedAt` | ISO timestamp |

### Input Parameters

#### Mode

- **By Category** (`byCategory`) — Browse companies in a specific service category (web development, mobile apps, SEO, etc.)
- **Search** (`search`) — Search for companies by keyword across the web development category
- **Company Profile** (`companyProfile`) — Fetch specific company profiles by URL or slug

#### Filters

| Parameter | Type | Description |
|---|---|---|
| `categorySlug` | Select | Service category (web-development-agency, mobile-app-development, etc.) |
| `searchQuery` | String | Keyword to match in company name or description |
| `sortBy` | Select | Sort order: default, reviews, or rating |
| `minRating` | Number | Minimum GoodFirms rating (1.0–5.0) |
| `minReviews` | Integer | Minimum number of client reviews |
| `maxItems` | Integer | Maximum results to return (1–500) |

### Example Inputs

**Browse top web development agencies:**

```json
{
  "mode": "byCategory",
  "categorySlug": "web-development-agency",
  "sortBy": "reviews",
  "maxItems": 50
}
```

**Search for CRM companies:**

```json
{
  "mode": "search",
  "searchQuery": "web development",
  "minRating": 4.5,
  "maxItems": 30
}
```

**Fetch specific company profiles:**

```json
{
  "mode": "companyProfile",
  "companyUrls": [
    "https://www.goodfirms.co/company/sdlc-corp",
    "instinctools"
  ]
}
```

### Use Cases

- **Vendor discovery** — Find top-rated IT companies for a specific technology or service
- **Market research** — Analyze pricing, employee counts, and reviews across service categories
- **Lead generation** — Build lists of agencies for outreach and partnership opportunities
- **Competitive analysis** — Compare ratings and reviews of competing firms
- **Supplier vetting** — Research a vendor before engaging them for a project

### FAQ

**Does this require login or API keys?**
No. GoodFirms company listings are publicly accessible without any credentials.

**How many companies are available?**
GoodFirms lists 150,000+ company profiles. Category pages typically show 48 companies per page.

**Can I filter by technology or programming language?**
Use specific category slugs like `web-development-agency/react`, `web-development-agency/nodejs` — these subcategory paths are supported by the `categorySlug` field.

**What's the difference between browse and search modes?**
Browse (byCategory) paginates through a specific GoodFirms category. Search applies a keyword filter to the same pages. For company lookups, use companyProfile mode.

**Why don't some companies have hourly rates or employee counts?**
GoodFirms allows companies to optionally display these metrics. Fields are only included when data is available.

# Actor input Schema

## `mode` (type: `string`):

How to scrape GoodFirms listings.

## `searchQuery` (type: `string`):

Company name or service keyword to search for.

## `categorySlug` (type: `string`):

GoodFirms service category slug. Currently supported: web-development-agency, blockchain-development-services, low-code-no-code.

## `companyUrls` (type: `array`):

GoodFirms company profile URLs or slugs (e.g. https://www.goodfirms.co/company/sdlc-corp or just sdlc-corp).

## `sortBy` (type: `string`):

Sort order for category/search results.

## `minRating` (type: `number`):

Only include companies with rating at or above this value (1.0–5.0).

## `minReviews` (type: `integer`):

Only include companies with at least this many reviews.

## `maxItems` (type: `integer`):

Maximum number of company records to return.

## Actor input object example

```json
{
  "mode": "search",
  "searchQuery": "web development",
  "categorySlug": "web-development-agency",
  "companyUrls": [],
  "sortBy": "default",
  "maxItems": 20
}
```

# Actor output Schema

## `companies` (type: `string`):

Dataset containing all scraped GoodFirms company profiles.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "searchQuery": "web development",
    "categorySlug": "web-development-agency",
    "companyUrls": [],
    "sortBy": "default",
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/goodfirms-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchQuery": "web development",
    "categorySlug": "web-development-agency",
    "companyUrls": [],
    "sortBy": "default",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/goodfirms-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchQuery": "web development",
  "categorySlug": "web-development-agency",
  "companyUrls": [],
  "sortBy": "default",
  "maxItems": 20
}' |
apify call crawlerbros/goodfirms-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawlerbros/goodfirms-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/WwLqJx0x9fuv30E5V/builds/MqfMje7thptTEt9aV/openapi.json