Docs
Open Lodol
DocumentationIntegrationsAPI

xeno-canto

App · Research & Academia · 6 actions

Search xeno-canto, a community collection of more than a million wildlife sound recordings from around the world: birds, grasshoppers and crickets, bats, frogs and land mammals. Find recordings of a species by English or scientific name, filtered by country, sound type, quality rating, length, date and licence; find recordings made near a place; draw one at random; get a recording's details, sonograms and annotations; and download its audio. Needs a free xeno-canto API key.

Actions

ActionWhat it does
Advanced searchSearch with xeno-canto's own search tags, for anything Search recordings has no filter for: background species, remarks, recording method, equipment, sample rate, coordinates, annotations and more.
Download a recordingDownload a recording's audio, the recordist's original MP3 or WAV file, as a file a later step can attach to an email, post to a chat or save to storage, with its details and citation.
Find recordings near a placeFind recordings made near a point, given by latitude and longitude, optionally only of one species or group, sound type, quality rating or recent upload date.
Get a random recordingDraw one recording at random from all that match a species, group, country, world area, sound type, quality rating or licence, such as a top rated bird song from Kenya for a daily post.
Get a recordingGet one recording by its catalogue number or link, with everything xeno-canto records about it: species, recordist, place and date, sound type, quality, length, audio and sonogram links, licence, citation, background species, remarks, equipment, and any annotations marking where each species can be heard.
Search recordingsSearch xeno-canto's recordings by species, English or scientific name, and by group, country, world area, sound type, sex, life stage, quality rating, length, year recorded, upload date, recordist and licence, best rated first.

Search with xeno-canto's own search tags, for anything Search recordings has no filter for: background species, remarks, recording method, equipment, sample rate, coordinates, annotations and more. Each term is a tag and a value, such as cnt:brazil or q:A, and every term must match.

Inputs

QueryquerytextRequired
A query in xeno-canto's search tags: each term a tag, a colon and a value, with double quotes around a value of several words or with an operator, as in sp:"larus fuscus" cnt:netherlands len:"<30". Every term must match. The tags are listed at https://xeno-canto.org/help/search. A value xeno-canto would silently ignore for type, sex, stage or method is refused.
Results per pageper_pagenumber
How many recordings to return at once, from 50 to 500. Leave empty for 50: xeno-canto sends no fewer.From 50 to 500.
Pagepagenumber
Which page of results to return, starting at 1. Leave empty for the first page. A page past the last one comes back empty but still gives the totals.At least 1.

Outputs

