Skip to main content

Introduction to the API service | NiamonX API

🔐 How to CreateCreate, Reissue, and UseMonitor Your NiamonX API Key

This guide explains how to create your NiamonX API key, reissue it when needed, keep it secure, and startmonitor makingyour requestsdaily API usage directly from the NiamonX Dashboard.

The NiamonX Dashboard API key system is now connected to the NiamonX Core API v2.infrastructure. This means API keys are generated and managed through secure backend Core API calls instead of the legacy local Dashboard key generation system.

1. Requirements

To generatecreate anand use a NiamonX API key, you must have an active paid plan.
 with API access enabled.

API access is available only for supported paid plans.

Free-tier users and users on tariff plan 1 cannot createcreate, reissue, or use API keys.

image.pngIf your current plan does not support API access, the API key generation buttons will be disabled in the Dashboard.

2. Open the API Key Dashboard

Visit the official API key management page:

👉 https://dash.niamonx.io/api-key

On this page, you can:

  • Generate a new API key

  • Reissue your existing API key

  • View your current API usage statistics

  • Monitor daily limits and remaining quota

  • Check which tools are used most often

  • Review usage by API category

3. Creating an API Key

VisitTo thecreate officiala keynew generationAPI page:key, click:

👉Generate https://dash.niamonx.io/api-keyAPI Key

OnceThe Dashboard will securely send a backend request to the NiamonX Core API and create a default Dashboard API key for your subscription is active, click “Create API Key.”account.

image.pngThe generated key will be shown only once.

⚠️ Important:
After generation, the API key will not be displayed again.
ItCopy isit securelyimmediately stored in the database as a SHA-256 hash, meaning even NiamonX staff cannot recover it.

Keep your key safe —and store it in a secure place, such as an encrypted password manager or ana protected environment variable.

image.png

Do
not

3.store API Keykeys Dashboarddirectly Information

in

Afterfrontend creatingcode, thepublic key,repositories, youscreenshots, willchat seemessages, theor followingdocumentation details:


Status Created: — Last used: — Revoked: no

These fields update automatically as you start using your key.examples.

4. Reissuing an API Key

If you need to replace your existing API key, click:

Reissue API Key

Reissuing creates a new API key and invalidates the previous active key on the NiamonX Core API side.

Use reissue when:

  • You lost access to the previous key

  • You suspect the key may have been exposed

  • You want to rotate credentials for security

  • A production key needs to be replaced

  • A team member who had access to the key should no longer use it

⚠️ Important:
After reissue, update the API key in all systems, scripts, servers, CI/CD pipelines, and environment variables where the old key was used.

5. API Key Security

Your API key is a private credential. Anyone with access to it may be able to make API requests under your account and consume your quota.

Recommended storage methods:

NIAMONX_API_KEY="YOUR_API_KEY"

Example usage in a backend application:

export NIAMONX_API_KEY="YOUR_API_KEY"

Never expose your API key in:

  • Public GitHub repositories

  • Frontend JavaScript

  • Browser localStorage

  • Screenshots

  • Public documentation

  • Shared logs

  • Client-side mobile apps without secure backend protection

6. Main API Endpoint Format

NiamonX API tools are available through the Core API:

https://api.niamonx.io/v1/tools/

Each tool has its own endpoint path.

Example:

POST https://api.niamonx.io/v1/tools/globeline-ping

7. Authentication

All API requests gomust throughinclude your API key in the mainAuthorization entry point:header.

Authorization: 
Bearer 
YOUR_API_KEY


Content-Type: 
application/json

Accept: 
POST https://dash.niamonx.io/api/v2/application/json

Do not use the Dashboard system token.
The system token is used only internally by the NiamonX Dashboard backend to communicate with the NiamonX Core API.

5.8. Example Request

BasicGlobeLine Health Check (gl_ping)Ping


POST https://dash.api.niamonx.io/api/v2/gl_pingv1/tools/globeline-ping

Headers:

Authorization: 
Bearer 
YOUR_API_KEY








Content-Type:Type: application/json
X-API-KeyAccept: application/json

Body:

{
  "ip": YOUR_API_KEY

Body:


{ "ip": "1.1.1.1" }

Example cURL request:

curl -X POST "https://api.niamonx.io/v1/tools/globeline-ping" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"ip":"1.1.1.1"}'

6.9. API Key Dashboard Analytics

The API Key Dashboard now includes daily usage analytics.

The statistics are loaded by client ID and show usage for the current day.

Example internal statistics endpoint used by the Dashboard:

GET https://api.niamonx.io/v1/system/users/{USER_ID}/usage/today

This endpoint is called by the Dashboard backend using secure system authorization.

Regular users do not need to call this system endpoint directly.

10. Usage Overview

The Dashboard displays a summary of your daily API usage, including:

  • Available tools

  • Used tools today

  • Total daily request limit

  • Total requests used today

  • Remaining requests today

  • Total percentage of quota used

Example overview:

FieldDescription
Available toolsNumber of API tools available for your plan
Used tools todayNumber of unique tools used today
Total daily limitTotal number of requests available today
Total used todayNumber of requests already used today
Remaining todayNumber of requests still available
Total percent usedPercentage of your daily quota already consumed

11. Visual Usage Charts

The Dashboard also includes visual charts to make API monitoring easier.

Quota Overview

Shows how much of your total daily quota has been used and how much remains.

This helps you quickly understand whether your account is close to its daily limit.

Top Used Tools

Shows the most frequently used API tools for the current day.

This is useful for identifying which tools consume most of your requests.

Usage by Category

Groups usage by API category, such as:

  • OSINT

  • Network

  • DNS

  • Domain

  • Security

  • Malware

  • Breach

  • Utility

  • Document

  • Screenshot

This helps you understand which areas of the API you use most.

Highest Quota Load

Shows tools that are closest to reaching their daily limits.

This is useful for preventing unexpected limit errors in production systems.

12. Tool Usage Table

Below the charts, the Dashboard displays detailed usage for each API tool.

The table includes:

ColumnDescription
ToolHuman-readable tool name
Tool slugInternal tool identifier
CategoryAPI tool category
MethodHTTP method used by the tool
PathAPI endpoint path
UsedRequests used today
LimitDaily request limit
RemainingRequests still available today
UsagePercentage of the tool quota already used

This allows you to monitor both overall account usage and per-tool limits.

13. Client and Plan Information

The Dashboard may also display account and subscription information returned by the Core API, including:

  • Client name

  • Client email

  • Dashboard user ID

  • Dashboard plan ID

  • Plan slug

  • Subscription status

  • Subscription validity period

  • Last Dashboard/Core synchronization time

This helps verify that API access is connected to the correct user account and active subscription.

14. Possible API Responses

(messagefromToolService)
HTTP Code Description
200 ✅ success: true, data: {...} — requestRequest completed successfully
400 ❌ Invalid input data (or validation error)error
401 🚫 InvalidInvalid, missing, or missingexpired API key
403 ⛔ TheAccess requesteddenied, toolplan isrestriction, disabled tool, or insufficient permissions
404 ❓ Unknown tooltool, endpoint, or endpointresource
405 ⚙️ Method not allowed (use POST)
429 ⏳ CooldownDaily request limit, cooldown, or daily requestrate limit exceeded
500🔥 Internal server error

15. Plan Restrictions

Tariff plan 1 is not allowed to create or use API keys.

If your account is on plan 1, the Dashboard will show an API access restriction message and the API key generation actions will be disabled.

To enable API access, upgrade to a supported paid plan with API access included.

7.16. SecurityBest RecommendationsPractices

For production usage:

  • Never shareStore your API key publiclyin (includingenvironment screenshotsvariables

    or
    • code
  • samples).

    Use HTTPS for all requests

  • Rotate keysyour key regularly

  • Reissue your key immediately if youcompromise suspectis anysuspected

    compromise.

  • Monitor quota usage from the Dashboard

  • Watch the “Highest Quota Load” chart to avoid hitting limits

  • Do not expose API keys in client-side code

  • Use environmentbackend variablesproxy tologic storeif keysintegrating inwith productionweb systems.or mobile applications

  • AlwaysLog userequest HTTPSIDs whenand communicatingAPI witherrors thefor API.debugging

  • Avoid hardcoding keys into scripts or repositories

17. Troubleshooting

I cannot generate an API key

Check that:

  • Your subscription is active

  • Your plan supports API access

  • You are not on tariff plan 1

  • You are logged into the correct Dashboard account

My API request returns 401

This usually means:

  • The API key is missing

  • The API key is invalid

  • The API key was reissued and the old key is no longer valid

  • The Authorization header is formatted incorrectly

Correct format:

Authorization: Bearer YOUR_API_KEY

My API request returns 429

You may have exceeded:

  • Daily account quota

  • Tool-specific daily limit

  • Cooldown limit

  • Rate limit

Check the Dashboard usage analytics to see which limit was reached.

My old key stopped working

If you clicked Reissue API Key, the old key was invalidated.
Replace it everywhere with the new key shown after reissue.

18. Quick Start Checklist

Before using the API, make sure you have completed the following:

  • Active supported paid plan

  • API key generated from the Dashboard

  • API key copied and stored securely

  • API key added to your backend environment variables

  • Requests sent to https://api.niamonx.io/v1/tools/

  • Authorization: Bearer YOUR_API_KEY header included

  • First test request completed successfully

  • Dashboard usage analytics checked after testing

✅ You’re Ready to Start

Your NiamonX API key is now ready to start!
Withuse.

You can generate or reissue keys from the Dashboard, securely authenticate API requests through the Core API, and monitor your keydaily securelyusage storedwith visual analytics, quota charts, category breakdowns, and yourper-tool firststatistics.

Start with a small test requestrequest, working,confirm you can now explorethat the fullresponse NiamonXis successful, and then integrate the API toolkit.into your production workflow.

Back to top