curl -H "Authorization: Bearer sk_live_..." \
"https://socdefenders.ai/api/v1/iocs/stats"{
"meta": {
"generated_at": "2026-05-17T10:30:00Z",
"cache_updated_at": "2026-05-17T10:25:00Z",
"cache_age_seconds": 300,
"feed_version": "1.0",
"source": "SOC Defenders"
},
"data": {
"totalIOCs": 1351663,
"totalArticles": 21121,
"byType": {
"ipv4": 423891,
"ipv6": 12450,
"domain": 287654,
"url": 198432,
"sha256": 234812,
"md5": 89345,
"sha1": 67234,
"email": 23456,
"cve": 5611,
"mitre_attack": 8778
},
"bySource": {
"URLhaus": 412908,
"Feodo Tracker": 234567,
"ThreatFox": 198765,
"BleepingComputer": 56789,
"Krebs on Security": 23456
},
"byCategory": {
"threat-intel": 891234,
"news": 234561,
"research": 145678,
"vendor": 56781,
"government": 23409
},
"last24h": {
"newIOCs": 18432,
"newArticles": 287,
"byType": {
"ipv4": 5432,
"domain": 4321,
"sha256": 3210,
"url": 2876
}
},
"last7d": {
"newIOCs": 134567,
"newArticles": 2034,
"trend": [
18234,
19102,
17654,
21345,
18432,
19876,
19924
]
},
"feedHealth": {
"total": 84,
"healthy": 78,
"degraded": 4,
"error": 2
},
"topMitreTechniques": [
{
"id": "T1566",
"count": 1234
},
{
"id": "T1059",
"count": 987
},
{
"id": "T1190",
"count": 845
}
],
"topCVEs": [
{
"id": "CVE-2026-12345",
"count": 234
},
{
"id": "CVE-2026-9999",
"count": 187
}
],
"lastUpdated": "2026-05-17T10:25:00Z"
}
}Pre-computed aggregations over the entire IOC corpus. Backed by the iocs_stats_cache table (refreshed every 10 minutes via pg_cron) — sub-millisecond response time.
Response includes:
X-Cache-Updated-At: when the cache was last refreshedX-Cache-Age-Seconds: how stale the data is (max ~600s)X-Cache-Stale: true if pg_cron missed its windowcurl -H "Authorization: Bearer sk_live_..." \
"https://socdefenders.ai/api/v1/iocs/stats"{
"meta": {
"generated_at": "2026-05-17T10:30:00Z",
"cache_updated_at": "2026-05-17T10:25:00Z",
"cache_age_seconds": 300,
"feed_version": "1.0",
"source": "SOC Defenders"
},
"data": {
"totalIOCs": 1351663,
"totalArticles": 21121,
"byType": {
"ipv4": 423891,
"ipv6": 12450,
"domain": 287654,
"url": 198432,
"sha256": 234812,
"md5": 89345,
"sha1": 67234,
"email": 23456,
"cve": 5611,
"mitre_attack": 8778
},
"bySource": {
"URLhaus": 412908,
"Feodo Tracker": 234567,
"ThreatFox": 198765,
"BleepingComputer": 56789,
"Krebs on Security": 23456
},
"byCategory": {
"threat-intel": 891234,
"news": 234561,
"research": 145678,
"vendor": 56781,
"government": 23409
},
"last24h": {
"newIOCs": 18432,
"newArticles": 287,
"byType": {
"ipv4": 5432,
"domain": 4321,
"sha256": 3210,
"url": 2876
}
},
"last7d": {
"newIOCs": 134567,
"newArticles": 2034,
"trend": [
18234,
19102,
17654,
21345,
18432,
19876,
19924
]
},
"feedHealth": {
"total": 84,
"healthy": 78,
"degraded": 4,
"error": 2
},
"topMitreTechniques": [
{
"id": "T1566",
"count": 1234
},
{
"id": "T1059",
"count": 987
},
{
"id": "T1190",
"count": 845
}
],
"topCVEs": [
{
"id": "CVE-2026-12345",
"count": 234
},
{
"id": "CVE-2026-9999",
"count": 187
}
],
"lastUpdated": "2026-05-17T10:25:00Z"
}
}Documentation Index
Fetch the complete documentation index at: https://docs.socdefenders.ai/llms.txt
Use this file to discover all available pages before exploring further.