Sync API V2.1 Documentation

Real-time music licensing price predictions powered by machine learning

Interactive Docs

Overview

Real-time Predictions

Instant pricing based on ML models trained on industry data

Global Coverage

Support for local, regional, and global licensing scenarios

Easy Integration

Simple REST API with comprehensive documentation

The Sync API V2.1 provides real-time music licensing price predictions for sync licensing across multiple usage types including advertising, film/TV, video games, and content creation. Our machine learning models are trained on actual industry licensing data to provide accurate market-based pricing estimates.

Getting Started

Base URL

https://sync-api-v2-fw24fpoaza-uc.a.run.app

Authentication

All requests require an API key in the X-API-Key header:

X-API-Key: YOUR_API_KEY_HERE

Rate Limits

• 100 requests per minute per IP address
• Contact us for higher limits if needed

Supported Usage Types

🎬 Film/TV

Feature films, TV series, documentaries, trailers

Subtypes: in_program, trailer_marketing, promo_network

📺 Advertising

TV, radio, online, cinema campaigns

Subtypes: brand_campaign, product_launch, seasonal_promotion

🎮 Video Games

AAA games, indie games, mobile games

Subtypes: in_game_background, cutscene, menu_ui

📱 Content Creator

YouTube, TikTok, Instagram, Twitch content

Subtypes: background_music, intro_outro, highlight_reel

Usage Examples

Advertising Campaign

bash

curl -X POST "https://sync-api-v2-fw24fpoaza-uc.a.run.app/api/v2/predict" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
  "title": "Blinding Lights",
  "artist": "The Weeknd",
  "usage_type": "Advertising", 
  "usage_subtype": "brand_campaign",
  "territory_ui": "Global",
  "client_size": "International/Global",
  "duration_days": 365,
  "media_types": ["Television", "Online"]
}'

YouTube Content Creator

bash

curl -X POST "https://sync-api-v2-fw24fpoaza-uc.a.run.app/api/v2/predict" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
  "title": "Shape of You",
  "artist": "Ed Sheeran",
  "usage_type": "Content Creator",
  "usage_subtype": "background_music", 
  "platform": "youtube",
  "follower_count": "500K",
  "territory_ui": "Global",
  "duration_days": 365,
  "media_types": ["Online"]
}'

Integration Examples

JavaScript/Node.js

javascript

const response = await fetch('https://sync-api-v2-fw24fpoaza-uc.a.run.app/api/v2/predict', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    title: 'Song Title',
    artist: 'Artist Name',
    usage_type: 'Advertising',
    usage_subtype: 'brand_campaign',
    territory_ui: 'Global',
    duration_days: 365,
    media_types: ['Television']
  })
});

const data = await response.json();
console.log(`Price range: $${data.predicted_price_low} - $${data.predicted_price_high}`);

Python

python

import requests

url = "https://sync-api-v2-fw24fpoaza-uc.a.run.app/api/v2/predict"
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
}
data = {
    "title": "Song Title",
    "artist": "Artist Name", 
    "usage_type": "Advertising",
    "usage_subtype": "brand_campaign",
    "territory_ui": "Global",
    "duration_days": 365,
    "media_types": ["Television"]
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print("Price range: $" + str(result["predicted_price_low"]) + " - $" + str(result["predicted_price_high"]))

💡 Pro Tip: Using ISRC

For the most accurate results, include the ISRC (International Standard Recording Code) in your requests. This eliminates ambiguity and ensures correct artist popularity data.

Response Format

json

{
  "track_name": "Anti-Hero",
  "artist_name": "Taylor Swift", 
  "currency": "USD",
  "estimator_version": "v2.1.0",
  "predicted_price_low": 45000.0,
  "predicted_price_high": 55000.0
}

Support & Contact

Integration Support

Need help integrating the API? Contact our team through our contact page

Rate Limit Increases

Interactive API Documentation

Try out the API directly in your browser with our interactive Swagger documentation.

Open Interactive Docs