const { useState, useEffect, useCallback } = React; // Custom Hook for responsive design const useResponsive = () => { const [dimensions, setDimensions] = useState({ width: typeof window !== 'undefined' ? window.innerWidth : 1200, height: typeof window !== 'undefined' ? window.innerHeight : 800, isMobile: typeof window !== 'undefined' ? window.innerWidth <= 768 : false, isTablet: typeof window !== 'undefined' ? (window.innerWidth > 768 && window.innerWidth <= 1024) : false, isDesktop: typeof window !== 'undefined' ? window.innerWidth > 1024 : true }); useEffect(() => { const handleResize = () => { const width = window.innerWidth; const height = window.innerHeight; setDimensions({ width, height, isMobile: width <= 768, isTablet: width > 768 && width <= 1024, isDesktop: width > 1024 }); }; window.addEventListener('resize', handleResize); handleResize(); return () => window.removeEventListener('resize', handleResize); }, []); return dimensions; }; // Icon Components const ChevronDown = ({ size = 16 }) => React.createElement('svg', { width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2" }, React.createElement('polyline', { points: "6 9 12 15 18 9" }) ); const Menu = ({ size = 24 }) => React.createElement('svg', { width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2" }, React.createElement('line', { x1: "3", y1: "12", x2: "21", y2: "12" }), React.createElement('line', { x1: "3", y1: "6", x2: "21", y2: "6" }), React.createElement('line', { x1: "3", y1: "18", x2: "21", y2: "18" }) ); const X = ({ size = 24 }) => ( ); const Copy = ({ size = 16 }) => ( ); const Check = ({ size = 16 }) => ( ); const Play = ({ size = 16 }) => ( ); // Authentication Overlay Component function AuthOverlay({ onAuthenticate, authError, isAuthenticating, responsive }) { const [localApiKey, setLocalApiKey] = useState(''); const handleSubmit = () => { if (localApiKey.trim()) { onAuthenticate(localApiKey.trim()); } }; return (
{/* Logo - Fixed position on all devices */}
REVERB API for Developers
{/* Animated Background */}
{/* Primary orange orbs - increased opacity and size */}
{/* Additional orange elements for more warmth */}
{/* Frosted glass overlay */}
{/* Main Content Area - Scrollable */}
{/* Existing Clients Login Card */}

Reverb Clients

setLocalApiKey(e.target.value)} onKeyPress={(e) => { if (e.key === 'Enter' && localApiKey.trim()) { handleSubmit(); } }} onFocus={(e) => { e.target.style.borderColor = 'rgba(255, 107, 53, 0.5)'; e.target.style.boxShadow = '0 0 20px rgba(255, 107, 53, 0.2)'; }} onBlur={(e) => { e.target.style.borderColor = 'rgba(255, 107, 53, 0.2)'; e.target.style.boxShadow = 'none'; }} />
{authError &&
{authError}
}

Don't have an API key or having trouble? Contact{' '} reverbtechsupport@bcguardian.com

{/* New Clients Info Card */}

Are you a Music Rights Owner?

The Reverb Catalog API enables rights owners to seamlessly synchronize their catalog with Reverb, BCGuardian's proprietary artificial intelligence and machine learning platform that helps rights owners recover lost revenue.

To request access for your organization:

