Entity Resolution API — API reference

Splink + LLM hybrid entity resolution. Map varied surface forms ("Samsung Elec", "삼성전자") to one canonical entity, with multilingual and abbreviation handling. API-first, no self-hosting.

Base URL

https://api.hannune.ai/entity-resolution/v1

Authentication

All requests require an API key as a Bearer token. Create a key in your dashboard.

Authorization: Bearer erk_live_xxxxxxxxxxxxxxxx

Resolve one entity

POST /match — resolve a single surface form to a canonical entity. Counts as one match against your monthly quota when a match is found.

curl -X POST https://api.hannune.ai/entity-resolution/v1/match \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_name": "Samsung Elec",
    "entity_type": "organization"
  }'

Response

{
  "tier": "free",
  "match_found": true,
  "resolved_entity": "Samsung Electronics",
  "resolved_id": "company_samsung_electronics",
  "match_type": "exact_alias",
  "confidence": 1.0,
  "normalized_name": "samsung elec",
  "candidate_pool": 13371
}

Optional fields: context (a short string to help disambiguation) and registry_id (to match against a custom registry instead of the default).

Check usage

GET /usage — current month usage and limits for your key.

curl https://api.hannune.ai/entity-resolution/v1/usage -H "Authorization: Bearer $API_KEY"

{
  "tier": "free",
  "month": "2026-06",
  "matches_used": 12,
  "matches_limit": 1000,
  "requests_this_month": 20,
  "rate_per_min": 10
}

Plans & limits

Errors

• 401 — missing or invalid API key.
• 402 — monthly quota exceeded. Upgrade your plan to continue.
• 429 — rate limit exceeded. Retry after a short delay.