> For the complete documentation index, see [llms.txt](https://docs.mindplug.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mindplug.io/api/query.md).

# Query Data

### Prerequisites

Requires a user auth token. See the [API Auth](/api/api-setup-text.md) section.

### Querying data - API

This endpoint retrieves the stored data based on the meaning of the query. The endpoins requires:

1. Database name: `db`
2. A collection name: `collection`
3. An text string to search about: `search`
4. optional `count`: the number of matches to return. Defaults to 3
5. optional `metadataFilters`: to further filter data by metadata. Please see subpage

{% code overflow="wrap" lineNumbers="true" %}

```javascript
import mindplug from "@/src/mindplugAPI"; // base instance

mindplug.post("/data/query", {
    db: "walmart",
    collection: "office supplies",
    search: "an eraser with no crumbs",
    count: 1
});
```

{% endcode %}

### Sample Response

Returns a list of matching responses.

```json
{
    "data": [
        {
            "id": "4334eb12-f57d-4b67-8b13-1f62d7cf5791",
            "score": 0.893768728,
            "values": [],
            "metadata": {
                "content": "Premium eraser: an eraser that works on both pen and pencil and leaves no crumbs",
                "lastStock": "June 2023",
                "totalItems": 123
            }
        }
    ]
}
```