{ if (!responsive.isMobile) { e.target.style.transform = 'translateY(-2px)'; e.target.style.boxShadow = '0 6px 25px rgba(255, 107, 53, 0.5)'; } }} onMouseLeave={(e) => { if (!responsive.isMobile) { e.target.style.transform = 'translateY(0)'; e.target.style.boxShadow = '0 4px 15px rgba(255, 107, 53, 0.3)'; } }}>Contact Us
{/* Footer - Sticky at bottom */} {/* Animation Styles */}
); } // Main Application Component function ReverbAPIDocumentation() { const responsive = useResponsive(); const [mobileMenuOpen, setMobileMenuOpen] = useState(false); const [dropdownOpen, setDropdownOpen] = useState(false); const [isAuthenticated, setIsAuthenticated] = useState(false); const [apiKey, setApiKey] = useState(''); const [authError, setAuthError] = useState(''); const [isAuthenticating, setIsAuthenticating] = useState(false); const [activePage, setActivePage] = useState('introduction'); const [copiedStates, setCopiedStates] = useState({}); const [activeLanguages, setActiveLanguages] = useState({}); const [testConsoles, setTestConsoles] = useState({}); const [formInputs, setFormInputs] = useState({ search: { apiKey: '', artist: '', song: '', isrc: '', limit: '10' }, add: { apiKey: '', artist1: '', song1: '', isrc1: '', copyright1: '', copyrightDate1: '', copyrightReg1: '', artist2: '', song2: '', isrc2: '', copyright2: '', copyrightDate2: '', copyrightReg2: '' }, update: { apiKey: '', isrc: '', song: '', copyright: '' }, csv: { apiKey: '' } }); // Check for saved session on mount useEffect(() => { const savedApiKey = localStorage.getItem('reverb_api_key'); if (savedApiKey) { validateApiKey(savedApiKey).catch(() => { localStorage.removeItem('reverb_api_key'); localStorage.removeItem('reverb_client_id'); }); } }, []); // Add/remove authenticated-content class to body useEffect(() => { if (isAuthenticated && !responsive.isMobile) { document.body.classList.add('authenticated-content'); } else { document.body.classList.remove('authenticated-content'); } return () => { document.body.classList.remove('authenticated-content'); }; }, [isAuthenticated, responsive.isMobile]); const validateApiKey = async (key) => { setIsAuthenticating(true); setAuthError(''); try { const response = await fetch('/api/v1/validate-key', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': key }, body: JSON.stringify({ validate: true }) }); const data = await response.json(); if (response.ok && data.success) { setIsAuthenticated(true); setApiKey(key); localStorage.setItem('reverb_api_key', key); if (data.client_id) { localStorage.setItem('reverb_client_id', data.client_id); } setFormInputs(prev => ({ search: { ...prev.search, apiKey: key }, add: { ...prev.add, apiKey: key }, update: { ...prev.update, apiKey: key }, csv: { ...prev.csv, apiKey: key } })); } else { setAuthError(data.error || 'Invalid API key. Please check your credentials.'); localStorage.removeItem('reverb_api_key'); localStorage.removeItem('reverb_client_id'); } } catch (error) { console.error('Authentication error:', error); setAuthError('Failed to validate API key. Please check your connection and try again.'); localStorage.removeItem('reverb_api_key'); localStorage.removeItem('reverb_client_id'); } finally { setIsAuthenticating(false); } }; const handleAuthenticate = (enteredKey) => { if (!enteredKey) { setAuthError('Please enter your API key'); return; } validateApiKey(enteredKey); }; const handleLogout = () => { setIsAuthenticated(false); setApiKey(''); localStorage.removeItem('reverb_api_key'); localStorage.removeItem('reverb_client_id'); setMobileMenuOpen(false); }; const copyToClipboard = async (text, id) => { try { await navigator.clipboard.writeText(text); setCopiedStates(prev => ({ ...prev, [id]: true })); setTimeout(() => { setCopiedStates(prev => ({ ...prev, [id]: false })); }, 2000); } catch (err) { console.error('Failed to copy:', err); } }; const scrollToSection = (sectionId) => { setTimeout(() => { const element = document.getElementById(sectionId); if (element) { element.scrollIntoView({ behavior: 'smooth', block: 'start' }); } }, 100); }; const testAPI = async (section) => { const consoleKey = `${section}-console`; setTestConsoles(prev => ({ ...prev, [consoleKey]: { loading: true, data: null, error: null } })); try { let endpoint, method, body; switch(section) { case 'search': endpoint = `/api/v1/reverb-catalog-access?limit=${formInputs.search.limit || 10}${formInputs.search.artist ? `&artist=${encodeURIComponent(formInputs.search.artist)}` : ''}${formInputs.search.song ? `&song_title=${encodeURIComponent(formInputs.search.song)}` : ''}`; method = 'GET'; break; case 'add': endpoint = '/api/v1/quick-batch'; method = 'POST'; body = JSON.stringify([{ artist: formInputs.add.artist1 || 'Demo Artist', song_title: formInputs.add.song1 || 'Test Track', isrc: formInputs.add.isrc1 || 'XX0001234567', copyright_claimant: formInputs.add.copyright1 || undefined, copyright_date: formInputs.add.copyrightDate1 || undefined, copyright_registration_num: formInputs.add.copyrightReg1 || undefined }]); break; case 'update': endpoint = `/api/v1/revise-reverb-catalog?isrc=${formInputs.update.isrc || 'XX0001234567'}`; method = 'PATCH'; body = JSON.stringify({ song_title: formInputs.update.song || 'Updated Song' }); break; case 'csv': setTestConsoles(prev => ({ ...prev, [consoleKey]: { loading: false, data: { status: 200, statusText: 'OK', response: { message: 'CSV upload endpoint ready. Use with actual CSV file.', endpoint: '/api/v1/upload-csv', method: 'POST', headers: { 'X-API-Key': apiKey, 'Content-Type': 'text/csv' } } }, error: null } })); return; default: throw new Error('Unknown section'); } const response = await fetch(endpoint, { method: method, headers: { 'X-API-Key': apiKey, 'Content-Type': 'application/json' }, body: method !== 'GET' ? body : undefined }); const data = await response.json(); setTestConsoles(prev => ({ ...prev, [consoleKey]: { loading: false, data: { status: response.status, statusText: response.statusText, response: data }, error: null } })); } catch (error) { setTestConsoles(prev => ({ ...prev, [consoleKey]: { loading: false, data: null, error: error.message } })); } }; const updateInput = (section, field, value) => { setFormInputs(prev => ({ ...prev, [section]: { ...prev[section], [field]: value } })); }; const getCodeExamples = useCallback((section) => { const examples = { search: { curl: `curl -X GET "https://reverb2catalogapi.bcguardian.com/api/v1/reverb-catalog-access?limit=${formInputs.search.limit || 10}${formInputs.search.artist ? `&artist=${encodeURIComponent(formInputs.search.artist)}` : ''}${formInputs.search.song ? `&song_title=${encodeURIComponent(formInputs.search.song)}` : ''}" \\ -H "X-API-Key: ${formInputs.search.apiKey || 'your-api-key-here'}" \\ -H "Content-Type: application/json"`, javascript: `const searchCatalog = async () => { const params = new URLSearchParams({ limit: ${formInputs.search.limit || 10}${formInputs.search.artist ? `, artist: "${formInputs.search.artist}"` : ''}${formInputs.search.song ? `, song_title: "${formInputs.search.song}"` : ''}${formInputs.search.isrc ? `, isrc: "${formInputs.search.isrc}"` : ''} }); const response = await fetch(\`https://reverb2catalogapi.bcguardian.com/api/v1/reverb-catalog-access?\${params}\`, { method: 'GET', headers: { 'X-API-Key': '${formInputs.search.apiKey || 'your-api-key-here'}', 'Content-Type': 'application/json' } }); const data = await response.json(); console.log(data); }; searchCatalog();`, python: `import requests url = "https://reverb2catalogapi.bcguardian.com/api/v1/reverb-catalog-access" headers = { "X-API-Key": "${formInputs.search.apiKey || 'your-api-key-here'}", "Content-Type": "application/json" } params = { "limit": ${formInputs.search.limit || 10}${formInputs.search.artist ? `, "artist": "${formInputs.search.artist}"` : ''}${formInputs.search.song ? `, "song_title": "${formInputs.search.song}"` : ''}${formInputs.search.isrc ? `, "isrc": "${formInputs.search.isrc}"` : ''} } response = requests.get(url, headers=headers, params=params) data = response.json() print(data)`, java: `import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class SearchCatalog { public static void main(String[] args) throws Exception { HttpClient client = HttpClient.newHttpClient(); String url = "https://reverb2catalogapi.bcguardian.com/api/v1/reverb-catalog-access?limit=${formInputs.search.limit || 10}${formInputs.search.artist ? `&artist=${encodeURIComponent(formInputs.search.artist)}` : ''}${formInputs.search.song ? `&song_title=${encodeURIComponent(formInputs.search.song)}` : ''}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .header("X-API-Key", "${formInputs.search.apiKey || 'your-api-key-here'}") .header("Content-Type", "application/json") .GET() .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }` }, add: { curl: `curl -X POST "https://reverb2catalogapi.bcguardian.com/api/v1/quick-batch" \\ -H "X-API-Key: ${formInputs.add.apiKey || 'your-api-key-here'}" \\ -H "Content-Type: application/json" \\ -d '[{ "artist": "${formInputs.add.artist1 || 'Demo Artist'}", "song_title": "${formInputs.add.song1 || 'Test Track One'}", "isrc": "${formInputs.add.isrc1 || 'XX0001234567'}"${formInputs.add.copyright1 ? `, "copyright_claimant": "${formInputs.add.copyright1}"` : ''}${formInputs.add.copyrightDate1 ? `, "copyright_date": "${formInputs.add.copyrightDate1}"` : ''}${formInputs.add.copyrightReg1 ? `, "copyright_registration_num": "${formInputs.add.copyrightReg1}"` : ''} }${formInputs.add.artist2 || formInputs.add.song2 || formInputs.add.isrc2 ? `, { "artist": "${formInputs.add.artist2 || 'Sample Band'}", "song_title": "${formInputs.add.song2 || 'Example Song'}", "isrc": "${formInputs.add.isrc2 || 'XX0001234568'}"${formInputs.add.copyright2 ? `, "copyright_claimant": "${formInputs.add.copyright2}"` : ''} }` : ''}]'`, javascript: `const addRecords = async () => { const records = [{ artist: "${formInputs.add.artist1 || 'Demo Artist'}", song_title: "${formInputs.add.song1 || 'Test Track One'}", isrc: "${formInputs.add.isrc1 || 'XX0001234567'}"${formInputs.add.copyright1 ? `, copyright_claimant: "${formInputs.add.copyright1}"` : ''}${formInputs.add.copyrightDate1 ? `, copyright_date: "${formInputs.add.copyrightDate1}"` : ''} }${formInputs.add.artist2 || formInputs.add.song2 ? `, { artist: "${formInputs.add.artist2 || 'Sample Band'}", song_title: "${formInputs.add.song2 || 'Example Song'}", isrc: "${formInputs.add.isrc2 || 'XX0001234568'}" }` : ''}]; const response = await fetch('https://reverb2catalogapi.bcguardian.com/api/v1/quick-batch', { method: 'POST', headers: { 'X-API-Key': '${formInputs.add.apiKey || 'your-api-key-here'}', 'Content-Type': 'application/json' }, body: JSON.stringify(records) }); const data = await response.json(); console.log(data); }; addRecords();`, python: `import requests import json url = "https://reverb2catalogapi.bcguardian.com/api/v1/quick-batch" headers = { "X-API-Key": "${formInputs.add.apiKey || 'your-api-key-here'}", "Content-Type": "application/json" } records = [ { "artist": "${formInputs.add.artist1 || 'Demo Artist'}", "song_title": "${formInputs.add.song1 || 'Test Track One'}", "isrc": "${formInputs.add.isrc1 || 'XX0001234567'}"${formInputs.add.copyright1 ? `, "copyright_claimant": "${formInputs.add.copyright1}"` : ''}${formInputs.add.copyrightDate1 ? `, "copyright_date": "${formInputs.add.copyrightDate1}"` : ''} }${formInputs.add.artist2 || formInputs.add.song2 ? `, { "artist": "${formInputs.add.artist2 || 'Sample Band'}", "song_title": "${formInputs.add.song2 || 'Example Song'}", "isrc": "${formInputs.add.isrc2 || 'XX0001234568'}" }` : ''} ] response = requests.post(url, headers=headers, data=json.dumps(records)) data = response.json() print(data)`, java: `import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; import com.google.gson.Gson; import java.util.List; import java.util.Map; public class AddRecords { public static void main(String[] args) throws Exception { HttpClient client = HttpClient.newHttpClient(); Gson gson = new Gson(); List> records = List.of( Map.of( "artist", "${formInputs.add.artist1 || 'Demo Artist'}", "song_title", "${formInputs.add.song1 || 'Test Track One'}", "isrc", "${formInputs.add.isrc1 || 'XX0001234567'}"${formInputs.add.copyright1 ? `, "copyright_claimant", "${formInputs.add.copyright1}"` : ''} )${formInputs.add.artist2 || formInputs.add.song2 ? `, Map.of( "artist", "${formInputs.add.artist2 || 'Sample Band'}", "song_title", "${formInputs.add.song2 || 'Example Song'}", "isrc", "${formInputs.add.isrc2 || 'XX0001234568'}" )` : ''} ); String jsonBody = gson.toJson(records); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://reverb2catalogapi.bcguardian.com/api/v1/quick-batch")) .header("X-API-Key", "${formInputs.add.apiKey || 'your-api-key-here'}") .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(jsonBody)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }` }, update: { curl: `curl -X PATCH "https://reverb2catalogapi.bcguardian.com/api/v1/revise-reverb-catalog?isrc=${formInputs.update.isrc || 'XX0001234567'}" \\ -H "X-API-Key: ${formInputs.update.apiKey || 'your-api-key-here'}" \\ -H "Content-Type: application/json" \\ -d '{ "song_title": "${formInputs.update.song || 'Updated Demo Song'}"${formInputs.update.copyright ? `, "copyright_claimant": "${formInputs.update.copyright}"` : ''} }'`, javascript: `const updateRecord = async () => { const updates = { song_title: "${formInputs.update.song || 'Updated Demo Song'}"${formInputs.update.copyright ? `, copyright_claimant: "${formInputs.update.copyright}"` : ''} }; const response = await fetch( 'https://reverb2catalogapi.bcguardian.com/api/v1/revise-reverb-catalog?isrc=${formInputs.update.isrc || 'XX0001234567'}', { method: 'PATCH', headers: { 'X-API-Key': '${formInputs.update.apiKey || 'your-api-key-here'}', 'Content-Type': 'application/json' }, body: JSON.stringify(updates) } ); const data = await response.json(); console.log(data); }; updateRecord();`, python: `import requests import json url = "https://reverb2catalogapi.bcguardian.com/api/v1/revise-reverb-catalog" headers = { "X-API-Key": "${formInputs.update.apiKey || 'your-api-key-here'}", "Content-Type": "application/json" } params = { "isrc": "${formInputs.update.isrc || 'XX0001234567'}" } updates = { "song_title": "${formInputs.update.song || 'Updated Demo Song'}"${formInputs.update.copyright ? `, "copyright_claimant": "${formInputs.update.copyright}"` : ''} } response = requests.patch(url, headers=headers, params=params, data=json.dumps(updates)) data = response.json() print(data)`, java: `import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; import com.google.gson.Gson; import java.util.Map; public class UpdateRecord { public static void main(String[] args) throws Exception { HttpClient client = HttpClient.newHttpClient(); Gson gson = new Gson(); Map updates = Map.of( "song_title", "${formInputs.update.song || 'Updated Demo Song'}"${formInputs.update.copyright ? `, "copyright_claimant", "${formInputs.update.copyright}"` : ''} ); String jsonBody = gson.toJson(updates); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://reverb2catalogapi.bcguardian.com/api/v1/revise-reverb-catalog?isrc=${formInputs.update.isrc || 'XX0001234567'}")) .header("X-API-Key", "${formInputs.update.apiKey || 'your-api-key-here'}") .header("Content-Type", "application/json") .method("PATCH", HttpRequest.BodyPublishers.ofString(jsonBody)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }` }, csv: { curl: `curl -X POST "https://reverb2catalogapi.bcguardian.com/api/v1/upload-csv" \\ -H "X-API-Key: ${formInputs.csv.apiKey || 'your-api-key-here'}" \\ -H "Content-Type: text/csv" \\ --data-binary @catalog.csv # Or with inline CSV data: curl -X POST "https://reverb2catalogapi.bcguardian.com/api/v1/upload-csv" \\ -H "X-API-Key: ${formInputs.csv.apiKey || 'your-api-key-here'}" \\ -H "Content-Type: text/csv" \\ --data-binary 'artist,song_title,isrc,copyright_claimant Stellar Wave,Digital Dreams,USRC12345001,Wave Music Group The Echo Chamber,Midnight Reflections,USRC12345002,Echo Productions LLC'`, javascript: `const uploadCSV = async () => { const csvContent = \`artist,song_title,isrc,copyright_claimant,copyright_date The Crickets,Yesterday,GBUM71505079,Apple Records,2024-01-15 King,Best Day,GBUM71500023,King Music Ltd,2024-02-20 Pink,You Were Here,GBDRL7500001,Pink Music,2024-03-10\`; const response = await fetch('https://reverb2catalogapi.bcguardian.com/api/v1/upload-csv', { method: 'POST', headers: { 'X-API-Key': '${formInputs.csv.apiKey || 'your-api-key-here'}', 'Content-Type': 'text/csv' }, body: csvContent }); const data = await response.json(); console.log(data); }; // Or upload from file input const uploadCSVFile = async (file) => { const csvContent = await file.text(); const response = await fetch('https://reverb2catalogapi.bcguardian.com/api/v1/upload-csv', { method: 'POST', headers: { 'X-API-Key': '${formInputs.csv.apiKey || 'your-api-key-here'}', 'Content-Type': 'text/csv' }, body: csvContent }); const data = await response.json(); console.log(data); }; uploadCSV();`, python: `import requests url = "https://reverb2catalogapi.bcguardian.com/api/v1/upload-csv" headers = { "X-API-Key": "${formInputs.csv.apiKey || 'your-api-key-here'}", "Content-Type": "text/csv" } # From file with open('catalog.csv', 'r') as file: csv_content = file.read() # Or inline csv_content = """artist,song_title,isrc,copyright_claimant,copyright_date,copyright_registration_num Demo Artist,Test Track One,TEST12345001,Demo Publishing LLC,2024-01-15,REG2024001 Sample Band,Example Song,TEST12345002,Sample Music Group,2024-02-20,REG2024002 Studio Crew,Digital Dreams,TEST12345003,Studio Records Inc,2024-03-10,REG2024003 Echo Chamber,Midnight Run,TEST12345004,Echo Productions,2024-04-05,""" response = requests.post(url, headers=headers, data=csv_content) data = response.json() print(data)`, java: `import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; import java.nio.file.Files; import java.nio.file.Paths; public class UploadCSV { public static void main(String[] args) throws Exception { HttpClient client = HttpClient.newHttpClient(); // Read CSV from file String csvContent = Files.readString(Paths.get("catalog.csv")); // Or use inline CSV /* String csvContent = """ artist,song_title,isrc,copyright_claimant Stellar Wave,Digital Dreams,USRC12345001,Wave Music Group The Echo Chamber,Midnight Reflections,USRC12345002,Echo Productions LLC Neon Skyline,Electric Pulse,USRC12345003,Skyline Records Inc """; */ HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://reverb2catalogapi.bcguardian.com/api/v1/upload-csv")) .header("X-API-Key", "${formInputs.csv.apiKey || 'your-api-key-here'}") .header("Content-Type", "text/csv") .POST(HttpRequest.BodyPublishers.ofString(csvContent)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }` } }; return examples[section] || {}; }, [formInputs]); if (!isAuthenticated) { return ; } // Main app after authentication return (
{/* Static Background - No animations after login */}
{/* Primary large orange orbs */}
{/* Additional medium orange elements */}
{/* Smaller accent orbs */}
{/* Navigation */} {/* Main Content */}
{activePage === 'introduction' && } {activePage === 'catalog-management' && ( )}
{/* Footer */}