last_pagenumber
The last page's number.
next_pagenumber
The next page's number, or null on the last page: the value to loop on.
pagenumber
This page's number.
per_pagenumber
How many recordings a page holds.
querytext
The query sent, in xeno-canto's search tags, which Advanced search takes as it is.
recordingslist
The recordings on this page, best rated first, newest first within each rating.
total_recordingsnumber
How many recordings match, over all pages.
total_speciesnumber
How many species they are of.
Example output
{
  "last_page": 1,
  "next_page": null,
  "page": 1,
  "per_page": 50,
  "query": "sp:\"larus fuscus\" q:A",
  "recordings": [
    {
      "altitude": "70",
      "animal_seen": true,
      "annotations": [],
      "audio_url": "https://xeno-canto.org/1154497/download",
      "automatic": false,
      "background_species": [],
      "catalogue_number": "XC1154497",
      "citation": "David Darrell-Lambert, XC1154497. Accessible at www.xeno-canto.org/1154497.",
      "country": "United Kingdom",
      "date": "2026-07-07",
      "device": "Sound devices 702",
      "english_name": "Lesser Black-backed Gull",
      "file_name": "XC1154497-Lesser-Black-backed-Gull-alarm-very-good-Panfield,-Essex-England_SoundDevices702_Telinga9_1890.wav",
      "genus": "Larus",
      "group": "birds",
      "id": 1154497,
      "identification_status": "identified",
      "latitude": 51.8971,
      "length": "1:33",
      "length_seconds": 93,
      "license": "CC BY-NC-SA 4.0",
      "license_url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
      "life_stage": "adult",
      "locality": "Panfield), Essex, England",
      "longitude": 0.5267,
      "method": "field recording",
      "microphone": "Telinga Pro 9 MKII",
      "playback_used": false,
      "quality": "A",
      "recordist": "David Darrell-Lambert",
      "registration_number": null,
      "remarks": null,
      "restricted": false,
      "sample_rate": 48000,
      "scientific_name": "Larus fuscus",
      "sex": "uncertain",
      "sonograms": {
        "full": "https://xeno-canto.org/sounds/spectrograms/AYKHDFBYIH/1154497/colour.png",
        "large": "https://xeno-canto.org/sounds/spectrograms/AYKHDFBYIH/1154497/colour.png",
        "medium": "https://xeno-canto.org/sounds/spectrograms/AYKHDFBYIH/1154497/grey-medium.png",
        "small": "https://xeno-canto.org/sounds/spectrograms/AYKHDFBYIH/1154497/grey-small.png"
      },
      "sound_type": "alarm call",
      "species_epithet": "fuscus",
      "subspecies": "graellsii",
      "temperature": null,
      "time": "05:30",
      "uploaded": "2026-07-08",
      "url": "https://xeno-canto.org/1154497"
    },
    {
      "altitude": "150",
      "animal_seen": true,
      "annotations": [],
      "audio_url": "https://xeno-canto.org/128000/download",
      "automatic": false,
      "background_species": [],
      "catalogue_number": "XC128000",
      "citation": "Jarek Matusiak, XC128000. Accessible at www.xeno-canto.org/128000.",
      "country": "Poland",
      "date": "2013-03-30",
      "device": null,
      "english_name": "Lesser Black-backed Gull",
      "file_name": "XC128000-Larus_fuscus_Poland_Jarek_Matusiak_20120330-016.mp3",
      "genus": "Larus",
      "group": "birds",
      "id": 128000,
      "identification_status": "identified",
      "latitude": 51.4802,
      "length": "0:11",
      "length_seconds": 11,
      "license": "CC BY-NC-SA 3.0",
      "license_url": "https://creativecommons.org/licenses/by-nc-sa/3.0/",
      "life_stage": null,
      "locality": "Ostr\u00f3w Lubelski (near  Gmina Ostr\u00f3w Lubelski), Lubart\u00f3w County, Lublin Voivodeship",
      "longitude": 22.9464,
      "method": "field recording",
      "microphone": null,
      "playback_used": false,
      "quality": "A",
      "recordist": "Jarek Matusiak",
      "registration_number": null,
      "remarks": "Bird on night roosting place on passage, call of some birds from 18bird flock",
      "restricted": false,
      "sample_rate": 44100,
      "scientific_name": "Larus fuscus",
      "sex": null,
      "sonograms": {
        "full": "https://xeno-canto.org/sounds/spectrograms/ZNCDXTUOFL/128000/colour.png",
        "large": "https://xeno-canto.org/sounds/spectrograms/ZNCDXTUOFL/128000/colour.png",
        "medium": "https://xeno-canto.org/sounds/spectrograms/ZNCDXTUOFL/128000/grey-medium.png",
        "small": "https://xeno-canto.org/sounds/spectrograms/ZNCDXTUOFL/128000/grey-small.png"
      },
      "sound_type": "song",
      "species_epithet": "fuscus",
      "subspecies": "fuscus",
      "temperature": null,
      "time": "18:20",
      "uploaded": "2013-03-31",
      "url": "https://xeno-canto.org/128000"
    }
  ],
  "total_recordings": 35,
  "total_species": 1
}

Download a recording

Download a recording's audio, the recordist's original MP3 or WAV file, as a file a later step can attach to an email, post to a chat or save to storage, with its details and citation. Files up to 50 MB; recordings of restricted species cannot be downloaded.

Inputs

RecordingrecordingtextRequired
The recording: its catalogue number (694038 or XC694038), its xeno-canto link, or a recording from another xeno-canto step.

Outputs

