# Search within a dataset

![Search by metadata attributes and label content](/files/-Mdv0qiZhNdE4XmZK5dq)

## Search syntax

To search by sample name, just type the full or partial name of a sample.

To search by metadata attribute, use the `key:value` syntax.

To search by number of objects of a category in a labelset, use the `labelset.category:=value` syntax, or  `labelset.total_count:=value` to search by total number of objects.

To search by labeler and reviewer of a sample, use the `labeled-by:username` or `reviewed-by:username` syntax.

For string values, use the `:` operator. For numeric values, use the operators `:=`,`:>`, `:>=`, `:<` and `:<=` to search for values that are equal to, greater than, greater than or equal to, less than, and less than or equal to another value. For list values, use the `:|` operator to search for a value contained in the list.

Queries can be combined by separating them with a space. They will be ANDed together.

## Examples

| Examples                                                                                                                                                                                                                                              |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **image\_grayscale** matches samples with the word "image\_grayscale" in their name.                                                                                                                                                                  |
| **city:london** matches samples with a metadata attribute "city" set to "london".                                                                                                                                                                     |
| **vehicle\_id:>3** matches samples with a metadata attribute "vehicle\_id" set to a value larger than 3.                                                                                                                                              |
| **ground-truth.car:>=5** matches samples where the "ground-truth" label contains 5 or more "car" objects.                                                                                                                                             |
| **my-predictions.car:<5** matches samples where the "my-predictions" label contains less than 5 "car" objects.                                                                                                                                        |
| **my-predictions.total\_count:<=20** matches samples where the "my-predictions" label contains 20 or fewer objects in total.                                                                                                                          |
| **city:london ground-truth.car:>0 my-predictions.car:=0** matches samples where metadata attribute "city" is set to "london" AND the "ground-truth" label contains more than 0 "car" objects AND the "my-predictions" label contains 0 "car" objects. |
| **tags:\|red** matches samples where metadata attribute "tags" is a list of values \["red", "green", "blue"].                                                                                                                                         |
| **labeled-by:jane** matches samples labeled by the user with username jane.                                                                                                                                                                           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.segments.ai/guides/search-functionality.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.