BCGuardian Proprietary and Confidential. All Rights Reserved © 2025-2030

); } // Introduction Page Component (unchanged) function IntroductionPage({ setActivePage, responsive }) { return (

Reverb Catalog API Documentation

Easily integrate and manage your catalog with Reverb to protect and recover lost revenue.

Introduction

How Reverb Works

Reverb enables you to recover lost licensing revenue in real time. It is BCGuardian's proprietary artificial intelligence and machine learning application that detects, verifies, and monitors unauthorized use of your music on social media in real time.

Reverb's Technology:

Reverb's technology is a multi-step real-time proprietary workflow that blends state of the art technology and human expertise generally composed of these steps:

{[ { num: "1", title: "Post Collection", desc: "This is where we collect the posts from the different social media networks." }, { num: "2", title: "Music Identification", desc: "This is where we split and identify the music inside the post. This also when we preserve the videos and the music." }, { num: "3", title: "Catalog Matching", desc: "This is where we take the post with the identified music and match it to your catalog. Records are then pushed into Reverb, and they are available to you with an initial status." }, { num: "4", title: "Human Verification", desc: "BCGuardian content review specialists (CRS) review the records and update the status. These statuses are pushed to Reverb app in real-time." }, { num: "5", title: "Still/Image Preservation", desc: "For all BCGuardian-Verified posts, Reverb triggers image/still preservation, capturing engagement metrics, comments, etc." } ].map((step) => (
{step.num}
{step.title}

{step.desc}

))}

