Skip to main content
GET
Report List

Query Parameters

apikey
string
required

Your API key. For details on how to obtain and manage your API key, please refer to the Authentication page.

Kindly note:

Please check if you have bound your access IP to the key and have the authority quotas to access this API before you interact with it.

query
string

Keyword search parameter that matches across multiple indexed fields, including report title, summary, tags, IOCs, CVE identifiers and names, target products, target organizations, and other relevant attributes.

threat_type
string

Specifies one or more threat event types to filter reports. Accepts comma-separated values. Supported types include:

  • APT
  • Ransomware
  • Supply Chain Attack
  • Phishing
  • Data Leakage
  • Data Breach
  • Crypto Mining
  • DDoS
  • Others — any threat type not covered by the categories above.
severity
string

Specifies one or more severity levels to filter reports. Accepts comma-separated values. Supported levels include:

  • critical
  • high
  • low

If not provided, reports of all severity levels will be returned.

threat_actor
string

Specifies one or more threat actors (hacker groups) to filter reports. Accepts comma-separated values.

Example values include names of known threat groups such as Lazarus, APT41, etc.

target_region
string

Specifies one or more target countries to filter reports. Accepts comma-separated values.

target_industry
string

Specifies one or more target industries to filter reports. Accepts comma-separated values. Industry names follow the STIX II industry taxonomy (e.g., financial-services, government, technology, etc.).

target_org
string

Specifies one or more targeted organizations referenced in the reports. Accepts comma-separated values.

target_product
string

Specifies one or more targeted products referenced in the reports. Accepts comma-separated values.

Examples include product names such as OpenSSH, Exchange Server

category
string

Specifies one or more report content categories to filter results. Accepts comma-separated values. Supported categories include:

  • Incident Analysis
  • Malware Analysis
  • Vulnerability Analysis
  • Summary Report
  • Security News
  • Incident Response

Multiple values are supported.

has_iocs
boolean

Indicates whether to return only reports that contain IOC information.

  • true, only reports with IOC data will be returned.
  • false or omitted, all reports will be included by default.
has_cves
boolean

Indicates whether to return only reports that contain CVE information.

  • true, only reports with CVE data will be returned.
  • false or omitted, all reports will be included by default.
has_rules
boolean

Indicates whether to return only reports that contain detection rules.

  • true, only reports with detection rule data will be returned.
  • false or omitted, all reports will be included by default.
published_from
string

Specifies the start of the report publication time range (inclusive). Supports ISO8601 datetime format, e.g., 2024-09-01T00:00:00Z.

published_to
string

Specifies the end of the report publication time range (inclusive). Supports ISO8601 datetime format, e.g., 2024-10-01T00:00:00Z.

from_tb_lab
boolean

Indicates whether to return only ThreatBook Lab exclusive reports.

  • true, only ThreatBook Lab–originated reports will be returned.
  • false or omitted, all reports (including open-source intelligence) will be included by default.
limit
integer

Specifies the number of records to return per page. The default value is 20, and the maximum allowed value is 100.

cursor
string

Specifies the pagination cursor used to retrieve the next page of results.
If omitted, the first page of results will be returned.

Response

data
object
required
response_code
integer
required
msg
string
required

Allowed value: "Success"