eBird Web Services - Version 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
      This data service provides notable sightings (rare & unusual) on a state or country basis. Records returned are species oriented. (I.e. not checklists)
      returns recent 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
    • ws1.1/lifelist/liferef/taxa
      returns species in the ebird taxonomy
    • ws1.1/productref/lifelist/yearhotspot/region
      provides a list of eBird hotspots for a given region, optionally filtered to those with recent data
    • ws1.1/productref/lifelist/monthhotspot/geo
      provides a list of nearby eBird hotspots, optionally filtered to those with recent data
    • ws1.1/ref
    
    This path contains supporting lookup services for the /data and /product services
    • /location
      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="cff16548-b59b-431b-8f24-b8fbaf5d8420"><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 ("/")

...