Website: https://www.inaturalist.org/
Prerequisites
Data Fetch
To integrate iNaturalist with Gundi, you will need either:
- iNaturalist Taxa IDs
- iNaturalist Project IDs
Identifying the Project ID
The Project ID can be either a numeric value or a slug. You can find the slug by:
Navigating to the desired project on iNaturalist.
Copying the identifier from the site URL.
Example: https://www.inaturalist.org/projects/example-project

Another method is appending .json to the project URL and searching for the slug value.
Example: https://www.inaturalist.org/projects/example-project.json

Identifying the Taxon ID
The Taxon ID is a numeric value found in the site URL when viewing a taxon page.
Example: https://www.inaturalist.org/taxa/47686
-Protozoa

Alternatively, you can append .json to the taxon URL and search for the numeric ID.
Example: https://www.inaturalist.org/taxa/47686-Protozoa.json

Data Delivery
EarthRanger
To send data to EarthRanger, you will need:
- A special EarthRanger user with permissions to post event data.
- A long-lived token for authentication assigned to the user created in the previous step.
- Confirm that the required event type and schema is configured in EarthRanger.
- Required event type:
inat_observation
- Required event type:
Please refer to EarthRanger's documentation or contact Support.
Smart Connect
To send data to SMART:
- Ensure that the necessary categories and attributes are set up in your SMART CA data model before proceeding.
Configuration in Gundi
1. Click Create Connection.
2. Select iNaturalist.
3. Click Add Item to enter a Taxa ID or Project ID.
4. Apply any optional filters (these will be in addition to any filters already applied in iNaturalist).
Quality Grade
If specified, only observations with the selected quality grades will be included. As of November 2024, valid values are:
casual
needs_id
research
Annotations
Map of annotation terms and the values which to include.
Format
{"TermID": ["TermValue"], "TermID": ["TermValue", "TermValue",…]}
Multiple term values are treated as ORS, while multiple term IDs are treaded as ANDS.
Example
{"1": ["2"], "22": ["24", "25"]}
This will include observations where:
Life Stage is Adult (ID 1, Value 2) AND
Evidence of Presence is Organism (22, Value 24) OR Scat (22, Value 25).
Reference Guide |
---|
Term ID 1: Life Stage (2=Adult, 3=Teneral, 4=Pupa, 5=Nymph, 6=Larva, 7=Egg, 8=Juvenile, 16=SubimagoBody) |
Term ID 9: Sex (10=Female, 11=Male) |
Term ID 12: Plant Phenology (13=Flowering, 14=Fruiting, 15=Flower Budding, 21=No Evidence of Flowering) |
Term ID 17: Alive or Dead (18=Alive, 19=Dead, 20=Cannot Be Determined) |
Term ID 22: Evidence of Presence (23=Feather, 24=Organism, 25=Scat, 26=Track, 27=Bone, 28=Molt, 29=Gall, 30=Egg, 31=Hair, 32=Leafmine, 35=Construction) |
Bounding box
Specify a bounding box for the search area in the format:
[ne_latitude, ne_longitude, sw_latitude, sw_longitude]
5. Enter the event type ID to use in EarthRanger.
6. Configure a string prefix for observed species when creating events.
7. Configure the number of days of data to load from iNaturalist on the connection's first run.
8. Specify whether to include photos from iNaturalist observations.
9. Select your Organization.
10. Enter a name for this Connection (e.g., “iNaturalist - AccountName”)
11. Click Next
12. Select a Destination. Please consult our guides.
Data Delivery
The time it takes for data to appear in your destination system depends on several factors, such as latency introduced by the source, network conditions, and intermediary systems. While these factors may vary, Gundi typically checks for available data at scheduled intervals (approximately every 10 minutes).
If data is not available in your system after this interval, please check the source of the data for its availability. If the issue persists, contact our Support team for assistance.
Screenshots



Contact Support
If you need help with Gundi, here are some resources to try.
Contact the Gundi team
Send an email to support@earthranger.com with your questions or a description of the issue you have been experiencing.
Help Us Improve Gundi
If you have comments, corrections or suggestions regarding our guides, website, or the Gundi portal, please contact us. Feel free to explore our website for more contact information.
Tags: Pull Integration, Events, Data Provider, Sightings, Events
Last Update: March 12, 2025