Skip to main content
GET
ML hardware catalog

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

type
enum<string>

Case-insensitive exact match on the accelerator class as recorded by Epoch; the enum lists every stored type. Some tokens are composite, e.g. DCU (GPGPU). An unknown value returns 400 INVALID_ENUM.

Available options:
GPU,
TPU,
XPU-R,
NPU,
GPGPU,
ASIC,
XPU,
LPU,
Hybrid CPU,
DCU (GPGPU),
Other
manufacturer
string

Case-insensitive substring match on manufacturer (e.g. Nvidia, AMD, Google, Huawei, Cambricon). Alias org is accepted.

foundry
string

Case-insensitive substring match on the fabricator. Observed values: TSMC, SMIC, Samsung, Intel (plus dual-fab SMIC,TSMC parts, which either SMIC or TSMC returns). Echoed in applied_filters. Not strictly validated — an unmatched value returns 0 rows rather than 400.

Example:

"SMIC"

date_start
string<date>

Filter to hardware with release_date on or after this date (YYYY-MM-DD). A malformed date is ignored rather than erroring.

Example:

"2023-01-01"

date_end
string<date>

Filter to hardware with release_date on or before this date (YYYY-MM-DD). Combine with date_start for a release-date window.

Example:

"2024-12-31"

limit
integer
default:25

Rows per page (1–200). Defaults to 25.

Required range: 1 <= x <= 200
cursor
string

Canonical page token — pass the pagination.next_cursor from the previous response here to fetch the next page (uniform across all list endpoints).

offset
integer

Row offset for pagination. Prefer the canonical cursor token; both are supported.

Required range: x >= 0

Response

A page of ML hardware. Envelope: { success, data, pagination, applied_filters }.

success
boolean
data
object[]
pagination
object
applied_filters
object