---
title: "Plants search"
method: GET
path: "/plant_id/kb/plants/name_search"
tags: ["Plant.id"]
---

# Plants search

`GET /plant_id/kb/plants/name_search`

## Request

- Base URL: `https://agents.kindwise.com`
- URL: `https://agents.kindwise.com/plant_id/kb/plants/name_search`
- Auth: none required

This endpoint is alpha beta testing and **can change**!

Search plant knowledge base by query. Plants are searchable by scientific names, common names (in specified language), synonyms.

Plant name and query are always matched from start of a word., i.e. "Aloe vera" is searchable by "Aloe", "Alo", "Vera", "ver", "Aloe vera"...

## Query parameters

- `q` string
- `limit` string
- `lang` string

## Response `200`

Basic

- PlantIdSearchResults
  - `entities` object[]
    - `access_token` string
    - `entity_name` string
    - `match_length` number
    - `match_position` number
    - `matched_in` string
    - `matched_in_type` string
  - `entities_trimmed` boolean
  - `limit` number

## Other responses

- `429`: Free daily trial limit reached for this client IP (10 queries / rolling 24 hours). The same status is also returned if the upstream Kindwise API is out of credits.

---

[API](https://skmtc.dev/kindwise/apis/kindwise-agent-trial-proxy.md) · [All operations](https://skmtc.dev/kindwise/apis/kindwise-agent-trial-proxy/llms.txt) · [OpenAPI document](https://skmtc.dev/kindwise/apis/kindwise-agent-trial-proxy/revisions/04259e0cd5e2?raw)