Migrate research provider to SongStats

.env.example

@@ -17,6 +17,7 @@ RESEND_API_KEY=
 PERPLEXITY_API_KEY=
 SERPAPI_API_KEY=
 ANTHROPIC_API_KEY=
+SONGSTATS_API_KEY=
 
 # Spotify
 SPOTIFY_CLIENT_ID=

app/api/research/albums/route.ts

@@ -12,10 +12,10 @@ export async function OPTIONS() {
 }
 
 /**
- * GET /api/research/albums — Album discography for a Chartmetric artist id.
+ * GET /api/research/albums — Album discography for a provider artist id.
  * Discovery by name is the caller's job via `GET /api/research`.
  *
- * @param request - must include numeric `artist_id` query param
+ * @param request - must include provider `artist_id` query param
  * @returns JSON album list or error
  */
 export async function GET(request: NextRequest) {

app/api/research/metrics/route.ts

@@ -2,6 +2,8 @@ import { NextRequest, NextResponse } from "next/server";
 import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getResearchMetricsHandler } from "@/lib/research/getResearchMetricsHandler";
 
+export const maxDuration = 60;
+
 /**
  * OPTIONS /api/research/metrics — CORS preflight.
  *

app/api/research/playlists/route.ts

@@ -2,6 +2,9 @@ import { NextRequest, NextResponse } from "next/server";
 import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getResearchPlaylistsHandler } from "@/lib/research/getResearchPlaylistsHandler";
 
+// SongStats top_playlists (scope=current) is a slow stat call; allow up to 60s.
+export const maxDuration = 60;
+
 /**
  * OPTIONS /api/research/playlists — CORS preflight.
  *

app/api/research/track/playlists/route.ts

@@ -14,7 +14,7 @@ export async function OPTIONS() {
 /**
  * GET /api/research/track/playlists — Playlists featuring a specific track. Requires `?id=` or `?q=` query param.
  *
- * @param request - must include `id` (Chartmetric track ID) or `q` (track name) query param
+ * @param request - must include `id` (provider track ID) or `q` (track name) query param
  * @returns JSON playlist placements for the track or error
  */
 export async function GET(request: NextRequest) {

app/api/research/track/route.ts

@@ -12,10 +12,10 @@ export async function OPTIONS() {
 }
 
 /**
- * GET /api/research/track — Full Chartmetric track details by numeric `id`.
+ * GET /api/research/track — Full provider track details by `id`.
  * Discovery (search by name) is the caller's job via `GET /api/research`.
  *
- * @param request - must include numeric `id` query param
+ * @param request - must include provider `id` query param
  * @returns JSON track details or error
  */
 export async function GET(request: NextRequest) {