Skip to main content
POST
POST /search
Search the Trackyard catalog using natural language queries. Describe what you need in plain English, and the AI infers genre, mood, BPM, instrumentation, and more. Cost: 1 credit per request

Authentication

All requests require a valid API key in the Authorization header:

Request Body

string
required
Natural language description of the music you need.Examples:
  • "upbeat electronic music for a tech startup video"
  • "moody piano for a rainy scene"
  • "15-second clip for an Instagram Reel about travel"
number
default:20
Maximum number of results to return.Range: 1-100
number
default:0
Pagination offset. Use with limit to paginate through results.
object
Optional structured filters to refine results.

Example Request


Response

array
required
Array of track objects matching your query.
number
required
Your remaining credit balance after this request.

Example Response


Rate Limits

All responses include rate limit headers:
See Rate Limits & Credits for details.

Error Responses

Missing or invalid API key.
Out of credits.
Rate limit exceeded.
See Error Codes for full reference.

Tips for Better Results

Be specific: “upbeat electronic music for a tech startup video” beats “upbeat music”
Include context: Describe the scene, use case, or platform (Instagram Reel, podcast intro, etc.)
Combine AI + filters: Let the AI interpret your query, then add filters for surgical precision
Preview before downloading: Stream the preview_url to audition tracks before spending a credit on /download-track

Next Steps

Download Track

Download full tracks or smart-trimmed clips

Parameters Guide

Full reference of all search filters

AI-Powered Search

Learn how natural language search works

Code Examples

Python and JavaScript examples