*** This version of Confluence is for testing only and contains a copy of content from June 29th 2026. No changes will be preserved. ***
Description
Returns a list of all bird species (along with their most recent sighting and location) in a given area.
Base URL
http://ebird.org/ws1.1/data/nearest/geo_spp/recent
Example
http://ebird.org/ws1.1/data/obsnearest/geo_spp/recent?lng=-76.507416&lat=42.45994&hotspot=true&sci=branta%20canadensis
Parameter Descriptions
parameter | required | default | value options | example value | description | status | ||
|---|---|---|---|---|---|---|---|---|
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="ff3d60aa07209605-a255e8a8-4ec14362-8668b821-f96ea394fd70c3ba3f1487b5"><ac:plain-text-body><![CDATA[ | lat | y | n/a | [-90,90] | 42.46 | decimal latitude | ]]></ac:plain-text-body></ac:structured-macro> | |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="11521ea7f891787c-b712657a-4e5a4cdb-9c3f8822-fa54f572d217a58abfca74a4"><ac:plain-text-body><![CDATA[ | lng | y | n/a | [-180,180] | -76.51 | decimal longitude |
| ]]></ac:plain-text-body></ac:structured-macro> |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="b93cc4339409c0b6-d9bf0a1e-49ee47dd-9504bffd-220e3c496024099d34752124"><ac:plain-text-body><![CDATA[ | dist | 25 | [0,50] | 15 | distance defining area of interest from given lat/lng in miles kilometers |
| ]]></ac:plain-text-body></ac:structured-macro> | |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="26e65d089a51b18a-4df6e1fb-4c344108-9627a81c-e3a7f17928e0a53d8ae3cad1"><ac:plain-text-body><![CDATA[ | back db |
| 14 | [1,30] | 7 | daysBack, the number of days since the current date back to look for observations |
| ]]></ac:plain-text-body></ac:structured-macro> |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="9607d75550608fd5-e7e7d581-46154d84-bb9b9067-ea0fa9ed2d03389e494d72bd"><ac:plain-text-body><![CDATA[ | maxResults |
| unlimited n/a | [01,infinity) 10000] | 10 | the maximum number of result rows to return in this request; to get all results do not include this parameter |
| ]]></ac:plain-text-body></ac:structured-macro> sci |
detail |
| simple | simple, full | simple |
| |||
locale |
| en_US | Java standard locale codes | fr_CA | Language/locale of response (when translations are available). See http://java.sun.com/javase/6/docs/api/java/util/Locale.html. |
| ||
fmt |
| json | json | json | format of the response |
| ||
sci | y |
| any scientific name | larus%20delawarensis | scientific name of the species of interest |
| ||
hotspot |
| false | true,false | false | set to true if results should be limited to sightings at hotspots |
|
Results
General result comments
Format
General format notes.
JSON
Specific format notes.