byte_sizenumber
The file's size in bytes.
content_typetext
The file's media type: audio/mpeg or audio/wav.
document_reftext
The stored file's reference.
documentslist
The audio file as a document, ready to attach to a later step.
recordingobject
The recording, as Get a recording returns it.
source_urltext
Where it was downloaded from.
urltext
A URL that serves the stored file.
Example output
{
  "byte_size": 3980062,
  "content_type": "audio/mpeg",
  "document_ref": "doc_xeno_canto_xc694038",
  "documents": [
    {
      "content_type": "audio/mpeg",
      "document_ref": "doc_xeno_canto_xc694038",
      "filename": "XC694038 - Eurasian Wren - Troglodytes troglodytes.mp3",
      "size_bytes": 3980062,
      "url": "/actions/core/serve-document/doc_xeno_canto_xc694038?teamId=65f0c0ffee0000000000c0de"
    }
  ],
  "recording": {
    "altitude": "30",
    "animal_seen": true,
    "annotations": [],
    "audio_url": "https://xeno-canto.org/694038/download",
    "automatic": false,
    "background_species": [
      "Turdus viscivorus",
      "Turdus iliacus",
      "Parus major"
    ],
    "catalogue_number": "XC694038",
    "citation": "Jacobo Ramil MIllarengo, XC694038. Accessible at www.xeno-canto.org/694038.",
    "country": "Spain",
    "date": "2021-12-23",
    "device": null,
    "english_name": "Eurasian Wren",
    "file_name": "XC694038-211223_02Carrizo variaci\u00f3ns dunha frase bastante stereotipada siteD 9.30 Sisalde.mp3",
    "genus": "Troglodytes",
    "group": "birds",
    "id": 694038,
    "identification_status": "identified",
    "latitude": 42.8373,
    "length": "4:08",
    "length_seconds": 248,
    "license": "CC BY-NC-SA 4.0",
    "license_url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
    "life_stage": "adult",
    "locality": "Sisalde, Ames, A Coru\u00f1a, Galicia",
    "longitude": -8.652,
    "method": "field recording",
    "microphone": null,
    "playback_used": false,
    "quality": "B",
    "recordist": "Jacobo Ramil MIllarengo",
    "registration_number": null,
    "remarks": "A male repeat a stereotyped phrase with few syllabic variation . HPF 270 Hz. It\u00b4s raining.",
    "restricted": false,
    "sample_rate": 44100,
    "scientific_name": "Troglodytes troglodytes",
    "sex": "male",
    "sonograms": {
      "full": null,
      "large": "https://xeno-canto.org/sounds/spectrograms/LHCOINSOBZ/694038/colour.png",
      "medium": "https://xeno-canto.org/sounds/spectrograms/LHCOINSOBZ/694038/grey-medium.png",
      "small": "https://xeno-canto.org/sounds/spectrograms/LHCOINSOBZ/694038/grey-small.png"
    },
    "sound_type": "song",
    "species_epithet": "troglodytes",
    "subspecies": null,
    "temperature": null,
    "time": "09:30",
    "uploaded": "2021-12-27",
    "url": "https://xeno-canto.org/694038"
  },
  "source_url": "https://xeno-canto.org/694038/download",
  "url": "/actions/core/serve-document/doc_xeno_canto_xc694038?teamId=65f0c0ffee0000000000c0de"
}

Find recordings near a place

Find recordings made near a point, given by latitude and longitude, optionally only of one species or group, sound type, quality rating or recent upload date. Each recording comes with its distance from the point, or null for a restricted species whose location xeno-canto withholds.

Inputs

LatitudelatitudenumberRequired
The point's latitude in decimal degrees, from -90 to 90.From -90 to 90.
LongitudelongitudenumberRequired
The point's longitude in decimal degrees, from -180 to 180.From -180 to 180.
Within (km)within_kmnumber
How far to look from the point, north, south, east and west, in kilometres from 0.1 to 500. Leave empty for 10. The area searched is a square, so its corners reach about 1.4 times as far; each recording's distance_km says exactly how far it is.From 0.1 to 500.0.
Speciesspeciestext
The species to find, by English name (Eurasian Wren) or scientific name (Troglodytes troglodytes); or a subspecies (Larus fuscus graellsii), genus (Larus) or family (Laridae). Part of an English name finds every species whose name contains it: wren finds all the wrens. English names are xeno-canto's, which follow the IOC list for birds, so Turdus merula is the Common Blackbird. Also takes a recording from another xeno-canto step, to find more of its species.
Groupgrouptext
Only this group of animals. Soundscapes record a whole place, many species at once.One of: birds, grasshoppers (Grasshoppers and crickets), bats, frogs, land mammals, soundscape (Soundscapes (whole places, many species at once)).
Sound typesound_typetext
Only recordings of this kind of sound. Some belong to one group only, such as echolocation to bats and calling song to grasshoppers; the list says which.One of: aberrant, advertisement call (Advertisement call (frogs)), agonistic call (Agonistic call (land mammals)), alarm call, begging call, call, calling song (Calling song (grasshoppers)), courtship song (Courtship song (grasshoppers)), dawn song (Dawn song (birds)), defensive call (Defensive call (land mammals)), and 20 more.
Minimum qualityminimum_qualitytext
Only recordings rated at least this well. The community rates recordings from A (best) to E; unrated ones are left out when this is set.One of: A (A (best only)), B (B or better), C (C or better), D (D or better).
Uploaded in the last daysuploaded_in_last_daysnumber
Only recordings uploaded in the last this many days: 1 is today's uploads, 7 the last week. The way to a regular digest of new recordings.At least 1.
Results per pageper_pagenumber
How many recordings to return at once, from 50 to 500. Leave empty for 50: xeno-canto sends no fewer.From 50 to 500.
Pagepagenumber
Which page of results to return, starting at 1. Leave empty for the first page. A page past the last one comes back empty but still gives the totals.At least 1.

Outputs

