{"ok":true,"site":"inaturalist","host":"inaturalist.org","about":"iNaturalist, a citizen-science biodiversity platform. This CLI searches and reads observations, taxa, places, projects and users through iNaturalist's documented public read-only API (api.inaturalist.org/v1), which the iNaturalist web app itself calls.","commands":[{"command":"search-observations","summary":"Search wildlife observations by text, taxon, place, user, quality grade and date range, with sorting and pagination","params":[{"name":"q","type":"string","description":"Free-text search, matched against taxon names, descriptions and place names"},{"name":"taxon_id","type":"string","description":"Restrict to this taxon and its descendants. Takes a numeric taxon id, or several ids separated by commas."},{"name":"place_id","type":"string","description":"Restrict to a place. Takes a numeric place id (find ids with search-places)."},{"name":"user_id","type":"string","description":"Restrict to one observer, given as a user login or numeric id"},{"name":"project_id","type":"string","description":"Restrict to a project, given as a project id or slug"},{"name":"quality_grade","type":"string","description":"Data quality grade","oneOf":["research","needs_id","casual"]},{"name":"iconic_taxa","type":"string","description":"Broad group. Comma-separated values from: Plantae, Aves, Insecta, Mammalia, Reptilia, Amphibia, Actinopterygii, Mollusca, Arachnida, Fungi, Protozoa, Chromista, Animalia"},{"name":"d1","type":"string","description":"Observed on or after this date (ISO, e.g. 2024-01-31)"},{"name":"d2","type":"string","description":"Observed on or before this date (ISO, e.g. 2024-12-31)"},{"name":"photos","type":"boolean","description":"Only return observations that have photos"},{"name":"order_by","type":"string","description":"Sort field","oneOf":["created_at","observed_on","id","votes","species_guess","random"],"default":"created_at"},{"name":"order","type":"string","description":"Sort direction","oneOf":["desc","asc"],"default":"desc"},{"name":"per_page","type":"number","description":"Results per page (max 200)","default":30},{"name":"page","type":"number","description":"Page number, starting at 1","default":1}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/search-observations?q=oak&taxon_id=47851&place_id=14&user_id=kueda"},{"command":"get-observation","summary":"Get full details of one observation by its numeric id: taxon, photos, location, identifications and observer","params":[{"name":"id","type":"string","required":true,"description":"Numeric observation id (the id field from search-observations)"}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/get-observation"},{"command":"list-species-counts","summary":"Count observed species (leaf taxa) matching observation filters, e.g. the most-observed species in a place","params":[{"name":"place_id","type":"string","description":"Numeric place id"},{"name":"taxon_id","type":"string","description":"Restrict to descendants of this taxon id"},{"name":"user_id","type":"string","description":"Restrict to one observer, given as a login or id"},{"name":"project_id","type":"string","description":"Restrict to a project, given as an id or slug"},{"name":"quality_grade","type":"string","description":"Data quality grade","oneOf":["research","needs_id","casual"]},{"name":"d1","type":"string","description":"Observed on or after this date (ISO date)"},{"name":"d2","type":"string","description":"Observed on or before this date (ISO date)"},{"name":"per_page","type":"number","description":"Results per page (max 500)","default":30},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/list-species-counts?place_id=14"},{"command":"list-top-observers","summary":"List the users with the most observations that match the given filters (taxon, place, project)","params":[{"name":"taxon_id","type":"string","description":"Restrict to descendants of this taxon id"},{"name":"place_id","type":"string","description":"Numeric place id"},{"name":"project_id","type":"string","description":"Project id or slug"},{"name":"quality_grade","type":"string","description":"Data quality grade","oneOf":["research","needs_id","casual"]},{"name":"per_page","type":"number","description":"Results per page","default":30},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/list-top-observers?taxon_id=47851"},{"command":"search-taxa","summary":"Search taxa (species, genera, families and so on) by scientific or common name, optionally filtered by rank","params":[{"name":"q","type":"string","required":true,"description":"Scientific or common name to search for"},{"name":"rank","type":"string","description":"Taxonomic rank filter","oneOf":["kingdom","phylum","class","order","family","genus","species","subspecies","variety"]},{"name":"is_active","type":"boolean","description":"Only return currently accepted (active) taxa","default":true},{"name":"per_page","type":"number","description":"Results per page","default":30},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/search-taxa?q=oak"},{"command":"get-taxon","summary":"Get details of a taxon by numeric id: name, rank, ancestry, common name, conservation status and Wikipedia summary","params":[{"name":"id","type":"string","required":true,"description":"Numeric taxon id, e.g. 47851 (Quercus, the oaks). Several ids can be given separated by commas."}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/get-taxon"},{"command":"search-places","summary":"Find places (countries, states, parks and so on) by name to get the place_id that the observation filters use","params":[{"name":"q","type":"string","required":true,"description":"Place name"},{"name":"per_page","type":"number","description":"Max results","default":10}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/search-places?q=California"},{"command":"search-projects","summary":"Search iNaturalist projects (bioblitzes, collections, umbrella projects) by name","params":[{"name":"q","type":"string","required":true,"description":"Project name or keywords"},{"name":"place_id","type":"string","description":"Only projects associated with this place id"},{"name":"per_page","type":"number","description":"Results per page","default":30},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/search-projects?q=bioblitz"},{"command":"get-user","summary":"Get a user's public profile (login, name, observation and species counts) by login or numeric id","params":[{"name":"id","type":"string","required":true,"description":"User login or numeric user id"}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/get-user"},{"command":"list-identifications","summary":"List identifications (species IDs that users added to observations), filterable by taxon, identifier and whether they are current","params":[{"name":"taxon_id","type":"string","description":"Identified taxon id (descendants are included)"},{"name":"user_id","type":"string","description":"Identifier's login or user id"},{"name":"observation_id","type":"string","description":"Only identifications on this observation id"},{"name":"current","type":"boolean","description":"Only identifications that are each user's current ID","default":true},{"name":"per_page","type":"number","description":"Results per page","default":30},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/inaturalist/list-identifications?taxon_id=47851"}]}