How to search
Web dashboard
Sidebar → Catalog → search bar at top. Type any query:Via Aria
Via MCP
catalog_search is the semantic search — pass any text query, get
ranked results.
browse_catalog is the listing endpoint — paginate through your full
catalog without a query.
What you can search by
| Query type | Example | What it returns |
|---|---|---|
| Title | "Sleeper" | Tracks with that title |
| Artist | "Mira" | Tracks by that artist |
| ISRC | GBUM71029604 | The single matching track |
| Genre / mood tags | "dreampop", "melancholy" | Tracks tagged with those |
| Natural-language vibe | "slow sad ballad", "late-night" | Tracks whose AI caption matches the feel |
| Sonic similarity | "like [track ID]" | Tracks with similar audio to a reference track |
How search works
- Catalog metadata is normalized on every catalog write.
- Sonic features from sonic analysis ride alongside title, artist, ISRC, release date, and platform metadata.
- Similarity features are available for tracks with completed audio analysis.
- Results are scoped to your workspace and ranked by field match, freshness, audio similarity, and requested filters.
Examples
Find a specific track by ISRC
Find tracks for a playlist
Find similar tracks
Browse without a query
Limitations
- Search is only as good as the indexed data. Tracks without completed sonic analysis won’t match audio-feature queries.
- Similarity is catalog-only. “Find similar tracks” works within your own catalog.
- Index lag is ~30 seconds. A freshly imported track is searchable within ~30 seconds of import completing.
Pricing
Plans, AI credits, and limits live on the pricing page — we keep them there so they’re always current.Related pages
- Catalog import — what goes into the index
- Catalog upload — file path
- AI-discoverable tracks — the captions search ranks against
- Playlists — match tracks to playlist targets
FAQ
Can I search across other users' catalogs?
Can I search across other users' catalogs?
No. Search is scoped to your Patchline workspace. Enterprise
customers with multi-user workspace access search the shared
workspace catalog.
Why didn't my just-imported track show up?
Why didn't my just-imported track show up?
Search can have a ~30 second lag after import. Wait a moment and refresh.
If still missing after 5 minutes, the import may have failed —
check the catalog UI for an error state.
How are similar-track results ranked?
How are similar-track results ranked?
Patchline compares audio-similarity features from completed sonic
analysis and filters out weak matches. Metadata, genre, and audience
context can also affect the ranking.
Can I save searches?
Can I save searches?
Saved searches / smart playlists are on the roadmap. v1 you re-run
the query.