docs / enrich-trust

Business Trust API

base /enrich-trust/v12 endpoints

post/enrich-trust/v1/business_trust7 credits

domain‖company_name → entity-resolved PUBLIC trust signals: positive_signals[], risk_signals[], unknowns[] + a respectful heuristic recommendation. NOT KYB/AML.

Parameter		Allowed / range	Description
domain	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	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	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 = auto	optional	auto · local · ecommerce · saas · brand · b2b	Optional hint that tunes which signals matter and prevents false risks (e.g. b2b → no public reviews is expected, never penalized).
depth = basic	optional	basic · rich	basic = domain/presence/reputation/news core; rich adds region-routed reputation (Yelp/TripAdvisor/ReclameAqui/Naver), store/app presence, brand trends and review depth.

Try in playground →

post/enrich-trust/v1/batch24 credits

assess up to 10 domains in one call (core signals, cache-first, per-item ok/error)

Parameter		Allowed / range	Description
domains	required	—	Up to 10 domains (array or comma-separated). Each is assessed like `business_trust`; per-item ok/error, cache-first.
country	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 = auto	optional	auto · local · ecommerce · saas · brand · b2b	Optional hint that tunes which signals matter and prevents false risks (e.g. b2b → no public reviews is expected, never penalized).

Try in playground →

Example request · business_trust

curl -X POST https://api.reefapi.com/enrich-trust/v1/business_trust \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"domain":"stripe.com","depth":"basic"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}