amoeba.com APIamoeba.com ↗
Search and browse Amoeba Music's catalog via API. Get album details, track listings, used listings with pricing, new releases, and store locations.
curl -X GET 'https://api.parse.bot/scraper/90ef3b1e-22c5-4af7-9ca5-f5f47eeeea37/search_catalog?query=Pink+Floyd' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for artists and albums in the Amoeba Music catalog. Returns matching results with links to artist or album pages.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'Beatles', 'Miles Davis') |
{
"type": "object",
"fields": {
"query": "string, the search query echoed back",
"results": "array of objects with title, url, meta (genre info), and type ('artist', 'album', or 'unknown')"
},
"sample": {
"data": {
"query": "Miles Davis",
"results": [
{
"url": "https://www.amoeba.com/miles-davis/artist/133059",
"meta": "(Jazz, Bop, Hard Bop, Cool Jazz, Fusion)",
"type": "artist",
"title": "Miles Davis"
}
]
},
"status": "success"
}
}About the amoeba.com API
The Amoeba Music API covers 5 endpoints for searching, browsing, and retrieving detailed data from Amoeba's vinyl and CD catalog. The get_product_detail endpoint returns full album metadata including track listings, condition-specific used listings with pricing, label, catalog number, and format — data that's useful for music inventory tools, price trackers, and collector applications.
Catalog Search and Product Data
The search_catalog endpoint accepts a keyword query and returns matching artists and albums with their titles, URLs, genre metadata, and type classification (artist, album, or unknown). These URLs feed directly into get_product_detail, which returns the full product record: title, artist, details (including genre, release_date, label, catalog_number, format, and length), a tracks array with track number, title, and duration, plus both listings (new copies with condition, price, and availability) and used_listings (used copies with condition, comment, and price).
Browsing and New Releases
The browse_vinyl_and_cd endpoint lets you page through the catalog with filters for type (new, used, or all) and a numeric genre ID. Each item in the response includes title, artist, url, date_added, format, and a prices object keyed by availability type. The get_new_releases endpoint returns items sorted by release date, also filterable by genre, with fields for title, artist, url, release_date, format, and price. Both endpoints use 1-based pagination and return a total count alongside the current page's results.
Store Locations
The get_store_info endpoint returns an array of Amoeba's physical store locations. Each entry includes the store's name (city), address, hours, and phone — useful for apps that need to surface in-store visit details alongside online listings.
- Track used vinyl prices by condition using
used_listingsfromget_product_detail - Build a new-release alert tool filtered by genre using
get_new_releases - Compare new and used copy availability for a specific album via
listingsandused_listings - Populate a music catalog database with label, catalog number, and track listings from
get_product_detail - Create a genre-filtered inventory browser using
browse_vinyl_and_cdwith thetypeandgenreparams - Display Amoeba store hours and addresses in a local music shop locator using
get_store_info - Resolve artist searches to specific album URLs using
search_catalogfollowed byget_product_detail
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Amoeba Music have an official developer API?+
What does `get_product_detail` return for used listings versus new listings?+
listings covers new copies with condition, price, and availability. used_listings covers used copies and adds a comment field — a per-copy note about condition specifics such as sleeve or media quality — which new listings do not include. Both arrays can be empty if no copies are in stock.Can I filter `browse_vinyl_and_cd` by specific format, such as 7-inch or LP?+
browse_vinyl_and_cd endpoint supports filtering by type (new/used/all) and numeric genre ID, but not by specific vinyl format. Format data is returned per item in the response. You can fork this API on Parse and revise it to add a format filter endpoint.Does `search_catalog` return pricing or availability data directly?+
search_catalog returns title, url, meta (genre info), and type for matching results — it does not include pricing or stock data. Pricing and availability are only available via get_product_detail using one of the returned URLs.Is artist page data available through `get_product_detail`?+
tracks, details, listings, used_listings) is populated from album pages, not artist pages. Use search_catalog to find album URLs directly when you need complete records.