Website: https://ebird.org/
Prerequisites
Data Fetch
eBird API Key: Log in to your eBird account and generate an API key from the eBird Keygen page.
Area of Interest: You can define your area of interest in several ways:
- Geographic location: Specify latitude and longitude coordinates.
- eBird Hotspot: Use the unique identifier for a specific eBird Hotspot.
- Region Code: Use the ISO two-letter country code for a broader region.
- Species Code: Specify a specific bird species (may have limited accuracy).
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 are configured in EarthRanger.
- Required event type:
ebird_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 eBird.
3. Enter your eBird API Key. Generate your key here.
4. Set the number of days of data to retrieve.
5. List eBird species codes to filter the query. If left blank, all species will be included.
You can find the species code in the URL of the eBird species profile. Example:

6. Select the language for species information.
7. Choose between:
- Fetching data around a specific location (provide latitude, longitude, and search distance in kilometers).
- Fetching data within a region (enter the Region Code from this list.
8. Choose whether to include unreviewed observations.
9. Select your Organization.
10. Enter a Connection Name (e.g., eBird - Project Name).
11. Click Next.
12. Select a Destination. Refer to our guides for details.
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
Additional Resources
Notes for Support
We suggest consulting the eBird documentation for details on specific functionalities.
- eBird Hotspot FAQ: eBird Hotspot Frequently Asked Questions
- Understanding eBird Regions, Hotspots: Explore Regions and Hotspots in eBird
- Searching for Species Taxonomy: Find Species on eBird
Internal Documentation: https://allenai.atlassian.net/wiki/spaces/ER/pages/30496456711/eBird
Need Help?
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
Last Update: March 17, 2025