> For the complete documentation index, see [llms.txt](https://docs.hyper-space.io/hyperspace-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hyper-space.io/hyperspace-docs/api-documentation/dsl-query-framework/scoring-and-ranking/rarity-score-tf-idf.md).

# Rarity Score (TF-IDF)

Term Frequency-Inverse Document Frequency(TF-IDF), is a numerical statistic that reflects the importance of a term within a document in a corpus. It is the default score for matched terms.

**Example:**

{% code lineNumbers="true" %}

```python
{
  "query": {
    "bool": {
      "must": 
        {
          "term": {
            "Color": "Black"
         }
      }
    }
  }
}
```

{% endcode %}

In the above example, matched documents will be assigned with a score based on the TF-IDF formula and will be ranked accordingly.