# 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, 7 bookmarks - **User rating**: 5.00 out of 5 stars ## 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 '' with your token const client = new ApifyClient({ 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 '' with your token. client = ApifyClient("") # 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/goodfirms-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GoodFirms Scraper", "description": "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.", "version": "1.0", "x-build-id": "MqfMje7thptTEt9aV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~goodfirms-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-goodfirms-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/crawlerbros~goodfirms-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-goodfirms-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/crawlerbros~goodfirms-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-goodfirms-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "byCategory", "search", "companyProfile" ], "type": "string", "description": "How to scrape GoodFirms listings.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Company name or service keyword to search for.", "default": "web development" }, "categorySlug": { "title": "Category slug (mode=byCategory)", "enum": [ "web-development-agency", "blockchain-development-services", "low-code-no-code" ], "type": "string", "description": "GoodFirms service category slug. Currently supported: web-development-agency, blockchain-development-services, low-code-no-code.", "default": "web-development-agency" }, "companyUrls": { "title": "Company URLs or slugs (mode=companyProfile)", "type": "array", "description": "GoodFirms company profile URLs or slugs (e.g. https://www.goodfirms.co/company/sdlc-corp or just sdlc-corp).", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort results by", "enum": [ "default", "reviews", "rating" ], "type": "string", "description": "Sort order for category/search results.", "default": "default" }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Only include companies with rating at or above this value (1.0–5.0)." }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Only include companies with at least this many reviews." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of company records to return.", "default": 20 } } }, "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 } } } } } } } } } } ```