Why Your Catalog Matters

During the third phase of Reverb, collected posts are automatically matched against your catalog's assets. A robust, up to date catalog helps Reverb identify more unauthorized use of your music, which can translate to more recovered licensing revenue. This API was specifically built to allow your technical team to automatically integrate and maintain an up-to-date catalog, eliminating the need for manual exports and emails.

); } // Catalog Management Page Component - Updated with all fields function CatalogManagementPage({ formInputs, updateInput, activeLanguages, setActiveLanguages, getCodeExamples, copyToClipboard, copiedStates, testAPI, testConsoles, responsive }) { const setLanguage = (section, language) => { setActiveLanguages(prev => ({ ...prev, [section]: language })); }; return (

Overview of Reverb Catalog Schema

At the moment, Reverb's third phase works exclusively with recording information, so your catalog must include the corresponding details. If you are a publisher and do not have the necessary recording information, please contact us at{' '} { if (!responsive.isMobile) { e.target.style.transform = 'translateY(-1px)'; e.target.style.boxShadow = '0 4px 12px rgba(255, 107, 53, 0.5)'; } }} onMouseLeave={(e) => { if (!responsive.isMobile) { e.target.style.transform = 'translateY(0)'; e.target.style.boxShadow = '0 2px 8px rgba(255, 107, 53, 0.3)'; } }}> reverbaccountsupport@bcguardian.com .

