AI hardware

curl --request GET \
  --url https://gdeltcloud.com/api/v2/epoch/hardware \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/epoch/hardware', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": [
    {
      "hardware_name": "NVIDIA H100 SXM5",
      "manufacturer": "NVIDIA",
      "type": "GPU",
      "release_date": "2022-03-22",
      "release_price_usd": null,
      "tensor_fp16_flops": 989000000000000,
      "fp8_flops": 1979000000000000,
      "memory_bytes": 85899345920,
      "tdp_w": 700,
      "process_size_nm": 4,
      "entity_id": "e_9f8e7d6c5b4a3210",
      "entity_page_name": "Nvidia"
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "next_cursor": null,
    "next_offset": null
  },
  "applied_filters": {
    "manufacturer": "Nvidia",
    "ignored": {}
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

GET

api

epoch

hardware

AI hardware

curl --request GET \
  --url https://gdeltcloud.com/api/v2/epoch/hardware \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/epoch/hardware', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": [
    {
      "hardware_name": "NVIDIA H100 SXM5",
      "manufacturer": "NVIDIA",
      "type": "GPU",
      "release_date": "2022-03-22",
      "release_price_usd": null,
      "tensor_fp16_flops": 989000000000000,
      "fp8_flops": 1979000000000000,
      "memory_bytes": 85899345920,
      "tdp_w": 700,
      "process_size_nm": 4,
      "entity_id": "e_9f8e7d6c5b4a3210",
      "entity_page_name": "Nvidia"
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "next_cursor": null,
    "next_offset": null
  },
  "applied_filters": {
    "manufacturer": "Nvidia",
    "ignored": {}
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

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

Query Parameters

limit

integer

default:25

Rows per page. Default 25, max 200. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Required range: 1 <= x <= 200

cursor

string

Opaque pagination cursor taken from the previous response's pagination.next_cursor. Also accepts: offset. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

entity

string

Participant entity: spine ID, news ID, Wikipedia URL or resolved name; all terminal aliases are included. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#entity_handle

participant_role

string

Exact source role. Hardware ownership does not establish building ownership. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

manufacturer

string

Manufacturer substring. Also accepts: org. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

type

enum<string>

Exact accelerator type, case-insensitive. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#epoch_hardware_type

Available options:

gpu,

tpu,

xpu-r,

npu,

gpgpu,

other,

xpu,

asic,

lpu,

hybrid cpu,

dcu (gpgpu)

foundry

string

Fabricator substring. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

date_start

string<date>

Inclusive source-date lower bound, YYYY-MM-DD. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

date_end

string<date>

Inclusive source-date upper bound, YYYY-MM-DD. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Response

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

success

boolean

data

object[]

Show child attributes

pagination

object

Show child attributes

applied_filters

object

Show child attributes

Events

Stories

Situations

Entities

Unified Search

Media Intelligence

Facilities

Monitors

Geography

Government

Political Offices

Filings

Reference Data

Energy

AI Compute

Macro Finance

Screening and Reference

China

Maritime

Atlas Intelligence

Natural Resources

Meta

AI hardware

Authorizations

Query Parameters

Response