Tracking

Add, list, and remove creators from your private tracking list.

Track a Creator

POST /api/track

Add a creator to your tracking list. They'll get daily snapshots from our cron job (6 AM UTC), which builds velocity data over time.

Request Body

{
  "channelId": "@IndigoGaming",
  "niche": "gaming"
}

Field	Required	Default	Description
channelId	Yes	—	Channel ID, handle (@name), or YouTube URL
niche	No	general	Category tag for organizing your tracked creators

Accepted Channel ID Formats

Format	Example
Handle	@IndigoGaming
Channel ID	UCX6OQ3DkcsbYNE6H8uQQuVA
YouTube URL	https://youtube.com/@IndigoGaming
YouTube URL (channel)	https://youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA

Response

{
  "status": "ok",
  "message": "Now tracking Indigo Gaming in gaming",
  "creator": {
    "channel_id": "UCTRohxutThBffdcP3H6O0Zg",
    "title": "Indigo Gaming",
    "handle": "@indigo_gaming",
    "niche": "gaming"
  }
}

What Happens After Tracking

1. The creator is added to your private tracking list (only you can see it)
2. Our cron job runs daily at 6 AM UTC and collects a snapshot (subscribers, views, videos)
3. After 2+ snapshots, we can calculate velocity and opportunity scores
4. After 7+ days, we can show 7-day growth rates
5. After 30+ days, we can show 30-day growth rates and acceleration

Example

curl -X POST \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channelId": "@IndigoGaming", "niche": "gaming"}' \
  "https://beta.pushapi.xyz/api/track"

Tracking Multiple Creators

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

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

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

---

List Tracked Creators

GET /api/track

List all creators you're currently tracking.

Query Parameters

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

Response

{
  "status": "ok",
  "pagination": {
    "total": 3,
    "offset": 0,
    "limit": 20,
    "has_more": false
  },
  "tracked": [
    {
      "channel_id": "UCTRohxutThBffdcP3H6O0Zg",
      "platform": "youtube",
      "title": "Indigo Gaming",
      "handle": "@indigo_gaming",
      "avatar_url": "https://...",
      "niche": "gaming",
      "created_at": "2026-07-26T10:00:00Z"
    }
  ]
}

Pagination

# Page 1
curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/track?limit=10&offset=0"

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

---

Stop Tracking

DELETE /api/track/{channelId}

Remove a creator from your tracking list.

Path Parameters

Parameter	Description
channelId	The channel ID to stop tracking

Response

{
  "status": "ok",
  "message": "Stopped tracking"
}

Error Response

If the channel isn't in your tracking list:

{
  "error": "Channel not found in your tracking list"
}

Example

curl -X DELETE \
  -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/track/UCTRohxutThBffdcP3H6O0Zg"

Note

You must use the full channel ID (starts with UC) for the delete endpoint, not the handle.