# Business Trust API — public trust and reputation signals for any domain or company

> domain‖company_name → entity-resolved PUBLIC trust signals: positive_signals[], risk_signals[], unknowns[] + a respectful heuristic recommendation. NOT KYB/AML.
> ReefAPI engine `enrich-trust` · 2 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/enrich-trust/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-trust/v1/business_trust — 7 credits
domain‖company_name → entity-resolved PUBLIC trust signals: positive_signals[], risk_signals[], unknowns[] + a respectful heuristic recommendation. NOT KYB/AML.

**Parameters:**
- `domain` (string, optional) — Business website domain to assess (bare host like stripe.com; a full URL or leading www. is accepted and normalized). Provide `domain` OR `company_name` — domain gives the strongest signals.
- `company_name` (string, optional) — Business name to assess when you have no domain. Weaker than `domain` (no domain-lifecycle signals); pair with `country` for accurate region-routing and entity confirmation.
- `country` (string, optional) — ISO-3166 alpha-2 country hint (e.g. TR, BR, KR, US). Drives region-routing for reputation sources and suppresses false risks (an absent US-only source is not a risk abroad). Inferred from the ccTLD when omitted.
- `business_type` (enum, optional, default "auto") — Optional hint that tunes which signals matter and prevents false risks (e.g. b2b → no public reviews is expected, never penalized). [one of: auto, local, ecommerce, saas, brand, b2b]
- `depth` (enum, optional, default "basic") — basic = domain/presence/reputation/news core; rich adds region-routed reputation (Yelp/TripAdvisor/ReclameAqui/Naver), store/app presence, brand trends and review depth. [one of: basic, rich]

**Returns:** entity (input, kind: domain|name, match type, confidence, canonical_name, country, evidence[]), positive_signals[] (code, label, evidence, source), risk_signals[] (code, label, evidence, source), unknowns[] (code, label, reason, source — includes a sanctions: not_checked notice), reputation (trustpilot score/reviews, Google Maps rating/reviews, regional sources), domain_signals (age_days, parked, impersonation risk, ssl, dns), recommendation (proceed | review | high_risk | insufficient_data), score_method, disclaimer; meta.subcalls[] listing each contributing source

**Example request body:**
```json
{
  "domain": "stripe.com",
  "depth": "basic"
}
```

### POST /enrich-trust/v1/batch — 24 credits
assess up to 10 domains in one call (core signals, cache-first, per-item ok/error)

**Parameters:**
- `domains` (array, required) — Up to 10 domains (array or comma-separated). Each is assessed like `business_trust`; per-item ok/error, cache-first.
- `country` (string, optional) — ISO-3166 alpha-2 country hint (e.g. TR, BR, KR, US). Drives region-routing for reputation sources and suppresses false risks (an absent US-only source is not a risk abroad). Inferred from the ccTLD when omitted.
- `business_type` (enum, optional, default "auto") — Optional hint that tunes which signals matter and prevents false risks (e.g. b2b → no public reviews is expected, never penalized). [one of: auto, local, ecommerce, saas, brand, b2b]

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

**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-trust
- Human docs page: https://reefapi.com/docs/enrich-trust
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt