DATA & SOURCES / API CATALOG

Find your data.
Choose your endpoint.

Start with a data family, then inspect the records and filters. Open a working tool in API Arena when you’re ready to try a request.

See example workflows ↗Explore data & country coverage ↗

10 endpoints matching “/epoch/” across all data families

AI & compute

Research models, hardware, data centers and the organizations building them.

Epoch AI

GETGPU clusters/api/v2/epoch/gpu-clusters

Epoch cluster observations with status, certainty, hardware and source evidence; clusters remain distinct from physical buildings.

Response: success, data · MCP tool: epoch_gpu_clusters

Parameters and accepted values (7)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine id, news id, Wikipedia URL or resolved name. Unresolved names return 404.
participant_role: Source-supported role of the selected entity in the record; distinguish owners, operators, financiers and users. A hardware ownership role does not establish ownership of a building.
collection: Source collection identifier returned by these observations or the coverage catalog; narrows to that dataset collection.
country: Exact ISO-3 country when the source reports one.
q: Substring of the observation name.

GETAI chip owners/api/v2/epoch/chip-owners

Quarterly and cumulative chip ownership estimates with original median and uncertainty fields, resolved participants and native units.

Response: success, data · MCP tool: epoch_chip_owners

Parameters and accepted values (7)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine id, news id, Wikipedia URL or resolved name. Unresolved names return 404.
participant_role: Source-supported role of the selected entity in the record; distinguish owners, operators, financiers and users. A hardware ownership role does not establish ownership of a building.
collection: Source collection identifier returned by these observations or the coverage catalog; narrows to that dataset collection.
country: Exact ISO-3 country when the source reports one.
q: Substring of the observation name.

GETAI chip users/api/v2/epoch/chip-users

Lab compute-use estimates and intermediate calculations, preserving units, periods and uncertainty.

Response: success, data · MCP tool: epoch_chip_users

Parameters and accepted values (7)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine id, news id, Wikipedia URL or resolved name. Unresolved names return 404.
participant_role: Source-supported role of the selected entity in the record; distinguish owners, operators, financiers and users. A hardware ownership role does not establish ownership of a building.
collection: Source collection identifier returned by these observations or the coverage catalog; narrows to that dataset collection.
country: Exact ISO-3 country when the source reports one.
q: Substring of the observation name.

GETAI chip components/api/v2/epoch/chip-components

Logic, packaging and memory component estimates; chip and designer totals and supply denominators remain distinct collections.

Response: success, data · MCP tool: epoch_chip_components

Parameters and accepted values (7)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine id, news id, Wikipedia URL or resolved name. Unresolved names return 404.
participant_role: Source-supported role of the selected entity in the record; distinguish owners, operators, financiers and users. A hardware ownership role does not establish ownership of a building.
collection: Source collection identifier returned by these observations or the coverage catalog; narrows to that dataset collection.
country: Exact ISO-3 country when the source reports one.
q: Substring of the observation name.

GETEpoch observations/api/v2/epoch/observations

Typed Epoch source collections, including dated finance, cooling, quantity and timeline observations. Native fields retain units, qualifiers and uncertainty.

Response: success, data · MCP tool: epoch_observations

Parameters and accepted values (7)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine id, news id, Wikipedia URL or resolved name. Unresolved names return 404.
participant_role: Source-supported role of the selected entity in the record; distinguish owners, operators, financiers and users. A hardware ownership role does not establish ownership of a building.
collection: Source collection identifier returned by these observations or the coverage catalog; narrows to that dataset collection.
country: Exact ISO-3 country when the source reports one.
q: Substring of the observation name.

GETAI models/api/v2/epoch/models

Epoch model observations with terminal entity IDs, separately resolved participants, source roles and publication coverage.

Response: success, data, pagination, applied_filters · MCP tool: epoch_models

