batch_search_tidal
Search TIDAL for multiple tracks, albums, or artists in one request. Batch process up to 100 queries to reduce API calls and speed up data retrieval.
Instructions
Search TIDAL for multiple tracks/albums/artists in a single request.
This is MUCH MORE EFFICIENT than calling search_tidal multiple times.
USE THIS TOOL WHEN:
- You need to search for multiple songs to create a playlist
- You have a list of song names to look up
- You're building a collection of tracks based on a user's description
- The user provides a list of songs they want to find
This tool processes all searches concurrently, making it 10-50x faster than
calling search_tidal repeatedly for each song.
When processing the results:
1. Check each result for the 'tracks' array with matching songs
2. Use the first track in each result as the best match
3. Some queries may have 'error' instead of results - handle gracefully
4. Collect track IDs for playlist creation
Args:
queries: List of search queries. Each item can be:
- A string: "Bohemian Rhapsody Queen" (searches for tracks)
- A dict with 'query' and optional 'type':
{"query": "Bohemian Rhapsody", "type": "track"}
Valid types: "track", "album", "artist", "playlist", "all"
Default type is "track" if not specified.
Maximum 100 queries per request.
limit_per_query: Maximum results per query (default: 5, max: 20)
Keep this low (1-5) for faster responses when you only need the best match.
Returns:
Dictionary with 'results' array containing search results for each query.
Each result includes the original query and matching tracks/albums/etc.
Example:
batch_search_tidal([
{"query": "Bohemian Rhapsody Queen", "type": "track"},
{"query": "Yesterday Beatles", "type": "track"},
"Stairway to Heaven" # String queries default to track type
], limit_per_query=1)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| queries | Yes | ||
| limit_per_query | No |