Text Similarity

Compare two pieces of text and get a similarity score between 0 and 1 using cosine similarity on word-frequency vectors.

Get API Key

Vue d'ensemble

Cas d'utilisation

Duplicate content detection
Plagiarism checking
Search and recommendation relevance scoring
Document clustering and deduplication
FAQ matching and chatbot response selection

Fonctionnalités

Cosine similarity on bag-of-words vectors

Normalised score between 0 (no overlap) and 1 (identical)

Case-insensitive, punctuation-agnostic tokenisation

Fast, in-memory computation — no external ML model required

Points de terminaison de l'API

Compare Text Similarity

Compares two texts and returns a cosine similarity score.

POST

https://requiems.xyz/v1/text/similarity

Paramètres

Nom	Type	Requis	Description
text1	`string`	Requis	The first text to compare.
text2	`string`	Requis	The second text to compare.

Essayez-le

Démo en direct

Requête

text1 * (string)

The first text to compare.

text2 * (string)

The second text to compare.

Champs de réponse

Champ	Type	Description
similarity	`number`	Cosine similarity score between the two texts, in the range [0, 1].
method	`string`	The algorithm used. Currently always 'cosine'.

Exemples de code

curl -X POST https://requiems.xyz/v1/text/similarity \
  -H "requiems-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text1": "The cat sat on the mat", "text2": "A cat was sitting on a mat"}'

import requests

url = "https://requiems.xyz/v1/text/similarity"
headers = {
    "requiems-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "text1": "The cat sat on the mat",
    "text2": "A cat was sitting on a mat"
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()
print(data["data"]["similarity"])
print(data["data"]["method"])

const response = await fetch('https://requiems.xyz/v1/text/similarity', {
  method: 'POST',
  headers: {
    'requiems-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text1: 'The cat sat on the mat',
    text2: 'A cat was sitting on a mat'
  })
});

const data = await response.json();
console.log(data.data.similarity);
console.log(data.data.method);

require 'net/http'
require 'json'

uri = URI('https://requiems.xyz/v1/text/similarity')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
  text1: 'The cat sat on the mat',
  text2: 'A cat was sitting on a mat'
}.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data['data']['similarity']
puts data['data']['method']

Réponses d'erreur

validation_failed

One or both text fields are missing or empty.

bad_request

The request body is missing or malformed.

internal_error

Unexpected server error.

Aucun résultat