NIXUS API Documentation

Real-time social media intelligence across YouTube, TikTok, and Instagram. One API, three platforms, actionable data.

The NIXUS API gives you programmatic access to trending content, hashtag analytics, top-performing videos, and deep social listening across major short-form platforms. All responses are JSON with a data envelope.

Authentication

All API requests require an API key passed via the X-API-Key header. You can also pass it as a query parameter ?api_key=YOUR_KEY, but the header method is preferred.

Copy# Header method (recommended)
curl https://nixus.pro/api/v1/trends \
  -H "X-API-Key: nix_your_key_here"

# Query parameter method
curl "https://nixus.pro/api/v1/trends?api_key=nix_your_key_here"

API keys start with nix_ and are 52 characters long. Keep your key secret - it controls your rate limits and usage tracking.

Quickstart

Get up and running in under a minute.

Step 1: Get your API key

Copycurl -X POST https://nixus.pro/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

{
  "data": {
    "api_key": "nix_a1b2c3d4e5f6...",
    "email": "you@example.com",
    "plan": "free",
    "daily_limit": 100
  }
}

Step 2: Make your first request

Copycurl https://nixus.pro/api/v1/trends \
  -H "X-API-Key: YOUR_API_KEY" \
  -G -d "platform=youtube" \
     -d "category=health" \
     -d "limit=5"

Copyimport requests

API_KEY = "YOUR_API_KEY"
BASE = "https://nixus.pro/api/v1"

r = requests.get(
    f"{BASE}/trends",
    headers={"X-API-Key": API_KEY},
    params={"platform": "youtube", "category": "health"}
)

for video in r.json()["data"]:
    print(f"{video['title']} - {video['views']:,} views")

Copyconst API_KEY = "YOUR_API_KEY";

const res = await fetch(
  "https://nixus.pro/api/v1/trends?platform=youtube&category=health",
  { headers: { "X-API-Key": API_KEY } }
);

const { data } = await res.json();
data.forEach(v => console.log(`${v.title} - ${v.views} views`));

Rate Limits

Rate limits are applied per API key based on your plan. When you exceed the limit, you'll receive a 429 response with details.

Daily limits reset at midnight UTC. Check your current usage anytime via the /v1/usage endpoint.

Error Handling

The API uses standard HTTP status codes. Errors include a JSON body with details.

{
  "error": "Daily rate limit exceeded.",
  "limit": 100,
  "plan": "free",
  "upgrade_url": "https://nixus.pro/api/pricing"
}

Trends

Get trending topics and viral content across platforms. Returns videos sorted by view count with metadata.

Query Parameters

Request

Copycurl https://nixus.pro/api/v1/trends?platform=youtube&category=health&limit=3 \
  -H "X-API-Key: YOUR_KEY"

{
  "data": [
    {
      "video_id": "dQw4w9WgXcQ",
      "platform": "youtube",
      "title": "What Happens When You Take Cold Showers Every Day",
      "views": 17640605,
      "channel": "RealLogic",
      "published": "2 weeks ago",
      "thumbnail": "https://i.ytimg.com/vi/...",
      "url": "https://youtube.com/watch?v=dQw4w9WgXcQ"
    }
  ],
  "platform": "youtube",
  "date": "2026-03-07",
  "count": 1
}

Hashtags

Get hashtag analytics including usage count and total views across tracked content.

Query Parameters

{
  "data": [
    {
      "hashtag": "#shorts",
      "platform": "youtube",
      "count": 10926,
      "total_views": 869912593
    },
    {
      "hashtag": "#health",
      "platform": "youtube",
      "count": 3616,
      "total_views": 274258005
    }
  ],
  "count": 2
}

Videos

Get top-performing videos in any niche. Filter by minimum views, platform, and time period.

Query Parameters

Request

Copycurl "https://nixus.pro/api/v1/videos?niche=castor+oil&min_views=100000&limit=5" \
  -H "X-API-Key: YOUR_KEY"

Search

Keyword-based video search across platforms. The most flexible endpoint for content research.

Query Parameters

Request

Copycurl "https://nixus.pro/api/v1/search?q=intermittent+fasting&platform=youtube&min_views=50000" \
  -H "X-API-Key: YOUR_KEY"

Orbit (Deep Social Listening)

Queue a deep social listening job. Multi-keyword, multi-platform analysis with aggregated insights. Returns an orbit_id for retrieving results.

Request Body (JSON)

Request

Copycurl -X POST https://nixus.pro/api/v1/orbit \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Health Niche Research",
    "keywords": ["cold shower benefits", "cortisol reduction", "castor oil"],
    "platforms": ["youtube"]
  }'

{
  "data": {
    "orbit_id": "a1b2c3d4e5f6...",
    "status": "completed",
    "name": "Health Niche Research"
  }
}

Orbit Results

Retrieve results from a completed orbit job. Includes videos, total views, and aggregated analysis.

{
  "data": {
    "id": "a1b2c3d4...",
    "status": "completed",
    "results": {
      "videos": [...],
      "total_videos": 47,
      "analysis": {
        "top_performing": {...},
        "avg_views": 2450000,
        "total_views": 115150000
      }
    }
  }
}

Create API Key

Generate a free API key. One key per email address. Starts on the Free plan (1 test request (lifetime)).

Request Body (JSON)

Copycurl -X POST https://nixus.pro/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "dev@yourapp.com"}'

Usage

Check your current API usage, plan details, and remaining daily quota.

{
  "data": {
    "plan": "free",
    "requests_today": 23,
    "requests_total": 156,
    "daily_limit": 100,
    "platforms": ["youtube"],
    "orbit_access": false
  }
}

Plans

Get all available plans with pricing and feature details.

Pricing

Start free, upgrade when you need more.

Changelog

v1.0.0 - March 7, 2026

• Initial public beta release
• Endpoints: trends, hashtags, videos, search, orbit
• YouTube support (TikTok and Instagram coming soon)
• Free tier: 100 req/day, no credit card
• 5 pricing tiers from Free to Enterprise