ITIS icon

ITIS

Authoritative taxonomic information on plants, animals, fungi, and microbes of North America and the world

Actions9

  • Name Actions
  • Name Usage Actions
  • Name Usage Search Actions
  • Name Usage Suggest Actions
  • Reference Actions
  • Synonym Actions
  • Taxon Actions
  • Tree Actions
  • Vernacular Actions

Vernacular → Get

AI-generated

Overview

This node interacts with the ITIS (Integrated Taxonomic Information System) API to retrieve authoritative taxonomic information. Specifically, for the Vernacular - Get operation, it fetches vernacular (common) names of organisms from the ITIS dataset. This is useful when you want to find common names in various languages or search by partial name queries.

Practical examples include:

  • Retrieving common names of species for display in user interfaces.
  • Searching vernacular names in a specific language using ISO 639-3 codes.
  • Paging through large sets of vernacular names with offset and limit parameters.

Properties

Name Meaning
Additional Fields A collection of optional fields to refine the vernacular name search:
- Query (q) The vernacular name search query string.
- Language The 3-letter ISO 639-3 code specifying the language of the vernacular name to filter results.
- Offset Numeric offset for paging through results (default 0).
- Limit Maximum number of results to return (minimum 1, default 50).

Output

The node outputs an array of JSON objects representing vernacular names matching the search criteria. Each object corresponds to a vernacular name record returned by the ITIS API.

The output JSON structure directly reflects the API response, typically including fields such as the vernacular name, language code, and associated taxonomic identifiers.

No binary data output is produced by this operation.

Dependencies

  • Requires internet access to call the ITIS API at https://api.checklistbank.org/dataset/2144/vernacular.
  • No authentication or API keys are required for this endpoint.
  • Uses standard HTTP GET requests with query parameters based on input properties.

Troubleshooting

  • Empty results: If no vernacular names are returned, verify that the query (q) and language code are correct and exist in the ITIS database.
  • Invalid language code: Ensure the language parameter uses a valid ISO 639-3 three-letter code.
  • Paging issues: If results seem incomplete, adjust the offset and limit parameters appropriately.
  • Network errors: Check internet connectivity and that the ITIS API endpoint is reachable.
  • Unexpected API changes: Since the node relies on an external API, any changes to the ITIS API may affect functionality.

Links and References

Discussion