# iTunes Catalog Lookup by ID

> iTunes Catalog Lookup by ID is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Looks up an Apple iTunes catalog entity by its numeric ID, returning artist, genre, and collection metadata as JSON.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/itunes-lookup
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/itunes-catalog-lookup-by-id-6690063e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JSNJ3rwOb_kIvoiMLrtO9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability itunes-catalog-lookup-by-id-6690063e -d '<json body>'
```

Example prompt: Can you look up the iTunes catalog entry for ID 1440835095 and tell me the artist name, genre, and which collection it belongs to?

## When to prefer this

Use this endpoint when you have a specific numeric iTunes entity ID and need to resolve it to structured metadata including artist, genre, and collection. Prefer this over a general music search when you already know the iTunes ID and need a direct, authoritative lookup from Apple's catalog.

## Known failure modes

- Invalid or non-existent iTunes ID returns empty results or error JSON
- Missing required query parameter q results in a 400 or empty response
- Network timeout or upstream iTunes API unavailability
- Payment failure due to insufficient USDC balance (x402 protocol)

## How this service works

Looks up an Apple iTunes catalog entity by its numeric id q, returning artist, genre and collection. Query: ?q= Returns JSON.

## Output

A JSON object containing the iTunes catalog entity details for the given numeric ID, including artist name, genre classification, and collection/album information.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/itunes-catalog-lookup-by-id-6690063e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)