Skip to content
skopnix

API

Every endpoint is free and keyless: no account, no signup. JSON over HTTPS, CORS open, per-IP rate limits stated on each endpoint.

Every endpoint below has a curl, Python and JavaScript example that runs as printed: Python is the standard library only, JavaScript is plain fetch (Node 18 or later as an .mjs file, or a browser console). The same reference is an OpenAPI 3.1 document at /api/v1/openapi.json.

Basics

  • Base URL. https://skopnix.com. Every path below is relative to it.

  • No key. Nothing to sign up for. Send a User-Agent that names your tool: some HTTP libraries' defaults are refused at the edge.

  • Rate limits. Per IP, per minute, stated on each endpoint. A few endpoints share one budget. The indicator check and the single-indicator lookup also have a daily allowance for anonymous callers (15 a day between them; 60 for full profiles). Over a limit is a 429: wait and retry.

  • Polling. Feeds, network exports and the graph change slowly: poll them every 15 minutes or slower. Send a User-Agent that names your tool and a contact, and send each ETag back as If-None-Match, so an unchanged list costs a 304. The indicator check and single lookup are a daily allowance (15 a day without an account), not a feed: for bulk use, pull an export.

  • Caching. Most JSON responses carry an ETag. Send it back as If-None-Match and an unchanged response is a 304 with no body, the cheapest request you can make.

  • Errors. A JSON body {"error": "…"} with the status code. A 503 means our store could not be read: an error, never an empty result. A 200 with nothing in it means nothing matched, and you can rely on that difference.

  • null means unknown. A missing score, date or verdict is null, never zero and never a guess.

  • Cited means quoted. Every actor link carries the sentence it rests on and the URL of the report it comes from. A link without both is never served. A citation is the report's claim, not our confirmation.

  • We are not the source. Every story links its original report. Cite that, not us.

Endpoints and limits

  1. POST /api/v1/stackCheck a stack10/min
  2. GET /api/v1/stackDescribe the stack checkcached
  3. GET /api/v1/itemsStories60/min
  4. GET /api/v1/exploitsPublic exploits for a CVE60/min
  5. GET /api/v1/exploits/trendingThis week's exploit board60/min
  6. GET /api/v1/detectionsDetection rules60/min
  7. POST /api/v1/ioc/checkCheck indicators30/min + 15/day
  8. GET /api/v1/ioc/checkDescribe the indicator checkcached
  9. GET /api/v1/ioc/{indicator}One indicator120/min + 15/day
  10. GET /api/v1/ioc/profile/{value}Everything public about a domain, IP or hash20/min + 60/day
  11. GET /api/v1/ioc/statsHow many indicators we hold60/min
  12. GET /api/v1/ioc/blocklistA blocklist for a firewall or SIEM10/min
  13. GET /api/v1/actorsThe adversary roster60/min
  14. GET /api/v1/actors/{id}One dossier120/min
  15. GET /api/v1/graph/{type}/{id}What one entity is linked to60/min
  16. GET /api/v1/cves/{id}/actorsWho a report ties to a CVE60/min
  17. GET /api/v1/claimsClaims60/min
  18. GET /api/v1/claims/country/{cc}Claims naming one country120/min
  19. GET /api/v1/claims/context/{id}The evidence behind one claim30/min
  20. GET /api/v1/azThe Azerbaijan board60/min
  21. GET /api/v1/stix/actors/{id}An actor's cited intelligence as STIX 2.160/min
  22. GET /api/v1/stix/cves/{cve}Who exploits a CVE, as STIX 2.160/min
  23. GET /api/v1/taxii2/TAXII 2.1 API root60/min
  24. GET /api/v1/taxii2/collections/TAXII collections60/min
  25. GET /api/v1/taxii2/collections/{id}/One TAXII collection60/min
  26. GET /api/v1/taxii2/collections/{id}/objects/A page of a TAXII collection60/min
  27. GET /api/v1/misp/manifest.jsonMISP feed index60/min
  28. GET /api/v1/misp/{uuid}.jsonOne MISP event60/min
  29. GET /api/v1/misp/hashes.csvMISP feed hashes60/min
  30. GET /api/v1/openapi.jsonThis reference as OpenAPI 3.1cached
  31. GET /api/v1/exports/manifest.jsonNetwork and firewall exports: the list120/min
  32. GET /api/v1/exports/{path}Network and firewall exports: one file120/min

Limits are per IP and per minute; each endpoint below says which share one budget. The daily figure is the allowance an anonymous caller gets for indicator lookups. “cached” is a static response with no limit.

Stack check: what the answers mean

Each finding of POST /api/v1/stack says how your version compares, whether the CVE is exploited in the wild, and how sure the match is. Exposure by product and version only: no configuration, reachability or backport check.

