AI models

AI models

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

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

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

{
  "success": true,
  "data": [
    {
      "model": "GPT-4",
      "domain": "Language",
      "organization": "OpenAI",
      "publication_date": "2023-03-14",
      "parameters": null,
      "training_compute_flop": 2.1e+25,
      "training_hardware": "NVIDIA A100 SXM4 80 GB",
      "frontier_model": true,
      "open_weights": false,
      "model_accessibility": "API access",
      "entity_id": "e_58a5cada3c775725",
      "entity_page_name": "OpenAI"
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "next_cursor": null,
    "next_offset": null
  },
  "applied_filters": {
    "frontier": true,
    "sort": "compute",
    "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

models

AI models

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

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

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

{
  "success": true,
  "data": [
    {
      "model": "GPT-4",
      "domain": "Language",
      "organization": "OpenAI",
      "publication_date": "2023-03-14",
      "parameters": null,
      "training_compute_flop": 2.1e+25,
      "training_hardware": "NVIDIA A100 SXM4 80 GB",
      "frontier_model": true,
      "open_weights": false,
      "model_accessibility": "API access",
      "entity_id": "e_58a5cada3c775725",
      "entity_page_name": "OpenAI"
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "next_cursor": null,
    "next_offset": null
  },
  "applied_filters": {
    "frontier": true,
    "sort": "compute",
    "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.

organization

string

Developer 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.

domain

enum<string>[]

One domain or a comma-separated intersection of task domains. 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_model_domain

Available options:

Language,

Vision,

Biology,

Multimodal,

Image generation,

Video,

Speech,

Robotics,

Games,

Audio,

Medicine,

Mathematics,

Materials science,

Earth science,

Recommendation,

Driving,

Search,

3D modeling,

Other,

Psychology,

Astronomy,

Cybersecurity

model_accessibility

enum<string>

Exact accessibility tier, 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_model_accessibility

Available options:

Open weights (unrestricted),

Open weights (restricted use),

Open weights (non-commercial),

API access,

Hosted access (no API),

Limited access,

Unreleased

organization_categorization

string

Source organization-category 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.

frontier

boolean

true/false selects frontier/non-frontier models. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

min_compute

number

Positive floor on source training FLOP. 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: x >= 0

sort

string

publication_date or compute. 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 AI models. 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

Authorizations

Query Parameters

Response