GoodFirms API

Pull GoodFirms directories, company profiles and verified client reviews as clean JSON.

The API.SH GoodFirms API turns the public GoodFirms B2B review platform into structured JSON. List every service directory, then pull the providers in a directory (software, web, app, AI, marketing, design, IT and more) by country, with the site's hourly-rate, team-size, client-type, service and industry filters. Open a company for its rating breakdown, hourly rate, team size, founding year, services, clients, portfolio and offices, and page through its verified client reviews.

Get a free API key Try it in the playground

4 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

GoodFirms company profile

GET https://api.api.sh/goodfirms/v1/company

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the GoodFirms API

B2B lead generation

Pull the agencies in a directory and country, filtered by hourly rate and team size, with websites and locations, to build an outreach list.

/directory /categories

Vendor shortlisting

Compare candidate agencies on rating, review count, hourly rate, team size and services before you send a brief.

/company /directory

Review analysis

Read a company's verified reviews with per-aspect ratings for quality, schedule and communication, what clients liked and what could improve.

/reviews

Agency market research

Map pricing and team sizes across service directories and countries to see how rates differ by market.

/categories /directory

Competitor tracking for agencies

Monitor competitors' profiles, badges, ratings and new reviews over time.

/company /reviews

GoodFirms data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

GoodFirms API endpoints and prices

Every GoodFirms endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Profiles and accounts2

GoodFirms company profile /goodfirms/v1/company	$1 · $2 PAYG 1 credit
GoodFirms company reviews /goodfirms/v1/reviews	$1 · $2 PAYG 1 credit

More data2

GoodFirms directory list /goodfirms/v1/categories	$1 · $2 PAYG 1 credit
GoodFirms directory /goodfirms/v1/directory	$1 · $2 PAYG 1 credit

Call the GoodFirms API

GoodFirms company profile: GET https://api.api.sh/goodfirms/v1/company

curl "https://api.api.sh/goodfirms/v1/company?url=https%3A%2F%2Fwww.goodfirms.co%2Fcompany%2Fgeeks-ltd" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/goodfirms/v1/company",
    params={"url": "https://www.goodfirms.co/company/geeks-ltd"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/goodfirms/v1/company");
url.searchParams.set("url", "https://www.goodfirms.co/company/geeks-ltd");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/goodfirms/v1/company", "url", "https://www.goodfirms.co/company/geeks-ltd")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "GoodFirms" and "GoodFirms company profile".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for GoodFirms data

Public data only: no GoodFirms login, cookies or account needed
One key and one response shape for GoodFirms and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official GoodFirms API

GoodFirms does not offer a public API for its directories or reviews. API.SH returns the public profiles, directories and reviews as JSON with one key.

Instead of comparing GoodFirms scrapers on Apify or building your own, use API.SH: one key, the directory's own filters and a fixed price per call.

GoodFirms API questions

What GoodFirms data can I get?+

The list of service directories (/goodfirms/v1/categories), the providers in a directory with filters (/goodfirms/v1/directory), a company profile with ratings, rates, services, clients and offices (/goodfirms/v1/company) and its verified client reviews (/goodfirms/v1/reviews).

How much does the GoodFirms API cost?+

Every GoodFirms endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /goodfirms/v1/categories at 1 credit each.

Is there an official GoodFirms API?+

No public one. API.SH reads the public GoodFirms website and returns its directories, profiles and reviews as JSON.

Do I need a GoodFirms account or login?+

No. API.SH reads public GoodFirms pages only. No endpoint uses a login or anyone's account.

Can I filter agencies by hourly rate and team size?+

Yes. /goodfirms/v1/directory takes the site's hourly-rate, team-size, client-type, service and industry filters, optionally by country, and returns the filter ids you can use.

Does the API return reviewer names or emails?+

No. Reviews include the reviewer's role and company, never their name or contact details. Company profiles include the office addresses and phone numbers the company publishes.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /goodfirms/v1/categories to pick a directory, then /goodfirms/v1/directory with that category and a country. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.