last_pagenumber
The last page's number.
next_pagenumber
The next page's number, or null on the last page: the value to loop on.
pagenumber
This page's number.
per_pagenumber
How many recordings a page holds.
querytext
The query sent, in xeno-canto's search tags, which Advanced search takes as it is.
recordingslist
The recordings on this page, best rated first, newest first within each rating.
total_recordingsnumber
How many recordings match, over all pages.
total_speciesnumber
How many species they are of.
Example output
{
  "last_page": 1,
  "next_page": null,
  "page": 1,
  "per_page": 50,
  "query": "en:\"=common blackbird\" box:52.2778,4.757,52.4574,5.0512",
  "recordings": [
    {
      "altitude": "0",
      "animal_seen": false,
      "annotations": [],
      "audio_url": "https://xeno-canto.org/571736/download",
      "automatic": false,
      "background_species": [],
      "catalogue_number": "XC571736",
      "citation": "Ed, XC571736. Accessible at www.xeno-canto.org/571736.",
      "country": "Netherlands",
      "date": "2019-04-21",
      "device": null,
      "distance_km": 6.87,
      "english_name": "Common Blackbird",
      "file_name": "XC571736-20190421-0837.mp3",
      "genus": "Turdus",
      "group": "birds",
      "id": 571736,
      "identification_status": "identified",
      "latitude": 52.3458,
      "length": "0:04",
      "length_seconds": 4,
      "license": "CC BY-NC-SA 4.0",
      "license_url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
      "life_stage": "adult",
      "locality": "Amsterdam, Amsterdam, Noord-Holland",
      "longitude": 4.8095,
      "method": "field recording",
      "microphone": null,
      "playback_used": false,
      "quality": "B",
      "recordist": "Ed",
      "registration_number": null,
      "remarks": null,
      "restricted": false,
      "sample_rate": 48000,
      "scientific_name": "Turdus merula",
      "sex": "uncertain",
      "sonograms": {
        "full": "https://xeno-canto.org/sounds/spectrograms/RJSGDNTSUP/571736/colour.png",
        "large": "https://xeno-canto.org/sounds/spectrograms/RJSGDNTSUP/571736/colour.png",
        "medium": "https://xeno-canto.org/sounds/spectrograms/RJSGDNTSUP/571736/grey-medium.png",
        "small": "https://xeno-canto.org/sounds/spectrograms/RJSGDNTSUP/571736/grey-small.png"
      },
      "sound_type": "alarm call",
      "species_epithet": "merula",
      "subspecies": null,
      "temperature": null,
      "time": "08:37",
      "uploaded": "2020-06-26",
      "url": "https://xeno-canto.org/571736"
    },
    {
      "altitude": "-4",
      "animal_seen": false,
      "annotations": [],
      "audio_url": "https://xeno-canto.org/1051977/download",
      "automatic": true,
      "background_species": [],
      "catalogue_number": "XC1051977",
      "citation": "guus van duin, XC1051977. Accessible at www.xeno-canto.org/1051977.",
      "country": "Netherlands",
      "date": "2025-11-03",
      "device": "Olympus L14",
      "distance_km": 2.6,
      "english_name": "Common Blackbird",
      "file_name": "XC1051977-merel-tuin-LPS-eerste-ochtendschetter-07.02-uur.mp3",
      "genus": "Turdus",
      "group": "birds",
      "id": 1051977,
      "identification_status": "identified",
      "latitude": 52.3559,
      "length": "0:09",
      "length_seconds": 9,
      "license": "CC BY-NC-SA 4.0",
      "license_url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
      "life_stage": null,
      "locality": "tuin Guus, Laplacestraat Amsterdam",
      "longitude": 4.9373,
      "method": "field recording",
      "microphone": "two external Primo's",
      "playback_used": false,
      "quality": "E",
      "recordist": "guus van duin",
      "registration_number": null,
      "remarks": "First morning chatter of local male ....",
      "restricted": false,
      "sample_rate": 44100,
      "scientific_name": "Turdus merula",
      "sex": "male",
      "sonograms": {
        "full": "https://xeno-canto.org/sounds/spectrograms/KXALCXUHMD/1051977/colour.png",
        "large": "https://xeno-canto.org/sounds/spectrograms/KXALCXUHMD/1051977/colour.png",
        "medium": "https://xeno-canto.org/sounds/spectrograms/KXALCXUHMD/1051977/grey-medium.png",
        "small": "https://xeno-canto.org/sounds/spectrograms/KXALCXUHMD/1051977/grey-small.png"
      },
      "sound_type": null,
      "species_epithet": "merula",
      "subspecies": null,
      "temperature": null,
      "time": "07:02",
      "uploaded": "2025-11-03",
      "url": "https://xeno-canto.org/1051977"
    }
  ],
  "total_recordings": 5,
  "total_species": 1
}

Get a random recording

Draw one recording at random from all that match a species, group, country, world area, sound type, quality rating or licence, such as a top rated bird song from Kenya for a daily post. Recordings of restricted species, whose audio is withheld, are passed over.

