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. Full value list: https://docs.gdeltcloud.com/reference/enums#epoch_hardware_type

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. Observed vocabulary, measured 2026-08-10 (5 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/epoch/hardware?limit=1 — readfoundry``. The fab that manufactured the accelerator, as Epoch publishes it. Matched as a case-insensitive SUBSTRING with no validation, so a typo returns an empty 200 rather than a 400. Note some rows carry a comma-joined pair (SMIC,TSMC). Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#epoch_foundry

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