eBird Web Services - Version 1.1

Issues

Issues that we need to deal with before wrapping up 1.1:

• move "valid" and "reviewed" fields to simple output option
• make sci names unique; add "domesticus" to binomial
• consider publishing grouping info along with eBird-1.1-SpeciesReference
• consider making life history zip file from eBird more accessible
• transition 1.0 apis to 1.1 url structure, fields, result formats, etc.

API

This API enhances the originally released eBird 1.0 API

• ebird.org/ws1.1
  This is the root of eBird-specific web services.
  • ws1.1/data
    This path contains data services.
    • ws1.1/data/obs/notable/recent
      This data service provides notable sightings (rare & unusual) on a state or country basis. Records returned are species oriented. (I.e. not checklists)
    • ws1.1/data/hotspot/list
      This data service provides list of eBird hotspots on a state or country basis.
    • Raw Data Services--all of these services return recent sighting information in the results
      • ws1.1/data/obs/geo/recent
        • returns recent nearby observations
      • ws1.1/data/obs/hotspot/recent
        • returns recent observations at hotspots
      • ws1.1/data/notable/geo/recent
        • returns recent nearby notable observations
      • ws1.1/data/obs/geo_spp/recent
        • returns recent nearby observations of a species
      • ws1.1/data/nearest/geo_spp/recent
        • returns nearest locations with observations of a species
  • ws1.1/product
    This path contains products consisting of aggregated raw data.
    • ws1.1/product/byloc/recent
      This data service provides a summary of recent sightings for up to three hotspot locIDs.

This path contains supporting lookup services for the /data and /product services

• • • ws1.1/ref/taxa
• ebird.org/wstools1.1
  This is location of gadget code and demo pages.
• ebird.org/wsresource1.1
  This is the root of the static resources that version 1.1 of the web services require.
  • wsresource1.1/images
  • wsresource1.1/css
  • wsresource1.1/js

Resources

The current eBird taxonomy can be downloaded here.  The following table might be helpful for encoding a scientific name within a URL: