API Resources

GET
/v4/advisory

모든 피드에 걸쳐 VulnCheck v4 어드바이저리 인덱스를 조회합니다.

쿼리 파라미터

namestring

어드바이저리 피드 이름으로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?name=rockwell
cve_idstring

CVE ID로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?cve_id=CVE-2024-1234
vendorstring

벤더 이름으로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?vendor=rockwell
productstring

제품 이름으로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?product=windows
platformstring

OS 또는 플랫폼으로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?platform=linux
versionstring

제품 버전으로 필터링. 시맨틱 버저닝 기반 매칭을 지원.

예시 URL:

https://api.vulncheck.com/v4/advisory?version=1.2.3
cpestring

CPE 2.3 문자열로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?cpe=cpe:2.3:a:vendor:product:*
package_namestring

패키지 이름으로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?package_name=lodash
purlstring

패키지 URL (PURL)로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?purl=pkg:npm/lodash@4.17.20
reference_urlstring

참조 URL로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?reference_url=https://example.com/advisory
reference_tagstring

참조 태그로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?reference_tag=patch
description_langstring

설명 언어 코드로 필터링.

예시 URL:

https://api.vulncheck.com/v4/advisory?description_lang=en
updatedAfterstring (RFC3339)

이 날짜 이후에 업데이트된 어드바이저리를 반환. RFC3339 타임스탬프를 허용합니다.

예시 URL:

https://api.vulncheck.com/v4/advisory?updatedAfter=2026-01-01T00:00:00Z
updatedBeforestring (RFC3339)

이 날짜 이전에 업데이트된 어드바이저리를 반환. RFC3339 타임스탬프를 허용합니다.

예시 URL:

https://api.vulncheck.com/v4/advisory?updatedBefore=2024-01-01T00:00:00Z
pageinteger

페이지네이션 결과의 페이지 번호. 기본값은 1. cursor와 함께 사용 불가.

예시 URL:

https://api.vulncheck.com/v4/advisory?page=2
limitinteger

페이지당 결과 수. 최대 100. 기본값은 10.

예시 URL:

https://api.vulncheck.com/v4/advisory?limit=50
start_cursorstring

이 파라미터가 존재하면 첫 번째 페이지부터 커서 기반 페이지네이션이 활성화됩니다. 값은 무시됩니다. page와 함께 사용 불가.

예시 URL:

https://api.vulncheck.com/v4/advisory?start_cursor
cursorstring

이전 응답의 _meta.next_cursor에서 가져온 커서 값. 커서 모드에서 다음 페이지를 가져오는 데 사용.

예시 URL:

https://api.vulncheck.com/v4/advisory?cursor=<next_cursor_value>

::

요청 예시

curl --request GET \
  --url 'https://api.vulncheck.com/v4/advisory?cve_id=CVE-2024-1234' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer insert_token_here'

오류 처리

상태 코드의미
400잘못된 쿼리 파라미터 값
401인증 토큰이 누락되었거나 유효하지 않음
402요청한 데이터에 구독이 필요함
429속도 제한 초과
503어드바이저리 데이터 소스를 사용할 수 없음

응답

{
  "data": [
    {
      "dataType": "CVE_RECORD",
      "dataVersion": "5.0",
      "cveMetadata": {
        "cveId": "CVE-2024-1234",
        "assignerOrgId": "...",
        "state": "PUBLISHED"
      },
      "containers": {
        "cna": {
          "providerMetadata": {
            "orgId": "...",
            "shortName": "vulncheck"
          },
          "descriptions": [
            {
              "lang": "en",
              "value": "..."
            }
          ]
        }
      }
    }
  ],
  "_meta": {
    "total": 1,
    "page": 1,
    "pages": 1,
    "limit": 10,
    "filtered": 1
  }
}

V4 API 개요

/v4/advisory/list