matching

Find duplicate clusters in a list of strings

Cluster a list of strings by fuzzy similarity. Returns groups of likely duplicates with scores. Useful for data cleaning: 'which of these entity names are probably the same thing?' Tip: for organization or facility names, run /v1/names/org-name/clean on the inputs first so casing and punctuation don't depress scores. This is raw fuzzy string matching, not semantic — heavy abbreviations ('Univ' vs 'University', 'SLU') may still not match; lower the threshold or pre-expand abbreviations for those. Billing: 1 cost unit per item in the list, like every batch endpoint (e.g. 1,000 items = 1,000 units). The response's meta.cost_units shows the exact charge.

post/v1/matching/deduplicate

Request

  • Base URL: https://api.snipget.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.snipget.ai/v1/matching/deduplicate
  • Auth: none declared

Query parameters

include_receiptboolean

Set true to attach an execution receipt at meta.receipt — caller-verifiable sha256 hashes over the RFC 8785 (JCS) canonicalization of this call's as-received JSON body and its result (free, like include_trace). Reproduce with any JCS library: input_hash = sha256(jcs({"tool": <request path>, "args": <your body minus include_trace/include_receipt>})); result_hash = sha256(jcs(result)). For deterministic tools, same input on the same build reproduces result_hash.

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

itemsstring[] required

List of strings to deduplicate.

strategystring

Similarity strategy: ratio (character-level), partial_ratio (best substring), token_sort_ratio (ignores word order), token_set_ratio (ignores order + duplicates, default).

thresholdnumber

Similarity threshold for clustering (0.0–1.0).

include_traceboolean

Response

Successful Response

statusstring
confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.