Inputs

Speciesspeciestext
The species to find, by English name (Eurasian Wren) or scientific name (Troglodytes troglodytes); or a subspecies (Larus fuscus graellsii), genus (Larus) or family (Laridae). Part of an English name finds every species whose name contains it: wren finds all the wrens. English names are xeno-canto's, which follow the IOC list for birds, so Turdus merula is the Common Blackbird. Also takes a recording from another xeno-canto step, to find more of its species.
Groupgrouptext
Only this group of animals. Soundscapes record a whole place, many species at once.One of: birds, grasshoppers (Grasshoppers and crickets), bats, frogs, land mammals, soundscape (Soundscapes (whole places, many species at once)).
Countrycountrytext
Only recordings made in this country, as xeno-canto names it. Also takes a country code (NL or NLD) or another name for it (Holland, USA). Overseas territories count as their country: Reunion is France.One of: Afghanistan, Albania, Algeria, Andorra, Angola, Antarctica, Antigua & Departments, Argentina, Armenia, Australia, and 189 more.
World areaareatext
Only recordings made in this part of the world.One of: africa, america (The Americas), asia, australia (Australasia and the Pacific), europe.
Sound typesound_typetext
Only recordings of this kind of sound. Some belong to one group only, such as echolocation to bats and calling song to grasshoppers; the list says which.One of: aberrant, advertisement call (Advertisement call (frogs)), agonistic call (Agonistic call (land mammals)), alarm call, begging call, call, calling song (Calling song (grasshoppers)), courtship song (Courtship song (grasshoppers)), dawn song (Dawn song (birds)), defensive call (Defensive call (land mammals)), and 20 more.
Minimum qualityminimum_qualitytext
Only recordings rated at least this well. The community rates recordings from A (best) to E; unrated ones are left out when this is set.One of: A (A (best only)), B (B or better), C (C or better), D (D or better).
Licencelicense_typetext
Only recordings shared under this Creative Commons licence. Every one but public domain asks for the recordist to be credited, and the NonCommercial ones rule out commercial use.One of: BY-NC-SA (Attribution, NonCommercial, ShareAlike (CC BY-NC-SA)), BY-NC-ND (Attribution, NonCommercial, NoDerivatives (CC BY-NC-ND)), BY-NC (Attribution, NonCommercial (CC BY-NC)), BY-SA (Attribution, ShareAlike (CC BY-SA)), BY (Attribution (CC BY)), PD (Public domain (CC0)).

Outputs

querytext
The query sent, in xeno-canto's search tags, which Advanced search takes as it is.
recordingobject
The recording drawn.
total_recordingsnumber
How many recordings it was drawn from.
Example output
{
  "query": "en:\"=eurasian wren\" q:\"A\"",
  "recording": {
    "altitude": "10",
    "animal_seen": true,
    "annotations": [],
    "audio_url": "https://xeno-canto.org/1161483/download",
    "automatic": false,
    "background_species": [
      "Sturnus vulgaris"
    ],
    "catalogue_number": "XC1161483",
    "citation": "Michael Johnstone, XC1161483. Accessible at www.xeno-canto.org/1161483.",
    "country": "United Kingdom",
    "date": "2026-06-13",
    "device": "Sound Devices Mix Pre 6 II",
    "english_name": "Eurasian Wren",
    "file_name": "XC1161483-13.06.26-Wren-Papa-Stour-Shetland.mp3",
    "genus": "Troglodytes",
    "group": "birds",
    "id": 1161483,
    "identification_status": "identified",
    "latitude": 60.332,
    "length": "2:05",
    "length_seconds": 125,
    "license": "CC BY-NC-SA 4.0",
    "license_url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
    "life_stage": "adult",
    "locality": "Papa Stour Shetland Ferry Terminal (near  Biggings), Shetland Islands, Scotland",
    "longitude": -1.6721,
    "method": "field recording",
    "microphone": "MKH 8020 in Telinga dish + 2 x MKH 8040 in ORTF",
    "playback_used": false,
    "quality": "A",
    "recordist": "Michael Johnstone",
    "registration_number": null,
    "remarks": "High and low pass filtering in post, but not so as to affect recorded vocalisation.  Time intervals between song bursts are as recorded.  20 m to the bird singing from low cover and from a low fence.  No other wrens singing close by.  Longer and other recordings of the same individual are available as .wav/.flac.  Clear, calm but cool conditions.",
    "restricted": false,
    "sample_rate": 48000,
    "scientific_name": "Troglodytes troglodytes",
    "sex": "uncertain",
    "sonograms": {
      "full": null,
      "large": "https://xeno-canto.org/sounds/spectrograms/IVAXDQYHKB/1161483/colour.png",
      "medium": "https://xeno-canto.org/sounds/spectrograms/IVAXDQYHKB/1161483/grey-medium.png",
      "small": "https://xeno-canto.org/sounds/spectrograms/IVAXDQYHKB/1161483/grey-small.png"
    },
    "sound_type": "song",
    "species_epithet": "troglodytes",
    "subspecies": null,
    "temperature": null,
    "time": "04:00",
    "uploaded": "2026-07-27",
    "url": "https://xeno-canto.org/1161483"
  },
  "total_recordings": 612
}

