# Repertoire Bmi — 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.

> Search for music writers and composers to discover their complete songview catalog directly from BMI's repertoire database. Find detailed information about songs, compositions, and musical works created by your favorite artists and industry professionals.

**Category:** Music | **Website:** [repertoire.bmi.com/Search/Catalog?num=epD%252f4W7QIR53FWWH5f0rkA%253d%253d&cae=O3GZHCgB4J8GqHE%252fD060zw%253d%253d&partType=WriterList&search=%7B%22Main_Search_Text%22%3A%22Eden%20Joel%22%2C%22Sub_Search_Text%22%3A%22%22%2C%22Main_Search%22%3A%22Writer%2FComposer%22%2C%22Sub_Search%22%3Anull%2C%22Search_Type%22%3A%22all%22%2C%22View_Count%22%3A20%2C%22Page_Number%22%3A1%2C%22Part_Type%22%3Anull%2C%22Part_Id%22%3Anull%2C%22Part_Id_Sub%22%3Anull%2C%22Part_Name%22%3A%22URRY%20PHILIP%20EDEN%20JOEL%22%2C%22Part_Cae%22%3Anull%2C%22Original_Search%22%3Anull%2C%22Ip_Address%22%3A%22172.249.67.223%22%2C%22Pwa_Indicator%22%3Anull%2C%22DisclaimerViewed%22%3Anull%7D&resetPageNumber=True&partIdSub=YO0HedHMatLb45JzS23DVw%253d%253d](https://repertoire.bmi.com/Search/Catalog?num=epD%252f4W7QIR53FWWH5f0rkA%253d%253d&cae=O3GZHCgB4J8GqHE%252fD060zw%253d%253d&partType=WriterList&search=%7B%22Main_Search_Text%22%3A%22Eden%20Joel%22%2C%22Sub_Search_Text%22%3A%22%22%2C%22Main_Search%22%3A%22Writer%2FComposer%22%2C%22Sub_Search%22%3Anull%2C%22Search_Type%22%3A%22all%22%2C%22View_Count%22%3A20%2C%22Page_Number%22%3A1%2C%22Part_Type%22%3Anull%2C%22Part_Id%22%3Anull%2C%22Part_Id_Sub%22%3Anull%2C%22Part_Name%22%3A%22URRY%20PHILIP%20EDEN%20JOEL%22%2C%22Part_Cae%22%3Anull%2C%22Original_Search%22%3Anull%2C%22Ip_Address%22%3A%22172.249.67.223%22%2C%22Pwa_Indicator%22%3Anull%2C%22DisclaimerViewed%22%3Anull%7D&resetPageNumber=True&partIdSub=YO0HedHMatLb45JzS23DVw%253d%253d) | **Docs:** [parse.bot/marketplace/b1f9a2ae-3cbf-49f2-a48d-6fe2e17d7673/repertoire-bmi-com-api](https://parse.bot/marketplace/b1f9a2ae-3cbf-49f2-a48d-6fe2e17d7673/repertoire-bmi-com-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-repertoire-bmi-com-api-b1f9a2ae/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_catalog

Retrieve the Songview catalog of musical works for a specific writer/composer. Requires opaque identifiers obtained from search_writers. Returns paginated works with titles, BMI Work IDs, ISWC codes, reconciliation status, co-writers with their affiliations and IPI numbers, publishers with their affiliations and IPI numbers, performers, society control percentages, and alternate titles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cae` | string | Yes | Opaque CAE identifier from search_writers results (cae field). |
| `page` | integer | No | Page number for paginated catalog results. |
| `page_size` | integer | No | Number of works per page. Must be 20, 50, or 100. |
| `part_id_sub` | string | Yes | Opaque sub-identifier from search_writers results (part_id_sub field). |
| `search_text` | string | No | Original search text used to find this writer. When omitted, writer_name is used. |
| `search_type` | string | No | Catalog scope filter. |
| `writer_id` | string | Yes | Opaque writer identifier from search_writers results (writer_id field). |
| `writer_name` | string | Yes | Writer name as returned by search_writers (e.g. 'SHEERAN ED'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-repertoire-bmi-com-api-b1f9a2ae/get_catalog \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cae":"<string>","page":"<integer>","page_size":"<integer>","part_id_sub":"<string>","search_text":"<string>","search_type":"<string>","writer_id":"<string>","writer_name":"<string>"}'
```

### search_writers

Search for writers/composers by name in the BMI Songview database. Returns matching writers with their IPI numbers, affiliations, and opaque identifiers needed to fetch their full catalog via get_catalog.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Writer or composer name to search for (e.g. 'Ed Sheeran', 'Taylor Swift'). |
| `page` | integer | No | Page number of search results. |
| `search_type` | string | No | Which catalog scope to search in. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-repertoire-bmi-com-api-b1f9a2ae/search_writers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>","page":"<integer>","search_type":"<string>"}'
```