Inaturalist Get Similar Species
inaturalist_get_similar_speciesList related taxa ranked by observations carrying current identifications of both taxa. This is co-identification evidence, not a directional correction count or an exhaustive list of visually similar organisms. Scope it to an area in exactly one form (place_id, the lat/lng/radius triple in kilometres, or a four-corner bounding box), or leave the area off for global results. The taxon must be a genus or finer (genus, species, or below). Resolve the organism name to a taxon id with inaturalist_resolve_name first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"taxon_id": "<taxon_id>"
},
"name": "inaturalist_get_similar_species"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| d1 | No | Earliest observation date, YYYY-MM-DD. Inclusive. Must be on or before d2. | |
| d2 | No | Latest observation date, YYYY-MM-DD. Inclusive. | |
| lat | No | Latitude of the search centre, in decimal degrees. Requires lng and radius. | |
| lng | No | Longitude of the search centre, in decimal degrees. Requires lat and radius. | |
| limit | No | Maximum related taxa to return. Served ceiling: 24; requests above it are reduced to 24. Positive safe integer requests are accepted. | |
| nelat | No | North-east corner latitude of the bounding box, at or north of swlat. All four corners or none. | |
| nelng | No | North-east corner longitude of the bounding box. All four corners or none. West of swlng is accepted: it describes a box crossing the antimeridian. | |
| swlat | No | South-west corner latitude of the bounding box. All four corners or none. | |
| swlng | No | South-west corner longitude of the bounding box. All four corners or none. | |
| radius | No | Search radius around lat/lng, in KILOMETRES, greater than 0. Requires lat and lng. Ceiling: 20040; oversized values are clamped with notice. | |
| captive | No | True returns captive and cultivated records only — zoo animals, garden plantings; false returns wild records only. Defaults to false. Captive records are graded casual, so pair true with "casual" in quality_grade. | |
| place_id | No | Numeric iNaturalist place id from inaturalist_find_places. Mutually exclusive with the lat/lng/radius triple and the bounding box. | |
| taxon_id | Yes | Numeric taxon id to find look-alikes for, at genus or finer — a genus, species, or subspecies; a family or anything coarser is refused. Resolve a name to an id with inaturalist_resolve_name. | |
| quality_grade | No | Identification confidence tiers to include, normalized to unique values in first-appearance order. Defaults to research-grade only; adding "needs_id" roughly doubles the corpus and lowers identification confidence. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit that was applied. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | How many look-alikes this response carries. | |
| notice | No | Guidance when no look-alikes are recorded, or when the limit cut the set. | |
| taxon_id | No | The taxon the look-alikes were found for. | |
| truncated | No | True when the local limit cut the list or upstream reached its ceiling, so more related taxa may exist. | |
| totalCount | No | How many look-alikes upstream returned, before the limit was applied. | |
| similar_species | No | Look-alikes ranked by misidentification_count, most-confused first. | |
| truncationCeiling | No | Misidentification count of the last look-alike shown. The ranking is descending, so no omitted look-alike exceeds it. |