Get a recording

Get one recording by its catalogue number or link, with everything xeno-canto records about it: species, recordist, place and date, sound type, quality, length, audio and sonogram links, licence, citation, background species, remarks, equipment, and any annotations marking where each species can be heard.

Inputs

RecordingrecordingtextRequired
The recording: its catalogue number (694038 or XC694038), its xeno-canto link, or a recording from another xeno-canto step.

Outputs

recordingobject
The recording.
Example output
{
  "recording": {
    "altitude": "170",
    "animal_seen": true,
    "annotations": [
      {
        "annotation_remarks": null,
        "annotation_xc_id": 74608,
        "annotator": null,
        "end_time": 4.7305,
        "frequency_high": 20971,
        "frequency_low": 1454,
        "life_stage": "uncertain",
        "original_set_metadata": {
          "set_creation_date": "2026-08-23 17:15:01",
          "set_creator": "Przemek Kvapil",
          "set_license": "CC-BY-NC-4.0",
          "set_name": "Annotation set for 1173143",
          "set_owner": null,
          "set_uri": "https://xeno-canto.org/annotation/set/438"
        },
        "scientific_name": "Troglodytes troglodytes",
        "sex": "uncertain",
        "sound_type": "song",
        "start_time": 0.324,
        "xc_nr": "1173143"
      },
      {
        "annotation_remarks": null,
        "annotation_xc_id": 74611,
        "annotator": null,
        "end_time": 33.9638,
        "frequency_high": 21143,
        "frequency_low": 2280,
        "life_stage": "uncertain",
        "original_set_metadata": {
          "set_creation_date": "2026-08-23 17:15:01",
          "set_creator": "Przemek Kvapil",
          "set_license": "CC-BY-NC-4.0",
          "set_name": "Annotation set for 1173143",
          "set_owner": null,
          "set_uri": "https://xeno-canto.org/annotation/set/438"
        },
        "scientific_name": "Troglodytes troglodytes",
        "sex": "uncertain",
        "sound_type": "song",
        "start_time": 28.863,
        "xc_nr": "1173143"
      }
    ],
    "audio_url": "https://xeno-canto.org/1173143/download",
    "automatic": false,
    "background_species": [
      "Sylvia atricapilla",
      "Phylloscopus collybita"
    ],
    "catalogue_number": "XC1173143",
    "citation": "Przemek Kvapil, XC1173143. Accessible at www.xeno-canto.org/1173143.",
    "country": "Poland",
    "date": "2026-07-20",
    "device": "iPhone SE",
    "english_name": "Eurasian Wren",
    "file_name": "XC1173143-2026-07-20-(strzy\u017cyk).wav",
    "genus": "Troglodytes",
    "group": "birds",
    "id": 1173143,
    "identification_status": "identified",
    "latitude": 54.4067,
    "length": "0:36",
    "length_seconds": 36,
    "license": "CC BY-NC-SA 4.0",
    "license_url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
    "life_stage": "uncertain",
    "locality": "Borowiec forest (near Gda\u0144sk), Pomorskie Voivodeship",
    "longitude": 18.4117,
    "method": "field recording",
    "microphone": null,
    "playback_used": false,
    "quality": "B",
    "recordist": "Przemek Kvapil",
    "registration_number": null,
    "remarks": "Processing: I compressed sounds below 500Hz to reduce background noise and normalized audio to -3dB.\r\nHabitat: mixed forest; the bird was near ground level among some low-growing plants.",
    "restricted": false,
    "sample_rate": 44100,
    "scientific_name": "Troglodytes troglodytes",
    "sex": "uncertain",
    "sonograms": {
      "full": "https://xeno-canto.org/sounds/spectrograms/KRPHCOAFFP/1173143/colour.png",
      "large": "https://xeno-canto.org/sounds/spectrograms/KRPHCOAFFP/1173143/colour.png",
      "medium": "https://xeno-canto.org/sounds/spectrograms/KRPHCOAFFP/1173143/grey-medium.png",
      "small": "https://xeno-canto.org/sounds/spectrograms/KRPHCOAFFP/1173143/grey-small.png"
    },
    "sound_type": "song",
    "species_epithet": "troglodytes",
    "subspecies": null,
    "temperature": null,
    "time": "05:30",
    "uploaded": "2026-08-23",
    "url": "https://xeno-canto.org/1173143"
  }
}

