% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/fetch.R
\name{get_taxonomicon_id}
\alias{get_taxonomicon_id}
\title{Find the Taxonomicon ID for a taxon name}
\usage{
get_taxonomicon_id(taxon, verbose = FALSE)
}
\arguments{
\item{taxon}{A character string giving the taxon name to search for.
Typically a genus name (e.g., \code{"Tyrannosaurus"}) but species and higher
ranks are also supported.}

\item{verbose}{Logical. If \code{TRUE}, prints status messages during retrieval.
Default is \code{FALSE}.}
}
\value{
A character string containing the Taxonomicon numeric ID, or \code{NULL}
if the taxon is not found.
}
\description{
Queries The Taxonomicon (taxonomy.nl) to retrieve the internal numeric
identifier for a given taxon name. The search filters out non-biological
entities such as astronomical objects that may share the same name.
}
\details{
The function queries the static search endpoint at
\code{taxonomicon.taxonomy.nl/TaxonList.aspx} and parses the resulting HTML
to extract the taxon ID from the hierarchy link. When multiple matches
exist (e.g., a genus name shared with an astronomical object), biological
entries are prioritised by filtering for entries annotated as dinosaur,
reptile, archosaur, animal, plant, fungus, or bacterium.
}
\examples{
\donttest{
get_taxonomicon_id("Tyrannosaurus")   # returns "50841"
get_taxonomicon_id("Homo")
get_taxonomicon_id("Quercus")
}
}
\seealso{
\code{\link[=get_lineage]{get_lineage()}}, \code{\link[=taxo_distance]{taxo_distance()}}
}
