Getting Started

PushAPI is a rising creator detection API. It helps you discover YouTube creators before they blow up — ranked by growth potential in any niche.

Quick Start (2 minutes)

1. Get Your API Key

Contact us at pricing@pushapi.xyz to get your API key.

2. Make Your First Request

curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/discover?niche=gaming&min_followers=50000"

3. Get Results

{
  "status": "ok",
  "niche": "gaming",
  "count": 5,
  "creators": [
    {
      "channel_id": "UC_iQdD0AKPC44T7Hir_i8hA",
      "title": "Fail Game Armaan",
      "handle": "@failgamearmaan",
      "current_subscribers": 85200,
      "total_views": 5039560,
      "video_count": 90,
      "opportunity_score": 47,
      "growth_score": 55,
      "niche_relevance": 29,
      "alert_level": "WATCH"
    }
  ]
}

The Agency Workflow

Here's how you'd typically use PushAPI as an agency scouting talent:

Step 1: Discover Rising Creators

Search for creators in a specific niche. No manual tracking needed — results are real-time from YouTube.

GET /api/discover?niche=fitness&min_followers=50000&max_followers=500000

This returns creators ranked by opportunity_score (0-100). Higher score = more growth potential.

Filtering tips:

• Use min_followers=50000 to skip tiny channels
• Use max_followers=500000 to focus on rising creators (not already-established ones)
• Use sort=opportunity_score to find the best growth potential
• Use sort=subscribers to find the biggest channels in a niche
• Use alert_level=RISING to filter by growth stage

Step 2: Validate a Specific Creator

When you find a creator that looks interesting, check their detailed velocity data:

GET /api/creators/youtube/@IndigoGaming

This returns:

• opportunity_score — 0-100 score based on real velocity data
• growth_rate_7d — subscriber growth rate over last 7 days (%)
• growth_rate_30d — subscriber growth rate over last 30 days (%)
• alert_level — HIGH_GROWTH, RISING, WATCH, or STABLE
• snapshot_count — how many daily snapshots we have (more = more reliable)

Step 3: Track Creators for Monitoring

When you want ongoing monitoring, add creators to your tracking list:

POST /api/track
{ "channelId": "@IndigoGaming", "niche": "gaming" }

Tracked creators get daily snapshot data from our cron job (runs at 6 AM UTC). This builds velocity history over time, which improves scoring accuracy.

You can track by:

• Handle: @IndigoGaming
• Channel ID: UCX6OQ3DkcsbYNE6H8uQQuVA
• YouTube URL: https://youtube.com/@IndigoGaming

Step 4: Set Up Alerts

Set your email once. We'll notify you when any tracked creator grows more than 10% in a day:

POST /api/alerts/email
{ "email": "scouts@youragency.com" }

Alert levels (based on growth percentage):

Growth	Alert Level	Email Color
50%+	EXPLOSIVE	Red
25-50%	SURGING	Orange
15-25%	RISING FAST	Purple
10-15%	WATCH	Cyan

Step 5: Monitor Your Portfolio

Check your tracked creators and their growth:

GET /api/creators/rising?niche=gaming&alert=RISING

Or see all your alerts:

GET /api/alerts

Real-World Examples

Example 1: Finding gaming talent for a brand deal

# Step 1: Find rising gaming creators with 10K-500K subs
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/discover?niche=gaming&min_followers=10000&max_followers=500000&sort=opportunity_score&limit=10"

# Step 2: Check the top result's velocity
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/creators/youtube/@failgamearmaan"

# Step 3: Track the ones you like
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"channelId": "@failgamearmaan", "niche": "gaming"}' \
  "https://beta.pushapi.xyz/api/track"

Example 2: Monitoring fitness creators for a supplement brand

# Discover fitness creators in the sweet spot (50K-200K subs)
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/discover?niche=fitness&min_followers=50000&max_followers=200000&sort=subscribers"

# Set alert email
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"email": "fitness-team@agency.com"}' \
  "https://beta.pushapi.xyz/api/alerts/email"

Example 3: Finance niche deep dive

# Find finance creators sorted by views (most viewed first)
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/discover?niche=finance&min_followers=10000&order=viewCount&limit=10"

# Find finance creators sorted by niche relevance (best keyword matches)
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/discover?niche=finance&min_followers=10000&sort=niche_relevance&limit=10"

Code Examples

JavaScript / Node.js

const API_KEY = "your-api-key";
const BASE = "https://beta.pushapi.xyz";

// Discover rising finance creators
const res = await fetch(`${BASE}/api/discover?niche=finance&min_followers=100000`, {
  headers: { "X-API-Key": API_KEY },
});
const data = await res.json();

data.creators.forEach((c) => {
  console.log(`${c.title}: score ${c.opportunity_score}, ${c.current_subscribers} subs`);
});

Python

import requests

API_KEY = "your-api-key"
BASE = "https://beta.pushapi.xyz"

# Discover rising fitness creators
res = requests.get(
    f"{BASE}/api/discover?niche=fitness&min_followers=50000",
    headers={"X-API-Key": API_KEY},
)
data = res.json()

for creator in data["creators"]:
    print(f"{creator['title']}: score {creator['opportunity_score']}")

cURL

# Discover
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/discover?niche=tech&min_followers=10000"

# Track a creator
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"channelId": "@Fireship", "niche": "tech"}' \
  "https://beta.pushapi.xyz/api/track"

# Set alert email
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}' \
  "https://beta.pushapi.xyz/api/alerts/email"

Base URL

All API requests go to:

https://beta.pushapi.xyz

What's Next?

• Authentication — How API keys work
• Rate Limits — Request quotas per tier
• API Reference — Full endpoint documentation