# Sonoteller Music Analysis API

> Sonoteller Music Analysis API is a paid API for AI agents from sna4an-sosmed-v1.vercel.app, paid per call via x402, $0.18/call, status unknown (last checked 2026-10-12).

Analyzes a music track or artist query to return music metadata, genre classification, mood, and sonic characteristics via the Sonoteller AI music analysis service

## Facts

- Endpoint: POST https://sna4an-sosmed-v1.vercel.app/api/sonoteller?utm_source=zero.xyz
- Price: $0.18/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sonoteller-music-analysis-api-6e44db8e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mMlOxRmEog2Kdl3xIgOb9

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 sonoteller-music-analysis-api-6e44db8e -d '<json body>'
```

Example prompt: Can you analyze the mood, genre, and sonic characteristics of 'Blinding Lights' by The Weeknd using Sonoteller?

## When to prefer this

Choose this endpoint when you need AI-powered music genre, mood, or sonic characteristic analysis for a known song or artist. It is well-suited for music recommendation engines, playlist curation, music journalism, or any workflow requiring structured musical metadata from a natural language query. Prefer this over general web search when you need structured, machine-readable music classification data rather than editorial descriptions.

## Known failure modes

- Ambiguous or misspelled query string may return inaccurate or irrelevant analysis
- Unknown or very obscure tracks may return empty or low-confidence results
- Overly generic queries (e.g. 'happy song') may yield unpredictable classification
- Service outage or upstream Sonoteller API unavailability returns an error response
- Payment failure via x402/Base chain blocks the request before processing

## How this service works

126 paid social media API endpoints - TikTok, Instagram, Twitter/X, YouTube, Finance, AI Tools &amp; more. Protected by x402 micropayments on Base chain.

## Output

Returns a JSON object containing music analysis results including genre classifications, mood labels, sonic descriptors, energy levels, and other AI-derived musical characteristics for the queried track or artist.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sonoteller-music-analysis-api-6e44db8e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sna4an-sosmed-v1.vercel.app](https://www.zero.xyz/host/sna4an-sosmed-v1.vercel.app/llms.txt)