# GoodFirms Company Directory Scraper

> GoodFirms Company Directory Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-02).

Scrapes structured company listings from GoodFirms directory pages, optionally including full profile details like tagline and focus areas.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/goodfirms?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/goodfirms-company-directory-scraper-d2155081
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r6PPawz4zNu4sJFIP_OWP

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-company-directory-scraper-d2155081 -d '<json body>'
```

Example prompt: Pull up to 200 companies from the GoodFirms mobile app development directory at https://www.goodfirms.co/directory/category/mobile-app-development, and include their full profiles with taglines and focus areas.

## When to prefer this

Use this endpoint when you need structured, bulk company data from GoodFirms directory pages — especially for lead generation, competitive research, or building agency databases. Prefer it over manual browsing or generic web scrapers when you want clean, schema-consistent output with optional profile enrichment and pay-per-success pricing.

## Known failure modes

- Invalid or inaccessible GoodFirms URL returns empty result set and no charge
- GoodFirms rate limiting or blocking causes partial or empty collection
- maxItems set to 0 with a very large directory may result in a very slow or timed-out response
- URL pointing to a non-directory GoodFirms page returns no items

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of collected companies and an array of items, each with fields including company name, website, logo URL, entity ID, source page, and (if profiles enabled) tagline and focus areas.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 100,
   "maximum": 5000,
   "minimum": 0,
   "description": "Maximum number of unique companies to save across directory pages. Set to 0 to follow every available page."
  },
  "searchUrl": {
   "type": "string",
   "description": "Full public GoodFirms company directory URL, including any category or location filters."
  },
  "includeProfiles": {
   "type": "boolean",
   "default": true,
   "description": "Visit each public company profile for tagline, focus areas, and visible portfolio count. Turning this off makes collection faster."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "logoAlt": null,
    "logoUrl": null,
    "entityId": null,
    "searchUrl": null,
    "entityName": null,
    "sourcePage": null,
    "companyName": null,
    "companyWebsite": null
   }
  ],
  "product": "goodfirms"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/goodfirms-company-directory-scraper-d2155081/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)