Alerts & Email

Get notified when your tracked creators start growing fast.

How Alerts Work

1. You track creators via POST /api/track
2. Our cron job runs daily at 6 AM UTC, collecting snapshots
3. If a creator grows >10% in one day, we create a HIGH_GROWTH alert
4. If you've set an email, we send you an email alert instantly
5. We also post to our internal Discord for monitoring

Alert Levels (Email)

Growth	Label	Color	When
50%+	EXPLOSIVE	Red (#ff3366)	Massive spike — viral video or major event
25-50%	SURGING	Orange (#ff6b35)	Very fast growth — channel is taking off
15-25%	RISING FAST	Purple (#a855f7)	Strong growth — worth paying attention
10-15%	WATCH	Cyan (#22d3ee)	Notable growth — early signal

Alert Levels (API)

The alert_level field on creators uses different thresholds:

Score	Label	Description
75+	HIGH_GROWTH	Explosive growth momentum
50+	RISING	Clear growth trajectory
25+	WATCH	Some growth signals
<25	STABLE	Normal or declining

Email Template

Each email includes:

• Creator name and growth percentage
• Before/after subscriber counts
• Direct link to the YouTube channel
• Color-coded by severity

Set Alert Email

POST /api/alerts/email

Set the email address that receives growth alerts. One email per API key.

Request Body

{
  "email": "you@example.com"
}

Response

{
  "status": "ok",
  "message": "Alert emails will be sent to scouts@agency.com",
  "email": "you@example.com"
}

Example

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"

Updating Your Email

Just call the same endpoint again with a new email:

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

---

Get Alert Email

GET /api/alerts/email

Check which email is configured for alerts.

Response

{
  "status": "ok",
  "email": "you@example.com"
}

If no email is set:

{
  "status": "ok",
  "email": null
}

---

List Alerts

GET /api/alerts

Get your recent alert history. Alerts are created when tracked creators grow more than 10% in a day.

Query Parameters

Parameter	Default	Description
offset	0	Number of results to skip
limit	20	Max results (1-100)

Response

{
  "status": "ok",
  "pagination": {
    "total": 8,
    "offset": 0,
    "limit": 20,
    "has_more": false
  },
  "alerts": [
    {
      "channel_id": "UCTRohxutThBffdcP3H6O0Zg",
      "alert_type": "HIGH_GROWTH",
      "message": "Indigo Gaming grew 15.3% in one day (183,000 → 211,091)",
      "created_at": "2026-07-26T06:15:00Z"
    }
  ]
}

Pagination

# Get most recent 5 alerts
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/alerts?limit=5"

# Get older alerts
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/alerts?limit=10&offset=10"

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/alerts?limit=5&offset=0"