{ "agent_answer": { "answer": "BLS QCEW reports Computing infrastructure providers, data processing, web hosting, and related services employment of 485040.0 (third month of the quarter) across 56613 establishments for 2025-10-01 as of 2025-10-01.", "citation": { "as_of": "2025-10-01", "raw_file_sha256": "1d8a48a8c8cefcb9cb90c2fef41f4fb5e2aad0c4442a9e6f8673abbe2247cda8", "sheet": "qcew", "source_file": "qcew_employment_sample.csv", "source_id": "employment.bls.qcew", "source_row": 179, "source_url": "https://www.bls.gov/cew/" }, "question": "Which national data-center-industry employment value can be verified from the raw BLS QCEW row?", "verification": { "hash_verified": true, "raw_file_sha256": "1d8a48a8c8cefcb9cb90c2fef41f4fb5e2aad0c4442a9e6f8673abbe2247cda8", "sheet": "qcew", "source_file": "qcew_employment_sample.csv", "source_row": 179 } }, "goal": "Use the agent-facing tool contract to discover, query, and verify ai_infrastructure.employment.", "steps": [ { "params": {}, "result": { "combinable_on": { "balancing_authority_code": [ "power.asset_ownership", "power.capacity", "power.demand", "power.fuel_cost", "power.generation" ], "county_fips": [ "ai_infrastructure.employment", "power.capacity", "power.interconnection_queue", "power.interconnection_queue_caiso", "power.interconnection_queue_ercot", "power.interconnection_queue_isone", "power.interconnection_queue_nyiso", "power.interconnection_queue_pjm", "power.interconnection_queue_pjm_cycle", "power.interconnection_queue_spp" ], "eia_plant_id": [ "power.asset_ownership", "power.capacity", "power.fuel_cost", "power.generation" ], "generator_id": [ "power.asset_ownership", "power.capacity", "power.generation" ], "state": [ "ai_infrastructure.employment", "natural_gas.prices", "power.asset_ownership", "power.capacity", "power.fuel_cost", "power.generation", "power.interconnection_queue", "power.interconnection_queue_caiso", "power.interconnection_queue_ercot", "power.interconnection_queue_isone", "power.interconnection_queue_nyiso", "power.interconnection_queue_pjm", "power.interconnection_queue_pjm_cycle", "power.interconnection_queue_spp", "power.price_ercot", "power.retail_sales", "robotics.adoption", "space.satellite_filings" ] }, "compounds": [ { "definition": "capacity_factor = sum(net_generation_mwh) / (sum(operating nameplate_mw) \u00d7 hours_in_month), over plant\u00d7fuel present in BOTH EIA-923 (generation) and EIA-860M operating capacity (snapshot matched to the month). Storage excluded; basis = nameplate.", "id": "power.capacity_factor", "kind": "compound", "metric": "capacity_factor", "primitive": "query_capacity_factor_v1", "sources": [ "energy.eia.eia860m", "energy.eia.eia923" ], "title": "Power Capacity Factor" } ], "domains": [ { "capabilities": [ { "anchors": [ "county_fips", "state", "lat", "lon", "eia_plant_id", "generator_id", "balancing_authority_code" ], "answers": [ "operating generator capacity by location, fuel, technology, and source-reported balancing authority code", "planned generator capacity by location, fuel, technology, source-reported balancing authority code, and planned online year", "retired generator capacity by location, fuel, technology, source-reported balancing authority code, and retirement year" ], "current_sources": [ "energy.eia.eia860m" ], "id": "power.capacity", "primitive": "query_power_capacity_v1", "product_spec": "blocks/power_capacity/card.md", "represented_facts": [ "EIA-860M reports operating generator capacity by location, fuel, technology, status, and source-reported balancing authority code", "EIA-860M reports planned generator capacity by location, fuel, technology, status, source-reported balancing authority code, and planned online year", "EIA-860M reports retired generator capacity by location, fuel, technology, status, source-reported balancing authority code, and retirement year" ], "status": "available", "title": "Power Capacity" }, { "anchors": [ "eia_plant_id", "state", "balancing_authority_code", "generator_id" ], "answers": [ "monthly net generation (MWh) by plant, prime mover, and fuel", "monthly net generation (MWh) by individual generator, joinable to EIA-860M", "generation mix by state, balancing-authority code, and fuel over time", "total and electric-only fuel consumption (MMBtu), aligned to Page 1 net generation across the served 2014-to-present history" ], "current_sources": [ "energy.eia.eia923" ], "id": "power.generation", "primitive": "query_power_generation_v1", "product_spec": "blocks/power_generation/card.md", "represented_facts": [ "EIA-923 reports monthly net electricity generation (MWh) by plant, prime mover, and fuel (Page 1)", "The same Page 1 source row reports total fuel consumed and fuel consumed for electricity separately in MMBtu", "EIA-923 reports monthly net electricity generation (MWh) by individual generator (Page 4), joinable to EIA-860M" ], "status": "available", "title": "Power Generation" }, { "anchors": [ "state", "eia_plant_id", "generator_id", "balancing_authority_code" ], "answers": [ "raw annual EIA-860 owner names and fractional ownership shares by plant and generator", "ownership rows for a raw owner-name string, with no name normalization or entity matching", "same-vintage state and source-reported balancing-authority slices, including ERCO", "the explicit EIA default that absence from the Owner schedule means wholly owned by the operator" ], "current_sources": [ "energy.eia.eia860_owner" ], "id": "power.asset_ownership", "primitive": "query_power_asset_ownership_v1", "product_spec": "blocks/power_asset_ownership/card.md", "represented_facts": [ "Annual EIA-860 reports the raw ownership shares and owner identities for generators that are jointly owned or wholly owned by an entity other than the operator. A generator absent from the Owner schedule is wholly owned by its operator, as EIA explicitly documents; the block carries same-vintage generator/operator context so consumers can apply that default without treating absence as unknown ownership.", "Owner-schedule absence means wholly owned by the same-vintage generator operator." ], "status": "available", "title": "Power Asset Ownership" }, { "anchors": [ "state", "eia_plant_id", "balancing_authority_code" ], "answers": [ "raw receipt-level delivered fuel costs in cents per MMBtu and physical quantities", "receipt rows by plant, month, fuel, state, supplier, purchase type, or source-reported balancing authority", "explicit counts and records for reported versus withheld fuel costs" ], "current_sources": [ "energy.eia.eia923_receipts_cost" ], "id": "power.fuel_cost", "primitive": "query_power_fuel_cost_v1", "product_spec": "blocks/power_fuel_cost/card.md", "represented_facts": [ "EIA-923 Page 5 reports individual fossil-fuel receipts by plant and month, including raw physical quantity and delivered fuel cost in cents per MMBtu. Confidential or otherwise unpublished costs remain explicit missing values; they are never zero-filled, imputed, or converted into heat rates or $/MWh.", "Withheld EIA fuel-cost cells are explicit nulls with the raw marker preserved." ], "status": "available", "title": "Power Fuel Receipts and Costs" }, { "anchors": [], "answers": [ "as-filed large-steam plant capacity, net generation, plant balances, fuel expense, and separate O&M line items", "raw respondent and plant-name searches without normalization or EIA matching", "which Form 1 respondents and raw plant names have served data for a report year", "a one-call ERCOT-relevance slice based only on the respondent's raw states-served disclosure" ], "current_sources": [ "energy.ferc.form1_plant_costs" ], "id": "power.plant_costs", "primitive": "query_power_plant_costs_v1", "product_spec": "blocks/power_plant_costs/card.md", "represented_facts": [ "Accepted native-XBRL FERC Form 1 filings report as-filed large steam-electric plant statistics by respondent, year, and raw plant name: installed capacity, net generation, plant-cost balance facts, and separate production-expense line items. Dollar values are nominal and are never inflation-adjusted, allocated, or summed into a derived O&M total." ], "status": "available", "title": "FERC Form 1 Plant Costs" }, { "anchors": [ "state" ], "answers": [ "daily Henry Hub spot prices in EIA's published dollars-per-MMBtu unit", "monthly state-average prices paid by electric-power consumers in EIA's published dollars-per-Mcf unit", "exact source-null state-month records, never zero-filled", "Texas monthly electric-power prices in one state-filtered call", "per-series coverage windows and separately queryable revision vintages" ], "current_sources": [ "energy.eia.natural_gas_prices" ], "id": "natural_gas.prices", "primitive": "query_natural_gas_prices_v1", "product_spec": "blocks/natural_gas_prices/card.md", "represented_facts": [ "EIA publishes the daily Henry Hub natural-gas spot price in dollars per MMBtu and monthly state-average natural-gas prices paid by electric-power consumers in dollars per Mcf. The state series is an aggregate of what the state's power sector paid in that month, not a plant-level price. Source-null state-month values remain explicit nulls and revisions remain separate capture vintages.", "Source-null state-month prices remain explicit nulls, and mixed source units are never blended." ], "status": "available", "title": "Natural Gas Prices" }, { "anchors": [ "balancing_authority_code" ], "answers": [ "hourly observed electricity demand (MW) for a balancing authority (Adjusted series, cited to the source row)", "the day-ahead demand forecast for the same BA-hours \u2014 forecast-vs-actual misses", "which hours EIA imputed rather than metered (is_imputed)", "BA-level demand shape over time (daily/seasonal profiles, growth at BA grain)" ], "current_sources": [ "energy.eia.eia930" ], "id": "power.demand", "primitive": "query_power_demand_v1", "product_spec": "blocks/power_demand/card.md", "represented_facts": [ "EIA-930 reports hourly observed electricity demand (MW) by balancing authority \u2014 EIA's Adjusted series, with the raw value and imputation flag preserved", "EIA-930 reports the day-ahead demand forecast (MW) on the same balancing-authority-hour rows" ], "status": "available", "title": "Power Demand" }, { "anchors": [], "answers": [ "hourly observed electricity demand (MW) for the US48 national total (cited to the source record)", "hourly observed demand for any of the 13 EIA regions (CAL, CAR, CENT, FLA, MIDA, MIDW, NE, NW, NY, SE, SW, TEN, TEX)", "the day-ahead demand forecast for the same respondent-hours \u2014 forecast-vs-actual misses", "national / regional demand shape over time (daily/seasonal profiles, growth) from EIA's own published totals" ], "current_sources": [ "energy.eia.eia930_rollup" ], "id": "power.demand_rollup", "primitive": "query_power_demand_rollup_v1", "product_spec": "blocks/power_demand_rollup/card.md", "represented_facts": [ "EIA-930 reports hourly observed electricity demand (MW) as EIA's own published rollup totals \u2014 US48 (the Lower-48 national total) and the 13 EIA regions (the Adjusted series, served verbatim, not a sum)", "EIA-930 reports the day-ahead demand forecast (MW) on the same respondent-hour rows" ], "status": "available", "title": "Power Demand (national / region rollup)" }, { "anchors": [ "state", "eia_utility_id" ], "answers": [ "annual retail electricity sales (billed MWh) by utility, state, and customer sector", "annual retail revenue (thousand dollars) and customer counts at the same grain", "industrial / commercial demand-growth signals by state and utility (year over year, as vintages accumulate)", "service-type structure (bundled vs energy-only vs delivery-only) per utility and state" ], "current_sources": [ "energy.eia.eia861" ], "id": "power.retail_sales", "primitive": "query_power_retail_sales_v1", "product_spec": "blocks/power_retail_sales/card.md", "represented_facts": [ "EIA-861 reports annual retail electricity sold to ultimate customers \u2014 billed sales (MWh), revenue, and customer counts \u2014 by utility, state, and customer sector", "EIA-861 reports the filing part and service type (bundled / energy-only / delivery-only) behind each utility\u00d7state row" ], "status": "available", "title": "Power Retail Sales" }, { "anchors": [ "state", "county_fips" ], "answers": [ "which generation projects have requested to connect to the MISO grid, by state/county, fuel, technology, and status", "the requested (net summer / net winter) megawatts of each queued project, cited to its source row", "the as-reported application status, study phase, and post-GIA status of each project (kept separate, never collapsed)", "the count of queued projects in a scope (active vs withdrawn vs done \u2014 by filtering application_status)" ], "current_sources": [ "energy.miso.giqueue" ], "id": "power.interconnection_queue", "primitive": "query_power_interconnection_queue_v1", "product_spec": "blocks/power_interconnection_queue/card.md", "represented_facts": [ "MISO's generator interconnection queue reports each project's REQUESTED interconnection capacity (net summer / net winter MW) \u2014 a request, not built capacity", "MISO's queue reports each project's location (state, county), fuel and technology, three as-reported status dimensions (application status, study phase, post-GIA status), and lifecycle dates (queue, withdrawn, in-service, done)", "MISO also reports two sparse lifecycle dates served under MISO's own field labels \u2014 gia_to_exec_date and neg_in_service_date; MISO publishes no data dictionary, so these are served as-reported and not reinterpreted (present where MISO reports them, null otherwise)" ], "status": "available", "title": "Power Interconnection Queue (MISO)" }, { "anchors": [ "state", "county_fips" ], "answers": [ "which projects have requested to connect to the PJM grid, by state/county, fuel, project type, and status", "the requested (max-facility-output / net summer / net winter) megawatts of each queued project, cited to its source row", "the as-reported status of each PJM project (Active / Withdrawn / In Service / Under Construction / \u2026), kept verbatim", "the realized in-service (built) megawatts of completed PJM projects (in_service_mw), separate from requested MW", "the count of queued projects in a scope (active vs withdrawn vs in service \u2014 by filtering status)" ], "current_sources": [ "energy.pjm.queue" ], "id": "power.interconnection_queue_pjm", "primitive": "query_power_interconnection_queue_pjm_v1", "product_spec": "blocks/power_interconnection_queue_pjm/card.md", "represented_facts": [ "PJM's New Services (interconnection) queue reports each project's REQUESTED interconnection capacity (MFO / net summer / net winter MW) \u2014 a request, not built capacity", "PJM's queue reports each project's location (state, POI county), fuel and project type, the single as-reported status, the study-document URLs and per-stage statuses, and lifecycle dates", "PJM also reports in_service_mw \u2014 the realized BUILT MW for in-service projects \u2014 carried under its own name, never as a requested figure" ], "status": "available", "title": "Power Interconnection Queue (PJM)" }, { "anchors": [ "state", "county_fips" ], "answers": [ "which projects are in PJM's cluster cycles (TC1/TC2 transition, C01+ reopened), by cycle, stage, state, fuel, and status", "the requested (MFO / net summer / net winter) megawatts of each cluster-cycle project, cited to its source row", "the cluster stage / decision point and developer of each project, as PJM reports them", "the realized in-service (built) megawatts and long-term-firm transmission MW, separate from requested MW", "the count of cluster-cycle projects in a scope (e.g. cycle=C01, status=Active)" ], "current_sources": [ "energy.pjm.cycle" ], "id": "power.interconnection_queue_pjm_cycle", "primitive": "query_power_interconnection_queue_pjm_cycle_v1", "product_spec": "blocks/power_interconnection_queue_pjm_cycle/card.md", "represented_facts": [ "PJM's cluster/cycle grid reports each project's cluster cycle (TC1/TC2 transition, C01+ reopened steady-state) and stage, with its REQUESTED interconnection capacity (MFO / net summer / net winter MW) \u2014 a request, not built capacity", "PJM's cycle grid reports each project's developer, location (state, county), fuel, phased System-Impact-Study report URLs + statuses, and lifecycle dates", "PJM also reports in_service_mw (realized built MW) and ltf_mw (long-term firm transmission MW), carried under their own names; this is a separate publication from PJM's New Services queue and is never merged with it" ], "status": "available", "title": "Power Interconnection Queue (PJM cluster/cycle)" }, { "anchors": [ "state", "county_fips" ], "answers": [ "which projects have requested to connect to the CAISO grid, by state/county, fuel/technology, cluster, deliverability, and status", "the net megawatts to grid of each queued CAISO project, cited to its source row", "the as-reported application status of each CAISO project (Active / Completed / Withdrawn), kept verbatim by tab", "each project's deliverability status (Full Capacity / Partial Capacity / Energy Only), TPD allocation, and cluster (study process), as CAISO reports it", "the count of projects in a scope (active vs completed vs withdrawn \u2014 by filtering application_status)" ], "current_sources": [ "energy.caiso.queue" ], "id": "power.interconnection_queue_caiso", "primitive": "query_power_interconnection_queue_caiso_v1", "product_spec": "blocks/power_interconnection_queue_caiso/card.md", "represented_facts": [ "CAISO's Public Queue Report reports each project's REQUESTED interconnection capacity (Net MWs to Grid) \u2014 a request, not built capacity \u2014 across the Active, Completed, and Withdrawn lifecycle tabs", "CAISO's queue reports each project's location (state, county), the Type/Fuel/MW hybrid triplets, the three-valued deliverability status (Full Capacity / Partial Capacity / Energy Only) with TPD allocation, the cluster study process, the per-phase study statuses, and lifecycle dates", "CAISO carries the requested-vs-built distinction in application_status + the lifecycle tab \u2014 a COMPLETED project carries an actual_online_date (the realized in-service date); CAISO publishes no separate built-MW column" ], "status": "available", "title": "Power Interconnection Queue (CAISO)" }, { "anchors": [ "state", "county_fips" ], "answers": [ "which projects have requested to connect to the NYISO grid, by state/county, fuel/technology, zone, and status", "the summer-peak (sp_mw) and winter-peak (wp_mw) megawatts of each queued NYISO project, cited to its source row", "NYISO load interconnection requests (the Load Projects tab) with their peak_mw_load, served as-reported", "the as-reported lifecycle status of each NYISO project (active / withdrawn / in-service / affected-system), kept by tab", "the as-reported study-phase code (study_status_code) and which studies are available, as NYISO reports them", "NYISO's own End-Use class per load request (end_use, 2026-07 edition onward, e.g. DAT / DAT-AI / DAT-CM, served verbatim) and the SIS study bundle (sis_bundle)", "the count of projects in a scope (active vs withdrawn vs in-service \u2014 by filtering application_status or sheet_name)" ], "current_sources": [ "energy.nyiso.queue" ], "id": "power.interconnection_queue_nyiso", "primitive": "query_power_interconnection_queue_nyiso_v1", "product_spec": "blocks/power_interconnection_queue_nyiso/card.md", "represented_facts": [ "NYISO's Interconnection Queue reports each project's REQUESTED interconnection capacity \u2014 summer (SP) and winter (WP) peak MW, kept separate \u2014 across every lifecycle tab NYISO publishes (nine through 2026-06; seven since the 2026-07 restructure folded the load/affected-system withdrawn lists into the active tabs under NYISO's own 0=Withdrawn code); a request, not built capacity", "NYISO uniquely publishes a Load Projects tab \u2014 load interconnection requests with their own peak_mw_load, and (since 2026-07) NYISO's own End-Use class per request (end_use, e.g. DAT / DAT-AI / DAT-CM, served verbatim \u2014 NYISO publishes no key for these codes) plus the SIS Bundle study-batch code (sis_bundle)", "NYISO carries the requested-vs-built distinction in application_status (the lifecycle tab's reading, overridden to the withdrawn form on NYISO's own status code 0) + study_status_code; the In Service tab is the built reading, and a project may appear on more than one tab (grain = sheet + queue_position)" ], "status": "available", "title": "Power Interconnection Queue (NYISO)" }, { "anchors": [ "state", "county_fips" ], "answers": [ "which projects have requested to connect to the ISO-NE grid, by state/county, fuel/technology, zone, and status", "the net / summer-peak / winter-peak megawatts of each queued ISO-NE project, cited to its source row", "the as-reported lifecycle status of each project (A=Active / C=Commercial / W=Withdrawn), kept separate from build-progress project_status", "the build-progress project_status (Under Study / Under Construction / In Service / \u2026), as ISO-NE reports it, never collapsed into application_status", "the request type (G=Generation / ETU=Elective Transmission Upgrade / TS=Transmission Service) and per-stage study statuses, as ISO-NE reports them", "the count of projects in a scope (active vs commercial vs withdrawn \u2014 by filtering application_status)" ], "current_sources": [ "energy.isone.queue" ], "id": "power.interconnection_queue_isone", "primitive": "query_power_interconnection_queue_isone_v1", "product_spec": "blocks/power_interconnection_queue_isone/card.md", "represented_facts": [ "ISO-NE's IRTT public-queue report lists each project's REQUESTED interconnection capacity \u2014 net, summer-peak and winter-peak MW, kept separate \u2014 for generation, elective-transmission-upgrade and transmission-service requests; a request, not built capacity", "ISO-NE carries the requested-vs-built distinction in application_status (A=Active / C=Commercial / W=Withdrawn) and a SEPARATE build-progress project_status (Under Study / Under Construction / In Service / \u2026), never collapsed; a Commercial project is the built reading", "ISO-NE publishes no load/data-center request type (all rows are generation or transmission); the queue-position (QP) is a non-unique reference reused across historical projects, so the grain is the published row ordinal" ], "status": "available", "title": "Power Interconnection Queue (ISO-NE)" }, { "anchors": [ "state", "county_fips" ], "answers": [ "which generation projects have requested to connect to the ERCOT (Texas) grid, by county, fuel, technology, CDR reporting zone, lifecycle, and size", "the requested capacity (MW) of each queued ERCOT project, cited to its source row", "the as-reported lifecycle of each project (ACTIVE / INACTIVE / CANCELLED, derived from ERCOT's own sheet structure), kept separate from build progress", "the build-progress signal \u2014 the GIM Study Phase token string and the milestone dates (screening study, FIS, IA signed, construction, energization), as ERCOT reports them", "the count of projects in a scope (active vs inactive vs cancelled \u2014 by filtering application_status)" ], "current_sources": [ "energy.ercot.queue" ], "id": "power.interconnection_queue_ercot", "primitive": "query_power_interconnection_queue_ercot_v1", "product_spec": "blocks/power_interconnection_queue_ercot/card.md", "represented_facts": [ "ERCOT's GIS Report lists each generation project's REQUESTED interconnection capacity (capacity_mw \u2014 one figure, no summer/winter split) across four lifecycle sheets (Large/Small Gen active, plus Inactive and Cancellation); a request, not built capacity", "ERCOT publishes no status column, so application_status (ACTIVE / INACTIVE / CANCELLED) is derived from the sheet the project is filed on (sheet_name served verbatim), and the build-progress reading is carried SEPARATELY in gim_study_phase + the milestone dates, never collapsed", "ERCOT files a hybrid project's legs as separate INR rows linked only by a shared poi_location (no in-row hybrid encoding); the GIS Report is generation-only and reports no load/data-center type" ], "status": "available", "title": "Power Interconnection Queue (ERCOT)" }, { "anchors": [ "state", "county_fips" ], "answers": [ "which generation projects have requested to connect to the SPP grid, by state, county, generation type, fuel, study cluster, transmission owner, and status", "the requested capacity (MW) of each queued SPP project, cited to its source row (and the five other MW columns SPP publishes, each labeled and never blended)", "the as-reported SPP status of each project (SPP's own vocabulary, kept verbatim with a per-source codebook), so an agent can scope to active vs withdrawn vs terminated", "the study cluster (DISIS-YYYY-NNN / Surplus / RTOE Transitional) and SPP regional cluster group, as SPP reports them", "the count of projects in a scope (by filtering native_status, state, generation_type, \u2026)" ], "current_sources": [ "energy.spp.queue" ], "id": "power.interconnection_queue_spp", "primitive": "query_power_interconnection_queue_spp_v1", "product_spec": "blocks/power_interconnection_queue_spp/card.md", "represented_facts": [ "SPP's GI Summary lists each generation project's REQUESTED interconnection capacity (capacity_mw \u2014 SPP's headline figure, with five other labeled MW columns served and never blended); a request, not built capacity", "SPP publishes a native Status column whose vocabulary it controls, so native_status is served VERBATIM with a codebook (never mapped to a lifecycle enum); ~66% of rows are WITHDRAWN, so a total is scoped by native_status, never read as built", "SPP spans ~14 central-US states (state is a real anchor), carries only a free-text town-or-county (county_fips derived by name where it resolves, else null), encodes hybrids natively as a Hybrid generation_type (no is_hybrid invented), and is generation-only (no load/data-center type)" ], "status": "available", "title": "Power Interconnection Queue (SPP)" }, { "anchors": [ "state" ], "answers": [ "the day-ahead wholesale price ($/MWh) at an ERCOT settlement point for a given delivery day and hour, cited to its source row", "the price at a named hub (e.g. HB_NORTH, HB_HOUSTON) or load zone (e.g. LZ_HOUSTON) \u2014 the regional benchmark prices", "the daily price shape at a settlement point (the 24 hourly day-ahead prices), and average / minimum / maximum price over a window", "how a settlement point is classified by ERCOT (Hub / Load Zone / Resource Node / DC-tie, as ERCOT's own verbatim code), so a single-plant node is not mistaken for a regional benchmark", "the price spread across settlement points or types for a given hour or day" ], "current_sources": [ "energy.ercot.prices" ], "id": "power.price_ercot", "primitive": "query_power_price_ercot_v1", "product_spec": "blocks/power_price_ercot/card.md", "represented_facts": [ "ERCOT's Day-Ahead Market Settlement Point Prices (NP4-190-CD) \u2014 the price ($/MWh) cleared the day before each operating day at every ERCOT settlement point, served hourly and point by point as a TOTAL (no energy/congestion/loss split; none is synthesized)", "a price is intensive ($/MWh): it is averaged / min'd / max'd over a scope, never summed; ERCOT's own hour-ending label and DST flag are carried verbatim (24 hours normally, 25 on the fall-back date, 23 on spring-forward)", "settlement_point_type is ERCOT's OWN verbatim classification (HU hub / LZ load zone / RN resource node / DC-tie \u2026), joined from ERCOT's published settlement-points list and never collapsed; a settlement point is electrical/aggregate, not a plant \u2014 the only geography anchor is state = TX", "historical delivery coverage begins 2014-05-02 from ERCOT's Data Access Portal archives; settlement-point names remain exactly as published in each vintage, and an older name absent from the current type reference receives a null type rather than a rewrite or guess" ], "status": "available", "title": "Power Prices (ERCOT day-ahead)" }, { "anchors": [], "answers": [ "PJM's cited marginal ELCC accreditation fraction for a resource class in a named auction document", "how preliminary-outlook ratings differ from final-auction or incremental-auction ratings without reconciling them", "all PJM resource classes in a linked class-ratings table, with the verbatim class name and normalized family" ], "current_sources": [ "energy.pjm.elcc" ], "id": "power.capacity_accreditation_pjm", "primitive": "query_power_capacity_accreditation_pjm_v1", "product_spec": "blocks/power_capacity_accreditation_pjm/card.md", "represented_facts": [ "PJM-published marginal Effective Load Carrying Capability (ELCC) class ratings, as a fraction of nameplate capacity, for each resource class and delivery year in each linked final Base Residual Auction document, Incremental Auction document, or preliminary multi-year outlook. Document identity is a dimension: preliminary and final ratings for the same delivery year are separate cited atoms and are never merged, preferred, reconciled, or corrected by this block." ], "status": "available", "title": "PJM ELCC Class Ratings (internal)" }, { "anchors": [], "answers": [ "RTO-wide and separated-LDA UCAP capacity-market clearing prices for a named PJM delivery year", "cleared RTO UCAP MW and the report-stated RTO reliability requirement where published", "the administrative price cap and floor as each stating document publishes them, making a cap-bound clearing visible", "for auctions with no stated collar, which documents were searched, so a None cap is provably not-stated", "documented coverage from delivery year 2018/2019 onward, with unsupported source formats recorded as exceptions" ], "current_sources": [ "energy.pjm.capacity_market" ], "id": "power.capacity_market_pjm", "primitive": "query_power_capacity_market_pjm_v1", "product_spec": "blocks/power_capacity_market_pjm/card.md", "represented_facts": [ "PJM Reliability Pricing Model Base Residual Auction results: UCAP-basis resource clearing prices in USD per MW-day for the RTO and published LDAs, RTO cleared UCAP MW, the stated RTO reliability requirement, and any administrative price cap and floor stated in the auction results report or the planning-period-parameters workbook \u2014 each on the basis its stating document uses, quoted verbatim in cap_basis. Documents searched for a collar that state none yield a collar_search atom, so absence is provably \"not stated\", never \"not parsed\". Workbook and report facts remain separate cited atoms at their exact source coordinates." ], "status": "available", "title": "PJM RPM Capacity-Market Results (internal)" } ], "id": "power" }, { "capabilities": [ { "anchors": [], "answers": [ "monthly private data-center construction spending ($ millions), seasonally-adjusted annual rate or not-adjusted monthly level (cited to the source cell)", "monthly private computer/electronic/electrical (semiconductor-fab) construction spending ($ millions)", "the data-center vs fab construction-spending trend over time (each as its own per-month series)", "whether a given month's value is preliminary, revised, or final (the Census revision status, carried verbatim)" ], "current_sources": [ "construction.census.c30_vip" ], "id": "ai_infrastructure.construction", "primitive": "query_ai_infrastructure_construction_v1", "product_spec": "blocks/ai_infrastructure_construction/card.md", "represented_facts": [ "Census C30 (Value of Construction Put in Place) reports the monthly value of private DATA-CENTER construction put in place ($ millions), served both seasonally-adjusted (annual rate) and not-seasonally-adjusted (monthly level), verbatim and cited", "Census C30 reports the monthly value of private COMPUTER/ELECTRONIC/ELECTRICAL (semiconductor-fab) construction put in place ($ millions) on the same two bases" ], "status": "available", "title": "AI Infrastructure Construction (data centers + fabs)" }, { "anchors": [ "state", "county_fips" ], "answers": [ "quarterly data-center-industry (NAICS 518210) employment, establishments, and wages by US / state / county", "quarterly semiconductor-manufacturing (NAICS 334413) employment and wages by US / state / county", "the state/county geography of data-center and semiconductor employment since 2014 (e.g. Loudoun County, VA)", "TOTAL covered employment and wages for any US county, quarterly since 2014 (\"did the county's employment rise?\")", "county construction-sector (NAICS 23) and commercial-building (236220) employment \u2014 the buildout-phase series", "county retail (\"44-45\"), accommodation (721), and food-service (722) employment \u2014 the induced local-economy series", "whether a county x industry cell is disclosed or withheld (the disclosure_code, carried verbatim)" ], "current_sources": [ "employment.bls.qcew" ], "id": "ai_infrastructure.employment", "primitive": "query_ai_infrastructure_employment_v1", "product_spec": "blocks/ai_infrastructure_employment/card.md", "represented_facts": [ "BLS QCEW reports quarterly establishments, monthly employment, and quarterly wages for the data-center industry (NAICS 518210, computing infrastructure / data processing / web hosting) by national / state / county and ownership, served verbatim and cited", "BLS QCEW reports the same for semiconductor & related device manufacturing (NAICS 334413); a confidential county \u00d7 industry cell is served as absent (withheld), never as a measured zero", "BLS QCEW reports the same for the place-based local-economy series (PD-069): total all industries ('10'), construction (23), commercial & institutional building construction (236220), retail trade ('44-45'), accommodation (721), and food services (722) \u2014 what a facility buildout does to a county's whole economy; jobs count at the employer's establishment, not the work site" ], "status": "available", "title": "AI Infrastructure Employment (data centers + semiconductors)" }, { "anchors": [], "answers": [ "monthly U.S. import value (USD) of all integrated circuits \u2014 HS-8542 \u2014 cited to the source row", "chip imports by country of origin (e.g. Taiwan, Malaysia, South Korea, Israel) \u2014 supply-source concentration", "the U.S. chip-import trend over time (each country / grouping / the national total as its own monthly series)", "general imports value vs imports-for-consumption value at the same grain" ], "current_sources": [ "trade.census.intltrade_imports_hs" ], "id": "ai_infrastructure.trade", "primitive": "query_ai_infrastructure_trade_v1", "product_spec": "blocks/ai_infrastructure_trade/card.md", "represented_facts": [ "Census International Trade reports the monthly customs value (USD) of U.S. imports of HS-8542 'Electronic integrated circuits' \u2014 ALL integrated circuits (processors, memory, amplifiers, parts), not AI-accelerator-specific \u2014 by country of origin, as general imports and imports-for-consumption value, served verbatim and cited", "Census reports these imports across overlapping country GROUPINGS (ASIA, APEC, EU, OECD, ASEAN, the continents) and an all-countries TOTAL; the groupings overlap each other and the countries, so they are never summed \u2014 the served TOTAL is the only national figure" ], "status": "available", "title": "AI Infrastructure Trade (chip imports)" }, { "anchors": [], "answers": [ "monthly U.S. import value (USD) of semiconductor-manufacturing equipment \u2014 HS-8486 \u2014 cited to the source row", "equipment imports by country of origin (e.g. Japan, the Netherlands, South Korea, Singapore) \u2014 tool-supply concentration", "the fab-buildout TOOLING trend \u2014 equipment flowing in between construction (C30) and chip output (HS-8542)", "general imports value vs imports-for-consumption value at the same grain" ], "current_sources": [ "trade.census.intltrade_equipment_hs" ], "id": "ai_infrastructure.equipment_trade", "primitive": "query_ai_infrastructure_equipment_trade_v1", "product_spec": "blocks/ai_infrastructure_equipment_trade/card.md", "represented_facts": [ "Census International Trade reports the monthly customs value (USD) of U.S. imports of HS-8486 'Machines and apparatus for the manufacture of semiconductor boules/wafers, devices, integrated circuits or flat panel displays' \u2014 the chip-MAKING equipment (which includes flat-panel-display machinery), NOT the chips themselves \u2014 by country of origin, as general imports and imports-for-consumption value, served verbatim and cited", "Census reports these imports across overlapping country GROUPINGS (ASIA, APEC, EU, OECD, ASEAN, the continents) and an all-countries TOTAL; the groupings overlap each other and the countries, so they are never summed \u2014 the served TOTAL is the only national figure" ], "status": "available", "title": "AI Infrastructure Equipment Trade (chip-making tools)" }, { "anchors": [], "answers": [ "the monthly industrial-production index (2017=100) for semiconductor & other electronic component manufacturing (NAICS 3344), seasonally adjusted or not adjusted, cited to the Fed's source observation", "monthly capacity utilization (percent, seasonally adjusted) for the same industry \u2014 how hot the domestic fabs and component plants are running", "the monthly capacity index (2017=100) behind the utilization rate", "the production / utilization trend over time (each series as its own per-month reading, averaged \u2014 never summed \u2014 over windows)" ], "current_sources": [ "production.fed.g17" ], "id": "ai_infrastructure.production", "primitive": "query_ai_infrastructure_production_v1", "product_spec": "blocks/ai_infrastructure_production/card.md", "represented_facts": [ "Fed G.17 reports the monthly industrial-production index (2017=100, seasonally adjusted and not adjusted) for semiconductor and other electronic component manufacturing (NAICS 3344) \u2014 the finest split G.17 publishes for this family, served verbatim and cited to the Board's SDMX observation", "Fed G.17 reports monthly capacity utilization (percent) and the capacity index (2017=100) for the same industry, seasonally adjusted only; an index or a rate is intensive \u2014 averaged over a window, never summed" ], "status": "available", "title": "AI Infrastructure Production (semiconductor output and utilization)" } ], "id": "ai_infrastructure" }, { "capabilities": [ { "anchors": [], "answers": [ "monthly U.S. imports of industrial robots in DOLLARS and in UNITS (robot counts) \u2014 cited to the source row", "robot imports by country of origin (e.g. Japan, China, South Korea, Germany, Mexico) \u2014 supply concentration", "the two robot categories separately \u2014 multipurpose robots (8479.50) vs lifting/handling robots (8428.70)", "general imports vs imports-for-consumption at the same grain, value and units" ], "current_sources": [ "trade.census.intltrade_robotics_hs" ], "id": "robotics.trade", "primitive": "query_robotics_trade_v1", "product_spec": "blocks/robotics_trade/card.md", "represented_facts": [ "Census International Trade reports the monthly customs value (USD) AND unit count (number of robots) of U.S. imports of industrial robots \u2014 HS-10 8479500000 'INDUSTRIAL ROBOTS, NESOI' (multipurpose) and 8428700000 'INDUSTRIAL ROBOTS FOR LIFTING, HANDLING, LOADING OR UNLOADING' (created by HS 2022; no data before 2022-01) \u2014 by country of origin, as general imports and imports-for-consumption, served verbatim and cited", "Census reports these imports across overlapping country GROUPINGS (ASIA, APEC, EU, OECD, ASEAN, the continents) and an all-countries TOTAL; the groupings overlap each other and the countries, so they are never summed \u2014 the served TOTAL is the only national figure" ], "status": "available", "title": "Robotics Trade (industrial-robot imports, value + robot counts)" }, { "anchors": [ "state" ], "answers": [ "what share of US manufacturing plants use industrial robots \u2014 nationally, by state, by industry (NAICS), by plant size \u2014 the only official installed-base adoption series", "what share of manufacturing employees work at plants with robots, at the same grains", "robotics capital expenditures ($1000) by industry, state, and plant size", "how adoption differs across plant sizes (small plants barely automate; large plants dominate)", "each edition separately (ASM 2018-2021 annual series; EC 2022 census snapshot), with the coverage break between them named, never spliced" ], "current_sources": [ "robotics.census.robotic_equipment" ], "id": "robotics.adoption", "primitive": "query_robotics_adoption_v1", "product_spec": "blocks/robotics_adoption/card.md", "represented_facts": [ "The Census Industrial Robotic Equipment product (experimental \u2014 the first official federal robotics-adoption statistics) reports the percent of manufacturing plants with industrial robots, the percent of manufacturing employees at plants with robots, and robotics capital expenditures ($1000) by NAICS industry, state, and plant size, in two editions (ASM 2018-2021 and the 2022 Economic Census), served verbatim and cited to the exact workbook cell-group", "The two editions measure different coverage universes (the 2022 Economic Census reaches small plants the ASM sample does not \u2014 US plants-with-robots 12.1% ASM-2021 vs 6.4% EC-2022), so editions are compared, never spliced into one series (PD-066)" ], "status": "available", "title": "Robotics Adoption (share of plants using robots, workers exposed, robotics capex)" } ], "id": "robotics" }, { "capabilities": [ { "anchors": [ "state" ], "answers": [ "every FCC space-station filing on record \u2014 by applicant, application type, status, and filing date \u2014 each cited to its exact record in the FCC's own database dump", "the licensing trail of any satellite system or operator (e.g. every SpaceX / Intelsat / Kuiper filing), with the FCC's own description text", "where each filing stands now (the FCC's own status vocabulary, decoded from the same dump vintage) \u2014 granted, pending, dismissed, surrendered \u2014 updated daily", "filing counts by applicant, type, status, state (applicant address), or period \u2014 the satellite-buildout pipeline signal back to the 1960s", "the lifecycle dates of any filing (filed, granted, expires, \u2026), e.g. when an authorization expires" ], "current_sources": [ "space.fcc.ibfs_sat" ], "id": "space.satellite_filings", "primitive": "query_space_satellite_filings_v1", "product_spec": "blocks/space_satellite_filings/card.md", "represented_facts": [ "The FCC's IBFS daily bulk database dump records every space-station (SAT-subsystem) filing in the FCC satellite licensing docket back to the 1960s \u2014 file number, call sign, application type and status in the FCC's own vocabulary (verbatim codes plus the FCC's own decode text from the same dump vintage), the full lifecycle date family, the FCC's plain-English description, and the applicant identity joined by the source's own address_key \u2014 served as-reported and cited to the exact record", "New-filing intake into IBFS structurally ended at the FCC's ICFS system cutover (~mid-2025; measured: zero 2026-filed records while 2026-dated status actions continue daily), and ICFS publishes no bulk data \u2014 so filings submitted after the cutover are not in this source (PD-064, engraved as a refusal)" ], "status": "available", "title": "Space Satellite Filings (FCC satellite licensing docket)" } ], "id": "space" } ], "version": "v1" }, "tool": "list_capabilities_v1" }, { "params": {}, "result": { "anchors": [ { "about": "2-letter state/jurisdiction code (PD-003).", "format": "usps_state", "kind": "geography", "name": "state", "scope": "universal" }, { "about": "5-digit Census county FIPS, zero-padded string.", "format": "fips5", "kind": "geography", "name": "county_fips", "scope": "universal" } ], "capability": "ai_infrastructure.employment", "codebooks": { "agglvl": { "codes": { "10": { "label": "National, total covered (all ownerships)" }, "11": { "label": "National, total \u2014 by ownership" }, "14": { "label": "National, by NAICS sector" }, "15": { "label": "National, by NAICS 3-digit" }, "18": { "label": "National, by 6-digit NAICS" }, "50": { "label": "State, total covered (all ownerships)" }, "51": { "label": "State, total \u2014 by ownership" }, "54": { "label": "State, by NAICS sector" }, "55": { "label": "State, by NAICS 3-digit" }, "58": { "label": "State, by 6-digit NAICS" }, "70": { "label": "County, total covered (all ownerships)" }, "71": { "label": "County, total \u2014 by ownership" }, "74": { "label": "County, by NAICS sector" }, "75": { "label": "County, by NAICS 3-digit" }, "78": { "label": "County, by 6-digit NAICS" } }, "coverage": "national / state / county at each pinned industry depth (MSA excluded \u2014 CBSA codes don't fit the county_fips anchor)", "note": "First digit = geography (1 national / 5 state / 7 county); second digit = industry depth (0 total covered, 1 total by ownership, 4 NAICS sector, 5 NAICS 3-digit, 8 NAICS 6-digit). Geography NESTS \u2014 18 national contains 58 state contains 78 county \u2014 and the total depth (x0/x1, industry '10') contains every other depth. Filter to one level (or group_by agglvl) to avoid double-counting. Depth follows the industry_code: '10' lives at x0/x1, 23 and '44-45' at x4, 721/722 at x5, 236220/518210/334413 at x8.", "semantics": "bls_qcew_aggregation_level", "source": "BLS QCEW aggregation levels." }, "industry": { "codes": { "10": { "label": "Total, all industries" }, "23": { "label": "Construction" }, "236220": { "label": "Commercial and institutional building construction" }, "334413": { "label": "Semiconductor and related device manufacturing" }, "44-45": { "label": "Retail trade" }, "518210": { "label": "Computing infrastructure providers, data processing, web hosting, and related services" }, "721": { "label": "Accommodation" }, "722": { "label": "Food services and drinking places" } }, "coverage": "the eight pinned industry series: the two AI-infrastructure NAICS + the PD-069 place-based local-economy set", "note": "DISTINCT series, never conflated. The only ancestries: '10' (total, all industries) contains every other series, and 23 (construction) contains 236220 (commercial building). The remaining series are mutually DISJOINT \u2014 721/722 sit under NAICS 72 (not served), NOT under retail '44-45'. Each code lives at its own agglvl depth ('10' at x0/x1; 23 and '44-45' at x4; 721/722 at x5; 236220/518210/334413 at x8); never sum a series with its ancestor. NAICS vintage: 2014-2021 coded under NAICS 2017, 2022Q1-forward under NAICS 2022 (BLS never recodes history) \u2014 the 2022 revision REDEFINED 518210, so its cross-2022Q1 level shift is reclassification, not a real change.", "semantics": "bls_qcew_naics_industry", "source": "BLS QCEW industry titles (NAICS 2022), verbatim." }, "ownership": { "codes": { "0": { "label": "Total Covered" }, "1": { "label": "Federal Government" }, "2": { "label": "State Government" }, "3": { "label": "Local Government" }, "4": { "label": "International Government" }, "5": { "label": "Private" }, "8": { "label": "Total Government" }, "9": { "label": "Total U.I. Covered (Excludes Federal Government)" } }, "coverage": "the ownership sectors QCEW publishes", "note": "own_code 5 = Private (the usual filter). 0 'Total Covered' and 8 'Total Government' are TOTALS that already contain their components \u2014 never sum a total with its parts.", "semantics": "bls_qcew_ownership", "source": "BLS QCEW ownership titles, verbatim." } }, "data_point": { "does_not_answer": [ "an \"AI jobs\" or data-center-ONLY headcount (NAICS 518210 is the broader computing-infrastructure / hosting industry)", "employment or wages for a SUPPRESSED county x industry cell (BLS withholds it for confidentiality \u2014 served as absent null, never zero)", "jobs at the WORK SITE \u2014 QCEW counts jobs at the employer's establishment, so construction workers building in a county for an out-of-county contractor are counted where the contractor is based, not at the site", "industries beyond the eight pinned series (e.g. electrical contractors 238210 \u2014 largely absent/suppressed at county grain; not served)", "a definition-constant 518210 series across 2022Q1 \u2014 the NAICS-2022 revision REDEFINED 518210 (BLS codes 2014-2021 under NAICS 2017, 2022-forward under NAICS 2022, and never recodes history), so a level shift at that boundary (e.g. Loudoun County, -45% in one quarter) is reclassification, not jobs lost", "MSA / metro-area figures (CBSA codes like 'C1018' do not fit the county_fips anchor \u2014 national / state / county only)", "occupation, job title, or skill detail (QCEW is an INDUSTRY program, not an occupational one)", "which company or establishment employs (QCEW carries no employer-level breakdown)", "a measured zero where the cell is withheld (a suppressed 0 is absence, disambiguated by disclosure_code)" ], "grain": "area_industry_quarterly", "id": "ai_infrastructure.employment", "note": "This is INDUSTRY employment, establishments, and wages from BLS QCEW for eight pinned industry series \u2014 the data-center industry (NAICS 518210) and semiconductor manufacturing (NAICS 334413), plus the PD-069 place-based set: total all industries ('10'), construction (23), commercial building (236220), retail ('44-45'), accommodation (721), and food service (722) \u2014 served verbatim per (area, ownership, industry, quarter). It is NOT an 'AI jobs' count; a confidential county \u00d7 industry cell is served absent (withheld), never zero; and jobs count at the employer's ESTABLISHMENT, not the work site. Counts and employment are additive only WITHIN one agglvl + one ownership + one quarter; industry codes NEST ('10' contains 23 contains 236220 \u2014 each depth has its own agglvl); employment is a per-quarter stock (not summable across quarters).", "product_spec": "blocks/ai_infrastructure_employment/card.md", "represented_fact": "BLS Quarterly Census of Employment and Wages (QCEW) \u2014 quarterly establishment counts, monthly employment, and quarterly wages for eight industry series, by national / state / county and ownership, served exactly as BLS publishes: the two vertical industries \u2014 NAICS 518210 (computing infrastructure providers, data processing, web hosting \u2014 the data-center industry proxy) and NAICS 334413 (semiconductor manufacturing) \u2014 plus the place-based local-economy set (PD-069): total all industries (\"10\"), construction (23), commercial & institutional building construction (236220), retail trade (\"44-45\"), accommodation (721), and food services & drinking places (722), so an agent can read what a facility buildout does to a county's whole economy, not just the operator industry. INDUSTRY employment \u2014 NOT an \"AI jobs\" or data-center-only count (NAICS 518210 spans hosting broadly). A confidential county x industry cell is served ABSENT (BLS withholds employment/wages by zeroing them; we never serve that 0 as a measured zero). Jobs are counted at the EMPLOYER'S ESTABLISHMENT, not the work site \u2014 a construction crew building in county X for a contractor based in county Y counts in county Y. Each year is served exactly as BLS coded it \u2014 2014-2021 under NAICS 2017, 2022Q1-forward under NAICS 2022; BLS never recodes history.", "source_basis": [ "employment.bls.qcew" ], "source_decisions": [ "docs/sources/employment/bls_qcew/build-plan.md" ] }, "input": { "controls": [ "include_records", "include_evidence", "limit", "order_by", "top_n", "order", "rollup_other" ], "date_range_params": [ "quarter_from", "quarter_to" ], "date_ranges": [ "quarter" ], "field_metadata": { "avg_wkly_wage": { "answer_label": "average weekly wage", "counting_definition": "A per-cell average \u2014 non-additive: never sum or average it across cells; a withheld (disclosure 'N'/'-') cell carries no value.", "definition": "BLS's published average weekly wage ($) for the cell (total quarterly wages \u00f7 average monthly employment \u00f7 13 weeks, computed by BLS), served on DETAIL records only.", "semantics": "bls_qcew_average_weekly_wage", "source_field": "avg_wkly_wage" } }, "filters": [ "as_of", "industry", "industry_code", "ownership", "own_code", "state", "county_fips", "area_fips", "agglvl", "year", "qtr", "quarter", "quarter_from", "quarter_to" ], "group_by": [ "industry", "industry_code", "ownership", "own_code", "state", "county_fips", "agglvl", "year", "qtr", "quarter" ], "ranking": { "no_ranking": "Omit order_by and top_n to return all groups in group-key order.", "order": { "default": "desc", "valid_values": [ "desc", "asc" ] }, "order_by": { "accepts": "one of output.metrics", "note": "Ranks the groups by a metric (a measure). Not a group_by dimension \u2014 rows already come back grouped by each group_by field.", "requires": [ "group_by" ], "valid_values": [ "qtrly_estabs", "month1_emplvl", "month2_emplvl", "month3_emplvl", "total_qtrly_wages", "source_record_count" ] }, "top_n": { "note": "Keeps the top N groups by order_by; the rest fold into one (other) remainder (additive metrics sum into it, non-additive ones are nulled) so the result still reconciles to summary.totals.", "requires": [ "group_by", "order_by" ], "type": "positive integer" } } }, "output": { "aggregate_citation_fields": [ "source_id", "publisher", "source_url", "source_file", "raw_file_sha256", "as_of", "source_rows_count", "source_rows_sample", "verify", "lineage_filter" ], "citation_fields": [ "source_id", "source_url", "source_file", "sheet", "source_row", "raw_file_sha256", "as_of" ], "detail_fields": [ "source_id", "sheet_name", "source_record_key", "report_period", "area_fips", "own_code", "industry_code", "agglvl_code", "size_code", "year", "qtr", "disclosure_code", "qtrly_estabs", "industry", "ownership", "state", "county_fips", "county_fips_source", "county_fips_unresolved", "quarter", "month1_emplvl", "month2_emplvl", "month3_emplvl", "total_qtrly_wages", "avg_wkly_wage", "source_row_number", "as_of", "raw_file_sha256", "citation" ], "metric_groups": { "employment": [ "month1_emplvl", "month2_emplvl", "month3_emplvl" ], "establishments": [ "qtrly_estabs" ], "records": [ "source_record_count" ], "wages": [ "total_qtrly_wages" ] }, "metric_metadata": { "month1_emplvl": { "additive_across_groups": true, "aggregation": "sum", "authoritative_total_path": "summary.totals.month1_emplvl", "category": "employment", "definition": "BLS QCEW covered employment in the first month of the quarter for the industry \u00d7 area \u00d7 ownership in scope, served verbatim \u2014 INDUSTRY employment, not an 'AI jobs' count.", "description": "Covered employment in month 1 of the quarter. The three monthly columns are intra-quarter SNAPSHOTS \u2014 average them for a quarterly figure, never sum the three together; and employment is a per-quarter STOCK, so it is not summable across quarters (a qcew_period scope note flags that). Additive across distinct AREAS within ONE agglvl + ONE ownership + ONE quarter (e.g. summing all counties in a state). NOT additive across geographic levels (national contains states/counties \u2014 a qcew_hierarchy scope note flags it), across nesting industry series ('10' contains every other series; 23 contains 236220), or across the ownership totals (own_code 0/8 contain their components). A ranked top_n '(other)' remainder that would fold NESTING groups serves NULL metrics with a qcew_rollup_overlap note instead of a double-counted sum. A withheld (disclosure 'N'/'-') cell is served NULL, never zero (PD-048).", "display_name": "Employment (month 1 of quarter)", "display_precision": "Integer headcount (stored as double; rounded to 6 decimal places in JSON).", "grain": "area \u00d7 ownership \u00d7 industry \u00d7 quarter", "null_handling": "A withheld (confidential) cell is absent (null), never zero; a matched group with no atoms returns null; an empty-query summary returns zero.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.month1_emplvl", "source_fields": [ "month1_emplvl" ], "unit": "count" }, "month2_emplvl": { "additive_across_groups": true, "aggregation": "sum", "authoritative_total_path": "summary.totals.month2_emplvl", "category": "employment", "definition": "BLS QCEW covered employment in the second month of the quarter for the industry \u00d7 area \u00d7 ownership in scope, served verbatim \u2014 INDUSTRY employment, not an 'AI jobs' count.", "description": "Covered employment in month 2 of the quarter. The three monthly columns are intra-quarter SNAPSHOTS \u2014 average them for a quarterly figure, never sum the three together; and employment is a per-quarter STOCK, so it is not summable across quarters (a qcew_period scope note flags that). Additive across distinct AREAS within ONE agglvl + ONE ownership + ONE quarter (e.g. summing all counties in a state). NOT additive across geographic levels (national contains states/counties \u2014 a qcew_hierarchy scope note flags it), across nesting industry series ('10' contains every other series; 23 contains 236220), or across the ownership totals (own_code 0/8 contain their components). A ranked top_n '(other)' remainder that would fold NESTING groups serves NULL metrics with a qcew_rollup_overlap note instead of a double-counted sum. A withheld (disclosure 'N'/'-') cell is served NULL, never zero (PD-048).", "display_name": "Employment (month 2 of quarter)", "display_precision": "Integer headcount (stored as double; rounded to 6 decimal places in JSON).", "grain": "area \u00d7 ownership \u00d7 industry \u00d7 quarter", "null_handling": "A withheld (confidential) cell is absent (null), never zero; a matched group with no atoms returns null; an empty-query summary returns zero.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.month2_emplvl", "source_fields": [ "month2_emplvl" ], "unit": "count" }, "month3_emplvl": { "additive_across_groups": true, "aggregation": "sum", "authoritative_total_path": "summary.totals.month3_emplvl", "category": "employment", "definition": "BLS QCEW covered employment in the third month of the quarter for the industry \u00d7 area \u00d7 ownership in scope, served verbatim \u2014 INDUSTRY employment, not an 'AI jobs' count.", "description": "Covered employment in month 3 of the quarter. The three monthly columns are intra-quarter SNAPSHOTS \u2014 average them for a quarterly figure, never sum the three together; and employment is a per-quarter STOCK, so it is not summable across quarters (a qcew_period scope note flags that). Additive across distinct AREAS within ONE agglvl + ONE ownership + ONE quarter (e.g. summing all counties in a state). NOT additive across geographic levels (national contains states/counties \u2014 a qcew_hierarchy scope note flags it), across nesting industry series ('10' contains every other series; 23 contains 236220), or across the ownership totals (own_code 0/8 contain their components). A ranked top_n '(other)' remainder that would fold NESTING groups serves NULL metrics with a qcew_rollup_overlap note instead of a double-counted sum. A withheld (disclosure 'N'/'-') cell is served NULL, never zero (PD-048).", "display_name": "Employment (month 3 of quarter)", "display_precision": "Integer headcount (stored as double; rounded to 6 decimal places in JSON).", "grain": "area \u00d7 ownership \u00d7 industry \u00d7 quarter", "null_handling": "A withheld (confidential) cell is absent (null), never zero; a matched group with no atoms returns null; an empty-query summary returns zero.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.month3_emplvl", "source_fields": [ "month3_emplvl" ], "unit": "count" }, "qtrly_estabs": { "additive_across_groups": true, "aggregation": "sum", "authoritative_total_path": "summary.totals.qtrly_estabs", "category": "establishments", "definition": "Count of establishments (physical locations) covered by unemployment insurance in the industry \u00d7 area \u00d7 ownership in scope, for the quarter, exactly as BLS publishes it in QCEW.", "description": "BLS's published count of UI-covered establishments. Not withheld even when a cell's employment/wages are. Additive across distinct AREAS within ONE agglvl + ONE ownership + ONE quarter (e.g. summing all counties in a state). NOT additive across geographic levels (national contains states/counties \u2014 a qcew_hierarchy scope note flags it), across nesting industry series ('10' contains every other series; 23 contains 236220), or across the ownership totals (own_code 0/8 contain their components). A ranked top_n '(other)' remainder that would fold NESTING groups serves NULL metrics with a qcew_rollup_overlap note instead of a double-counted sum. A withheld (disclosure 'N'/'-') cell is served NULL, never zero (PD-048).", "display_name": "Establishments", "display_precision": "Integer.", "grain": "area \u00d7 ownership \u00d7 industry \u00d7 quarter", "null_handling": "Always an establishment count (BLS does not suppress establishment counts); an empty-query summary returns zero.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.qtrly_estabs", "source_fields": [ "qtrly_estabs" ], "unit": "count" }, "source_record_count": { "additive_across_groups": true, "aggregation": "count source records", "authoritative_total_path": "summary.totals.source_record_count", "category": "records", "definition": "Count of normalized source records (area \u00d7 ownership \u00d7 industry \u00d7 quarter cells) contributing to the current result scope.", "description": "Number of normalized QCEW source cells (area \u00d7 ownership \u00d7 industry \u00d7 quarter) contributing to the value.", "display_name": "Source record count", "display_precision": "Integer.", "grain": "source row", "null_handling": "Always an integer count.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.source_record_count", "source_fields": [ "source_record_key" ], "unit": "count" }, "total_qtrly_wages": { "additive_across_groups": true, "aggregation": "sum", "authoritative_total_path": "summary.totals.total_qtrly_wages", "category": "wages", "definition": "Sum of total quarterly wages ($) paid by UI-covered employers in the industry \u00d7 area \u00d7 ownership in scope, exactly as BLS publishes it in QCEW.", "description": "Total quarterly wages ($). UNLIKE employment, wages DO sum across quarters (Q1+\u2026+Q4 = the annual wage bill). Additive across distinct AREAS within ONE agglvl + ONE ownership + ONE quarter (e.g. summing all counties in a state). NOT additive across geographic levels (national contains states/counties \u2014 a qcew_hierarchy scope note flags it), across nesting industry series ('10' contains every other series; 23 contains 236220), or across the ownership totals (own_code 0/8 contain their components). A ranked top_n '(other)' remainder that would fold NESTING groups serves NULL metrics with a qcew_rollup_overlap note instead of a double-counted sum. A withheld (disclosure 'N'/'-') cell is served NULL, never zero (PD-048).", "display_name": "Total quarterly wages", "display_precision": "USD, rounded to 6 decimal places in JSON to remove binary floating-point noise.", "grain": "area \u00d7 ownership \u00d7 industry \u00d7 quarter", "null_handling": "A withheld (confidential) cell is absent (null), never zero; a matched group with no atoms returns null; an empty-query summary returns zero.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.total_qtrly_wages", "source_fields": [ "total_qtrly_wages" ], "unit": "USD" } }, "metrics": [ "qtrly_estabs", "month1_emplvl", "month2_emplvl", "month3_emplvl", "total_qtrly_wages", "source_record_count" ], "summary_fields": [ "group_count", "totals" ] }, "primitive": "query_ai_infrastructure_employment_v1", "status": "available" }, "tool": "describe_ai_infrastructure_employment_v1" }, { "params": { "agglvl": "18", "include_records": true, "industry_code": "518210", "limit": 1, "own_code": "5", "quarter": "2025-10-01" }, "result": { "as_of": "2025-10-01", "citations": { "c1": { "source_rows_count": 1, "verify": { "as_of": "2025-10-01", "raw_file_sha256": "1d8a48a8c8cefcb9cb90c2fef41f4fb5e2aad0c4442a9e6f8673abbe2247cda8", "sheet": "qcew", "source_file": "qcew_employment_sample.csv", "source_id": "employment.bls.qcew", "source_row": 179, "source_url": "https://www.bls.gov/cew/" } } }, "primitive": "query_ai_infrastructure_employment_v1", "query": { "agglvl": [ "18" ], "as_of": "2025-10-01", "group_by": [], "include_records": true, "industry_code": [ "518210" ], "limit": 1, "own_code": [ "5" ], "quarter": "2025-10-01" }, "records": [ { "agglvl_code": "18", "area_fips": "US000", "as_of": "2025-10-01", "avg_wkly_wage": 3877.0, "citation": { "as_of": "2025-10-01", "raw_file_sha256": "1d8a48a8c8cefcb9cb90c2fef41f4fb5e2aad0c4442a9e6f8673abbe2247cda8", "sheet": "qcew", "source_file": "qcew_employment_sample.csv", "source_id": "employment.bls.qcew", "source_row": 179, "source_url": "https://www.bls.gov/cew/" }, "county_fips": null, "county_fips_source": null, "county_fips_unresolved": false, "disclosure_code": null, "industry": "Computing infrastructure providers, data processing, web hosting, and related services", "industry_code": "518210", "month1_emplvl": 485223.0, "month2_emplvl": 485415.0, "month3_emplvl": 485040.0, "own_code": "5", "ownership": "Private", "qtr": "4", "qtrly_estabs": 56613, "quarter": "2025-10-01", "raw_file_sha256": "1d8a48a8c8cefcb9cb90c2fef41f4fb5e2aad0c4442a9e6f8673abbe2247cda8", "report_period": "2024-01-01", "sheet_name": "qcew", "size_code": "0", "source_id": "employment.bls.qcew", "source_record_key": "US000|5|518210|2025Q4", "source_row_number": 179, "state": null, "total_qtrly_wages": 24458919379.0, "year": 2025 } ], "rows": [ { "group": {}, "lineage": { "citation_ref": "c1" }, "metrics": { "month1_emplvl": 485223.0, "month2_emplvl": 485415.0, "month3_emplvl": 485040.0, "qtrly_estabs": 56613, "source_record_count": 1, "total_qtrly_wages": 24458919379.0 } } ], "source_id": "employment.bls.qcew", "summary": { "group_count": 1, "totals": { "month1_emplvl": 485223.0, "month2_emplvl": 485415.0, "month3_emplvl": 485040.0, "qtrly_estabs": 56613, "source_record_count": 1, "total_qtrly_wages": 24458919379.0 } } }, "tool": "query_ai_infrastructure_employment_v1" }, { "params": { "as_of": "2025-10-01", "raw_file_sha256": "1d8a48a8c8cefcb9cb90c2fef41f4fb5e2aad0c4442a9e6f8673abbe2247cda8", "sheet": "qcew", "source_file": "qcew_employment_sample.csv", "source_id": "employment.bls.qcew", "source_row": 179, "source_url": "https://www.bls.gov/cew/" }, "result": { "as_of": "2025-10-01", "cited_row": { "area_fips": "US000", "avg_wkly_wage": "3877", "disclosure_code": "", "industry_code": "518210", "month1_emplvl": "485223", "month2_emplvl": "485415", "month3_emplvl": "485040", "own_code": "5", "qtr": "4", "qtrly_estabs": "56613", "total_qtrly_wages": "24458919379", "year": "2025" }, "hash_verified": true, "raw_file_sha256": "1d8a48a8c8cefcb9cb90c2fef41f4fb5e2aad0c4442a9e6f8673abbe2247cda8", "row_values": { "agglvl_code": "18", "area_fips": "US000", "avg_wkly_wage": "3877", "disclosure_code": "", "industry_code": "518210", "lq_avg_wkly_wage": "1.00", "lq_disclosure_code": "", "lq_month1_emplvl": "1.00", "lq_month2_emplvl": "1.00", "lq_month3_emplvl": "1.00", "lq_qtrly_contributions": "1.00", "lq_qtrly_estabs": "1.00", "lq_taxable_qtrly_wages": "1.00", "lq_total_qtrly_wages": "1.00", "month1_emplvl": "485223", "month2_emplvl": "485415", "month3_emplvl": "485040", "oty_avg_wkly_wage_chg": "-144", "oty_avg_wkly_wage_pct_chg": "-3.6", "oty_disclosure_code": "", "oty_month1_emplvl_chg": "2059", "oty_month1_emplvl_pct_chg": "0.4", "oty_month2_emplvl_chg": "1784", "oty_month2_emplvl_pct_chg": "0.4", "oty_month3_emplvl_chg": "2205", "oty_month3_emplvl_pct_chg": "0.5", "oty_qtrly_contributions_chg": "1448954", "oty_qtrly_contributions_pct_chg": "12.6", "oty_qtrly_estabs_chg": "657", "oty_qtrly_estabs_pct_chg": "1.2", "oty_taxable_qtrly_wages_chg": "-5917375", "oty_taxable_qtrly_wages_pct_chg": "-0.9", "oty_total_qtrly_wages_chg": "-799509700", "oty_total_qtrly_wages_pct_chg": "-3.2", "own_code": "5", "qtr": "4", "qtrly_contributions": "12952948", "qtrly_estabs": "56613", "size_code": "0", "taxable_qtrly_wages": "641958256", "total_qtrly_wages": "24458919379", "year": "2025" }, "sheet": "qcew", "source_file": "qcew_employment_sample.csv", "source_id": "employment.bls.qcew", "source_row": 179, "source_url": "https://www.bls.gov/cew/" }, "tool": "get_source_evidence_v1" } ] }