Catalog Database Structure

Your catalog is stored in our backend structure. Each record represents a single song in your catalog.

{['Column', 'Type', 'Constraint', 'Optional', 'Default', 'Description'].map(header => ( ))}
Table: reverb_catalog
{header}
artist VARCHAR(255) - NO - Recording artist or band name
song_title VARCHAR(255) - NO - Recording track or song title
isrc VARCHAR(12) PRIMARY KEY NO - Unique recording identifier (12 characters)
copyright_claimant VARCHAR(255) - YES NULL Copyright owner or publisher
copyright_date VARCHAR(255) - YES NULL Copyright registration date
copyright_registration_num VARCHAR(50) - YES NULL Official registration number
api_id VARCHAR(100) UNIQUE NO AUTO System-generated unique API identifier
date_updated_to_table_sql TIMESTAMP - NO CURRENT_TIMESTAMP Last modification timestamp
{/* API Endpoints */}
); } // New CSV Upload Section Component function CSVUploadSection({ formInputs, updateInput, activeLanguages, setLanguage, getCodeExamples, copyToClipboard, copiedStates, testAPI, testConsole, responsive }) { const languages = ['curl', 'javascript', 'python', 'java']; const examples = getCodeExamples('csv'); const activeLanguage = activeLanguages.csv || 'curl'; return (

