eBird

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

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.

 

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

 

Was this article helpful?