---
title: Best Match Text Search API
slug: best-match-text-search
url: https://apyhub.com/apyhub/service/best-match-text-search
provider: ApyHub
categories: [Developer Tools]
tags: [fuzzy-matching, string-similarity, levenshtein, text-search, autocomplete]
auth: api_key
---

# Best Match Text Search API

Ranks candidate strings against a source string and returns matches with Levenshtein distance. Useful for typo correction, deduplication, and closest-match lookup.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `` | What it does Ranks the provided candidate strings against a source string and returns the matches o… | 25 |

## About

## What it does
Text Match Ranking compares a source string against a list of candidate strings and returns them ordered by Levenshtein distance. Send a `source`, a `candidates` array, and an optional `limit`; get back a `data` array of matches with their `distance` values.

Use it when you need to find the closest spelling, product name, or user-entered value without building your own fuzzy matching logic. The response is straightforward: each item includes the matched string and its edit distance from the source, so you can rank, filter, or display the best options in your app.

Because the service works on plain strings, it fits deduplication workflows, search suggestions, typo correction, and lightweight record linking. If you are normalizing incoming text or comparing one value against a short candidate list, Text Match Ranking gives you the nearest matches in a format that is easy to sort and consume.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/best-match-text-search