Similarity and Diff¶

2 endpoints for pairwise text comparison and line-level diffing.

REST API Examples¶

Compare text similarity¶

curl -X POST "https://textanalysis.toolkitapi.io/v1/text/similarity" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text1": "The cat sat on the mat", "text2": "The cat sat on a rug", "method": "cosine"}'

const resp = await fetch("https://textanalysis.toolkitapi.io/v1/text/similarity", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ text1: "Hello world", text2: "Hello earth", method: "cosine" }),
});
const data = await resp.json();
console.log(`Similarity: ${data.score}`);

Python SDK Examples¶

Similarity by method¶

from toolkitapi import TextAnalysis

a = "The release includes search improvements and bug fixes."
b = "This release adds better search and fixes several bugs."

with TextAnalysis(api_key="tk_...") as ta:
    for method in ["levenshtein", "cosine", "jaccard"]:
        result = ta.similarity(a=a, b=b, method=method)
        print(method, result["similarity"])

Unified diff¶

from toolkitapi import TextAnalysis

original = "line one\nline two\nline three\n"
modified = "line one\nline 2\nline three\nline four\n"

with TextAnalysis(api_key="tk_...") as ta:
    diff = ta.diff(a=original, b=modified, context_lines=2)

print(diff["is_identical"])
print(diff["statistics"])
print(diff["unified_diff"])

Request Parameters¶

POST /v1/text/similarity¶

POST /v1/text/diff¶

Response Fields¶

Similarity¶

Diff¶