Psychic Snapshot Download

post

https://api.greynoise.io/v1/psychic/snapshots

Downloads a precomputed Psychic snapshot artifact. Snapshots are fixed,
already-materialized files for common rolling windows and latest model 4.
This endpoint does not generate missing ranges or convert missing MMDBs.

Models 1, 2, and 3 require days and currently support only 7 or
30. Model 4 downloads the latest model 4 snapshot and rejects days.
date, start_date, and end_date are not supported on this endpoint.

A successful response streams the snapshot file. Transfer time still
depends on file size and client connection speed. A 404 response means
the requested snapshot artifact is not available.

License: This endpoint requires the Psychic model meter entitlement
for the requested model. Models 1, 2, and 3 also require that model's
Psychic lookback-days entitlement to cover the resolved snapshot start
date.

Body Params

Psychic snapshot selector and optional file format.

Snapshot downloads use precomputed artifacts only. Models 1, 2, and 3
require days with a value of 7 or 30. Model 4 accepts model
and optional format only; sending days, date, start_date, or
end_date returns 400.

model

string

enum

required

Psychic model selector. Accepted selectors identify models 1, 2, 3, and 4.

days

integer

enum

Required for models 1, 2, and 3. Must be omitted for model 4.

Allowed:

format

string

enum

Defaults to bin

Download file format. Defaults to bin.

Allowed:

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/octet-stream

application/vnd.maxmind.maxmind-db

application/json

200OK - binary Psychic snapshot file.

400Bad request - request syntax is invalid for the Psychic download endpoint.

401Unauthorized. Please check your API key.

403Forbidden - request is not authorized due to API-key access, Psychic entitlement, or Psychic lookback limitations.

404Psychic model file not found.

413Request body too large. BI request-body inspection is limited to 32 KiB.

429Too many requests - either too many concurrent Psychic range downloads are being generated, or the requested Psychic model meter has no remaining usage. Retry later for concurrent-generation limits, or contact [email protected] to adjust model usage entitlements.

500Unexpected Psychic download error.