# Covers Musichoarders — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access data from covers.musichoarders.xyz.

**Category:** Music | **Website:** [covers.musichoarders.xyz/](https://covers.musichoarders.xyz/) | **Docs:** [parse.bot/marketplace/2a9d9f6b-0339-4f4b-95f4-de1a26fb6cef/covers-musichoarders-xyz-api](https://parse.bot/marketplace/2a9d9f6b-0339-4f4b-95f4-de1a26fb6cef/covers-musichoarders-xyz-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-covers-musichoarders-xyz-api-2a9d9f6b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_album_cover

Search for album cover art by artist name, album name, or both. Returns a list of matching covers with URLs sized to the requested pixel dimensions. At least one of artist or album must be provided. Results are sourced from the specified music platform and country storefront.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `album` | string | No | Album name to search for. At least one of artist or album must be provided. |
| `artist` | string | No | Artist name to search for. At least one of artist or album must be provided. |
| `country` | string | No | Country storefront code for the search. |
| `pixel_size` | integer | No | Pixel dimensions for the cover image URL (width and height). Must be between 1 and 10000. |
| `source` | string | No | Music platform to search for covers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-covers-musichoarders-xyz-api-2a9d9f6b/get_album_cover \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"album":"<string>","artist":"<string>","country":"<string>","pixel_size":"<integer>","source":"<string>"}'
```