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.
• character encoding issues. See http://ebird.org/ws1.0/data/hotspot/list?subnational1Code=US-CO&format=xml locID = L356957

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/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/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/obs/loc_spp/recent
    returns recent observations of a species at locations
  • ws1.1/data/obs/region/recent
    returns recent observations in a region
  • 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/notable/hotspot/recent
    returns recent notable observations at hotspots
  • ws1.1/data/notable/loc/recent
    returns recent notable observations at locations
  • ws1.1/data/notable/region/recent
    returns recent notable observations in a region
  • 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/obs/bylochotspot/recent
      This data service provides a summary of recent sightings for up to three hotspot locIDsbirding hotspots.
  • ws1.1/ref
    This path contains supporting lookup services for the /data and /product services
    • ws1.1/ref/taxa
      returns species in the ebird taxonomy
    • ws1.1/ref/hotspot/region
      provides a list of eBird hotspots for a given region, optionally filtered to those with recent data
    • ws1.1/ref/hotspot/geo
      provides a list of nearby eBird hotspots, optionally filtered to those with recent data
    • ws1.1/ref/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

Making Sense of Endpoint URLs

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