Bulk Upload via CSV

Upload multiple catalog records at once using a CSV file. Supports batch processing of up to thousands of records with strict header validation. If an ISRC already exists in our dataset, we will update the record based on the fields you provide.

{/* Endpoint Header */}
POST /api/v1/upload-csv
{/* CSV Format Requirements */}

CSV Format Requirements

Required Headers (case-sensitive):

artist, song_title, isrc

Optional Headers:

copyright_claimant, copyright_date, copyright_registration_num

Strict Requirements:

  • Headers must match exactly (case-sensitive)
  • Use underscores, not spaces: song_title not song title
  • No variations accepted: artist not Artist or artist_name
  • All required fields must have non-empty values
  • Maximum file size: 50MB
  • Supported delimiters: comma (,) or tab (\t)
{/* Example CSV Format */}

Example CSV Format

{`artist,song_title,isrc,copyright_claimant,copyright_date,copyright_registration_num
Demo Artist,Test Track One,TEST12345001,Demo Publishing LLC,2024-01-15,REG2024001
Sample Band,Example Song,TEST12345002,Sample Music Group,2024-02-20,REG2024002
Studio Crew,Digital Dreams,TEST12345003,Studio Records Inc,2024-03-10,REG2024003
Echo Chamber,Midnight Run,TEST12345004,Echo Productions,2024-04-05,`}
{/* API Key Input */}

