Log in / Sign up

API documentation

Quick start

  1. Log in and go to the API tokens page to create a token.
  2. Send the token in the Authorization header.
  3. Responses are JSON. Free plan limits: 30/min and 1,000 requests per day; beyond that you get 429 responses.
curl -H "Authorization: Token kol_..." \
  "https://kolunsec.com/api/v1/cves/?product=exchange%20server&min_cvss=9&kev=true"

Endpoints

https://kolunsec.com/api/v1/
GET /api/v1/cves/

فهرست CVEها، جدیدترین اول.

q · product · vendor · severity · min_cvss · min_epss · kev · published_after · published_before · sort=latest|cvss|epss · limit · offset

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

جزئیات کامل یک CVE: همه‌ی امتیازهای CVSS، محصولات و نسخه‌ها، KEV، تاریخچه‌ی EPSS، منابع و اخبار مرتبط.

GET /api/v1/kev/

ورودی‌های فهرست KEV آژانس CISA، جدیدترین اول.

limit · offset

GET /api/v1/news/

اخبار امنیتی همراه با CVEهای پیوندشده.

source · cve · limit · offset

GET /api/v1/products/

جستجوی محصول؛ همه‌ی نسخه‌های یک محصول در یک خانواده با تعداد CVE و KEV.

q (حداقل ۲ نویسه)

GET /api/v1/subscriptions/

محصولاتی که برای هشدار تلگرامی دنبال می‌کنید.

POST /api/v1/subscriptions/

دنبال کردن یک محصول. بدنه‌ی JSON: product (شناسه از products/)، و اختیاری min_severity و include_news.

DELETE /api/v1/subscriptions/{id}/

لغو دنبال کردن.

Pagination

Lists are paginated with limit (max 100) and offset. For speed no total count is returned; while next is not empty there is another page.

{
  "next": "https://kolunsec.com/api/v1/cves/?limit=25&offset=25",
  "previous": null,
  "results": [
    {
      "id": "CVE-2021-26855",
      "title": "Microsoft Exchange Server Remote Code Execution Vulnerability",
      "cvss_score": "9.8", "cvss_severity": "CRITICAL", "cvss_version": "3.1",
      "epss": 0.9431, "epss_percentile": 0.9995, "in_kev": true,
      "products": ["Microsoft Exchange Server"],
      "url": "https://.../cve/CVE-2021-26855/"
    }
  ]
}

Errors

401 Invalid or revoked token · 400 Invalid parameter · 404 Not found · 429 Rate limit exceeded (Retry-After header)

Allowed news sources for source: bleepingcomputer, darkreading, grahamcluley, helpnetsecurity, infosecurity, krebs, malwarebytes, schneier, securityaffairs, securityweek, thehackernews, theregister, welivesecurity