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

...

Data Source

...

Version

...

Status

...

eBird

...

1.1

...

NOTE: Please migrate to  Version 2.0 of the APIs. These 1.1 APIs are no longer available

Endpoints

• ebird.org/ws1.1
  This is the root of version 1.1. of eBird-specific web services.
  • ws1.1/data
    This path contains data services.
    • ws1.1/data/obs/notablegeo/recent
      returns recent
      This data service provides notable sightings (rare & unusual) on a state or country basis. Records returned are species oriented. (I.e. not checklists)nearby observations
    • ws1.1/data/obs/geo_spp/recent
      returns recent nearby observations of a species
    • ws1.1/data/obs/hotspot/recent
      returns recent observations at hotspots
    • ws1.1/data/obs/hotspot_spp/recent
      returns recent observations of a species at hotspots
    • ws1.1/data/obs/loc/recent
      returns recent observations at locations
    • ws1.1/data/hotspot/list
      This data service provides list of eBird hotspots on a state or country basis.Raw Data Services--all of obs/loc_spp/recent
      returns recent observations of a species at locations
    • ws1.1/data/obs/region/recent
      returns recent observations in a region these services return recent sighting information in the results
    • ws1.1/data/obs/region_spp/recent
      returns recent observations of a species in a region
    • ws1.1/data/notable/geo/recent
      returns recent nearby notable observations
    • ws1.1/data/obsnotable/hotspot/recent
      returns recent notable observations at hotspots
    • ws1.1/data/notable/geoloc/recent
      returns recent nearby notable observations at locations
    • ws1.1/data/obsnotable/geo_sppregion/recent
      returns recent nearby notable observations of in a speciesregion
    • 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/bylocobs/hotspot/recent
      This data service provides a summary of recent sightings for up to three hotspot locIDs.Life List Services birding hotspots.
  • ws1.1/ref
    This path contains supporting lookup services for the /data and /product services
    product/lifelist/life
    • ws1.1/product/lifelist/yearref/taxa
      returns species in the ebird taxonomy
    • ws1.1/productref/lifelist/monthhotspot/region
      provides a list of eBird hotspots for a given region, optionally filtered to those with recent data
    • ws1.1/ref
    
    This path contains supporting lookup services for the /data and /product services
    • /hotspot/geo
      provides a list of nearby eBird hotspots, optionally filtered to those with recent data
    • ws1.1/ref/taxalocation
      returns location-based look-up data
  • ebird.org/wstools1.1
    This is location of gadget code and demo pages.
  • ebird.org/tools/google
    This is location of original gadget code and demo pages.
    • ebird.org/tools/google/notable-birds.xml
      This is location of gadget code for notable birds by state within the US.
    • ebird.org/tools/google/notable-birds-canada.xml
      This is location of gadget code for notable birds by province/territory within the Canada
  • 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:

...

Character

...

Encoding

...

Space

...

%20

...

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="0f523331-a134-4b45-9714-776045d2e20b"><ac:plain-text-body><![CDATA[

...

Left Square Bracket ("[")

...

%5B

...

]]></ac:plain-text-body></ac:structured-macro>

...

Right Square Bracket ("]")

...

%5D

Making Sense of Endpoint URLs

There is a rational behind the URLs we use for endpoints. Find out what they mean.

...

Forward slash/Virgule ("/")

...