API Documentation
Everything you need to use your CyberSecStats Pro key: JSON, RSS, Slack setup, and code samples.
60-second setup
The fastest way to use Cyberstats Pro is to paste your RSS URL into Slack. You'll see new stats in your channel every morning.
- In any Slack channel, type
/feed subscribe - Paste the RSS URL below (replace
YOUR_KEYwith your API key) - You're done. New stats arrive daily.
Two ways to authenticate
Every request needs your API key. Use either a query parameter (simpler) or a Bearer token (more secure).
Option 1: Query parameter
Option 2: Authorization header (recommended)
The API endpoint
https://cybersecuritystatistic.com/api/v1/stats
Query parameters
| Parameter | Type | Description |
|---|---|---|
key |
string | Your API key (required if not using Authorization header). |
q |
string | Search query. Supports boolean operators: ransomware AND healthcare, phishing NOT email. |
format |
string | json (default) or rss. |
limit |
integer | Results per page. Default 10, max 100 for queries, max 10,000 for bulk export. |
offset |
integer | Pagination offset. Default 0. |
publisher |
string | Filter by publisher name. Case-insensitive partial match (e.g. Verizon, IBM). |
tags |
string | Comma-separated tags (e.g. Ransomware,Healthcare). |
days |
integer | Only stats added in the last N days (1-365). |
sort |
string | date (default) or relevance (requires q). |
order |
string | desc (default) or asc. |
digest |
string | RSS-only: daily (90-day window, publisher diversity) or monthly. |
count |
boolean | Set to 1 to include total_count in response. |
JSON response structure
A successful JSON request returns an object with an items array and pagination metadata.
Error responses
| Status | When it happens |
|---|---|
| 401 | Missing or invalid API key. |
| 429 | Rate limit exceeded (see below). |
| 500 | Server error. Retry with exponential backoff. |
RSS modes for every workflow
Add format=rss to any request. Three modes for different use cases:
Standard RSS
One item per stat. Good for feed readers like Feedly or Inoreader.
Daily digest (recommended for Slack)
Grouped digest with unique daily GUIDs so Slack shows fresh content every morning. Uses publisher diversity to avoid one report dominating.
Topic-filtered RSS
Only stats matching a query. Great for tracking one area (e.g. ransomware).
Publisher-filtered RSS
Only stats from a specific publisher.
Get stats in Slack in 30 seconds
The Slack RSS app pulls your feed automatically. No bot setup needed.
- In the Slack channel where you want stats, type
/feed subscribe - Paste the daily digest URL (replace
YOUR_KEYwith your key) - Hit enter. You'll see a confirmation. Stats arrive next morning and every morning after.
Language-specific snippets
Bash / curl
JavaScript (fetch)
Python (requests)
Node.js (axios)
Go
Fair use limits
| Window | Pro limit | Notes |
|---|---|---|
| Per hour | 100 requests | Per API key |
| Per day | 1,000 requests | Per API key |
| Per IP / hour | 200 requests | Prevents abuse |
Max limit per request |
10,000 items | For bulk export |
Need help?
Reply to your welcome email or reach out to contact@cybersecstats.com. We answer within one business day.
Common questions
My key stopped working. Most often this means your subscription lapsed. Check your account to renew, then reply to your welcome email and we'll re-issue the key.
How often is new data added? 50-100 new stats per week across 200+ publishers. The RSS daily digest surfaces new additions automatically.
Can I share my key with my team? Each Pro seat is for one person. For teams, email us and we'll set up a team plan.