Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.fanaura.com/llms.txt

Use this file to discover all available pages before exploring further.

Fanaura integrates with Spotify in a read-only capacity: artist search during onboarding and track/album metadata lookup when creating music assets. Fanaura does not use Spotify OAuth for pre-saves or library modifications.

​
What This Integration Does

  • Artist search (onboarding): When an artist signs up, they search for their Spotify artist profile to connect their identity.
  • Track metadata lookup: When creating a music asset, Fanaura searches the Spotify catalog to auto-fill song title, artist name, artwork, ISRC, and release date.
  • Artist tracks: The favorite song picker during fan onboarding pulls an artist’s top tracks from Spotify.

​
What This Integration Does NOT Do

  • No library saves — Fanaura does not save tracks to fans’ Spotify libraries
  • No OAuth from fans — Fans never authorize Spotify access through Fanaura
  • No OAuth from artists — Artists do not connect their Spotify for Artists account
Pre-saves in Fanaura use a native notification system instead of Spotify OAuth. See the “How Pre-Saves Actually Work” section below.

​
How Pre-Saves Actually Work

Fanaura deliberately chose not to implement traditional OAuth-based pre-saves (where a song is silently added to a fan’s Spotify library). Instead, Fanaura uses a native notification system that is platform-independent and drives higher engagement. Why not OAuth pre-saves?
  • Spotify requires 250,000 monthly active users for extended API access — an insurmountable barrier for any pre-revenue startup
  • Other platforms (Amazon Music, Deezer) have similar restrictions or closed developer registration entirely
  • A song silently added to a library generates no engagement moment — fans may never notice it
How Fanaura’s native pre-saves work:
1

Fan Visits Smart Link

Fan visits the artist’s smart link or pre-save page.
2

Fan Authenticates

Fan signs in with Fanaura (phone or email OTP). No Spotify login required.
3

Fan Selects Platform

Fan picks their preferred streaming platform (Spotify, Apple Music, YouTube Music, etc.).
4

Pre-Save Recorded

Fanaura records the pre-save internally and awards fan reward points.
5

Release Day Notification

On release day, Fanaura sends the fan a direct message (email or SMS) with a link to stream on their chosen platform.
6

Fan Streams

Fan clicks the link, which opens directly in their streaming app. The song starts playing immediately.
This approach creates an active engagement moment rather than a passive library addition, and works across every streaming platform — not just those with open APIs.

​
Artist Search and Metadata

When you create a new music asset in Fanaura:
1

Search

You enter the song title or artist name.
2

Results

Fanaura searches the Spotify catalog using the Spotify Search API. Matching results appear with artwork, title, artist, and album.
3

Auto-Fill

Select the correct match and metadata auto-fills into your asset.

​
What Metadata Gets Imported

FieldSource
Song titleSpotify catalog
Artist name(s)Spotify catalog
Album/single titleSpotify catalog
ArtworkSpotify catalog (high-resolution)
Release dateSpotify catalog
ISRCSpotify catalog
Spotify URIGenerated from match

​
No Artist Spotify Account Required

You do not need to connect your Spotify for Artists account to Fanaura. Metadata uses the public catalog. Fans use their own streaming apps — Fanaura just facilitates the connection through direct links, not library access.

​
Setup

Spotify search integration is configured at the platform level by Fanaura. There is no per-artist setup required.

​
For Your Team to Know

  • No API keys to enter.
  • No OAuth to authorize from your end.
  • Artist search and metadata lookup work automatically.

​
Spotify API Endpoints Used

EndpointPurpose
GET /v1/search?type=artistArtist search during onboarding
GET /v1/search?type=trackTrack metadata lookup
GET /v1/artists/{id}/top-tracksFavorite song picker in fan onboarding
GET /v1/artists/{id}/albumsArtist discography lookup
GET /v1/albums?ids=Album track listings
All endpoints use Spotify’s Client Credentials flow (app-level access) — no user OAuth tokens are involved.

​
Troubleshooting

  • Ensure the artist name is spelled correctly. The search is fuzzy but works best with exact names.
  • Very new or very small artists may not appear in Spotify’s catalog yet.
  • Check that the song exists on Spotify. Unreleased songs won’t appear in search results.
  • Try searching by ISRC if the title search returns too many results.
  • This is handled by Fanaura’s native notification system, not Spotify. Check the fan’s email/SMS delivery status in the activity logs.