Download GNQL Query File

Requires an Advanced or Elite platform license.

Download every IP matching a GNQL query as one pre-built file, to keep
a SIEM lookup current without paging GNQL Query.

The first request for a query subscribes to it: the response is 202
while the first file builds, and later requests serve the latest
build. Each subscription counts toward the workspace's GNQL feed
subscription limit. A subscription not fetched for 7 days stops
rebuilding; the next fetch serves its last file with
X-GreyNoise-Feed-Status: dormant while a new one builds. A
subscription dormant for 30 days is deleted, and fetching the query
again starts a new subscription. Delete GNQL Query File Subscription
removes one at once.

IPs are ordered newest last_seen first. The file is cut after the
last whole row that fits limit and the profile's uncompressed size
cap (200 MB unless the profile sets another); X-GreyNoise-Truncated
says whether it was. Columns for fields the
workspace's plan does not include are left empty.

The file is gzip-encoded (Content-Encoding: gzip) for clients that
accept it.

Query Params
string
required
length ≤ 4096

GNQL query selecting the IPs in the file, at most 4096 characters.
Each distinct query (compared with whitespace collapsed) is its own
subscription.

string
enum
Defaults to csv

File format. Only csv is supported.

Allowed:
string
Defaults to ngsiem

Feed profile laying out the file's columns, as id or
id@version; List Feed Profiles lists the active ones. ngsiem
is the CrowdStrike Falcon NG-SIEM lookup file, with
source.ip.greynoise.is.* and source.ip.greynoise.bs.* columns.

A new subscription naming a bare id is pinned to its latest active
version, and later requests with the bare id keep that pin.
Naming id@version moves the pin to that version, which must be
active. A deprecated version is still served to the subscriptions
pinned to it.

integer
1 to 2147483647

Maximum number of IPs to serve, newest last_seen first. Without
it, every IP the query matches is served, up to the profile's size
cap.

Headers
string

Name and version of the integration making the request, for example crowdstrike-ngsiem/2.0.0.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/csv
application/json