Description

Returns a list of all bird species seen within a nearby area, along with their most recent sighting date and specific location.

URL

Base URL

http://ebird.org/ws1.1/data/obs/geo/recent

Examples

Minimal:

http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=42.46

Fully specified:

http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=42.46&dist=2&back=5&maxResults=500&detail=simple&locale=en_US&fmt=json

Parameter Descriptions

parameter

required

default

value options

example value

description

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="71052a34-5d8d-492e-9b9b-099498ce438d"><ac:plain-text-body><![CDATA[

lat

y

n/a

[-90.00,90.00] decimal

42.46

decimal latitude, two decimal places of precision required

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="2493c100-2a6a-4de9-b2cb-350730dbcfb8"><ac:plain-text-body><![CDATA[

lng

y

n/a

[-180.00,180.00] decimal

-76.51

decimal longitude, two decimal places of precision required

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="43a078bb-432d-4089-8133-4aa26c1c0d5c"><ac:plain-text-body><![CDATA[

dist


25

[0,50] integer

15

distance defining area of interest from given lat/lng in kilometers

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="582f7dc9-5453-49ea-895b-df98c423a24c"><ac:plain-text-body><![CDATA[

back

 

14

[1,30] integer

7

the number of days 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="96d2cb91-c4c9-4361-8455-8effb36ba4ed"><ac:plain-text-body><![CDATA[

maxResults

 


[1,10000] integer

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>

detail

 

simple

simple, full

simple

see result field descriptions  tcl-add a description

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