NEXUSPLAYER
Home Go Pro Send a playlist
  • English
  • Français
  • Español
  • العربية
  • Português
  • Русский
  • Türkçe
Home Send a playlist
  • English
  • Français
  • Español
  • العربية
  • Português
  • Русский
  • Türkçe
Go Pro
Contents
  1. Authentication
  2. Base URL
  3. Endpoints
  4. Activate a TV directly
  5. Key Statuses
  6. Rate Limits
  7. Key Format
Back to Reseller Panel

Reseller API Documentation

Automate key generation and management using your API key. All endpoints require authentication via your API key.

Authentication

All API requests must include your API key in the Authorization header:

Authorization: Bearer nxp_res_your_api_key_here

You can find your API key in the Reseller Panel under Settings.

Important: Keep your API key secret. Do not share it in public repositories or client-side code. If compromised, regenerate it immediately from the panel.

Base URL

https://api.nexusplayer.app

Endpoints

POST /api/reseller/api/generate-key

Generate a new activation key. Deducts 1 credit from your balance. Each key activates one NexusPlayer Pro yearly license.

Request body:

FieldTypeRequiredDescription
notestringNoOptional label (customer name, order #...)
playlistobjectNoOptional playlist to link to the key (see below)
playlist.typestringYes*XTREAM, M3U or MAG
playlist.namestringNoPlaylist display name (defaults to "Playlist")
playlist.serverUrlstringXtreamXtream server URL
playlist.usernamestringXtreamXtream username
playlist.passwordstringXtreamXtream password
playlist.m3uUrlstringM3UM3U playlist URL
playlist.portalUrlstringMAGPortal URL (http or https)
playlist.macAddressstringMAGMAC address registered with the provider (XX:XX:XX:XX:XX:XX)
Playlist auto-push: When a key with a linked playlist is activated on a device, the playlist is automatically created on the device. No app modification needed.

Example (without playlist):

curl -X POST https://api.nexusplayer.app/api/reseller/api/generate-key \ -H "Authorization: Bearer nxp_res_your_api_key" \ -H "Content-Type: application/json" \ -d '{"note": "Customer #42"}'

Example (with Xtream playlist):

curl -X POST https://api.nexusplayer.app/api/reseller/api/generate-key \ -H "Authorization: Bearer nxp_res_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "note": "Customer #42", "playlist": { "type": "XTREAM", "name": "Premium TV", "serverUrl": "http://provider.com:8080", "username": "user123", "password": "pass456" } }'

Example (with MAG playlist):

curl -X POST https://api.nexusplayer.app/api/reseller/api/generate-key \ -H "Authorization: Bearer nxp_res_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "note": "Customer #43", "playlist": { "type": "MAG", "name": "Living room", "portalUrl": "http://provider.com/c", "macAddress": "00:1A:79:12:34:56" } }'

Response (201):

{ "code": "NXP-A4K9-M2R7", "note": "Customer #42", "createdAt": "2026-03-11T14:30:00.000Z", "playlist": { "type": "XTREAM", "name": "Premium TV" } }

Errors:

StatusErrorDescription
400Insufficient creditsYour balance is 0. Buy more credits.
400Invalid playlist dataPlaylist given with a type but missing or invalid fields (no credit used)
401Invalid API keyCheck your Authorization header.

GET /api/reseller/api/keys

List all your generated keys with their status. An activated key shows the TV's ID in device.deviceCode: in full for TVs you activated yourself, partly masked (A7K2-••••-4TPL) when your customer entered the key.

Query parameters:

ParamTypeDefaultDescription
pageinteger1Page number

Example:

curl https://api.nexusplayer.app/api/reseller/api/keys \ -H "Authorization: Bearer nxp_res_your_api_key"

Response (200):

{ "keys": [ { "code": "NXP-A4K9-M2R7", "note": "Customer #42", "status": "PENDING", "createdAt": "2026-03-11T14:30:00.000Z", "activatedAt": null, "playlistType": "XTREAM", "playlistName": "Premium TV", "playlistServerUrl": "http://provider.com:8080", "playlistUsername": "user123", "playlistPassword": "pass456", "playlistM3uUrl": null, "playlistPortalUrl": null, "playlistMacAddress": null }, { "code": "NXP-B8F3-X5L1", "note": null, "status": "ACTIVATED", "createdAt": "2026-03-10T10:15:00.000Z", "activatedAt": "2026-03-10T12:00:00.000Z", "playlistType": null, "playlistName": null } ] }

PUT /api/reseller/api/keys/:code/playlist

Link a playlist to an existing PENDING key. The playlist will be automatically pushed to the device when the key is activated.

Request body:

FieldTypeRequiredDescription
playlist.typestringYesXTREAM, M3U or MAG
playlist.namestringNoPlaylist display name
playlist.serverUrlstringXtreamXtream server URL
playlist.usernamestringXtreamXtream username
playlist.passwordstringXtreamXtream password
playlist.m3uUrlstringM3UM3U playlist URL
playlist.portalUrlstringMAGPortal URL (http or https)
playlist.macAddressstringMAGMAC address registered with the provider (XX:XX:XX:XX:XX:XX)

Example:

curl -X PUT https://api.nexusplayer.app/api/reseller/api/keys/NXP-A4K9-M2R7/playlist \ -H "Authorization: Bearer nxp_res_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "playlist": { "type": "M3U", "name": "Customer Playlist", "m3uUrl": "http://provider.com/get.php?username=user&password=pass&type=m3u_plus" } }'

Response (200):

{ "success": true, "code": "NXP-A4K9-M2R7", "playlist": { "type": "M3U", "name": "Customer Playlist" } }

Errors:

StatusErrorDescription
400Can only link playlist to PENDING keysKey is already activated or revoked
400Invalid playlist dataMissing required fields for the playlist type
404Key not foundInvalid key code or not owned by you

DELETE /api/reseller/api/keys/:code/playlist

Remove the linked playlist from a PENDING key.

Example:

curl -X DELETE https://api.nexusplayer.app/api/reseller/api/keys/NXP-A4K9-M2R7/playlist \ -H "Authorization: Bearer nxp_res_your_api_key"

Response (200):

{ "success": true, "code": "NXP-A4K9-M2R7" }

GET /api/reseller/api/balance

Check your current credit balance.

Example:

curl https://api.nexusplayer.app/api/reseller/api/balance \ -H "Authorization: Bearer nxp_res_your_api_key"

Response (200):

{ "credits": 47 }

Activate a TV directly

Activate NexusPlayer Pro on your customer's TV without sending them a key: one credit becomes a one-year license right away. Check the device first (free, no credit used), then activate it.

GET /api/reseller/api/device/:deviceId

Returns the device's platform, model, name (the name its owner gave the device, when known) and current license, and whether it can be activated. The device ID is the 12-character code shown at the very bottom of the app's Settings on the TV (dashes optional).

Response (200):

{ "deviceCode": "A7K2-9QXM-4TPL", "platform": "android_tv", "model": "Smart TV", "name": "Living room TV", "license": { "type": "TRIAL", "state": "trial", "expiresAt": "2026-11-05T10:00:00.000Z" }, "eligible": true, "reason": null, "previousPlaylist": null }

license.state is free, trial, expired, active or lifetime. When eligible is false, reason is already_pro or not_tv. previousPlaylist ({ "type", "name" }) is the playlist you linked to an earlier activation of this TV, if any.

name is free text chosen by the device's owner (up to 100 characters, any script or emoji) and null when unknown: escape it before showing it in a web page.

POST /api/reseller/api/activate-device

Uses 1 credit and activates a one-year NexusPlayer Pro license on the TV immediately. A key with status ACTIVATED is recorded: it appears in your key list, with the TV's ID in device.deviceCode.

Request body:

FieldTypeRequiredDescription
deviceCodestringYesDevice ID shown on the TV (12 characters, dashes optional)
notestringNoOptional label (customer name, order #...)
playlistobjectNoPlaylist sent to the TV, same format as for generate-key
reusePreviousPlaylistbooleanNoSend again the playlist of your previous activation of this TV (see previousPlaylist). Never sent unless you ask for it.
No duplicates: a playlist that is already on the TV (same server and username, same M3U URL, or same portal URL and MAC address) is not added again. playlistAdded tells you whether it was added.

Example:

curl -X POST https://api.nexusplayer.app/api/reseller/api/activate-device \ -H "Authorization: Bearer nxp_res_your_api_key" \ -H "Content-Type: application/json" \ -d '{"deviceCode": "A7K2-9QXM-4TPL", "note": "Customer #42"}'

Response (201):

{ "success": true, "code": "NXP-A4K9-M2R7", "deviceCode": "A7K2-9QXM-4TPL", "licenseType": "YEARLY", "expiresAt": "2027-10-22T12:00:00.000Z", "credits": 46, "playlistAdded": false }

Errors (JSON { "error", "reason" }, no credit used):

StatusreasonMeaning
400invalid_deviceThe device ID is not 12 characters
400invalid_playlistPlaylist fields missing or invalid (see generate-key)
400insufficient_creditsYour balance is 0
404not_foundNo device with this ID
409already_proThe TV already has an active license (one year or lifetime)
422not_tvNot a TV: on phones and tablets, Pro is unlocked in the app
429Too many requests (see Rate Limits)
Safe to retry: if a request times out, you can send it again. A TV activated by the first request answers 409 already_pro, and no second credit is used.

Key Statuses

StatusDescription
PENDINGKey generated, not yet activated on a device
ACTIVATEDKey has been activated on a device (yearly license)
REVOKEDKey revoked by admin

Rate Limits

API requests are limited to 200 requests per 15 minutes per IP address. Beyond that you receive 429 Too Many Requests: wait for the window to reset, or spread bulk operations over time.

Direct activation is also limited per account, to protect your credits if your API key leaks: 60 device checks and 30 activations per minute.

Note: Authentication is required for all requests. If your API key is invalid or missing, you'll receive a 401 Unauthorized response.

Key Format

Generated keys follow the format NXP-XXXX-XXXX where X is an alphanumeric character (A-Z excluding I and O, digits 2-9). Each key represents one yearly NexusPlayer Pro license (365 days).

End users activate keys through the NexusPlayer app on their device.

NEXUSPLAYER

The player for your playlists, on all your screens.

NexusPlayer

  • NexusPlayer Pro
  • Send a playlist
  • Reseller area

Information

  • Terms and conditions
  • Privacy
  • Contact
© 2026 NexusPlayer. All rights reserved. NexusPlayer is a player: it does not provide any content.