v1

latestOpenAPI 3.0.0Proprietary2026-07-244990150.4 KB
Threat Briefs

List Articles

Returns a paginated list of published articles (Threat Briefs). Supports filtering by category, search term, and pagination parameters.

get/v3/articles

Query parameters

pageinteger

Page number for pagination (1-indexed).

sizeinteger

Number of articles per page.

searchstring

Case-insensitive search across title, subtitle, and description.

categorystring

Filter articles by category value.

sort_bystring

Field to sort results by.

sort_desc'true' | 'false'

Sort in descending order. Set to false for ascending.

Response

A paginated list of published articles.

Example response

{
  "metadata": {
    "total_results": 42,
    "current_page": 1,
    "count": 10
  },
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Understanding Internet Background Noise",
      "subtitle": "A deep dive into scan traffic",
      "category": {
        "label": "Threat Intelligence",
        "value": "threat-intelligence",
        "color": "#FF5733"
      },
      "author": "GreyNoise Research"
    }
  ]
}