Search recordings

Search xeno-canto's recordings by species, English or scientific name, and by group, country, world area, sound type, sex, life stage, quality rating, length, year recorded, upload date, recordist and licence, best rated first. Returns each recording's details, audio and sonogram links, licence and citation, with how many recordings and species match.

Inputs

Speciesspeciestext
The species to find, by English name (Eurasian Wren) or scientific name (Troglodytes troglodytes); or a subspecies (Larus fuscus graellsii), genus (Larus) or family (Laridae). Part of an English name finds every species whose name contains it: wren finds all the wrens. English names are xeno-canto's, which follow the IOC list for birds, so Turdus merula is the Common Blackbird. Also takes a recording from another xeno-canto step, to find more of its species.
Groupgrouptext
Only this group of animals. Soundscapes record a whole place, many species at once.One of: birds, grasshoppers (Grasshoppers and crickets), bats, frogs, land mammals, soundscape (Soundscapes (whole places, many species at once)).
Countrycountrytext
Only recordings made in this country, as xeno-canto names it. Also takes a country code (NL or NLD) or another name for it (Holland, USA). Overseas territories count as their country: Reunion is France.One of: Afghanistan, Albania, Algeria, Andorra, Angola, Antarctica, Antigua & Departments, Argentina, Armenia, Australia, and 189 more.
World areaareatext
Only recordings made in this part of the world.One of: africa, america (The Americas), asia, australia (Australasia and the Pacific), europe.
Sound typesound_typetext
Only recordings of this kind of sound. Some belong to one group only, such as echolocation to bats and calling song to grasshoppers; the list says which.One of: aberrant, advertisement call (Advertisement call (frogs)), agonistic call (Agonistic call (land mammals)), alarm call, begging call, call, calling song (Calling song (grasshoppers)), courtship song (Courtship song (grasshoppers)), dawn song (Dawn song (birds)), defensive call (Defensive call (land mammals)), and 20 more.
Sexsextext
Only recordings whose animal is recorded as this sex. Most recordings do not say.One of: female, male.
Life stagelife_stagetext
Only recordings of animals at this life stage. Nestling is for birds, nymph for grasshoppers and subadult for bats.One of: adult, juvenile, nestling (Nestling (birds)), nymph (Nymph (grasshoppers)), subadult (Subadult (bats)).
Minimum qualityminimum_qualitytext
Only recordings rated at least this well. The community rates recordings from A (best) to E; unrated ones are left out when this is set.One of: A (A (best only)), B (B or better), C (C or better), D (D or better).
Minimum length (seconds)min_length_secondsnumber
Only recordings at least this many seconds long.At least 0.
Maximum length (seconds)max_length_secondsnumber
Only recordings at most this many seconds long.At least 0.
Recorded from yearrecorded_from_yearnumber
Only recordings made in this year or later.From 1800 to 2100.
Recorded to yearrecorded_to_yearnumber
Only recordings made in this year or earlier.From 1800 to 2100.
Uploaded in the last daysuploaded_in_last_daysnumber
Only recordings uploaded in the last this many days: 1 is today's uploads, 7 the last week. The way to a regular digest of new recordings.At least 1.
Recordistrecordisttext
Only recordings by recordists whose name contains this, such as Vellinga.
Licencelicense_typetext
Only recordings shared under this Creative Commons licence. Every one but public domain asks for the recordist to be credited, and the NonCommercial ones rule out commercial use.One of: BY-NC-SA (Attribution, NonCommercial, ShareAlike (CC BY-NC-SA)), BY-NC-ND (Attribution, NonCommercial, NoDerivatives (CC BY-NC-ND)), BY-NC (Attribution, NonCommercial (CC BY-NC)), BY-SA (Attribution, ShareAlike (CC BY-SA)), BY (Attribution (CC BY)), PD (Public domain (CC0)).
Results per pageper_pagenumber
How many recordings to return at once, from 50 to 500. Leave empty for 50: xeno-canto sends no fewer.From 50 to 500.
Pagepagenumber
Which page of results to return, starting at 1. Leave empty for the first page. A page past the last one comes back empty but still gives the totals.At least 1.

Outputs

