# \[WS\] Audible via API
**URL:** https://community.mp3tag.de/t/ws-audible-via-api/64347
**Category:** Web Sources Scripts
**Created:** [April 9, 2024, 10:02am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347 "2024-04-09T10:02:08Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [April 9, 2024, 10:02am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/1 "2024-04-09T10:02:08Z")
# Audible API Tag Source
This Audible Tag Source allows for searching audiobooks via the external Audible API.
## Download
[audible-api-0.6.4.zip](https://community.mp3tag.de/uploads/short-url/yFbSIczDQzXQrUIAS59KUp803G.zip) (20.8 KB)
## Installation
Requires Mp3tag v3.22 or Mp3tag for Mac v1.8.6.
### Windows
In Mp3tag, use **File → Open configuration folder** and extract the contents of the downloaded archive to `data\sources\`. I suggest using [https://www.7-zip.org](https://www.7-zip.org) to extract the archive.
### macOS
In Mp3tag, use **Tag Sources → Open Tag Sources Folder** and extract the contents of the downloaded archive.
## Supported Fields
| Mp3tag | Audible |
| --- | --- |
| `ALBUM` | Title |
| `ALBUMARTIST` | Author |
| `ALBUMARTISTS` | List of authors |
| `ALBUMSORT` | If `ALBUM` only, then _Title_, if `ALBUM` and `SUBTITLE`, then _Title - Subtitle_, if `SERIES`, then _Series Series-Part - Title_ |
| `ARTIST` | Author, Narrator |
| `ASIN` | Amazon Standard Identification Number |
| `COMMENT` | Publisher's Summary (MP3) |
| `COMPOSER` | Narrator |
| `CONTENTGROUP` | Series, Book # |
| `COPYRIGHT` | Copyright |
| `DESCRIPTION` | Publisher's Summary (M4B) |
| `EXPLICIT` | Set to `1` if adult content |
| `FORMAT` | Format type, e.g., `unabridged` |
| `GENRE` | Genre1/Genre2 (using the configured delimiter for multiple values) |
| `ISBN` | International Standard Book Number |
| `ITUNESADVISORY` | Set to `1` if adult content, `2` if clean (M4B) |
| `ITUNESGAPLESS` | M4B Gapless album = 1 |
| `ITUNESMEDIATYPE` | M4B Media type = Audiobook |
| `LANGUAGE` | Language |
| `MOVEMENT` | Series Book # |
| `MOVEMENTNAME` | Series |
| `PUBLISHER` | Publisher |
| `RATING WMP` | Audible Rating (MP3) |
| `RATING` | Audible Rating |
| `RELEASETIME` | Audiobook Release Date |
| `SERIES-PART` | Series Book # |
| `SERIES` | Series |
| `SHOWMOVEMENT` | M4B Movement, if Series then set to `1` otherwise left out |
| `SUBTITLE` | Subtitle |
| `TMP_GENRE1` | Genre 1 (if single genre only configuration setting is enabled) |
| `TMP_GENRE2` | Genre 2 (if single genre only configuration setting is enabled) |
| `WWWAUDIOFILE` | Audible Album URL |
| `YEAR` | Audiobook Release Year |
I've tried to be as compatible to the existing Audible Tag Sources as possible. Let me know if there is something missing or can be changed to improve compatibility with existing systems.
## Configuration Settings
### Add narrator to artist
If enabled, the narrator is added to the artist field.
### Add single album artist only
If enabled and the audiobook has multiple artists, only the first artist is added to the `ALBUMARTIST` field and the complete list of artists is stored in `ALBUMARTISTS`.
### Add single genre only
If enabled and the audiobook has multiple genres, only the first genre is added to the `GENRE` field and `TMP_GENRE1` and `TMP_GENRE2` have additional genres.
### Use full release date as year
If enabled, the full release date `YYYY-MM-DD` is used for the year field (otherwise it's `YYYY` only).
### Delimiter for multiple values
The string to use as a delimiter for multiple genres.
## Changelog
## 0.6.4 (2026-05-05) @Florian
- Changed to use standard capitalization for format and language. ([#71173](https://community.mp3tag.de/t/71173))
- Prevent use of empty `SERIES-PART` in `ALBUMSORT` and `CONTENTGROUP`. ([#71175](https://community.mp3tag.de/t/71175/3))
- Prevent `ARTIST` to start with comma if only `NARRATOR` is provided. ([#71175](https://community.mp3tag.de/t/71175))
## 0.6.3 (2025-10-30) @bblatt
- Added support for 2400x2400 px cover sizes if available.
## 0.6.2 (2025-09-06) @Florian
- Added configuration option to use full release date for `YEAR` field.
## 0.6.1 (2025-05-16) @Florian
- Changed to filter non-author roles (e.g., translators) from list of authors.
## 0.6.0 (2025-05-15) @bblatt @Florian
- Added support for field `COPYRIGHT`.
- Added support for field `EXPLICIT` and `ITUNESADVISORY`.
- Added support for field `FORMAT`.
- Added support for field `ISBN`.
- Added support for field `LANGUAGE`.
- Added support for field `RATING WMP`.
- Added configuration setting to use first album artist only and store complete list in `ALBUMARTISTS`.
- Added importing of additional genres to `TMP_GENRE1` and `TMP_GENRE2` if first genre only is stored in `GENRE`.
- Added Tag Sources for audible.co.jp
- Added Tag Sources for audible.com.au
- Added Tag Sources for audible.com.br
- Added Tag Sources for audible.es
- Added Tag Sources for audible.it
- Added Tag Sources to directly search by filename.
- Changed to write `TMP_GENRE1` and `TMP_GENRE2` if single genre only configuration setting is enabled.
- Fixed preview URL to use locale-specific URL.
- Removed code duplication in Search by ASIN Tag Sources.
- Added README
## 0.5.0 (2025-04-16) @Florian
- Added Tag Sources for `audible.ca`
- Added Tag Sources for `audible.fr`
- Fixed `WWWAUDIOFILE` to use locale-specific URL.
## 0.4.0 (2024-12-29) @Florian
- Added Tag Sources for `audible.co.uk`
## 0.3.0 (2024-11-06) @Florian
- Added Tag Source to directly search by ASIN.
- Added column for Narrator to query results.
- Fixed multiple series and parts were concatenated into one string.
## 0.2.1 (2024-05-25) @Florian
- Fixed no results opened confirmation dialog with static fields.
## 0.2.0 (2024-05-24) @Florian
- Added dedicated preview URL instead of opening API result.
## 0.1.0 (2024-04-09) @Florian
- Initial release.
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [April 9, 2024, 1:49pm UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/2 "2024-04-09T13:49:13Z")
3 posts were split to a new topic: [Purpose of using `[Version]` in header of Web Sources](https://community.mp3tag.de/t/purpose-of-using-version-in-header-of-web-sources/64350)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [April 27, 2024, 5:48am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/3 "2024-04-27T05:48:59Z")
5 posts were split to a new topic: [Audible API doesn't work with v3.21](https://community.mp3tag.de/t/audible-api-doesnt-work-with-v3-21/64530)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [November 6, 2024, 3:35pm UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/7 "2024-11-06T15:35:46Z")
2 posts were split to a new topic: [Multiple series are concatenated in Audible via API WS](https://community.mp3tag.de/t/multiple-series-are-concatenated-in-audible-via-api-ws/66453)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [September 29, 2024, 7:28am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/9 "2024-09-29T07:28:16Z")
5 posts were split to a new topic: [Timeout when running Audible via API Tag Source on Mac](https://community.mp3tag.de/t/timeout-when-running-audible-via-api-tag-source-on-mac/66094)
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [November 27, 2024, 9:21pm UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/11 "2024-11-27T21:21:43Z")
A post was split to a new topic: [Install webs source script](https://community.mp3tag.de/t/install-webs-source-script/66651)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [April 16, 2025, 8:47am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/13 "2025-04-16T08:47:35Z")
2 posts were split to a new topic: [Add support for FR and CA in WS Audible via API](https://community.mp3tag.de/t/add-support-for-fr-and-ca-in-ws-audible-via-api/68207)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [April 16, 2025, 8:40am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/15 "2025-04-16T08:40:03Z")
A post was split to a new topic: [Add Copyright to WS Audible via API](https://community.mp3tag.de/t/add-copyright-to-ws-audible-via-api/68206)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [April 28, 2025, 8:09am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/21 "2025-04-28T08:09:25Z")
3 posts were split to a new topic: [Modifications to the Audible via API WS](https://community.mp3tag.de/t/modifications-to-the-audible-via-api-ws/68329)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [May 18, 2025, 6:53pm UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/24 "2025-05-18T18:53:37Z")
6 posts were split to a new topic: [Settings Syntax Error - ERROR(Settings): expected value, got 'A' (65)](https://community.mp3tag.de/t/settings-syntax-error-error-settings-expected-value-got-a-65/68536)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [August 25, 2025, 10:36am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/25 "2025-08-25T10:36:21Z")
3 posts were split to a new topic: [Are series working with Audible WS at the moment?](https://community.mp3tag.de/t/are-series-working-with-audible-ws-at-the-moment/69532)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [September 6, 2025, 12:47pm UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/28 "2025-09-06T12:47:06Z")
2 posts were split to a new topic: [Bulk tagging of Audiobooks via Audible WS possible?](https://community.mp3tag.de/t/bulk-tagging-of-audiobooks-via-audible-ws-possible/69632)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [September 12, 2025, 7:49am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/30 "2025-09-12T07:49:52Z")
4 posts were split to a new topic: [Remove leading zeros from search term for Audible via WS?](https://community.mp3tag.de/t/remove-leading-zeros-from-search-term-for-audible-via-ws/69685)
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [October 11, 2025, 5:09pm UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/31 "2025-10-11T17:09:58Z")
A post was split to a new topic: [Use Audible web source on Mac](https://community.mp3tag.de/t/use-audible-web-source-on-mac/69983)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [November 3, 2025, 2:53pm UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/32 "2025-11-03T14:53:32Z")
2 posts were split to a new topic: [Add support for 2400x2400 px cover sizes from Audible if available](https://community.mp3tag.de/t/add-support-for-2400x2400-px-cover-sizes-from-audible-if-available/70071)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [May 5, 2026, 7:15am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/35 "2026-05-05T07:15:28Z")
3 posts were split to a new topic: [Use standard capitalization for format and language Audible via API](https://community.mp3tag.de/t/use-standard-capitalization-for-format-and-language-audible-via-api/71173)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [May 5, 2026, 7:12am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/38 "2026-05-05T07:12:53Z")
3 posts were split to a new topic: [ERROR(Settings): expected value, got ‘A‘ (65) when using Audible via API](https://community.mp3tag.de/t/error-settings-expected-value-got-a-65-when-using-audible-via-api/71172)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [May 5, 2026, 7:11am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/41 "2026-05-05T07:11:25Z")
2 posts were split to a new topic: [Chapter titles for Audiobooks via Audible](https://community.mp3tag.de/t/chapter-titles-for-audiobooks-via-audible/71171)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [May 5, 2026, 7:09am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/43 "2026-05-05T07:09:31Z")
2 posts were split to a new topic: [No result for audible UK version of a book](https://community.mp3tag.de/t/no-result-for-audible-uk-version-of-a-book/71170)
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [May 5, 2026, 7:59am UTC](https://community.mp3tag.de/t/ws-audible-via-api/64347/46 "2026-05-05T07:59:17Z")
3 posts were split to a new topic: [Audible via API to prevent use of empty fields when composing fields](https://community.mp3tag.de/t/audible-via-api-to-prevent-use-of-empty-fields-when-composing-fields/71175)
[Next page](https://community.mp3tag.de/t/ws-audible-via-api/64347.md?page=2)