# Municipal Building Energy Use & Utility Costs by Building (`buildingsignal/municipal-building-energy-use`) Actor

Energy use and utility costs of city-owned buildings: annual electricity, gas, EUI, ENERGY STAR score and energy cost per facility for Nashville, New Orleans, Norfolk, Calgary and Winnipeg. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/buildingsignal/municipal-building-energy-use.md
- **Developed by:** [BuildingSignal](https://apify.com/buildingsignal) (community)
- **Categories:** Business, Lead generation, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Municipal Building Energy Use & Utility Costs by Building

Get **energy use and utility costs for city-owned buildings**: electricity and gas use, EUI, ENERGY STAR score and annual energy and water costs per facility. Ideal for public-sector energy services and performance contracting.

**📥 [Input](https://apify.com/buildingsignal/municipal-building-energy-use/input-schema) · 📤 [Output](https://apify.com/buildingsignal/municipal-building-energy-use/output-schema) · 💰 [Pricing](https://apify.com/buildingsignal/municipal-building-energy-use/pricing)**

![Coverage](https://img.shields.io/badge/Coverage-US%20%26%20Canada-blue)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)
![Billing](https://img.shields.io/badge/Billing-Pay%20per%20result-brightgreen)

### Example result

This is one real record returned by the actor:

```json
{
  "buildingSignalId": "a673a5d2697bfba0",
  "jurisdiction": "Nashville, TN",
  "programName": "Metro Nashville Government Building Energy Benchmarking",
  "reportingYear": 2022,
  "periodEnding": null,
  "sourceRecordId": "Fairgrounds|Expo Buildings",
  "propertyName": "Expo Buildings",
  "addressStreet": "401 Wingrove Street",
  "city": "Nashville",
  "state": "TN",
  "zip": null,
  "latitude": null,
  "longitude": null,
  "propertyType": "Convention Center",
  "grossFloorAreaSqft": 127988,
  "yearBuilt": null,
  "energyStarScore": null,
  "siteEuiKbtuSqft": 58.2,
  "weatherNormalizedSiteEuiKbtuSqft": null,
  "siteEnergyUseKbtu": 7452020,
  "electricityKwh": 1535000,
  "naturalGasTherms": 22146,
  "ghgEmissionsMtco2e": null,
  "electricityCostUsd": 185629.24,
  "naturalGasCostUsd": 30622.65,
  "waterCostUsd": null,
  "totalUtilityCostUsd": 216251.89,
  "waterUseCcf": null,
  "department": "Fairgrounds",
  "source": "Metro Nashville Energy Use Intensity Benchmarking",
  "observedAt": "2026-10-22T06:07:39.436Z"
}
```

### What you get

- **buildingSignalId**: Stable BuildingSignal building ID (same building across years and runs)
- **jurisdiction**: City, county, state or province of the program
- **programName**: Name of the disclosure or compliance program
- **reportingYear**: Data year of the report
- **periodEnding**: Period ending
- **sourceRecordId**: Building ID used by the program
- **propertyName**: Property or building name
- **addressStreet**: Street address
- **city**: City
- **state**: State or province
- **zip**: ZIP or postal code
- **latitude**: Latitude
- **longitude**: Longitude
- **propertyType**: Property type normalized to ENERGY STAR Portfolio Manager categories
- **grossFloorAreaSqft**: Gross floor area (sq ft)
- **yearBuilt**: Year built
- **energyStarScore**: ENERGY STAR score (1-100; 50 = national median, 75+ = top performer)
- **siteEuiKbtuSqft**: Site energy use intensity (kBtu per sq ft per year)
- **weatherNormalizedSiteEuiKbtuSqft**: Weather-normalized site EUI (kBtu per sq ft)
- **siteEnergyUseKbtu**: Total annual site energy use (kBtu)
- **electricityKwh**: Annual grid electricity use (kWh)
- **naturalGasTherms**: Annual natural gas use (therms)
- **ghgEmissionsMtco2e**: Total greenhouse gas emissions (metric tons CO2e)
- **electricityCostUsd**: Annual electricity cost (USD)
- **naturalGasCostUsd**: Annual natural gas cost (USD)
- **waterCostUsd**: Annual water cost (USD)
- **totalUtilityCostUsd**: Total annual utility cost (USD)
- **waterUseCcf**: Annual water use (CCF)
- **department**: City department that operates the building
- **source**: Official source program or agency

### Who is it for

- ESCOs and energy performance contractors
- Public-sector energy consultants
- Utility program implementers
- Govtech vendors

### Use cases

- Find the highest-cost city facilities
- Prepare performance-contracting proposals
- Benchmark municipal portfolios

### How to use it

1. Open the **Input** tab and pick the filters you need (all are optional).
2. Set the maximum number of buildings to return.
3. Click **Start**. Results appear in the dataset as they are collected and can be exported to JSON, CSV or Excel, or pulled through the Apify API.
4. Schedule the actor (daily, weekly or monthly) to keep your list fresh.

### FAQ

**Am I charged if a run fails or finds nothing?**

No. You pay only for records actually delivered to your dataset. Failed or empty runs cost nothing.

**Is there a free trial?**

Yes. Free Apify plans can run every actor and receive up to 10 results per run to evaluate the data.

**Where does the data come from?**

From official public records and open-data disclosures published by the government programs named on this page. BuildingSignal cleans, normalizes and standardizes them into one consistent schema.

**How fresh is the data?**

Each run reads the current official publication, so you always get the latest data the program has released. Schedule the actor to track changes over time.

**Can I use it with my CRM or BI tool?**

Yes. Export to CSV/Excel/JSON, call it through the Apify API, or connect it with Make, Zapier, n8n or Google Sheets integrations.

### Related BuildingSignal actors

- [US Building Energy Benchmarking Data: EUI, ENERGY STAR & GHG](https://apify.com/buildingsignal/us-building-energy-benchmarking)
- [NYC Local Law 97 Carbon Penalty Estimator & Building Leads](https://apify.com/buildingsignal/nyc-ll97-carbon-penalty-leads)
- [Building Performance Standards Compliance: Non-Compliant Lists](https://apify.com/buildingsignal/building-performance-standards-compliance)
- [NYC Boiler & Burner Equipment Leads: Make, Model, Expiration](https://apify.com/buildingsignal/nyc-boiler-burner-equipment-leads)
- [Cooling Tower Registry & Legionella Compliance Data (New York)](https://apify.com/buildingsignal/cooling-tower-registry-legionella)
- [NYC Facade Inspection (FISP / Local Law 11) Unsafe Buildings](https://apify.com/buildingsignal/nyc-facade-inspection-fisp)

***

*BuildingSignal is an independent data provider and is not affiliated with, endorsed by, or sponsored by any government agency or program named on this page. Data comes from official public records; always confirm critical decisions with the issuing agency.*

# Actor input Schema

## `jurisdictions` (type: `array`):

Which cities to include.

## `reportingYears` (type: `array`):

Only these years.

## `maxBuildings` (type: `integer`):

Maximum number of buildings to return. Free Apify plans are limited to 10 per run.

## Actor input object example

```json
{
  "jurisdictions": [
    "nashville",
    "norfolk"
  ],
  "maxBuildings": 50
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "jurisdictions": [
        "nashville",
        "norfolk"
    ],
    "maxBuildings": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("buildingsignal/municipal-building-energy-use").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "jurisdictions": [
        "nashville",
        "norfolk",
    ],
    "maxBuildings": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("buildingsignal/municipal-building-energy-use").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "jurisdictions": [
    "nashville",
    "norfolk"
  ],
  "maxBuildings": 50
}' |
apify call buildingsignal/municipal-building-energy-use --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,buildingsignal/municipal-building-energy-use"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/YPwfFyp5J7qje8xoA/builds/Q3m2NUweZ89ouQC4z/openapi.json