eBird

Website: https://ebird.org/ 
 

Prerequisites

Data Source

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 (e.g., “Gundi Service Account”) for this integration. Please refer to EarthRanger's documentation or contact Support.
  • A long-lived token for authentication assigned to the user created in the previous step. Please refer to EarthRanger's documentation or contact Support.
  • Confirm that the required event type and schema are configured in EarthRanger. 
    • Required event type: ebird_observation
  • Update the EarthRanger user (e.g., “Gundi Service Account”) to give it permission to the event type.
 
 

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. Login to Gundi and 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.
 

Next Steps

EarthRanger

The following configurations are optional:

1. Select the data you want to see in the map.

1.1. Log in to EarthRanger as an admin.
1.2. Go to Source providers.
1.3. Click on Subject Details Configuration.
1.4. Configure the additional information you would like to see on the map.

2. Rename your Subjects.

3. Assign your Subjects to a Subject Group.

Please refer to EarthRanger's documentation or contact Support.

 
 

Movebank

Please visit our guide for adding tags to your Movebank study. 

 
 

Note on Latency

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.

 

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 

 
 

 

Tags: Pull Integration, Events, Data Provider, Sightings
Last Update: Sep 4, 2025