Errors

PushAPI uses standard HTTP status codes and returns JSON error responses.

Status Codes

Code	Meaning
200	Success
400	Bad request — missing or invalid parameters
401	Unauthorized — invalid or missing API key
404	Not found — resource doesn't exist
429	Rate limit exceeded — too many requests today
500	Server error — something went wrong on our end

Error Response Format

All errors follow the same format:

{
  "error": "Human-readable error message"
}

Common Errors

Missing API Key

{
  "error": "Invalid API key"
}

Fix: Pass your API key in the X-API-Key header.

Rate Limited

{
  "error": "Daily rate limit reached",
  "tier": "free",
  "limit": 50,
  "used": 50,
  "resets_at": "midnight UTC"
}

Fix: Wait until midnight UTC or upgrade your tier.

Missing Parameter

{
  "error": "Missing ?niche= query parameter (e.g. gaming, fitness, finance)"
}

Fix: Add the required query parameter to your request.

Channel Not Found

{
  "error": "Channel not found"
}

Fix: Check the channel ID, handle, or URL. Try the /api/creators/search endpoint first.