last_pagenumber
The last page's number.
next_pagenumber
The next page's number, or null on the last page: the value to loop on.
pagenumber
This page's number.
per_pagenumber
How many recordings a page holds.
querytext
The query sent, in xeno-canto's search tags, which Advanced search takes as it is.
recordingslist
The recordings on this page, best rated first, newest first within each rating.
total_recordingsnumber
How many recordings match, over all pages.
total_speciesnumber
How many species they are of.
Example output
{
  "last_page": 1,
  "next_page": null,
  "page": 1,
  "per_page": 50,
  "query": "en:\"=eurasian wren\" cnt:\"=Netherlands\" q:\"A\"",
  "recordings": [
    {
      "altitude": "0",
      "animal_seen": false,
      "annotations": [],
      "audio_url": "https://xeno-canto.org/1053191/download",
      "automatic": true,
      "background_species": [
        "Coloeus monedula"
      ],
      "catalogue_number": "XC1053191",
      "citation": "Susanne Kuijpers, XC1053191. Accessible at www.xeno-canto.org/1053191.",
      "country": "Netherlands",
      "date": "2025-11-08",
      "device": null,
      "english_name": "Eurasian Wren",
      "file_name": "XC1053191-241108_9670-Winterkoning.mp3",
      "genus": "Troglodytes",
      "group": "birds",
      "id": 1053191,
      "identification_status": "identified",
      "latitude": 51.9892,
      "length": "1:00",
      "length_seconds": 60,
      "license": "CC BY-NC-SA 4.0",
      "license_url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
      "life_stage": "adult",
      "locality": "Berkel en Rodenrijs, Lansingerland, Zuid-Holland",
      "longitude": 4.4694,
      "method": "field recording",
      "microphone": null,
      "playback_used": false,
      "quality": "A",
      "recordist": "Susanne Kuijpers",
      "registration_number": null,
      "remarks": null,
      "restricted": false,
      "sample_rate": 44100,
      "scientific_name": "Troglodytes troglodytes",
      "sex": "male",
      "sonograms": {
        "full": "https://xeno-canto.org/sounds/spectrograms/IZVNKUBNLN/1053191/colour.png",
        "large": "https://xeno-canto.org/sounds/spectrograms/IZVNKUBNLN/1053191/colour.png",
        "medium": "https://xeno-canto.org/sounds/spectrograms/IZVNKUBNLN/1053191/grey-medium.png",
        "small": "https://xeno-canto.org/sounds/spectrograms/IZVNKUBNLN/1053191/grey-small.png"
      },
      "sound_type": "dawn song, song",
      "species_epithet": "troglodytes",
      "subspecies": null,
      "temperature": null,
      "time": "07:23",
      "uploaded": "2025-11-08",
      "url": "https://xeno-canto.org/1053191"
    },
    {
      "altitude": "0",
      "animal_seen": null,
      "annotations": [],
      "audio_url": "https://xeno-canto.org/35589/download",
      "automatic": false,
      "background_species": [
        "Turdus philomelos",
        "Phylloscopus collybita"
      ],
      "catalogue_number": "XC35589",
      "citation": "Arnold Meijer, XC35589. Accessible at www.xeno-canto.org/35589.",
      "country": "Netherlands",
      "date": "2009-03-14",
      "device": null,
      "english_name": "Eurasian Wren",
      "file_name": "BLUEROBIN_Winterkoning_Panbos_Katwijk_ArnoldMeijer_140309_LS100491.mp3",
      "genus": "Troglodytes",
      "group": "birds",
      "id": 35589,
      "identification_status": "identified",
      "latitude": 52.1756,
      "length": "0:34",
      "length_seconds": 34,
      "license": "CC BY-NC-ND 2.5",
      "license_url": "https://creativecommons.org/licenses/by-nc-nd/2.5/",
      "life_stage": null,
      "locality": "Panbos, Katwijk, Zuid-Holland",
      "longitude": 4.4003,
      "method": "field recording",
      "microphone": null,
      "playback_used": null,
      "quality": "A",
      "recordist": "Arnold Meijer",
      "registration_number": null,
      "remarks": "link:http://www.bluerobin.nl",
      "restricted": false,
      "sample_rate": 48000,
      "scientific_name": "Troglodytes troglodytes",
      "sex": null,
      "sonograms": {
        "full": "https://xeno-canto.org/sounds/spectrograms/UXOKEACNUT/35589/colour.png",
        "large": "https://xeno-canto.org/sounds/spectrograms/UXOKEACNUT/35589/colour.png",
        "medium": "https://xeno-canto.org/sounds/spectrograms/UXOKEACNUT/35589/grey-medium.png",
        "small": "https://xeno-canto.org/sounds/spectrograms/UXOKEACNUT/35589/grey-small.png"
      },
      "sound_type": "song",
      "species_epithet": "troglodytes",
      "subspecies": null,
      "temperature": null,
      "time": null,
      "uploaded": "2009-06-11",
      "url": "https://xeno-canto.org/35589"
    }
  ],
  "total_recordings": 37,
  "total_species": 1
}

X (Twitter)

Previous Page

Xero

Next Page

On this page

ActionsAdvanced searchDownload a recordingFind recordings near a placeGet a random recordingGet a recordingSearch recordings