# GoodFirms Scraper - IT Company & Agency Leads (`logiover/goodfirms-scraper`) Actor

GoodFirms scraper & unofficial API alternative: export GoodFirms B2B company leads to CSV/JSON. Hourly rate, team size, rating. No login, no key.

- **URL**: https://apify.com/logiover/goodfirms-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Lead generation, Business, AI
- **Features:** Limited permissions
- **Stats:** 4 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## GoodFirms Scraper - IT Company & Agency Leads

![Apify Actor](https://img.shields.io/badge/Apify-Actor-00A67E?logo=apify\&logoColor=white) ![No API key](https://img.shields.io/badge/No%20API%20key-required-2ea44f) ![Pay per result](https://img.shields.io/badge/Pricing-Pay%20per%20result-1C7ED6) ![Export](https://img.shields.io/badge/Export-JSON%20%7C%20CSV%20%7C%20Excel-F59E0B)

**GoodFirms scraper & unofficial API alternative: export GoodFirms B2B company leads to CSV/JSON. Hourly rate, team size, rating. No login, no key.**

***

### What does the GoodFirms Scraper do?

This Actor turns GoodFirms into a structured dataset you can actually work with. You give it a search, it walks the result pages, and it writes one clean row per record into your dataset — ready to export as JSON, CSV or Excel, or to pull straight from the Apify API.

It runs on plain HTTP with no browser and no login, which keeps it fast and cheap, and it works the same on a free account as on a paid one. Every field documented below came from a real verification run of this Actor, so what you read here is what you get.

The current build returns **14 populated fields** per record, of which **14 are present on virtually every row**.

### Who is it for?

- **Analysts** who need GoodFirms data as a spreadsheet instead of a browser tab.
- **Operations and research teams** tracking how GoodFirms listings change over time.
- **Developers** wiring a live data feed into an internal tool or database.
- **Growth and sales teams** building prospect and market lists from public data.
- **AI teams** assembling structured training or grounding data.

### Use cases

- Export a full GoodFirms search into a spreadsheet for analysis.
- Track how prices, volumes or availability move week over week by scheduling the run.
- Feed a dashboard or internal database with a repeatable, structured source.
- Build a market map by running several searches in one job.
- Enrich an existing list by matching on the identifiers in the output.

### Why use this GoodFirms Scraper?

- 🔑 **No API key and no login** — nothing to authenticate, nothing to expire.
- 📦 **14 verified fields** — every column below was confirmed against live output.
- 📄 **Real pagination** — it walks the result set instead of returning the first screen.
- 🎯 **Bounded runs** — caps in the input stop the job exactly where you want, so the bill is predictable.
- 💸 **Tiered pay-per-result** — you pay per row, and higher Apify plans pay less per row.
- 📊 **Export anywhere** — JSON, CSV, Excel, HTML, the API, or any Apify integration.

### What data can you extract?

One row per record. These columns come from a live run, with the share of rows that carried a value:

| Field | Type | Typically filled | Description |
|-------|------|------------------|-------------|
| `city` | string | 100% | City |
| `foundedYear` | number | 98% | Founded year |
| `hourlyRate` | string | 100% | Hourly rate |
| `id` | string | 100% | Id |
| `location` | string | 100% | Location |
| `name` | string | 100% | Name |
| `profileUrl` | string | 100% | Profile url |
| `rating` | number | 95% | Rating |
| `region` | string | 100% | Region |
| `reviewCount` | number | 95% | Review count |
| `scrapedAt` | string | 100% | Scraped at |
| `tagline` | string | 100% | Tagline |
| `teamSize` | number | 100% | Team size |
| `website` | string | 100% | Website |

#### Output example

```json
{
  "city": "Batavia",
  "foundedYear": "2015",
  "hourlyRate": "$25 - $49/hr",
  "id": "75762",
  "location": "Batavia, United States",
  "name": "SDLC Corp",
  "profileUrl": "https://www.goodfirms.co/company/sdlc-corp",
  "rating": "4.9",
  "region": "United States",
  "reviewCount": "156",
  "scrapedAt": "2026-09-11T09:26:40.650Z",
  "tagline": "SDLC Corp provides cutting-edge custom software development services for mobile applications, web platforms, and enterprise systems, delivering tailored solutions to meet unique client needs. The agency also specializes in Odoo development and customization for streamlined business management. With expertise in AR/VR, gaming solutions, robotic process ...",
  "teamSize": "250 - 999",
  "website": "https://sdlccorp.com/"
}
```

### How to use

1. Open the Actor and fill in the search fields — the defaults below are a working example.
2. Set the result cap so the run stops where you want it.
3. Click **Start**, then export from the **Output** tab or pull the dataset through the API.

```json
{
  "searchUrls": [
    "https://www.goodfirms.co/directory/country/top-software-development-companies/us"
  ]
}
```

### Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `searchUrls` | array | `–` | GoodFirms.co listing URLs copied straight from the site — e.g. |
| `maxResults` | integer | `200` | Stop after this many companies across all URLs. |
| `maxResultsPerSearch` | integer | `0` | Cap companies collected per individual directory URL. |
| `useProxy` | boolean | `true` | Route requests through Apify Proxy. |
| `proxyConfiguration` | object | `{"useApifyProxy": true, "a` | Apify Proxy settings. |
| `maxConcurrency` | integer | `3` | How many directory URLs to process in parallel. |

### Tips for best results

- Broad searches return the deepest result sets; very narrow ones run out after a page or two.
- Use the result cap rather than the page cap when you want a predictable bill.
- Schedule the same input daily or weekly to build a history instead of a one-off snapshot.
- Lower the concurrency if you see retries — the source rate-limits aggressive crawling.
- Run several searches in one job instead of one search with a huge page count.
- Empty optional fields are normal; filter on the columns that matter to you after export.
- Deduplicate on the identifier column if you merge several runs together.
- Keep the proxy setting on the default unless the source blocks your region.

### Integrations

Push results straight into **Google Sheets**, **Slack**, **Zapier**, **Make**, **Airtable** or any **Webhook**. You can also **schedule** the Actor and have each run append to the same dataset, which is how you turn a single export into a time series.

### API usage

Replace `<YOUR_TOKEN>` with your Apify API token.

**cURL**

```bash
curl -X POST "https://api.apify.com/v2/acts/logiover~goodfirms-scraper/run-sync-get-dataset-items?token=<YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchUrls": ["https://www.goodfirms.co/directory/country/top-software-development-companies/us"]}'
```

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient('<YOUR_TOKEN>')
run = client.actor('logiover/goodfirms-scraper').call(run_input={"searchUrls": ["https://www.goodfirms.co/directory/country/top-software-development-companies/us"]})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

**Node.js**

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

const client = new ApifyClient({ token: '<YOUR_TOKEN>' });
const run = await client.actor('logiover/goodfirms-scraper').call({"searchUrls": ["https://www.goodfirms.co/directory/country/top-software-development-companies/us"]});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### 🤖 AI Agents, MCP & RAG Integration

This Actor is reachable through the Apify MCP server, so an AI agent can call it as a tool. Point the agent at `https://mcp.apify.com` and ask it something like *"pull the first 200 companies from GoodFirms and summarise them"* — it receives the same structured rows you would get from the UI.

Connect this Actor directly to **Apify AI**, **Claude Desktop**, **Cursor**, **VS Code**, **Windsurf**, **LangChain**, or **LlamaIndex** via the official **Apify MCP Server** — no custom wrapper code needed:

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

- **Schema-typed inputs & outputs:** Clean JSON records with explicit `.actor/input_schema.json` and `.actor/output_schema.json` definitions so LLM agents infer parameters and parse fields accurately without HTML noise.
- **Bounded & predictable runs:** Built-in volume caps and pay-per-result budget guards prevent runaway agent tool loops.
- **RAG & automation ready:** Stream run datasets straight into vector stores, n8n, Make, Zapier, or webhook pipelines.

### FAQ

#### Do I need a GoodFirms account or API key?

No. The Actor reads publicly available pages only. There is nothing to authenticate and no credentials to rotate.

#### Does it work on the free plan?

Yes. Every feature is available on a free Apify account — nothing is gated behind a paid tier. Pricing is per result, and higher plans simply pay less per row.

#### How many companies can I get in one run?

As many as the search exposes. Raise the page and result caps together; the run stops at whichever limit it reaches first.

#### Why did I get fewer rows than I asked for?

The search ran out of records. That is normal for narrow queries — broaden the search or add more searches to one run.

#### Why are some fields empty?

GoodFirms does not publish every attribute for every record. The table above shows how often each field is filled in practice.

#### What export formats are supported?

JSON, CSV, Excel, HTML and RSS from the Output tab, plus the Apify API and any integration you connect.

#### How fast is it?

It is pure HTTP with no browser, so a page of results typically takes a second or two.

#### Can I schedule it?

Yes. Use the Apify scheduler to run it on any interval and append each run to the same dataset.

#### Does it use a proxy?

It routes through Apify Proxy by default. You can switch groups or supply your own proxies in the input.

#### Is the output schema stable?

Yes. Field names and types are fixed, so downstream pipelines will not break between runs.

#### How often is the data refreshed?

Every run reads the live source. There is no cache, so the data is as current as the website itself.

#### What if the site changes its layout?

Open an issue on the Issues tab and it gets fixed — the Actor is actively maintained.

### 💬 Support, Issues & Reviews

- **Bug reports & target-site changes:** Hit an unexpected empty result or selector change? [Open a ticket in the Issues tab](https://apify.com/logiover/goodfirms-scraper/issues) with your **Run ID** or sample input — we actively monitor issues and ship fixes fast.
- **Feature & field requests:** Need an additional data attribute or filter? [Request it in the Issues tab](https://apify.com/logiover/goodfirms-scraper/issues).
- **Enjoying this Actor?** If it saved you engineering time, please consider leaving an honest [review on Apify Store](https://apify.com/logiover/goodfirms-scraper/reviews) or bookmarking [logiover/goodfirms-scraper](https://apify.com/logiover/goodfirms-scraper) — organic developer feedback helps others discover reliable tools and keeps maintenance prioritized.

### Is it legal?

This Actor reads only publicly available pages on GoodFirms — the same content any visitor sees without logging in. It does not bypass authentication and does not collect private data. You remain responsible for how you use the output: respect the source's terms of service, applicable copyright, and data-protection law such as GDPR where personal data is involved.

This Actor is an independent tool. It is not affiliated with, endorsed by, or sponsored by GoodFirms; GoodFirms and all other trademarks mentioned here are the property of their respective owners.

### Related scrapers

Other Actors from the same collection:

- [France Company Registry](https://apify.com/logiover/france-company-registry-scraper)
- [Czech Company Registry](https://apify.com/logiover/czech-company-registry-scraper)
- [Finland Company Registry](https://apify.com/logiover/finland-company-registry-scraper)
- [New York Company Registry](https://apify.com/logiover/usa-new-york-company-registry-scraper)

### How much GoodFirms data can you extract in one run?

A single run returned **1,000 rows** in 85 seconds on the example input, and it was still going when the measurement stopped — raise the result limit and it keeps paginating. That is roughly **705 rows a minute**.

There is no hard ceiling built into this Actor. What bounds a run is the result limit you set, the breadth of the input you give it, and how much GoodFirms itself publishes. Because billing is per result, a wider run costs proportionally more and a narrow one costs almost nothing — so it is worth starting small and scaling once the output looks right.

### 📝 Changelog

#### 2026-11-11

- Added reliable terminal run status telemetry and structured Apify AI / MCP Server (`mcp.apify.com`) tool configuration.
- Added direct Issues & Reviews support links and refreshed live maintenance verification.

#### 2026-11-01

- Monthly health check (2026-11-01): a live run on the current build completed successfully and returned data. Input options, output fields and pricing are unchanged.
- README refreshed: independence disclaimer added.
- README refreshed: duplicate "Related scrapers" sections merged.

#### 2026-10-15

- Every request now has a hard time limit, so a proxy connection that stalls can no longer hold up the run or push it past its timeout.
- A run that reaches its maximum cost per run now stops cleanly with its results saved and a status message, instead of ending as aborted.
- A proxy group your account cannot use no longer stops the run at start-up; it falls back to the default Apify Proxy.
- Memory is managed within the run's own limit, which removes a rare out-of-memory crash on large pages.
- The default used when the field is left out for `maxResults` is now 6,666 (was 200).

#### 2026-09-23

- Fleet-wide quality audit. Verified end to end against live data and re-checked the input schema, the output columns and the run configuration.
- Output verified on a live run: 200 row(s) across 16 columns, 85.8% of cells populated.
- Run reliability reviewed: 100.0% of public runs succeeded in the last 30 days.
- Input schema, output schema and pricing configuration reviewed.
- Noted that 2 column(s) came back empty in this sample (`minProjectSize`, `services`); these are under review.

#### 2026-09-01

- Fleet-wide health check. Verified against this Actor's real run history: 30-day success rate, output row counts, per-field fill rates, and peak memory against the configured memory limit.
- Reviewed for the failure patterns that have cost this fleet runs — unguarded proxy setup, retry loops that can outlast the run's own time budget, and full-page HTML parsing that can exhaust a small container.
- No change to input, output fields or scraping logic.

#### 2026-08-11

- Maintenance release: refreshed the build and dependencies.
- Re-verified live execution, non-empty structured output and dataset field/type integrity.
- Reviewed reliability (retries, pagination) and output quality as part of a full-fleet QA pass.

# Changelog

This Actor's version history is a separate document: https://apify.com/logiover/goodfirms-scraper/changelog.md

# Actor input Schema

## `searchUrls` (type: `array`):

GoodFirms.co listing URLs copied straight from the site — e.g. https://www.goodfirms.co/directory/country/top-software-development-companies/us or any service/category/country/city directory page. Apply your filters on GoodFirms, then paste the resulting URL here. The actor paginates the whole result set with ?page=N.

## `maxResults` (type: `integer`):

Stop after this many companies across all URLs. 0 = no limit (a single directory can span thousands of companies).

## `maxResultsPerSearch` (type: `integer`):

Cap companies collected per individual directory URL. 0 = no per-URL cap.

## `useProxy` (type: `boolean`):

Route requests through Apify Proxy. Residential is recommended and is the default.

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. Residential gives the highest success rate.

## `maxConcurrency` (type: `integer`):

How many directory URLs to process in parallel.

## Actor input object example

```json
{
  "searchUrls": [
    "https://www.goodfirms.co/directory/country/top-software-development-companies/us"
  ],
  "maxResults": 333,
  "maxResultsPerSearch": 0,
  "useProxy": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "maxConcurrency": 3
}
```

# Actor output Schema

## `id` (type: `string`):

GoodFirms entity ID

## `name` (type: `string`):

Company name

## `website` (type: `string`):

Company website (referral params stripped)

## `profileUrl` (type: `string`):

GoodFirms profile URL

## `tagline` (type: `string`):

Short company description

## `hourlyRate` (type: `string`):

Hourly rate band

## `minProjectSize` (type: `string`):

Minimum project size

## `teamSize` (type: `string`):

Employee / team size band

## `foundedYear` (type: `string`):

Year founded

## `location` (type: `string`):

Full location string

## `city` (type: `string`):

City

## `region` (type: `string`):

Region, state or country

## `rating` (type: `string`):

Average rating

## `reviewCount` (type: `string`):

Number of reviews

## `services` (type: `string`):

Listed service focus

## `scrapedAt` (type: `string`):

Scrape timestamp

# 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 = {
    "searchUrls": [
        "https://www.goodfirms.co/directory/country/top-software-development-companies/us"
    ],
    "maxResults": 333
};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/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 = {
    "searchUrls": ["https://www.goodfirms.co/directory/country/top-software-development-companies/us"],
    "maxResults": 333,
}

# Run the Actor and wait for it to finish
run = client.actor("logiover/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 '{
  "searchUrls": [
    "https://www.goodfirms.co/directory/country/top-software-development-companies/us"
  ],
  "maxResults": 333
}' |
apify call logiover/goodfirms-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,logiover/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/B442Flykt3aNIGmxw/builds/XxpOhwJ1XKIVJfB0x/openapi.json