Configure Parameters

updateInput('csv', 'apiKey', e.target.value)} style={{ padding: '0.5rem', background: 'rgba(0,0,0,0.3)', border: '1px solid rgba(255, 255, 255, 0.08)', borderRadius: '4px', color: '#ffffff', fontSize: '16px' }} />
{/* Code Examples */}
{languages.map((lang) => ( ))}
{activeLanguage === 'curl' ? 'cURL' : activeLanguage === 'java' ? 'Java' : activeLanguage.charAt(0).toUpperCase() + activeLanguage.slice(1)} Request 
                  {examples[activeLanguage]}
{/* Response Format Examples */}
Success Response Format
                {`{
  "success": true,
  "message": "CSV processed successfully with strict validation",
  "validation_summary": {
    "strict_mode": true,
    "required_headers_validated": true,
    "exact_match_enforced": true,
    "case_sensitive": true
  },
  "results": {
    "total_processed": 150,
    "added": 120,
    "updated": 30,
    "failed": 0,
    "parse_errors": 0
  },
  "header_analysis": {
    "required_found": ["artist", "song_title", "isrc"],
    "optional_found": ["copyright_claimant"],
    "delimiter_used": ","
  },
  "processing_time": "245ms"
}`}
Error Response Format
                {`{
  "success": false,
  "error": "Missing Required Headers",
  "message": "CSV is missing required column headers",
  "validation_details": {
    "required_headers": ["artist", "song_title", "isrc"],
    "missing_headers": ["isrc"],
    "found_headers": ["artist", "title"],
    "header_count": 2
  },
  "common_mistakes": [
    "Found 'title' - should be 'song_title'",
    "Using 'ISRC' instead of 'isrc'"
  ],
  "correct_example": "artist,song_title,isrc,copyright_claimant"
}`}
{/* Test Console */} {testConsole && (

API Response

                {testConsole.loading && 'Loading endpoint information...'}
                {testConsole.error && `Error: ${testConsole.error}`}
                {testConsole.data && (
                  <>
                    {`Response Status: ${testConsole.data.status} ${testConsole.data.statusText}\n\n`}
                    {JSON.stringify(testConsole.data.response, null, 2)}
                  
                )}
)}
); } // Troubleshooting Page Component (New) function TroubleshootingPage({ responsive }) { return (

