# CompanyFacts Company Search API

> CompanyFacts Company Search API is a paid API for AI agents from companyfacts.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Search a directory of newly-formed and FDIC-insured companies by name, location, technology, and hiring status, returning firmographic details, website evidence, and contact signals.

## Facts

- Endpoint: GET https://companyfacts.dev/x402/v1/company-search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/companyfacts-company-search-api-607881ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yl-UU7jP4sjElN1rre4RT

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 companyfacts-company-search-api-607881ea
```

Example prompt: Can you find newly formed LLCs in Denver, Colorado that are currently hiring and use Cloudflare? Show me up to 10 results.

## When to prefer this

Use this endpoint when you need structured firmographic data on newly formed US businesses (NY, CO, OR, CT, PA) or FDIC-insured banks, particularly when you want to filter by location, technology stack, hiring status, or formation date. Prefer this over generic business databases when you need direct website evidence linking the domain to the legal entity, or when you need ATS job board data alongside company facts.

## Known failure modes

- No companies match the filter combination — returns empty results array with matched:0
- Invalid query parameter values may return a 400 error
- Rate limiting or payment failure (x402) if USDC payment is not attached
- State abbreviation not recognized — returns no results
- Offset beyond total results returns empty list

## How this service works

Open job postings read first-hand from the applicant-tracking system behind a company's careers page: Greenhouse, Ashby, Lever or Workable. Includes a directory of 8532 company job boards, because none of the vendors publishes one. Salaries are parsed into numbers where the employer publishes them and refused where ambiguous. No personal data.

## Output

Returns a list of matched companies with their legal name, domain, city, state, zip, entity type, formation date, standing status, technologies detected on their website, contact signals (phone, role email, contact page), hiring status, links to related endpoints for contacts and changes, state record URL, and website evidence. Also includes total tracked count, number matched, number returned, and a next_offset for pagination.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "has": {
       "type": "string"
      },
      "city": {
       "type": "string"
      },
      "name": {
       "type": "string"
      },
      "tech": {
       "type": "string"
      },
      "limit": {
       "type": "string"
      },
      "state": {
       "type": "string"
      },
      "hiring": {
       "type": "string"
      },
      "offset": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "formed_since": {
       "type": "string"
      },
      "formed_until": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Tracked companies are newly formed NY, CO, OR, CT and PA businesses whose website we found with proof, and every FDIC-insured bank.",
  "matched": 1,
  "returned": 1,
  "companies": [
   {
    "zip": "80211",
    "city": "Denver",
    "more": {
     "changes": "/v1/company-changes?domain=timberstonehomeworks.com&state=CO&entity_number=20268147148",
     "contacts": "/v1/company-contacts?domain=timberstonehomeworks.com"
    },
    "state": "CO",
    "domain": "timberstonehomeworks.com",
    "hiring": null,
    "source": "state_register",
    "status": "Good Standing",
    "updated": "2026-10-31",
    "website": "https://timberstonehomeworks.com",
    "publishes": {
     "phone": true,
     "role_email": true,
     "contact_page": false
    },
    "source_id": "CO 20268147148",
    "legal_name": "Timberstone Homeworks LLC",
    "verify_url": "https://data.colorado.gov/resource/4ykn-tg5h.json?entityid=20268147148",
    "entity_type": "Limited Liability Company",
    "technologies": [
     "Cloudflare",
     "HSTS"
    ],
    "entity_number": "20268147148",
    "tracked_since": "2026-10-30",
    "formation_date": "2026-09-15",
    "state_record_url": "https://www.sos.state.co.us/biz/BusinessEntityDetail.do?quitButtonDestination=BusinessEntityResults&fileId=20268147148",
    "website_evidence": "timberstonehomeworks.com spells the company name, and https://timberstonehomeworks.com/ shows the legal name 'Timberstone Homeworks LLC' and Denver"
   }
  ],
  "next_offset": null,
  "total_tracked": 412
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/companyfacts-company-search-api-607881ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companyfacts.dev](https://www.zero.xyz/host/companyfacts.dev/llms.txt)