# Company Intelligence API — turn a domain into an enriched company profile: firmographics, reviews, local presence, brand trends, funding signals and tech footprint

> domain → entity-resolved company profile (core groups) with per-field provenance
> ReefAPI engine `enrich-company` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/enrich-company/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /enrich-company/v1/company_domain — 6 credits
domain → entity-resolved company profile (core groups) with per-field provenance

**Parameters:**
- `domain` (string, required) — Company website domain to enrich (bare host like stripe.com; a full URL or leading www. is accepted and normalized).
- `include` (array, optional) — Run ONLY these field groups (cost control). Default: all groups of this action. `entity` + `company` are always computed from whatever ran. [one of: domain, tech, presence, news, developer, hiring, reputation]
- `exclude` (array, optional) — Drop these field groups from this action's default set. [one of: domain, tech, presence, news, developer, hiring, reputation]

**Returns:** entity{input_domain,final_domain,match: exact-domain|redirected|brand-name|fuzzy, confidence, canonical_name, evidence[]}, company{name,name_latin,legal_name,description,logo_hint,phone,site_title — each {value,source,confidence,last_checked}}, domain{whois/dns/ssl/subdomains summary}, tech{technologies[],categories{cms/ecommerce/analytics/framework/cdn_hosting/payments/marketing_automation/chat_support/crm/email_provider}}, presence{search,og,social_links,redirect,website_alive,site_signals{has_contact_page,has_about_page,has_phone,has_quote_cta,has_service_keywords}}, news{articles[]}, developer{github_org,top_repos}, hiring{ats,jobs_count,by_department,sample_jobs}, reputation{trustpilot}; provenance{per-group status+engine+missing_reason: not_found|blocked|timeout|budget|unsupported|error|skipped}; meta.extra.subcalls[] (contributing sources, customer-safe)

**Example request body:**
```json
{
  "domain": "github.com",
  "include": [
    "domain",
    "presence"
  ]
}
```

### POST /enrich-company/v1/company_domain_rich — 14 credits
everything in company_domain + firmographics (LinkedIn/Indeed/Glassdoor), review depth, local/maps match, brand trends, app/package presence, registry funding signals (Wikidata), traffic rank

**Parameters:**
- `domain` (string, required) — Company website domain to enrich (bare host like stripe.com; a full URL or leading www. is accepted and normalized).
- `include` (array, optional) — Run ONLY these field groups (cost control). Default: all groups of this action. `entity` + `company` are always computed from whatever ran. [one of: domain, tech, presence, news, developer, hiring, reputation, trends, apps, funding, traffic]
- `exclude` (array, optional) — Drop these field groups from this action's default set. [one of: domain, tech, presence, news, developer, hiring, reputation, trends, apps, funding, traffic]

**Returns:** company_domain payload + company{industry,founded,employees,headquarters{raw,city,region,country,country_code},revenue_range,specialties,parent,ticker}, hiring.employer{linkedin,indeed,glassdoor}, reputation{trustpilot deep,maps}, trends{}, apps{}, funding{registry(Wikidata),recent_funding_news[],total_raised:null-if-unknown}, traffic{tranco rank+tier — rank not visits}

**Example request body:**
```json
{
  "domain": "github.com"
}
```

### POST /enrich-company/v1/batch — 24 credits
enrich up to 10 domains in one call (core groups, cache-first, per-domain ok/error)

**Parameters:**
- `domains` (array, required) — Up to 10 domains (array or comma-separated). Each is enriched like company_domain; per-domain ok/error, cache-first.
- `include` (array, optional) — Run ONLY these field groups (cost control). Default: all groups of this action. `entity` + `company` are always computed from whatever ran. [one of: domain, tech, presence, news, developer, hiring, reputation]
- `exclude` (array, optional) — Drop these field groups from this action's default set. [one of: domain, tech, presence, news, developer, hiring, reputation]

**Returns:** results[] (one company_domain payload or {ok:false,error} per input), count, ok_count

**Example request body:**
```json
{
  "domains": [
    "d0.example",
    "d1.example",
    "d2.example",
    "d3.example",
    "d4.example",
    "d5.example",
    "d6.example",
    "d7.example",
    "d8.example",
    "d9.example",
    "d10.example"
  ]
}
```

## More
- Try it live, no code: https://reefapi.com/playground?engine=enrich-company
- Human docs page: https://reefapi.com/docs/enrich-company
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt