Company enrichment

POST /v1/crawl/enrich/company resolves a company domain into a structured profile.

Request fields

Field	Type	Required	Notes
domain	string	yes	Company domain like stripe.com.
domains	array	no	Batch mode for multiple domains.
callback_url	string	no	Receive completion callbacks.

Response model

The route returns an enrichment job envelope:

{
  "job_id": "enj_123",
  "status": "processing",
  "result": {
    "domain": "stripe.com",
    "company_name": "Stripe",
    "pricing_model": "usage-based",
    "tech_stack": ["Ruby", "Go", "React"],
    "leadership": [{ "name": "Patrick Collison", "role": "CEO" }]
  }
}

Enrich one company

curl

```bash curl https://api.faircompany.ai/v1/crawl/enrich/company \ -X POST \ -H "Authorization: Bearer fc_live_xxx" \ -H "Content-Type: application/json" \ -d '{ "domain": "stripe.com", "callback_url": "https://example.com/webhooks/faircrawl" }' ```

TypeScript SDK

```ts const job = await fc.enrich.company({ domain: "stripe.com", callback_url: "https://example.com/webhooks/faircrawl", }); console.log(job.job_id); console.log(job.status); ```

Python SDK

```python job = fc.enrich_company( "stripe.com", callback_url="https://example.com/webhooks/faircrawl", ) print(job.job_id) print(job.status) ```

MCP

```json { "tool": "faircrawl_enrich_company", "arguments": { "domain": "stripe.com" } } ```