in-rangefindings[].version
Your version sits inside a published vulnerable range for this CVE, or equals a listed vulnerable version. Treat it as affected. fixed_in names the first fixed version when the range states one.
ambiguousfindings[].version
Possibly affected, not confirmed either way. The version could not be compared exactly: a bound is written differently (8.2p1 against 8.2.1), or the ranges list update or build numbers your version does not name (22.7 where 22.7 r2 and r2.1 are listed). Check your exact build, patch level or update number against the vendor advisory.
not-checkedfindings[].version
We did not compare your version for this CVE: no version ranges were available for the product in this check (a KEV-only name match, a range lookup that failed, or one over the per-check budget). Unknown, not safe. Compare your version with the advisory yourself, or run the check again.
no-versionfindings[].version
You sent no version, so every CVE on record for the product is listed. Send the version to narrow the list.
not-affectedcomponents[].not_affected
CVEs on record for the product whose ranges exclude your version. They are counted, never listed as findings. Nothing to do for those CVEs.
KEVfindings[].kev
The CVE is on the Known Exploited Vulnerabilities catalogue: exploitation in the wild has been observed, not predicted. kev_date_added says when it was listed; ransomware says the catalogue records use in ransomware campaigns. Patch these first. KEV outranks EPSS whenever the two disagree.
EPSSfindings[].epss
A forecast probability, 0 to 1, that the CVE is exploited in the next 30 days. null when there is no score. Use it to order what is not on KEV. A forecast, never evidence of exploitation.
confidence: highfindings[].confidence
The product was identified exactly (by your CPE or purl, a well-known product name, or a KEV entry's name) and your version is in a vulnerable range. Act on it.
confidence: mediumfindings[].confidence
Either the product was identified by your CPE or purl or a well-known product name but the version could not be compared (ambiguous, not-checked or no-version), or the version is in range but the product was matched from its name alone. Confirm the product or the version before acting.
confidence: lowfindings[].confidence
The product was matched from its name (a guess, or a KEV entry's name) and the version was not compared. The product may be filed under another name. Send a purl or CPE for that component to get a real answer.
actorsfindings[].actors
Threat actors a published report ties to the CVE. Each carries the quoted sentence (evidence) and the report (source, url); a link without both is never returned. Read the quote. A citation, not our confirmation.

components[].status

checked
Version ranges were evaluated for the product.
partial
Ranges were evaluated for some of the product's names; others failed or were cut.
kev-only
Matched the KEV catalogue by name; version ranges were not evaluated, so its findings are not-checked.
no-records
The product was identified, and nothing is on record for it.
unresolved
We could not tell which product this is. Send a purl or a CPE.
upstream-error
The range lookup failed for this product; KEV name matches are still shown.

Stack check

Send what you run; get the CVEs that hit it, which are exploited in the wild, and who a published report says exploits them.

POST /api/v1/stack

Check a stack

Send the products and versions you run. Each comes back with the CVEs whose published ranges include your version, whether each is on the KEV catalogue, its EPSS, and the threat actors a published report ties to it, with the quote and the report. Exposure by product and version only: no configuration, reachability or backport check.

Duplicates are folded. CVEs whose ranges exclude your version are counted in not_affected, never listed.

A cold check of many products can take up to a minute; what did not fit in time is reported as not-checked, with the reason.

10 requests a minute per IP. Never cached.

bodyapplication/json
At most 500 components and 1 MB. A purl or a CPE identifies a component best; a bare name is matched as a guess.
curl -sS -X POST "https://skopnix.com/api/v1/stack" \  -H "Content-Type: application/json" \  -d '{"components":[{"name":"log4j-core","version":"2.14.1","purl":"pkg:maven/org.apache.logging.log4j/[email protected]"},{"vendor":"fortinet","name":"fortios","version":"7.0.1"}]}'
Response · application/json
{  "note": "Exposure by product and version claim only: no configuration, reachability or backport check.",  "generated_at": "2026-11-03T20:00:00.000Z",  "summary": {    "components": 2,    "with_findings": 2,    "kev_cves": 6,    "kev_cves_unchecked": 0,    "cves_with_cited_actors": 2  },  "sources": {    "kev_catalog": {      "status": "ok",      "released": "2026-10-30"    },    "epss": "ok",    "actors": "ok",    "coverage": "ok",    "facts": {      "cves": 41,      "looked_up": 41,      "epss_looked_up": 41,      "truncated": false    }  },  "components": [    {      "input": {        "name": "log4j-core",        "version": "2.14.1",        "purl": "pkg:maven/org.apache.logging.log4j/[email protected]",        "cpe": null,        "vendor": null,        "namespace": null,        "origin": null      },      "resolved": {        "vendor": "apache",        "product": "log4j",        "part": "a",        "via": "purl"      },      "status": "checked",      "findings": [        {          "cve": "CVE-2021-44228",          "kev": true,          "kev_date_added": "2021-12-10",          "ransomware": true,          "epss": 0.944,          "version": "in-range",          "version_detail": "2.14.1 ∈ [2.0.1, 2.15.0)",          "fixed_in": "2.15.0",          "confidence": "high",          "actors": [            {              "actor_id": "apt35",              "actor": "APT35",              "evidence": "The group exploited the Log4Shell vulnerability (CVE-2021-44228) to gain initial access.",              "source": "example.com",              "url": "https://example.com/report/log4shell-exploitation",              "date": null            }          ],          "coverage_priority": null,          "not_looked_up": []        }      ],      "total_affected": 4,      "not_affected": 1,      "note": null    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 25
summary.kev_cvesinteger
Distinct KEV CVEs across your components.
summary.kev_cves_uncheckedinteger
Of those, how many matched without a version comparison.
sourcesobject
The state of each lookup this check relied on (ok or unavailable), how many product ranges were read or skipped, and whether facts were capped. A lookup that failed is reported here, never hidden as an empty result.
componentsobject[]
In the order you sent them, duplicates folded.
components[].inputobject
The component as you sent it, normalised.
components[].resolved.parta | o | h
a = application, o = operating system or firmware, h = hardware.
components[].resolved.viacpe | purl | alias | kev | name
How the product was identified, strongest first: cpe (you sent one), purl (mapped through our table), alias (a well-known product name), kev (the name matched a KEV entry), name (a guess from the name).
components[].resolved.altsobject[]
Other names the same product is filed under.
components[].statuschecked | partial | kev-only | no-records | unresolved | upstream-error
checked: version ranges evaluated. partial: evaluated for some of the product's names. kev-only: matched the KEV catalogue by name, ranges not evaluated. no-records: identified, nothing on record. unresolved: we could not tell which product this is. upstream-error: the range lookup failed; KEV name matches are still shown.
components[].findingsobject[]
Exploited first (KEV, cited actors), then version certainty, then EPSS.
components[].findings[].cvestring
A CVE id, upper case.
components[].findings[].kevboolean
On the KEV catalogue: exploitation in the wild has been observed, not predicted.
components[].findings[].kev_date_addedstring | null
When it was added to the catalogue.
components[].findings[].ransomwareboolean
The catalogue records known use in ransomware campaigns.
components[].findings[].epssnumber | null
EPSS: the forecast probability, 0 to 1, that the CVE is exploited in the next 30 days. A forecast, never an observation. null when there is no score.
components[].findings[].versionin-range | ambiguous | not-checked | no-version
How your version compares with the published vulnerable ranges. See the meanings on /docs.
components[].findings[].version_detailstring | null
The comparison in words, e.g. 2.14.1 ∈ [2.0, 2.15.0).
components[].findings[].fixed_instring | null
The first fixed version, when the ranges state one.
components[].findings[].confidencehigh | medium | low
How sure the match is: how the product was identified, and whether the version was compared.
components[].findings[].actors[].evidencestring
The quoted sentence that ties the actor to the CVE.
components[].findings[].actors[].sourcestring
Who published the report.
components[].findings[].actors[].urlstring | null
The report.
components[].findings[].not_looked_upactors | epss[]
Facts this check skipped for this CVE because it was over the per-check cap. Empty means looked up.
components[].total_affectedinteger
Affected CVEs before the per-component cap.
components[].not_affectedinteger
CVEs on record for the product whose ranges exclude your version. Counted, not listed.

Errors: 400 · 413 · 429 (what they mean)

GET /api/v1/stack

Describe the stack check

A GET runs nothing: it returns the body to send, the limits and a short key to the fields.

No per-IP limit: the response is cached. Cached 1 hour.

curl -sS "https://skopnix.com/api/v1/stack"
Response · application/json
{  "endpoint": "/api/v1/stack",  "method": "POST",  "body": {    "components": [      {        "name": "log4j-core",        "version": "2.14.1",        "purl": "pkg:maven/org.apache.logging.log4j/[email protected]"      }    ]  },  "limits": {    "components": 500,    "body": "1 MB",    "rate": "10 checks/min per IP"  }}

An example, trimmed: real responses carry more rows and may carry more fields.

The wire and exploits

Stories as data, public exploits per CVE, the week's exploit board and detection rules.

GET /api/v1/items

Stories

The wire as data, newest first. The filters run over the whole archive and total_matching is exact; one response reads at most 500 matching stories, and next_before pages on.

60 requests a minute per IP. Cached 5 minutes. ETag: send If-None-Match for a 304.

kevquery
Only stories naming a CVE on the KEV catalogue.
cvequery
Every story that names this CVE, e.g. CVE-2024-3400.
categoryquery
One category. Anything else is a 400.
sincequery
ISO 8601 date or date-time, e.g. 2026-09-01. A malformed one is a 400, not an empty list.
beforequery
Everything strictly older than this instant. Send next_before back here to keep walking.
limitquery
1 to 200, default 50.
curl -sS "https://skopnix.com/api/v1/items?kev=1&limit=5"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/items",  "version": 1,  "generated_at": "2026-11-03T20:00:00.000Z",  "count": 1,  "total_matching": 412,  "matched_in_window": 412,  "window": {    "size": 500,    "stories_seen": 412,    "complete": true  },  "filters": {    "kev": true,    "cve": null,    "category": null,    "since": null,    "before": null,    "limit": 1  },  "next_before": "2026-11-03T14:12:00.000Z",  "items": [    {      "id": "6727a1f0c2e4b1d3a9e8f012",      "url": "https://skopnix.com/news/example-edge-gateway-flaw-exploited",      "source_url": "https://example.com/advisories/edge-gateway",      "title_en": "Edge gateway flaw exploited before a patch shipped",      "title_az": "Edge gateway boşluğu yamadan əvvəl istismar edilib",      "summary_en": "Attackers exploited a command-injection flaw in the gateway's web interface. The vendor has released a fix.",      "summary_az": "Hücumçular şlüzün veb interfeysindəki boşluqdan istifadə ediblər.",      "truncated": false,      "category": "exploit",      "severity": "critical",      "cvss": 10,      "epss": 0.943,      "kev": true,      "cve_ids": [        "CVE-2024-3400"      ],      "kev_cves": [        "CVE-2024-3400"      ],      "cves": [        {          "id": "CVE-2024-3400",          "kev": true        }      ],      "roundup": false,      "region_relevant": false,      "published_at": "2026-11-03T14:12:00.000Z",      "dispatched_at": "2026-11-03T14:40:31.000Z",      "exposure": null,      "also_reported_by": [],      "cluster_id": "c-6727a1f0",      "is_duplicate": false    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 28
countinteger
Items in this response.
total_matchinginteger
Exact count of stories matching the filters across the whole archive.
window.completeboolean
false when more matched than one response reads; page on with next_before.
next_beforestring | null
Send it back as before= for the next, older page. null on an empty page.
items[].idstring
Stable id.
items[].urlstring
The story on skopnix.com.
items[].source_urlstring
The original report. We aggregate and verify; we do not author it. Cite this.
items[].title_azstring
Azerbaijani headline.
items[].summary_enstring
Body text, trimmed to whole sentences.
items[].truncatedboolean
The original published a cut description and we ended it at the last complete sentence. Fetch source_url for the rest.
items[].categoryexploit | vuln | apt | malware | ransomware | breach | supply-chain | research | policy
A hint, not a taxonomy.
items[].severitycritical | high | medium | low | null
null means no severity was published, not low.
items[].cvssnumber | null
As the cited report states it; null when none was published.
items[].epssnumber | null
EPSS: the forecast probability, 0 to 1, that the CVE is exploited in the next 30 days. A forecast, never an observation. null when there is no score.
items[].kevboolean
At least one CVE on this story is on the KEV catalogue. Use kev_cves to see which.
items[].cve_idsstring[]
CVEs the story names. Often empty.
items[].kev_cvesstring[]
Exactly which of cve_ids are on the KEV catalogue.
items[].cvesobject[]
The same CVEs with a per-CVE KEV flag. Decide per CVE, not per story.
items[].cves[].idstring
A CVE id, upper case.
items[].roundupboolean
The story names 20 or more CVEs (a monthly patch list). Read it as a digest, not a verdict on each CVE.
items[].region_relevantboolean
Relevant to Azerbaijan and the Caspian region.
items[].published_atstring
When the original was published (our own time when it carried none). Sorting, since and before use this.
items[].dispatched_atstring
When skopnix put it on the wire. Always at or after published_at.
items[].exposureobject | null
An internet-wide count of reachable hosts running the product, dated. A count, not an inventory and not a count of vulnerable hosts.
items[].exposure.measured_atstring | null
The day the count was measured.
items[].also_reported_bystring[]
Other outlets that ran the same story.
items[].cluster_idstring
Stories about the same event within 72 hours share it.
items[].is_duplicateboolean
true on the later members of a cluster. Filter on false for one story per event.

Errors: 400 · 429 · 503 (what they mean)

GET /api/v1/exploits

Public exploits for a CVE

Every public exploit and proof of concept we know of for one CVE, each listed once and grouped by where it was published, plus the timeline from disclosure to the first cited attacker. Links only: nothing is hosted or mirrored. status separates none known from could not be read, so an empty list never has to mean safe.

60 requests a minute per IP. Cached 5 minutes. ETag: send If-None-Match for a 304.

cvequery, required
Required. Case and separators are forgiven: cve-2024-3400 and 2024-3400 work.
curl -sS "https://skopnix.com/api/v1/exploits?cve=CVE-2024-3400"
Response · application/json
{  "generated_at": "2026-11-03T20:00:00.000Z",  "cve": "CVE-2024-3400",  "status": "found",  "note": "Links only; we host nothing. trust is a heuristic, never a finding.",  "count": 1,  "detection_templates": 0,  "exploits": {    "<published-in>": [      {        "source": "<published-in>",        "url": "https://example.com/poc/cve-2024-3400",        "name": "cve-2024-3400-poc",        "title": "CVE-2024-3400 proof of concept",        "description": "Checks for and demonstrates the command injection.",        "stars": 112,        "forks": 31,        "language": "Python",        "created_at": "2024-04-16T09:12:00.000Z",        "pushed_at": "2024-04-20T18:03:00.000Z",        "first_seen": "2024-04-16T10:00:00.000Z",        "trust": {          "level": "ok",          "score": 12,          "flags": []        }      }    ]  },  "timeline": [    {      "milestone": "kev_added",      "label": "KEV",      "at": "2024-04-12T00:00:00.000Z",      "days_from_previous": null,      "on_or_after": false,      "confidence": null    },    {      "milestone": "published",      "label": "Disclosed",      "at": "2024-04-12T07:20:00.707Z",      "days_from_previous": 0,      "on_or_after": false,      "confidence": null    },    {      "milestone": "first_poc_at",      "label": "First PoC",      "at": "2024-04-13T05:16:21.000Z",      "days_from_previous": 1,      "on_or_after": false,      "confidence": null    }  ],  "days_to_first_poc": 1,  "days_to_kev": 0}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 11
cvestring
A CVE id, upper case.
statusfound | none-known | unavailable
found: at least one public exploit. none-known: none where we look, which is not proof that none exists. unavailable: we could not read our exploit records just now; says nothing either way.
countinteger
Public exploits and proofs of concept, each listed once.
detection_templatesinteger
Scanner detection templates, counted apart: they detect, they do not exploit.
exploits{ key: object[] }
One array per place of publication; the key names it. Detection templates have their own array.
timelineobject[]
Only the steps that happened, in order.
timeline[].milestonestring
Which step this is: disclosure, the first public proof of concept, the KEV listing or the first cited attacker, among others.
timeline[].labelstring
The step in words.
timeline[].days_from_previousinteger | null
Days since the step before it; null on the first.
timeline[].on_or_afterboolean
The date is a lower bound: the step happened on or after it.
timeline[].confidencestring | null
How sure the date is: high, medium or low; null when not stated.

Errors: 400 · 429 · 503 (what they mean)

GET /api/v1/detections

Detection rules

Detection content built from our own findings: Sigma, QRadar (AQL, rule and reference sets) and Cortex XDR (XQL), mapped to ATT&CK, with false-positive notes and the rule text. Filters combine. At most 200 rules.

60 requests a minute per IP. Cached 1 hour. ETag: send If-None-Match for a 304.

platformquery
The rule language's platform.
techniquequery
An ATT&CK technique id, e.g. T1190.
cvequery
Rules built for one CVE.
actorquery
Rules built for one actor id, e.g. apt28.
kindquery
What the rule is built from.
curl -sS "https://skopnix.com/api/v1/detections?platform=sigma&technique=T1190"
Response · application/json
{  "generated_at": "2026-11-03T20:00:00.000Z",  "filter": {    "platform": "sigma",    "technique": "T1190"  },  "note": "Active detections only. Every rule ships as experimental: hunt before you alert.",  "count": 1,  "detections": [    {      "id": "det-cve-2024-3400-sigma",      "slug": "cve-2024-3400-sigma",      "kind": "cve",      "source_ref": "CVE-2024-3400",      "platform": "sigma",      "format": "yaml",      "title": "Command injection attempt against a VPN gateway web interface",      "description": "Requests carrying shell metacharacters in the session cookie.",      "severity": "high",      "confidence": 70,      "attack_techniques": [        "T1190"      ],      "actors": [],      "cves": [        "CVE-2024-3400"      ],      "fp_safety_notes": "Vulnerability scanners trigger it; exclude your own scanner addresses.",      "references": [        "https://skopnix.com/cve/CVE-2024-3400"      ],      "content": "title: Command injection attempt\nstatus: experimental\nlogsource:\n  category: webserver\ndetection:\n  selection:\n    cs-cookie|contains: '../'\n  condition: selection\n",      "qradar_rule": null,      "reference_set": null,      "cortex_correlation": null,      "generated_at": "2026-11-02T03:00:00.000Z"    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 7
filterobject
The filters you sent, normalised.
detectionsobject[]
Active rules only, at most 200.
detections[].kindttp | cve | actor | ioc
What the rule is built from.
detections[].source_refstring | null
The technique, CVE, actor or indicator set it was built from.
detections[].formatstring
The language of content: yaml (Sigma), aql (QRadar), xql (Cortex XDR) or reference-set (a QRadar reference set and its elements).
detections[].fp_safety_notesstring | null
Known false positives and what to tune before alerting.
detections[].contentstring | null
The rule text.

Errors: 400 · 429 · 503 (what they mean)

Indicators

Check IPs, domains, URLs and hashes; pull a blocklist; read everything public about one value.

POST /api/v1/ioc/check

Check indicators

Paste any text or a list. Every IP, domain, URL and file hash found in it comes back as hit, via-host, via-parent, official, clean or skipped, with a plain verdict, confidence, first and last seen, cited actors and what the address is (an anonymity exit, a VPN range). Clean means we have no record of it, not that it is safe.

30 requests a minute per IP. Anonymous callers also get 15 a day, shared with GET /api/v1/ioc/{indicator}; the allowance resets 24 hours after the first. Never cached.

bodyapplication/json
JSON only (415 otherwise), at most 64 KiB (413). Up to 500 indicators are looked up; the rest are counted in not_checked.
curl -sS -X POST "https://skopnix.com/api/v1/ioc/check" \  -H "Content-Type: application/json" \  -d '{"text":"beacon to hxxp://example[.]org/a from 185.99.135[.]110:8888"}'
Response · application/json
{  "schema": "https://skopnix.com/api/v1/ioc/check",  "version": 1,  "generated_at": "2026-11-03T20:00:00.000Z",  "note": "A hit means a list or a cited report names the indicator. Clean means we have no record of it, not that it is safe.",  "summary": {    "extracted": 2,    "checked": 2,    "hits": 1,    "via_host": 0,    "via_parent": 0,    "official": 0,    "clean": 1,    "claimed": 0,    "skipped": 0,    "not_checked": 0,    "truncated": false,    "by_verdict": {      "c2": 1    }  },  "results": [    {      "type": "ip:port",      "value": "185.99.135.110:8888",      "defanged": "185[.]99[.]135[.]110:8888",      "status": "hit",      "verdict": {        "kind": "c2",        "label": "Malware C2",        "text": "Listed as a command-and-control server for a malware family. Hosts talking to it are probably infected.",        "level": "bad"      },      "family": "Remcos",      "threat_type": "botnet_cc",      "confidence": 100,      "strength": "high",      "c2": true,      "sources": {        "count": 1      },      "first_seen": "2026-10-17T00:00:00.000Z",      "first_seen_ours": false,      "last_seen": "2026-11-03T00:00:00.000Z",      "tags": [        "remcos"      ],      "country": null,      "actors": []    },    {      "type": "url",      "value": "http://example.org/a",      "defanged": "hxxp://example[.]org/a",      "status": "clean"    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 19
summary.extractedinteger
Every indicator found, skipped ones included.
summary.claimedinteger
Indicators named in at least one public hacktivist claim.
summary.not_checkedinteger
Checkable indicators past the 500 cap, not looked up.
results[].valuestring
The indicator, refanged.
results[].defangedstring
The same, safe to paste into a ticket.
results[].statushit | via-host | via-parent | official | clean | skipped
hit: listed. via-host: a URL whose host is listed. via-parent: a subdomain whose parent domain is listed. official: not listed, and a government or official domain. clean: no record (not a statement that it is safe). skipped: private, reserved or a well-known vendor domain.
results[].matchedobject
For via-host and via-parent: the listed indicator that matched.
results[].verdict.kindc2 | malware_delivery | malware_file | malware | phishing | compromised | scanner | listed | reported
scanner means scanning and brute-force noise, not malware.
results[].verdict.textstring
The verdict in a sentence.
results[].verdict.levelbad | warn | noise
bad, warn or noise.
results[].confidenceinteger | null
0 to 100. Below 40 a verdict reads possible. null when only a cited report names it.
results[].sources.countinteger
How many independent lists name it.
results[].actorsobject[]
Actors a cited report ties to it, with up to two citations each.
results[].contextstring[]
What the address or host is, apart from any listing: an anonymity exit, a VPN range, an open proxy, dynamic DNS.
results[].officialstring
The official suffix or domain it belongs to.
results[].claimsobject
Public hacktivist claims that name this host, newest first.
results[].linkedobject[]
Knowledge-graph neighbours of the stored indicator: its malware family, actors that use that family, our active rules for it or those actors. Absent when the graph holds none; the same edges as /api/v1/graph.
results[].linked[].typestring
malware, actor or detection (our rule).
results[].linked[].slugstring
detection only: the rule page is /detections/rule/{slug}.

Errors: 400 · 413 · 415 · 429 · 503 (what they mean)

GET /api/v1/ioc/check

Describe the indicator check

A GET runs nothing and costs nothing against the daily allowance: it returns the body to send and the limits.

No per-IP limit: the response is cached. Cached 1 hour.

curl -sS "https://skopnix.com/api/v1/ioc/check"
Response · application/json
{  "endpoint": "/api/v1/ioc/check",  "method": "POST",  "content_type": "application/json",  "body": {    "text": "beacon to hxxp://example[.]org/a from 203.0.113.9",    "indicators": [      "198.51.100.7",      "evil[.]example"    ]  },  "limits": {    "indicators": 500,    "body": "64 KiB",    "rate": "30 checks/min and 15 checks a day per IP (X-Searches-Left)"  }}

An example, trimmed: real responses carry more rows and may carry more fields.

GET /api/v1/ioc/{indicator}

One indicator

One IP, domain, URL or hash, URL-encoded (a URL has slashes). Defanged forms work. The same result object as one row of the check.

120 requests a minute per IP. Anonymous callers also get 15 a day, shared with POST /api/v1/ioc/check; the allowance resets 24 hours after the first. Cached 15 minutes. ETag: send If-None-Match for a 304.

indicatorpath, required
One indicator, URL-encoded. More than one is a 400: use the check for lists.
curl -sS "https://skopnix.com/api/v1/ioc/185.99.135.110"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/ioc/{indicator}",  "version": 1,  "generated_at": "2026-11-03T20:00:00.000Z",  "note": "A hit means a list or a cited report names the indicator. Clean means we have no record of it, not that it is safe.",  "result": {    "type": "ip",    "value": "8.8.8.8",    "defanged": "8[.]8[.]8[.]8",    "status": "skipped",    "skip_reason": "benign"  }}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 16
result.valuestring
The indicator, refanged.
result.defangedstring
The same, safe to paste into a ticket.
result.statushit | via-host | via-parent | official | clean | skipped
hit: listed. via-host: a URL whose host is listed. via-parent: a subdomain whose parent domain is listed. official: not listed, and a government or official domain. clean: no record (not a statement that it is safe). skipped: private, reserved or a well-known vendor domain.
result.matchedobject
For via-host and via-parent: the listed indicator that matched.
result.verdict.kindc2 | malware_delivery | malware_file | malware | phishing | compromised | scanner | listed | reported
scanner means scanning and brute-force noise, not malware.
result.verdict.textstring
The verdict in a sentence.
result.verdict.levelbad | warn | noise
bad, warn or noise.
result.confidenceinteger | null
0 to 100. Below 40 a verdict reads possible. null when only a cited report names it.
result.sources.countinteger
How many independent lists name it.
result.actorsobject[]
Actors a cited report ties to it, with up to two citations each.
result.contextstring[]
What the address or host is, apart from any listing: an anonymity exit, a VPN range, an open proxy, dynamic DNS.
result.officialstring
The official suffix or domain it belongs to.
result.claimsobject
Public hacktivist claims that name this host, newest first.
result.linkedobject[]
Knowledge-graph neighbours of the stored indicator: its malware family, actors that use that family, our active rules for it or those actors. Absent when the graph holds none; the same edges as /api/v1/graph.
result.linked[].typestring
malware, actor or detection (our rule).
result.linked[].slugstring
detection only: the rule page is /detections/rule/{slug}.

Errors: 400 · 429 · 503 (what they mean)

GET /api/v1/ioc/profile/{value}

Everything public about a domain, IP or hash

The full card behind a check: for a domain, DNS, mail protection, registration, subdomains, exposure and breach listings, look-alikes and our own mentions; for an IPv4 address, its network, ports and known CVEs; for a hash, the file's facts and verdicts. Built once an hour per value.

A 503 with Retry-After means the profile is still being built; retry in a few seconds.

20 requests a minute per IP. Anonymous callers also get 60 a day; the allowance resets 24 hours after the first. Cached 10 minutes.

valuepath, required
One domain, IPv4 address or md5, sha1 or sha256 hash, URL-encoded. Defanged forms work.
curl -sS "https://skopnix.com/api/v1/ioc/profile/example.com"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/ioc/profile/{value}",  "version": 1,  "kind": "domain",  "domain": "example.com",  "registrable": "example.com",  "generated_at": "2026-11-03T20:00:00.000Z",  "dns": {    "status": "ok",    "a": [      "172.66.147.243"    ],    "aaaa": [],    "cname": [],    "ns": [      "a.example-dns.net"    ],    "mx": [      {        "host": "",        "pri": 0      }    ]  },  "mail": {    "mx": "ok",    "spf": {      "status": "ok",      "record": "v=spf1 -all",      "policy": "-all"    },    "dmarc": {      "status": "ok",      "record": "v=DMARC1;p=reject;sp=reject;adkim=s;aspf=s",      "policy": "reject"    },    "grade": {      "grade": "A",      "spoofable": false    }  },  "registration": {    "status": "ok",    "created": "1995-08-14T04:00:00.000Z",    "expires": "2027-08-13T04:00:00.000Z",    "age_days": 11404,    "registrar": "RESERVED-Internet Assigned Numbers Authority",    "dnssec": true,    "nrd": false  },  "subdomains": {    "status": "ok",    "count": 1,    "sample": [      "www.example.com"    ],    "dangling": [],    "internal": []  },  "mentions": {    "count": 0,    "stories": []  }}

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 400 · 429 · 503 (what they mean)

GET /api/v1/ioc/stats

How many indicators we hold

Counts per type and when the newest indicator was written: every indicator we hold and the check answers from, benign-capped and expired ones included. The network exports and blocklists carry only the unexpired, not-benign subset, so their counts are smaller. Computed hourly, so polling it is free.

60 requests a minute per IP. Cached 1 hour. ETag: send If-None-Match for a 304.

curl -sS "https://skopnix.com/api/v1/ioc/stats"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/ioc/stats",  "version": 1,  "generated_at": "2026-11-03T19:59:25.388Z",  "total": 1293637,  "by_type": {    "domain": 364009,    "ip": 609135,    "url": 223778,    "sha1": 29758,    "md5": 28095,    "sha256": 29563,    "ip:port": 9299  },  "updated_at": "2026-11-03T19:25:19.571Z"}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 2
generated_atstring | null
When the hourly count ran, not when this response was sent.
updated_atstring | null
When the newest indicator was written.

Errors: 429 · 503 (what they mean)

GET /api/v1/ioc/blocklist

A blocklist for a firewall or SIEM

A plain list, one value per line, for machines: values are real, not defanged. Scanning and brute-force noise is left out unless you ask for it. At most 100,000 lines; the X-Skopnix-Count and X-Skopnix-Truncated headers say how many and whether it was cut.

10 requests a minute per IP. Cached 10 minutes. ETag: send If-None-Match for a 304.

typequery, required
Required.
minquery
Lowest confidence, 20 to 100, default 80.
daysquery
Seen within the last 1, 7 or 30 days, default 7.
formatquery
txt (one value per line) or csv (with columns).
noisequery
1 keeps indicators that only scanning and brute-force lists name.
curl -sS "https://skopnix.com/api/v1/ioc/blocklist?type=ip&min=90&days=1"
Response · text/plain
45.128.12.14184.64.22.19445.154.98.118 

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 400 · 429 · 503 (what they mean)

Adversaries

The roster, one dossier, and the actors a report ties to a CVE.

GET /api/v1/actors

The adversary roster

One lean row per dossier: id, aliases, assessed origin and how often our wire named it in 90 days. The full dossier is one hop away at api_url.

60 requests a minute per IP. Cached 1 hour. ETag: send If-None-Match for a 304.

qquery
Case-insensitive substring over name and aliases.
typequery
Anything else is a 400.
originquery
ISO-2 country code, as the cited reporting states it.
limitquery
1 to 500, default 100.
curl -sS "https://skopnix.com/api/v1/actors?q=blizzard&type=nation-state"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/actors",  "version": 1,  "generated_at": "2026-11-03T20:00:00.000Z",  "count": 1,  "total_matching": 1,  "roster_refreshed": "2026-11-02T04:00:00.000Z",  "filters": {    "q": "blizzard",    "type": "nation-state",    "origin": null,    "limit": 100  },  "actors": [    {      "id": "apt29",      "name": "APT29",      "url": "https://skopnix.com/actors/apt29",      "api_url": "https://skopnix.com/api/v1/actors/apt29",      "type": "nation-state",      "origin": "RU",      "aliases": [        "Midnight Blizzard",        "Cozy Bear"      ],      "on_wire_90d": 7    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 2
actors[].originstring | null
ISO-2 country code, as the cited reporting states it; null when it does not.
actors[].on_wire_90dinteger
Stories on our wire that named it in the last 90 days.

Errors: 400 · 429 · 503 (what they mean)

GET /api/v1/actors/{id}

One dossier

Techniques, tools, observed targets, the stories that named it, and once computed the CVEs it uses and recent reports. What the cited reporting states, never guessed: a field not yet computed is null. An alias id answers 308 to the canonical one.

120 requests a minute per IP. Cached 1 hour. ETag: send If-None-Match for a 304.

idpath, required
The dossier id, e.g. apt28. Aliases redirect.
curl -sS "https://skopnix.com/api/v1/actors/apt28"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/actors/{id}",  "version": 1,  "generated_at": "2026-11-03T20:00:00.000Z",  "id": "apt28",  "name": "APT28",  "url": "https://skopnix.com/actors/apt28",  "aliases": [    "Fancy Bear",    "Forest Blizzard"  ],  "type": "nation-state",  "origin_country": "RU",  "state_sponsor": "GRU",  "mitre": "G0007",  "description": "A threat group the cited reporting attributes to Russian military intelligence.",  "targets": {    "countries": [      "UA",      "DE",      "AZ"    ],    "other": [],    "sectors": [      "government",      "defense"    ]  },  "techniques": [    {      "id": "T1566.001",      "name": "Spearphishing Attachment",      "tactic": "initial-access"    }  ],  "malware": [    "X-Agent"  ],  "tools": [    "Mimikatz"  ],  "victim_count": null,  "first_seen": "2004-01-01T00:00:00.000Z",  "last_active": "2026-10-30T00:00:00.000Z",  "related": [],  "on_wire": [    {      "title": "Router campaign tied to APT28",      "url": "https://skopnix.com/news/router-campaign-apt28",      "published_at": "2026-10-30T09:00:00.000Z",      "kev": true    }  ],  "reports": [    {      "title": "Edge-device campaign",      "source": "example.com",      "date": "2026-10-29",      "url": "https://example.com/report/edge-campaign"    }  ],  "cves": [    {      "cve": "CVE-2023-23397",      "kev": true,      "epss": 0.92,      "date": "2023-03-14",      "evidence": "APT28 exploited CVE-2023-23397 against European targets.",      "url": "https://example.com/report/outlook-campaign"    }  ],  "activity_30d": {    "stories": 4,    "victims": 0,    "cves_new": 1  },  "refs": [    "https://attack.mitre.org/groups/G0007/"  ],  "attack": {    "id": "G0007",    "url": "https://attack.mitre.org/groups/G0007",    "version": "18.1"  },  "attack_refs": [    {      "source_name": "mitre-attack",      "url": "https://attack.mitre.org/groups/G0007",      "external_id": "G0007"    }  ],  "attack_attribution": "MITRE ATT&CK®, © The MITRE Corporation. This work is reproduced and distributed with the permission of The MITRE Corporation.",  "last_refreshed": "2026-11-02T04:00:00.000Z"}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 18
idstring
Canonical id. An alias id answers 308 to this one.
origin_countrystring | null
Assessed origin, as the cited reporting states it.
mitrestring | null
The ATT&CK group id.
targetsobject
Observed targets, as stated by the cited reporting.
techniques[].idstring
ATT&CK technique id.
on_wireobject[]
Stories on our wire that named it in the last 90 days.
on_wire[].urlstring
The story on skopnix.com.
on_wire[].kevboolean
The story names a CVE on the KEV catalogue.
cvesobject[] | null
CVEs the cited reporting ties to it. null until computed.
cves[].cvestring
A CVE id, upper case.
cves[].epssnumber | null
EPSS: the forecast probability, 0 to 1, that the CVE is exploited in the next 30 days. A forecast, never an observation. null when there is no score.
cves[].evidencestring
The quoted sentence.
activity_30dobject | null
Counts over the last 30 days. null until computed.
attack.idstring
The ATT&CK group id.
attack.urlstring
The group's page on attack.mitre.org.
attack.versionstring | null
The ATT&CK release it was read from.
attack_refsobject[]
ATT&CK's own references for the group, its attack.mitre.org page first.
attack_attributionstring | null
The attribution MITRE's terms require wherever ATT&CK data is shown. Keep it with the data.

Errors: 404 · 429 · 503 (what they mean)

GET /api/v1/graph/{type}/{id}

What one entity is linked to

The knowledge graph around one actor, malware family, CVE, indicator, sector, country or skopnix rule: the software an actor uses, the CVEs it exploits, the rules that detect it, the indicators that point at it. Grouped by relation, strongest first, each link with how many records support it, when it was first and last seen, and a confidence. An entity with no links yet answers 200 with no groups.

60 requests a minute per IP. Cached 5 minutes. ETag: send If-None-Match for a 304.

typepath, required
The entity type.
idpath, required
Its id: apt28, x-agent, CVE-2023-23397, ip:1.2.3.4, finance, AZ, or a rule id. An actor alias answers for its dossier.
limitquery
Neighbours per relation, 1 to 100, default 25.
curl -sS "https://skopnix.com/api/v1/graph/actor/apt28"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/graph/{type}/{id}",  "version": 1,  "generated_at": "2026-11-03T20:00:00.000Z",  "node": {    "type": "actor",    "id": "apt28"  },  "limit_per_relation": 25,  "groups": [    {      "relation": "exploits",      "direction": "out",      "total": 1,      "neighbours": [        {          "type": "cve",          "id": "CVE-2023-23397",          "name": "CVE-2023-23397",          "count": 3,          "first_seen": "2023-03-14T00:00:00.000Z",          "last_seen": "2026-10-30T00:00:00.000Z",          "confidence": 90        }      ]    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 9
node.idstring
The canonical id (an actor alias answers for its dossier).
groupsobject[]
Empty when the graph holds no links for it yet.
groups[].relationstring
uses, exploits, indicates, related-to, targets, attributed-to, originates-from, located-at, in-sector or detects.
groups[].directionout | in
out: this entity is the subject (apt28 uses X-Agent). in: the link points at it (a rule detects apt28).
groups[].totalinteger
Neighbours in this group before the cap.
groups[].neighbours[].typestring
The other entity's type: actor, malware, tool, technique, cve, ioc, victim, sector, country, claim, detection or rule.
groups[].neighbours[].idstring
Its id. A claim's id is the 16-character id of its row in /api/v1/claims.
groups[].neighbours[].countinteger
How many records support the link.
groups[].neighbours[].confidenceinteger
0 to 100.

Errors: 400 · 429 · 503 (what they mean)

GET /api/v1/cves/{id}/actors

Who a report ties to a CVE

The threat actors a published report ties to this CVE, each with the verbatim quote and the report's URL. A citation, never our confirmation; a row without a quote or a source URL is never served.

60 requests a minute per IP. Cached 5 minutes. ETag: send If-None-Match for a 304.

idpath, required
A CVE id. Case and separators are forgiven.
curl -sS "https://skopnix.com/api/v1/cves/CVE-2023-23397/actors"
Response · application/json
{  "generated_at": "2026-11-03T20:00:00.000Z",  "schema": "https://skopnix.com/api/v1/cves/{id}/actors",  "version": 1,  "cve": "CVE-2023-23397",  "cve_url": "https://skopnix.com/cve/CVE-2023-23397",  "note": "Each row is a report cited as tying this actor to this CVE, with the quote that says so. A citation, not a confirmation.",  "count": 1,  "citations": [    {      "cve": "CVE-2023-23397",      "actor_id": "apt28",      "actor_text": "Forest Blizzard",      "actor_url": "https://skopnix.com/actors/apt28",      "relation": "exploited",      "quote": "Forest Blizzard exploited CVE-2023-23397 to target European government organisations.",      "actor_in_quote": true,      "source_url": "https://example.com/report/outlook-campaign",      "kev": true,      "extracted_at": "2026-10-01T06:00:00.000Z"    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 9
cvestring
A CVE id, upper case.
citationsobject[]
Quote-named citations first. A row without a quote or a source URL is never served.
citations[].cvestring
A CVE id, upper case.
citations[].actor_idstring
Canonical actor id.
citations[].actor_textstring
How the report names the actor.
citations[].relationexploited | used_in_campaign | attributed_by_report
What the sentence says: exploited, used_in_campaign, or attributed_by_report (the weakest; an unknown value is served as this).
citations[].quotestring
The sentence, verbatim.
citations[].actor_in_quoteboolean
true when the quote itself names the actor; false when the actor is named near it.
citations[].source_urlstring
The report the quote comes from.

Errors: 400 · 429 · 503 (what they mean)

Claims and Azerbaijan

Hacktivist and leak-site claims with our own reachability check, and the Azerbaijan board. Every row is a claim, never a confirmed incident.

GET /api/v1/claims

Claims

Hacktivist claims and ransomware leak-site listings, newest first, with our own reachability check of each named site. Every row is a claim made by a third party, never a confirmed incident. A reachability verdict means something for DDoS and defacement claims only.

60 requests a minute per IP. Cached 5 minutes. ETag: send If-None-Match for a 304.

regionquery
Azerbaijan, worldwide, or both (default).
limitquery
1 to 500, default 100.
curl -sS "https://skopnix.com/api/v1/claims?region=az&limit=10"
Response · application/json
{  "generated_at": "2026-11-03T20:00:00.000Z",  "region": "az",  "attribution": "…",  "note": "Each row is a claim made by a third party, not a confirmed incident. checks = the LATEST re-check of each named site.",  "stats": {    "total7d": 9,    "total30d": 41,    "hacktivist_7d": 7,    "hacktivist_30d": 33,    "ransomware_listings_7d": 2,    "ransomware_listings_30d": 8,    "top_claimants_30d": [      {        "group": "Example Cyber Team",        "n": 12,        "last": "2026-11-03T10:00:00.000Z"      }    ],    "last_seen": "2026-11-03T10:00:00.000Z"  },  "rows_returned": 1,  "claims": [    {      "id": "4f15a948dad34b61",      "region": "az",      "claimant": "Example Cyber Team",      "at": "2026-11-03T10:00:00.000Z",      "seenAt": "2026-11-03T10:01:12.000Z",      "text": "We took down example.az for six hours.",      "summaryEn": "A group claims a DDoS against example.az.",      "claimType": "ddos",      "alsoReportedBy": 2,      "targets": [],      "checkTargets": [        "example.az"      ],      "checks": [        {          "target": "https://example.az/",          "here": "200",          "at": "2026-11-03T10:03:00.000Z",          "az": {            "here": "200",            "ok": true,            "at": "2026-11-03T10:04:00.000Z"          },          "firstCheck": {            "at": "2026-11-03T10:03:00.000Z",            "here": "200",            "ok": true          }        }      ],      "checkedAt": "2026-11-03T10:03:00.000Z",      "corroboration": [],      "proof": []    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 16
attributionstring
The credit line the listing data's licence asks for. Keep it when you republish.
statsobject
Distinct claims by claim time, reposts folded, for the chosen region.
rows_returnedinteger
Rows in this response (see limit), not a period count.
claims[].idstring
16 hex characters. The evidence is at /api/v1/claims/context/{id}.
claims[].claimantstring
The group making the claim, as it names itself.
claims[].atstring
When the claim was made.
claims[].seenAtstring
When we saw it.
claims[].textstring
The claim, verbatim.
claims[].claimTypestring | null
ddos, defacement, leak, ransomware, intrusion, threat and others; null when unclear.
claims[].alsoReportedByinteger
Other posts making the same claim, folded into this row.
claims[].checkTargetsstring[]
The hosts we checked.
claims[].checksobject[]
The LATEST check of each named site, not its state when the claim was seen.
claims[].checks[].targetstring
The URL that was checked.
claims[].checks[].herestring
What the check got: an HTTP status, or the failure (timeout, refused, DNS).
claims[].checks[].azobject | null
The same check from inside Azerbaijan.
claims[].checks[].firstCheckobject | null
Our first look, when it differs from the latest.

Errors: 429 · 503 (what they mean)

GET /api/v1/claims/country/{cc}

Claims naming one country

The last 30 days of public claims that name one country: hacktivist claims and ransomware listings, our check results, the top groups and attack types, and the newest eight.

120 requests a minute per IP. Cached 2 minutes.

ccpath, required
ISO-2 country code, e.g. AZ.
curl -sS "https://skopnix.com/api/v1/claims/country/AZ"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/claims/country/{CC}",  "version": 1,  "cc": "AZ",  "name": "Azerbaijan",  "days": 30,  "total": 41,  "hacktivist": 33,  "ransomware": 8,  "last_24h": 2,  "checks": {    "defaced": 1,    "up": 20,    "filtered": 3,    "error": 1,    "unreachable": 4,    "not_checked": 12  },  "groups": [    {      "name": "Example Cyber Team",      "n": 12    }  ],  "types": [    {      "type": "ddos",      "n": 19    }  ],  "latest": [    {      "id": "4f15a948dad34b61",      "at": "2026-11-03T10:00:00.000Z",      "group": "Example Cyber Team",      "kind": "hacktivist",      "claim_type": "ddos",      "target": "example.az",      "verdict": "up"    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 3
ccstring
ISO-2, upper case.
daysinteger
The window, in days.
latestobject[]
The newest eight.

Errors: 400 · 429 · 503 (what they mean)

GET /api/v1/claims/context/{id}

The evidence behind one claim

For one claim: our own check history of each named site since the claim, from abroad and from inside Azerbaijan; the claimant's proof as we read it back; archived copies before and after; the group's track record; other claims on the same site; older ransomware listings of the same victim.

30 requests a minute per IP. Cached 5 minutes.

idpath, required
The 16-character id of a row from /api/v1/claims.
ID=$(curl -sS "https://skopnix.com/api/v1/claims?region=az&limit=50" | jq -r '[.claims[] | select(.checkTargets | length > 0)][0].id')curl -sS "https://skopnix.com/api/v1/claims/context/$ID"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/claims/context/{id}",  "version": 1,  "id": "4f15a948dad34b61",  "at": "2026-11-03T10:00:00.000Z",  "claim_type": "ddos",  "region": "az",  "targets": [    {      "host": "example.az",      "checks": {        "total": 3,        "up": 3,        "answered": 3,        "first_at": "2026-11-03T10:03:00.000Z",        "last_at": "2026-11-03T16:03:00.000Z",        "first_late_h": null,        "timeline": [          {            "at": "2026-11-03T10:03:00.000Z",            "ok": true          }        ]      },      "az": {        "total": 3,        "up": 3,        "answered": 3,        "last_at": "2026-11-03T16:04:00.000Z",        "last_ok": true      }    }  ],  "proof": [],  "group": null,  "related": [],  "ransomware": []}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 7
targets[].checksobject
Our checks of the host since the claim.
targets[].checks.first_late_hnumber | null
Hours between the claim and our first check, when it was late.
targets[].azobject | null
The same, from inside Azerbaijan.
proofany[]
What the claimant offered as proof, as we read it back.
groupobject | null
The claimant's track record.
relatedany[]
Other claims on the same site.
ransomwareany[]
Older ransomware listings of the same victim.

Errors: 400 · 404 · 429 · 503 (what they mean)

GET /api/v1/az

The Azerbaijan board

The board /az prints, as data: this week's claimed campaigns with our reachability check, the cited adversaries, breach listings (metadata only, never the data), and exploited CVEs relevant here. null means a section could not be read; [] means nothing recorded.

60 requests a minute per IP. Cached 5 minutes. ETag: send If-None-Match for a 304.

curl -sS "https://skopnix.com/api/v1/az"
Response · application/json
{  "generated_at": "2026-11-03T20:00:00.000Z",  "note": "Campaigns and exposure rows are CLAIMS made by third parties, not confirmed incidents. null = that section could not be read; [] = nothing recorded.",  "counts": {    "claims_7d": 9,    "campaigns_7d": 4,    "adversaries": 6,    "exposure_listings": 3,    "exploited_cves": 5,    "linked_iocs": 120  },  "campaigns_7d": [    {      "group": "Example Cyber Team",      "target": "example.az",      "claimTypes": [        "ddos"      ],      "kinds": [],      "claims": 2,      "first": "2026-11-01T13:00:00.000Z",      "last": "2026-11-03T10:00:00.000Z",      "verdict": "up",      "checkApplies": true,      "sources": []    }  ],  "adversaries": [],  "exposure": [    {      "id": "azx:913b781e8d9cd8438cf8",      "org": "Example Insurance",      "sector": "finance",      "claimType": "ransomware",      "group": null,      "status": "claimed",      "at": "2026-10-16T16:28:02.775Z"    }  ],  "exploited_now": {    "snapshot": "2026-11-03",    "rows": [      {        "cve": "CVE-2024-3400",        "title": "Command injection in a VPN gateway",        "kev": true,        "epss": 0.943,        "why": [          "az-exposure",          "kev"        ],        "exposure": {          "product": "VPN gateway",          "count": 140,          "asOf": "2026-11-01"        },        "actors": []      }    ]  }}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 9
campaigns_7dobject[] | null
Claimed campaigns this week, grouped by claimant and target. null when the section could not be read; [] when nothing was claimed.
campaigns_7d[].groupstring
The claimant, as it names itself.
campaigns_7d[].verdictdefaced | up | filtered | error | unreachable | not_checked | unchecked
Our own check of the target. Means something for DDoS and defacement claims only (see checkApplies).
campaigns_7d[].checkAppliesboolean
A DDoS or defacement claim is among them, so the reachability verdict is meaningful.
adversariesobject[] | null
Cited adversaries relevant here, each with its quote and source.
exposureobject[] | null
Breach listings naming an organisation here: metadata only, never the data and never a link to it.
exploited_now.rows[].cvestring
A CVE id, upper case.
exploited_now.rows[].epssnumber | null
EPSS: the forecast probability, 0 to 1, that the CVE is exploited in the next 30 days. A forecast, never an observation. null when there is no score.
exploited_now.rows[].whystring[]
Why it matters here, in short phrases.

Errors: 429 · 503 (what they mean)

STIX, TAXII and MISP

The cited intelligence in the formats a threat-intelligence platform ingests.

GET /api/v1/stix/actors/{id}

An actor's cited intelligence as STIX 2.1

The intrusion-set, the CVEs it exploits, the techniques it uses and the indicators that indicate it, each relationship carrying the report URL and the sentence it rests on. Paged at 400 citations (at most 803 objects): X-Total-Pages gives the count and a Link rel="next" header names the next page.

60 requests a minute per IP, shared with GET /api/v1/stix/cves/{cve}. Cached 1 hour. ETag: send If-None-Match for a 304.

idpath, required
The dossier id. Aliases redirect.
pagequery
1 and up. Past the last page is a 404.
curl -sS "https://skopnix.com/api/v1/stix/actors/apt28"
Response · application/stix+json;version=2.1
{  "type": "bundle",  "id": "bundle--5c1a8f3e-2d4b-5e6f-8a9b-0c1d2e3f4a5b",  "objects": [    {      "type": "intrusion-set",      "spec_version": "2.1",      "id": "intrusion-set--0b2f3c4d-5e6f-5a7b-8c9d-0e1f2a3b4c5d",      "name": "APT28"    },    {      "type": "vulnerability",      "spec_version": "2.1",      "id": "vulnerability--1c2d3e4f-5a6b-5c7d-8e9f-0a1b2c3d4e5f",      "name": "CVE-2023-23397"    },    {      "type": "relationship",      "spec_version": "2.1",      "id": "relationship--2d3e4f5a-6b7c-5d8e-9f0a-1b2c3d4e5f6a",      "relationship_type": "exploits",      "source_ref": "intrusion-set--0b2f3c4d-5e6f-5a7b-8c9d-0e1f2a3b4c5d",      "target_ref": "vulnerability--1c2d3e4f-5a6b-5c7d-8e9f-0a1b2c3d4e5f",      "description": "APT28 exploited CVE-2023-23397 against European targets.",      "confidence": 85,      "external_references": [        {          "source_name": "report",          "url": "https://example.com/report/outlook-campaign"        }      ]    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 400 · 404 · 429 · 503 (what they mean)

GET /api/v1/stix/cves/{cve}

Who exploits a CVE, as STIX 2.1

One vulnerability, every actor with a dossier that a published report ties to it, and one exploits relationship per report with its URL and quote. Citations naming an actor we hold no dossier for are left out rather than turned into a group named after free text. Paged like the actor bundle.

60 requests a minute per IP, shared with GET /api/v1/stix/actors/{id}. Cached 1 hour. ETag: send If-None-Match for a 304.

cvepath, required
A CVE id.
pagequery
1 and up.
curl -sS "https://skopnix.com/api/v1/stix/cves/CVE-2023-23397"
Response · application/stix+json;version=2.1
{  "type": "bundle",  "id": "bundle--6d2b9f4e-3e5c-5f7a-9b0c-1d2e3f4a5b6c",  "objects": [    {      "type": "vulnerability",      "spec_version": "2.1",      "id": "vulnerability--1c2d3e4f-5a6b-5c7d-8e9f-0a1b2c3d4e5f",      "name": "CVE-2023-23397"    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 400 · 404 · 429 · 503 (what they mean)

GET /api/v1/taxii2/

TAXII 2.1 API root

The read-only TAXII 2.1 API root. Point a TAXII 2.1 client at it; discovery is at /taxii2/. No key and no write endpoint.

60 requests a minute per IP, shared with every TAXII endpoint. Cached 1 day.

Acceptheader
application/taxii+json;version=2.1. Plain JSON and */* are accepted too; another TAXII version is a 406.
curl -sS "https://skopnix.com/api/v1/taxii2/" \  -H "Accept: application/taxii+json;version=2.1"
Response · application/taxii+json;version=2.1
{  "title": "skopnix cited intelligence",  "description": "Collections: cited-intel, az-claims and indicators. Read-only.",  "versions": [    "application/taxii+json;version=2.1"  ],  "max_content_length": 0}

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 406 · 429 (what they mean)

GET /api/v1/taxii2/collections/

TAXII collections

Two read-only collections: cited-intel (actor to CVE, technique and indicator links, each with its source URL and quote) and az-claims (public claims against Azerbaijan, as low-confidence reports labelled unverified-claim).

60 requests a minute per IP, shared with every TAXII endpoint. Cached 1 day.

Acceptheader
application/taxii+json;version=2.1.
curl -sS "https://skopnix.com/api/v1/taxii2/collections/" \  -H "Accept: application/taxii+json;version=2.1"
Response · application/taxii+json;version=2.1
{  "collections": [    {      "id": "52112f0f-f0cb-559c-9104-47495a0cbd89",      "title": "cited-intel",      "description": "Actor ↔ CVE, ATT&CK technique and indicator links, each a relationship carrying the source URL and the quoted sentence it rests on.",      "can_read": true,      "can_write": false,      "media_types": [        "application/stix+json;version=2.1"      ]    },    {      "id": "c99bd4bf-d03a-535a-a684-81cefccdc22b",      "title": "az-claims",      "description": "Public hacktivist and leak-site claims against Azerbaijan, as low-confidence reports labelled unverified-claim.",      "can_read": true,      "can_write": false,      "media_types": [        "application/stix+json;version=2.1"      ]    },    {      "id": "5f508a69-684e-5cb1-a0c2-5f732c153090",      "title": "indicators",      "description": "STIX 2.1 indicator objects for the same set the blocklist export serves: confidence 80 or more, not treated as benign, inside the type's lifetime (IP 30 days, URL 60, domain 90, hashes never).",      "can_read": true,      "can_write": false,      "media_types": [        "application/stix+json;version=2.1"      ]    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 1
collections[].idstring
A UUID. The title works in its place.

Errors: 406 · 429 (what they mean)

GET /api/v1/taxii2/collections/{id}/

One TAXII collection

One collection, by its UUID or its title.

60 requests a minute per IP, shared with every TAXII endpoint. Cached 1 day.

idpath, required
The collection's UUID, or cited-intel, az-claims or indicators.
Acceptheader
application/taxii+json;version=2.1.
curl -sS "https://skopnix.com/api/v1/taxii2/collections/cited-intel/" \  -H "Accept: application/taxii+json;version=2.1"
Response · application/taxii+json;version=2.1
{  "id": "52112f0f-f0cb-559c-9104-47495a0cbd89",  "title": "cited-intel",  "description": "Actor ↔ CVE, ATT&CK technique and indicator links, each a relationship carrying the source URL and the quoted sentence it rests on.",  "can_read": true,  "can_write": false,  "media_types": [    "application/stix+json;version=2.1"  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 1
idstring
A UUID. The title works in its place.

Errors: 404 · 406 · 429 (what they mean)

GET /api/v1/taxii2/collections/{id}/objects/

A page of a TAXII collection

One page as a TAXII 2.1 envelope. X-TAXII-Date-Added-First and -Last bracket the page; the -Last value is the added_after for your next poll. A citation's objects are never split across pages, so a page can hold fewer than limit. The indicators collection carries one STIX indicator per IOC (pattern_type stix, valid_until = newest sighting + the type's lifetime); its date added is the indicator's last update.

60 requests a minute per IP, shared with every TAXII endpoint. Cached 5 minutes. ETag: send If-None-Match for a 304.

idpath, required
The collection's UUID, or cited-intel, az-claims or indicators.
added_afterquery
RFC 3339 UTC timestamp. Only objects added strictly after it. Anything else is a 400.
limitquery
Objects per page, up to 1000 (larger values are capped). Exact on indicators. On cited-intel and az-claims a citation's objects (up to 3) are one indivisible group: a page never splits one, so a limit smaller than the first group returns that one whole group.
nextquery
The opaque value the previous page returned while more was true. Walk a collection with it rather than added_after: many objects can share one second.
Acceptheader
application/taxii+json;version=2.1.
curl -sS "https://skopnix.com/api/v1/taxii2/collections/cited-intel/objects/?limit=50" \  -H "Accept: application/taxii+json;version=2.1"
Response · application/taxii+json;version=2.1
{  "more": true,  "next": "MjAyNi0xMC0xN1QwNjowNzoyOS45NzZafDQ5",  "objects": [    {      "type": "identity",      "spec_version": "2.1",      "id": "identity--f8cb5b9b-bd4c-5d6a-9175-748154552143",      "name": "skopnix",      "identity_class": "organization",      "created": "2026-01-01T00:00:00.000Z",      "modified": "2026-01-01T00:00:00.000Z"    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 1
nextstring
Send it back as next= while more is true.

Errors: 400 · 404 · 406 · 429 · 503 (what they mean)

GET /api/v1/misp/manifest.json

MISP feed index

In MISP: Sync Actions → Feeds → Add Feed, source format MISP Feed, URL https://skopnix.com/api/v1/misp. MISP reads this index and fetches each actor's event when its timestamp moves.

60 requests a minute per IP, shared with every MISP endpoint. Cached 1 hour. ETag: send If-None-Match for a 304.

curl -sS "https://skopnix.com/api/v1/misp/manifest.json"
Response · application/json
{  "f47bdc6d-bf5f-5096-8074-ae75eb1e3464": {    "Orgc": {      "name": "skopnix",      "uuid": "f8cb5b9b-bd4c-5d6a-9175-748154552143"    },    "Tag": [      {        "name": "tlp:white",        "colour": "#ffffff",        "exportable": true      }    ],    "info": "skopnix cited intelligence: APT28",    "date": "2026-10-17",    "analysis": "1",    "threat_level_id": "4",    "timestamp": "1792233177"  }}

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 429 · 503 (what they mean)

GET /api/v1/misp/{uuid}.json

One MISP event

One actor's cited indicators and CVEs as a MISP event. Every attribute's comment is the quoted sentence and its source URL. The UUID is one the manifest lists.

60 requests a minute per IP, shared with every MISP endpoint. Cached 1 hour. ETag: send If-None-Match for a 304.

uuidpath, required
An event UUID from the manifest.
UUID=$(curl -sS "https://skopnix.com/api/v1/misp/manifest.json" | jq -r 'keys[0]')curl -sS "https://skopnix.com/api/v1/misp/$UUID.json"
Response · application/json
{  "Event": {    "uuid": "f47bdc6d-bf5f-5096-8074-ae75eb1e3464",    "info": "skopnix cited intelligence: APT28",    "date": "2026-10-17",    "threat_level_id": "4",    "analysis": "1",    "published": true,    "timestamp": "1792233177",    "Orgc": {      "name": "skopnix",      "uuid": "f8cb5b9b-bd4c-5d6a-9175-748154552143"    },    "Tag": [      {        "name": "tlp:white"      }    ],    "Attribute": [      {        "uuid": "a8fdd8b3-62a5-5da3-8a57-e3b85e271cbe",        "type": "domain",        "category": "Network activity",        "value": "bad.example",        "to_ids": true,        "comment": "\"Block network traffic to and from bad[.]example\" — https://example.com/report/edge-campaign",        "timestamp": "1792233177",        "distribution": "5",        "disable_correlation": false      }    ]  }}

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 404 · 429 · 503 (what they mean)

GET /api/v1/misp/hashes.csv

MISP feed hashes

md5(value),event-uuid for every attribute in the feed. A MISP server reads it when it caches the feed, so these indicators take part in its correlation and overlap views.

60 requests a minute per IP, shared with every MISP endpoint. Cached 1 hour. ETag: send If-None-Match for a 304.

curl -sS "https://skopnix.com/api/v1/misp/hashes.csv"
Response · text/csv
ac1d3944a10c0a0394a1403a9e323078,f47bdc6d-bf5f-5096-8074-ae75eb1e34642880d5c97121529df77ecedb5d2a8837,f47bdc6d-bf5f-5096-8074-ae75eb1e3464 

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 429 · 503 (what they mean)

GET /api/v1/exports/manifest.json

Network and firewall exports: the list

Every ready-to-load network file: Suricata rules with their datasets and IP reputation, Palo Alto and FortiGate external lists, plain IPv4 / IPv6 lists, ipset, nftables, MikroTik RouterOS scripts, a Zeek intel file and hash lists by malware family. Built from high-confidence, unexpired indicators. Each file's sha256 is also its ETag.

120 requests a minute per IP. Cached 15 minutes. ETag: send If-None-Match for a 304.

curl -sS "https://skopnix.com/api/v1/exports/manifest.json"
Response · application/json
{  "schema": "https://skopnix.com/api/v1/exports/manifest.json",  "version": 1,  "generated_at": "2026-11-03T20:00:00.000Z",  "min_confidence": 80,  "files": [    {      "path": "edl/paloalto-ip.txt",      "count": 1200,      "bytes": 16800,      "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",      "content_type": "text/plain; charset=utf-8",      "truncated": false    }  ]}

An example, trimmed: real responses carry more rows and may carry more fields.

Fields · 6
generated_atstring | null
When the files were last built.
min_confidencenumber | null
The lowest indicator confidence in any file.
files[].pathstring
Fetch it at /api/v1/exports/{path}.
files[].countinteger
Entries in the file.
files[].sha256string
The body's SHA-256, and the file's ETag.
files[].truncatedboolean
true when a size cap cut the list (firewall list limits).

Errors: 429 · 503 (what they mean)

GET /api/v1/exports/{path}

Network and firewall exports: one file

One file from the manifest, exactly as built. Poll it with If-None-Match: the ETag is the file's sha256, so you get 304 until the list changes. A path not in the manifest is 404.

Palo Alto: Objects > External Dynamic Lists, type IP List, source https://skopnix.com/api/v1/exports/edl/paloalto-ip.txt (also -domain and -url).

FortiGate: Security Fabric > External Connectors > Threat Feeds, URI https://skopnix.com/api/v1/exports/fortinet/ip.txt (also domain.txt, url.txt).

Suricata: fetch suricata/skopnix.rules plus the suricata/datasets and suricata/iprep files into your rules directory, then reload.

ipset: curl -s https://skopnix.com/api/v1/exports/ipset/skopnix.ipset | ipset restore -exist

nftables: curl -so skopnix.nft https://skopnix.com/api/v1/exports/nftables/skopnix.nft && nft -f skopnix.nft

MikroTik: /tool fetch url=https://skopnix.com/api/v1/exports/mikrotik/v7.rsc; /import v7.rsc (v6.rsc on RouterOS 6).

Zeek: load zeek/intel.dat with the Intel framework (redef Intel::read_files += { "intel.dat" }).

pfSense / any firewall: plain/ipv4.txt and plain/ipv6.txt, one address per line, as a URL table alias.

EDR: hashes/by_family.csv or .json, hashes grouped by malware family for custom-IOC import.

120 requests a minute per IP. Cached 15 minutes. ETag: send If-None-Match for a 304.

pathpath, required
A path from the manifest, e.g. edl/paloalto-ip.txt or suricata/skopnix.rules.
curl -sS "https://skopnix.com/api/v1/exports/edl/paloalto-ip.txt"
Response · text/plain
45.128.12.14184.64.22.194 

An example, trimmed: real responses carry more rows and may carry more fields.

Errors: 404 · 429 · 503 (what they mean)

This reference

The same reference as an OpenAPI 3.1 document.

GET /api/v1/openapi.json

This reference as OpenAPI 3.1

Every endpoint on this page, with its parameters, rate limit, response schema, example response and the same curl, Python and JavaScript examples. Load it into any OpenAPI tool or code generator.

No per-IP limit: the response is cached. Cached 1 hour.

curl -sS "https://skopnix.com/api/v1/openapi.json"
Response · application/json
{  "openapi": "3.1.0",  "info": {    "title": "skopnix API",    "version": "1.0.0"  },  "paths": {}}

An example, trimmed: real responses carry more rows and may carry more fields.

Account endpoints

The sandbox answers to a signed-in customer account, not to an anonymous caller. Sign in at /sandbox, copy the value of the skx_user cookie from your browser into SKOPNIX_SESSION, and send it as a cookie. The session lasts a week; treat it like a password.

  1. POST /api/v1/sandbox/submitcustomer account · 20 per 5 min

    Submit a URL or a file hash for analysis.

    Send: JSON {"value": "<url or md5/sha1/sha256>"}; the value is recognised as a URL or a hash whatever "kind" says.

    Returns: {"ok": true, "id": "<job id>"}; poll the job for the report.

    curl
    curl -s -X POST https://skopnix.com/api/v1/sandbox/submit -H "Cookie: skx_user=$SKOPNIX_SESSION" \  -H "Content-Type: application/json" -d '{"value": "https://example.com/login"}'
  2. POST /api/v1/sandbox/submit-fileL1 account · 10 per 10 min

    Upload a file (32 MB max) for detonation in a hosted Windows machine.

    Send: multipart/form-data with the file in the field "file". The bytes pass through to the analysis machine and are not stored by skopnix; only the report is.

    Returns: {"ok": true, "id": "<job id>"}; 503 while file detonation is switched off.

    curl
    curl -s -X POST https://skopnix.com/api/v1/sandbox/submit-file -H "Cookie: skx_user=$SKOPNIX_SESSION" -F "[email protected]"
  3. POST /api/v1/sandbox/submit-emailL1 account · 15 per 10 min

    Analyse a suspicious email (15 MB max): headers, links and attachments.

    Send: JSON {"text": "<full email source>"} or multipart/form-data with a .eml file in "file".

    Returns: {"ok": true, "id": "<job id>"}; attachments get their own jobs when file detonation is on.

    curl
    curl -s -X POST https://skopnix.com/api/v1/sandbox/submit-email -H "Cookie: skx_user=$SKOPNIX_SESSION" -F "[email protected]"
  4. GET /api/v1/sandbox/job/{id}customer account · no extra limit

    Poll one job: its status while it runs, the full report when it is done.

    Send: The job id from a submit call. An account reads its own jobs only.

    Returns: The job with "status" (queued, running, done or error) and, when done, "report" with the verdict and findings.

    curl
    curl -s https://skopnix.com/api/v1/sandbox/job/$JOB_ID -H "Cookie: skx_user=$SKOPNIX_SESSION"

Errors

304
Not modified: your If-None-Match matched the current ETag.
400
The request is malformed. The error says what to fix.
404
No such record. A missing id is a 404, never an empty 200.
406
The Accept header asks for a format this endpoint does not serve.
413
The body is over the size limit.
415
The body is not application/json.
429
Over the rate limit, or over the daily allowance. Wait and retry.
503
Our store could not be read. This is an error, never an empty result: retry later.

JSON errors are {"error": "…"}; the TAXII endpoints answer with a TAXII 2.1 error object.

Outside /api/v1

  1. /feed.json

    JSON Feed 1.1 of the newest stories. Cached hourly.

    curl
    curl -sS "https://skopnix.com/feed.json"
  2. /rss.xml

    RSS 2.0. kev=1 for actively exploited only, region=1 for regional, cat= one category, lang=az for Azerbaijani, q=a,b for up to ten terms matched against titles, category and CVE ids: a feed for your own stack.

    curl
    curl -sS "https://skopnix.com/rss.xml?kev=1"
  3. /taxii2/

    TAXII 2.1 discovery: names the API root above. 60 requests a minute per IP, shared with the TAXII endpoints.

    curl
    curl -sS -H "Accept: application/taxii+json;version=2.1" "https://skopnix.com/taxii2/"
  4. /actors/{id}/stix.json

    A dossier as a STIX 2.1 bundle: intrusion-set, techniques, malware, tools and the uses relationships. Shares its ids with the cited bundle, so the two merge. 60/min.

    curl
    curl -sS "https://skopnix.com/actors/apt28/stix.json"
  5. /actors/{id}/navigator.json

    A dossier as an ATT&CK Navigator layer (format 4.5, Enterprise). Every technique scores the same: we hold no per-technique frequency, and a graded heatmap would be invented. 60/min.

    curl
    curl -sS "https://skopnix.com/actors/apt28/navigator.json"
  6. /llms.txt

    A map of the site for AI agents.

    curl
    curl -sS "https://skopnix.com/llms.txt"
  7. /claims/rss.xml

    RSS 2.0 of the newest attacks claimed against Azerbaijan: type, claimant, targets, date. A claim, never a confirmed incident; our checks are on /claims. Poll every 15 minutes or slower.

    curl
    curl -sS -A "my-reader/1.0" "https://skopnix.com/claims/rss.xml"
  8. /detections/rss.xml

    RSS 2.0 of the newest Sigma, QRadar and Cortex XDR rules, each linking its rule page at /detections/rule/{slug}. Poll every 15 minutes or slower.

    curl
    curl -sS -A "my-reader/1.0" "https://skopnix.com/detections/rss.xml"

Adversary pages are at /actors; the stack check you can paste into is at /stack.

Follow the wire

Every exploited CVE and adversary move as it lands: Telegram for the push, RSS for your reader, a keyless JSON API and per-actor STIX for your tooling. No key, no signup.

Telegram ↗KEV RSSAPIStack check