---
title: "Execute semantic-similarity evaluator"
method: POST
path: "/v2/evaluators/semantic-similarity/execute"
tags: ["evaluators"]
---

# Execute semantic-similarity evaluator

`POST /v2/evaluators/semantic-similarity/execute`

Calculate semantic similarity between completion and reference

**Request Body:**
- `input.completion` (string, required): The completion text to compare
- `input.reference` (string, required): The reference text to compare against

## Request body

- RequestSemanticSimilarityRequest
  - `input` RequestSemanticSimilarityInput, required
    - `completion` string, required
    - `reference` string, required

## Response `200`

OK

- ResponseSemanticSimilarityResponse
  - `similarity_score` number

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/traceloop/apis/traceloop-api.md) · [All operations](https://skmtc.net/traceloop/apis/traceloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traceloop/traceloop-api/versions/9c12a04a5947/schema)