# GoodFirms IT Company Rankings & Dossiers

> GoodFirms IT Company Rankings & Dossiers is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns ranked lists of IT service companies from GoodFirms (by category and/or country) or a full dossier for a single company by its GoodFirms slug.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/goodfirms-companies?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/goodfirms-it-company-rankings-dossiers-45578609
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wYiBqNQ86KxBwlc9AdvOc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability goodfirms-it-company-rankings-dossiers-45578609
```

Example prompt: Show me the top 10 software development companies in the UK from GoodFirms — I need their names, hourly rates, ratings, and a recent client review for each.

## When to prefer this

Choose this endpoint when you need ranked, structured IT service company data sourced from GoodFirms — including hourly rates, client ratings, and recent reviews — either as a category leaderboard (with optional country filter) or as a detailed company dossier. Prefer this over generic web search when you need clean, structured vendor data with contact info and review summaries for software development, web design, digital marketing, or app development firms.

## Known failure modes

- Invalid category value returns empty results or error
- Invalid country code returns empty results
- Unknown company slug returns 404 or empty dossier
- Limit out of range (>48 or <1) may be clamped or return an error
- Rate limiting from upstream GoodFirms may cause stale or partial data
- Network timeout from Cloudflare Worker if GoodFirms is slow

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

In list mode: an array of ranked companies with name, rank, slug, phone, location, hourly rate band, GoodFirms URL, rating (value + review count), and a recent review (date, text, author, rating). In dossier mode: a single company object with founding year, website, offices, sales contacts, services list, rating, and recent reviews. Also includes source URL, category, country filter, and timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Companies in list mode, 1 to 48 (default 20)"
      },
      "company": {
       "type": "string",
       "description": "GoodFirms company slug for a dossier, e.g. eleks (from www.goodfirms.co/company/<slug>)"
      },
      "country": {
       "type": "string",
       "description": "Software development only: ae, au, ca, de, fr, gb, in, us, eg, sa"
      },
      "category": {
       "type": "string",
       "description": "List mode: software-development, web-design, digital-marketing, app-development (default software-development)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 5,
  "source": "https://www.goodfirms.co/directory/country/top-software-development-companies/gb",
  "country": "gb",
  "category": "software-development",
  "checkedAt": "2026-10-23T09:37:31.219Z",
  "companies": [
   {
    "name": "ELEKS",
    "rank": 1,
    "slug": "eleks",
    "phone": "012345678",
    "rating": {
     "value": 5,
     "reviews": 13
    },
    "location": {
     "city": "London",
     "region": "England",
     "street": "Moor Place, 1 Fore Street Avenue",
     "country": "GB",
     "postalCode": "00000"
    },
    "hourlyRate": "$25 - $49",
    "goodfirmsUrl": "https://www.goodfirms.co/company/eleks",
    "recentReview": {
     "date": "2026-05-25",
     "text": "ELEKS played a critical role in helping us achieve a smooth and successful IT infrastructure transition.",
     "title": null,
     "author": "Fulcran Perier",
     "rating": 5
    }
   },
   {
    "name": "Instinctools",
    "rank": 2,
    "slug": "instinctools",
    "phone": "012345678",
    "rating": {
     "value": 4.9,
     "reviews": 27
    },
    "location": {
     "city": "London",
     "region": "England",
     "street": "GB",
     "country": "GB",
     "postalCode": "00000"
    },
    "hourlyRate": "$25 - $49",
    "goodfirmsUrl": "https://www.goodfirms.co/company/instinctools",
    "recentReview": {
     "date": "2023-10-25",
     "text": "The team delivers on time and within budget, proactively asking how to help the client and providing new ideas.",
     "title": null,
     "author": "Sebastian Belle",
     "rating": 5
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/goodfirms-it-company-rankings-dossiers-45578609/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)