Naija Radio/Developers
Documentation / Quick start

Documentation

Community

API v1 · Free access

Get started

Quick start

Create an API key, configure your server, and make your first request.

1. Get your API key

Sign in to your API dashboard and create a free key for your website, app or game. Your account includes 100 requests per minute across all keys at ₦0, with usage visible in your dashboard. Keep your key on your server and never include it in public code.

Get your free API key →

2. Configure your environment

Store these variables in the website’s server environment or hosting secret settings:

.env.local
NAIJA_RADIO_API_KEY=nr_your_key_here
NAIJA_RADIO_API_BASE_URL=https://fm.puzzofme.com/api/v1

Never put the key in frontend JavaScript, a NEXT_PUBLIC_ variable, a URL, or a committed file. Restart or redeploy the partner website after configuring its environment.

3. Make your first request

Set your key in the server environment, then request the station catalogue. Choose an example for your stack.

Terminal
curl "https://fm.puzzofme.com/api/v1/stations" \
  -H "Authorization: Bearer $NAIJA_RADIO_API_KEY"

Next step

Build with AI

Give your coding assistant our ready-to-use integration prompt. It covers station discovery, playback, and keeping your API key secure.

Build with AI →

Prefer to write the integration yourself? Follow the manual guide.