Parameters and accepted values (13)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine ID, news ID, Wikipedia URL or resolved name; all terminal aliases are included.
participant_role: Exact source role. Hardware ownership does not establish building ownership.
organization: Developer substring.
domain: One domain or a comma-separated intersection of task domains.
Accepted values: 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: Exact accessibility tier, case-insensitive.
Accepted values: Open weights (unrestricted), Open weights (restricted use), Open weights (non-commercial), API access, Hosted access (no API), Limited access, Unreleased
organization_categorization: Substring of the publisher classification of the developing organization; narrows models by that source category.
frontier: true/false selects frontier/non-frontier models.
min_compute: Positive floor on source training FLOP.
sort: publication_date or compute.
date_start: Inclusive source-date lower bound, YYYY-MM-DD.
date_end: Inclusive source-date upper bound, YYYY-MM-DD.

GETAI hardware/api/v2/epoch/hardware

Epoch accelerator observations, manufacturer/foundry participants and release coverage.

Response: success, data, pagination, applied_filters · MCP tool: epoch_hardware

Parameters and accepted values (9)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine ID, news ID, Wikipedia URL or resolved name; all terminal aliases are included.
participant_role: Exact source role. Hardware ownership does not establish building ownership.
manufacturer: Manufacturer substring.
type: Exact accelerator type, case-insensitive.
Accepted values: gpu, tpu, xpu-r, npu, gpgpu, other, xpu, asic, lpu, hybrid cpu, dcu (gpgpu)
foundry: Fabricator substring.
date_start: Inclusive source-date lower bound, YYYY-MM-DD.
date_end: Inclusive source-date upper bound, YYYY-MM-DD.

GETAI data centers/api/v2/epoch/data-centers

Epoch compute and finance observations linked to physical Facilities. Curated inventory totals are not a worldwide census; participant roles and ownership certainty remain explicit.

Response: success, data, by_country, totals, pagination, applied_filters · MCP tool: epoch_data_centers

Parameters and accepted values (8)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine ID, news ID, Wikipedia URL or resolved name; all terminal aliases are included.
participant_role: Exact source role. Hardware ownership does not establish building ownership.
country: Country name, ISO-2 or ISO-3.
region: Shared geographic region.
Accepted values: Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, Northern America, Central America, Caribbean
continent: Shared continent.
Accepted values: Africa, Asia, Europe, North America, South America, Oceania
owner: Owner substring; entity selects resolved participants.

GETAI companies/api/v2/epoch/companies

Tracked labs with dated financial observations and terminal entity links. Latest valuation uses closed rounds.

Response: success, data, pagination, applied_filters · MCP tool: epoch_companies

Parameters and accepted values (4)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine ID, news ID, Wikipedia URL or resolved name; all terminal aliases are included.
participant_role: Exact source role. Hardware ownership does not establish building ownership.

GETAI chip sales/api/v2/epoch/chip-sales

Latest cumulative observations per chip designer; totals are not summed across alternate windows.

Response: success, data, pagination, applied_filters · MCP tool: epoch_chip_sales

Parameters and accepted values (5)

limit: Number of records to return on this page; use the returned continuation to request the next page.
cursor: Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page.
entity: Participant entity: spine ID, news ID, Wikipedia URL or resolved name; all terminal aliases are included.
participant_role: Exact source role. Hardware ownership does not establish building ownership.
chip_manufacturer: Exact chip designer, case-insensitive.

UNDERSTAND THE SOURCE

Where the data comes from.

SEC EDGAR ↗

Retrieve SEC filer identity, filing records and evidence-backed company relationships through GDELT Cloud. Connect US registrants to reporting with resolved entity identifiers.

Read the source guide FRED ↗

Use FRED and ALFRED economic series through GDELT Cloud’s macro API. Inspect metadata, dated observations, source attribution and redistribution limits.

Read the source guide Global Energy Monitor ↗

Explore Global Energy Monitor facilities through a structured API. Filter by country or proximity, inspect capacity and registry dates, and connect reporting to infrastructure carefully.

Read the source guide Sanctions & public records ↗

Inspect original-publisher sanctions and public-record sources through GDELT Cloud. Understand list coverage, entity connections and how MIT-licensed OpenSanctions crawler code is used.

Read the source guide