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
...
Search Box | ||||
---|---|---|---|---|
|
Data Source | Version | Status | Notes |
---|---|---|---|
eBird | 1.1 | deployed | enhances and supersedes v1.0 API |
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) - 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 returns recent nearby observations
- ws1.1/data/obs/geo_spp/recent
returns recent nearby observations of a species - ws1.1/data/obs/geo_spphotspot/recent
returns recent nearby observations of a speciesat 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/hotspotloc_spp/recent
returns recent observations of a species at hotspotslocations - ws1.1/data/obs/region/recent
returns recent observations of birds 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/data/obs/notablegeo/recent
- 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 locIDsbirding hotspots.
- ws1.1/product/bylocobs/hotspot/recent
- 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
- ws1.1/ref/taxa
- 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/tools/google/notable-birds.xml
- 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
- ws1.1/data
Making Sense of Endpoint URLs
There is a rational behind the URLs we use for endpoints. Find out what they mean.