% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/herbs.R
\name{search_herbs}
\alias{search_herbs}
\title{Search herbs in the Herb Explorer}
\usage{
search_herbs(
  q = NULL,
  therapeutic_en = NULL,
  therapeutic_cn = NULL,
  family = NULL,
  toxicity = NULL,
  source = NULL,
  flavors = NULL,
  properties = NULL,
  meridians = NULL,
  medicinal_part = NULL,
  page = 1L,
  page_size = 20L,
  all_pages = FALSE
)
}
\arguments{
\item{q}{Optional search query string.}

\item{therapeutic_en}{English therapeutic classification filter (character
vector).}

\item{therapeutic_cn}{Chinese therapeutic classification filter (character
vector).}

\item{family}{Botanical family filter (character vector).}

\item{toxicity}{Toxicity level filter (character vector).}

\item{source}{Data source filter (character vector).}

\item{flavors}{Flavor filter (character vector).}

\item{properties}{Property filter (character vector).}

\item{meridians}{Meridian tropism filter (character vector).}

\item{medicinal_part}{Medicinal part filter (character vector).}

\item{page}{Page number (default 1).}

\item{page_size}{Results per page (default 20, max 200).}

\item{all_pages}{If \code{TRUE}, fetch all pages via auto-pagination.}
}
\value{
A \code{\link[tibble:tibble]{tibble::tibble()}} of herbs with attribute \code{"total"}.
}
\description{
Query the UniTCM Herb Explorer with optional text search and faceted
filters. Multi-value filter parameters accept character vectors and are
collapsed to semicolon-separated strings internally.
}
\examples{
\dontrun{
search_herbs(q = "ginseng")
search_herbs(flavors = c("sweet", "bitter"), page_size = 50)
}
}
