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
...
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) 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/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 locIDs.birding 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
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="e2f835da-f7c3-4354-8a3a-c41e3dc590aa"><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 ("/")
...