Artyfile Music Licensing

Search the Artyfile catalog of licensable music — real recordings by real orchestras and musicians (never AI-generated). Returns ranked tracks with prices; each result id is the productId create_checkout accepts. Results with licenseScope "master_only" are Cover Editions with NO sync licence — do not pick them for film/video/media projects.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Use case, mood, genre or instrumentation, e.g. \"epic cinematic trailer\" or \"calm piano for a documentary\""
    },
    "genre": {
      "type": "string",
      "maxLength": 60,
      "description": "Optional genre filter, one of: Cinematic, Classical, Pop, Rock, Electronic, Ambient, Folk, Jazz, Lounge, World, Choral, Hip-Hop, Funk & Soul, Country"
    },
    "mood": {
      "type": "string",
      "maxLength": 60,
      "description": "Optional mood filter, one of: Uplifting, Happy, Energetic, Playful, Groovy, Epic, Dramatic, Suspenseful, Dark, Mysterious, Dreamy, Calm, Tender, Romantic, Reflective, Nostalgic, Melancholic, Solemn, Festive, Elegant"
    },
    "use_case": {
      "type": "string",
      "maxLength": 30,
      "description": "Optional use-case filter, one of: film, trailer, documentary, advertising, corporate, wedding, meditation, social, gaming, podcast, fashion, travel, sports, kids, christmas, party"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full details for one track by productId or slug: metadata, prices, licence scope, preview URL, human product page.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80,
      "description": "productId (from search_tracks) or the track slug"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Machine-readable summary of the Artyfile licence tiers: Basic (€29.90 one-time, worldwide perpetual sync licence) and Limited Edition (€69.90 per 1% numbered master share incl. revenue participation). Includes the Cover-Edition (master_only) restrictions and links to the binding Terms & Conditions.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a checkout for one track. Returns a Stripe hosted-payment URL that the USER must open and approve in a browser (EU PSD2 — payment is never completed by the agent) plus the order publicId for polling. The session and its price reservation expire after 1 hour.

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "id from search_tracks / get_track"
    },
    "tier": {
      "type": "string",
      "enum": [
        "basic",
        "le"
      ],
      "default": "basic",
      "description": "\"basic\" = sync licence; \"le\" = Limited Edition master share(s)"
    },
    "shares": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 1,
      "description": "LE only: number of 1% shares"
    },
    "giftName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "LE only: issue the ownership certificate to this name"
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "de"
      ],
      "default": "en"
    }
  },
  "required": [
    "productId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Poll an order by publicId. Once status is "paid" the payload carries downloadUrl (44.1 kHz WAV), invoiceUrl and certificateUrl (PDFs). Poll roughly every 15 seconds; a pending order older than 1 hour has expired.

{
  "type": "object",
  "properties": {
    "publicId": {
      "type": "string",
      "minLength": 6,
      "maxLength": 64
    }
  },
  "required": [
    "publicId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Download + document URLs for a PAID order: the WAV download (link re-issuable anytime, no cookies needed), the PDF invoice and the PDF licence/ownership certificate.

{
  "type": "object",
  "properties": {
    "publicId": {
      "type": "string",
      "minLength": 6,
      "maxLength": 64
    }
  },
  "required": [
    "publicId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}