Troubleshooting & FAQ

Common error codes, their meanings, and frequently asked questions.

Error Code Reference

{/* 400 Bad Request */}
400 Bad Request CLIENT ERROR

The request contains invalid syntax or missing required parameters.

Solution:

Review the request body and ensure all required fields are present with correct data types.

{/* 401 Unauthorized */}
401 Unauthorized AUTH ERROR

Authentication is required but was not provided or is invalid.

Solution:

Ensure the X-API-Key header is included with your valid API key.

{/* 404 Not Found */}
404 Not Found NOT FOUND

The requested endpoint or resource does not exist.

Solution:

Verify the endpoint URL matches documentation. All endpoints start with{' '} /api/v1/

{/* 429 Rate Limit */}
429 Too Many Requests RATE LIMIT

Request rate limit exceeded. Default: 100 requests per minute per API-key.

Solution:

Implement request throttling. Check{' '} X-Rate-Limit-Remaining header.

{/* 500 Internal Server Error */}
500 Internal Server Error SERVER ERROR

An unexpected error occurred on the server.

Solution:

Retry the request after a brief delay. If persistent, contact support.

{/* FAQ Section */}

Frequently Asked Questions

How do I handle duplicate ISRCs?

The system uses ISRC as a unique identifier. When you POST a record with an existing ISRC, it will update the existing record rather than create a duplicate. Use the PATCH endpoint for explicit updates.

What is the maximum batch size for CSV uploads?

CSV uploads support up to 50MB file size. For optimal performance, we recommend batches of 5,000-10,000 records. Larger catalogs should be split into multiple uploads.

How often should I synchronize my catalog?

We recommend daily or weekly synchronization depending on your catalog update frequency. Implement incremental updates for changed records rather than full catalog replacements.

What happens if my API key is compromised?

Contact support immediately at{' '} reverbtechsupport@bcguardian.com{' '} to revoke the compromised key and issue a replacement.

{/* Contact Support */}
); } // API Endpoint Component (with Java support) function APIEndpoint({ title, description, method, endpoint, methodColor, methodTextColor, section, formInputs, updateInput, activeLanguage, setLanguage, getCodeExamples, copyToClipboard, copiedStates, testAPI, testConsole, responsive, fields }) { const languages = ['curl', 'javascript', 'python', 'java']; const examples = getCodeExamples(section); return (

{title}

{description}

{/* Endpoint Header */}
{method} {endpoint}
{/* Parameters Form */}

Configure Parameters

{fields.map((field) => (
updateInput(section, field.name, e.target.value)} min={field.min} max={field.max} style={{ padding: '0.5rem', background: 'rgba(0,0,0,0.3)', border: '1px solid rgba(255, 255, 255, 0.08)', borderRadius: '4px', color: '#ffffff', fontSize: '16px' }} />
))}
{/* Code Examples */}
{languages.map((lang) => ( ))}
{activeLanguage === 'curl' ? 'cURL' : activeLanguage === 'java' ? 'Java' : activeLanguage.charAt(0).toUpperCase() + activeLanguage.slice(1)} Request 
                  {examples[activeLanguage]}
{/* Test Console */} {testConsole && (

API Response

                {testConsole.loading && 'Sending request...'}
                {testConsole.error && `Error: ${testConsole.error}`}
                {testConsole.data && (
                  <>
                    {`Response Status: ${testConsole.data.status} ${testConsole.data.statusText}\n\n`}
                    {JSON.stringify(testConsole.data.response, null, 2)}
                  
                )}
)}
); } // Render the component const root = ReactDOM.createRoot(document.getElementById('root')); root.render();