# USGBC LEED Certified Projects Scraper (`jungle_synthesizer/usgbc-leed-certified-projects-scraper`) Actor Scrapes the USGBC project database — the canonical global LEED certification registry — returning certification level, rating system, location, owner, LEED points, and more for 113k+ certified projects. - **URL**: https://apify.com/jungle\_synthesizer/usgbc-leed-certified-projects-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Real estate, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## USGBC LEED Certified Projects Scraper Scrapes the USGBC project database — the canonical global registry of LEED-certified buildings. Returns certification level, rating system, location, floor area, total LEED points, and more for 113,000+ projects across 180+ countries. USGBC publishes this data through a browsable interface at usgbc.org/projects but offers no bulk export. This actor queries the same Elasticsearch backend that powers the project browser and returns structured JSON. ### What It Returns One record per certified project. All data comes directly from the USGBC registry — no HTML scraping, no JavaScript rendering required. ```json { "project_id": "1000160729", "project_name": "Pima County OME Facility", "project_url": "https://www.usgbc.org/projects/pima-county-ome-facility", "certification_level": "Silver", "rating_system": "New Construction", "rating_system_version": "v4", "project_type": "New Construction", "country": "United States", "state": "Arizona", "city": "Tucson", "postal_code": "85713", "address": "3050 East Milber Street, Tucson, AZ 85713, USA", "latitude": 32.1775, "longitude": -110.9416, "certification_date": "2026-05-22", "registration_date": "2022-06-08", "gross_floor_area_sqft": 32243, "num_floors": null, "owner_organization": null, "owner_type": "Silver", "leed_points_awarded": 54, "leed_points_possible": null, "is_confidential": false } ```` #### Output Fields | Field | Type | Description | |-------|------|-------------| | `project_id` | string | USGBC project ID (prjt\_id) | | `project_name` | string | Project name | | `project_url` | string | Full URL on usgbc.org | | `certification_level` | string | Certified, Silver, Gold, or Platinum | | `rating_system` | string | LEED rating system (e.g. New Construction, Homes, Existing Buildings) | | `rating_system_version` | string | Version (e.g. v4, v4.1, v2009) | | `project_type` | string | Project type (mirrors rating system in USGBC data) | | `country` | string | Country name | | `state` | string | State or province name | | `city` | string | City name | | `postal_code` | string | Postal / ZIP code | | `address` | string | Full street address (geocoded; null for newer entries) | | `latitude` | number | Latitude coordinate (null for recently certified projects) | | `longitude` | number | Longitude coordinate (null for recently certified projects) | | `certification_date` | string | Date certification was awarded (YYYY-MM-DD) | | `registration_date` | string | Date project was registered (YYYY-MM-DD) | | `gross_floor_area_sqft` | integer | Gross floor area in square feet | | `num_floors` | integer | Number of floors (null — not in search API) | | `owner_organization` | string | Owner organization (null — org IDs only in search API) | | `owner_type` | string | Owner USGBC membership level | | `leed_points_awarded` | integer | Total LEED points awarded | | `leed_points_possible` | integer | Total possible points (null — scorecard only) | | `is_confidential` | boolean | Whether the project is flagged confidential | ### How It Works 1. Takes your filters (country, certification level, rating system, keyword). 2. Posts a query to the USGBC Elasticsearch backend — the same API the usgbc.org/projects browser uses. 3. Paginates through results in batches of 100 until `maxItems` is reached. 4. Returns one record per project, sorted by certification date descending. No proxy required. No JavaScript rendering. A single POST per page of results. ### Input Configuration | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxItems` | integer | 10 | Maximum records to return | | `searchQuery` | string | — | Keyword search across project names and locations | | `country` | string | — | ISO 2-letter country code (US, CA, GB, DE, ...) | | `state` | string | — | State or province abbreviation (CA, NY, TX, ...) | | `certificationLevel` | array | — | One or more of: Certified, Silver, Gold, Platinum | | `ratingSystem` | array | — | One or more of: New Construction, Existing Buildings, Homes, Core and Shell, Commercial Interiors, ... | All filters are optional. Run with only `maxItems` to get the most recently certified projects across the full global registry. #### Example: US Platinum buildings, New Construction ```json { "country": "US", "certificationLevel": ["Platinum"], "ratingSystem": ["New Construction"], "maxItems": 500 } ``` #### Example: All LEED-certified schools ```json { "ratingSystem": ["Schools"], "maxItems": 1000 } ``` #### Example: Keyword search ```json { "searchQuery": "hospital", "certificationLevel": ["Gold", "Platinum"], "maxItems": 200 } ``` ### Pricing \~$0.10 per run + $0.001 per record. Scraping 10,000 projects costs roughly $10.10. The full 113k-record database runs to about $113.10. ### Use Cases - **ESG analysts** building real estate portfolio sustainability scores from verified LEED data - **Green-building consultants** benchmarking certification rates by region, rating system, or year - **Architecture firms** tracking competitive LEED achievement across project types and markets - **Building product manufacturers** identifying certified buildings across the registry - **Real estate researchers** mapping LEED coverage across cities, states, or countries - **Academic researchers** analyzing the global trajectory of green-building adoption ### 🔍 FAQ **How do I scrape USGBC LEED certified buildings?** USGBC LEED Certified Projects Scraper queries the same Elasticsearch API that powers usgbc.org/projects. Set your filters (country, certification level, rating system), set `maxItems`, and run. No account required. **How much does USGBC LEED Certified Projects Scraper cost to run?** USGBC LEED Certified Projects Scraper costs $0.001 per record plus a $0.10 run fee. A 1,000-record export costs about $1.10. The full 113k-project registry is about $113. **What data can I get from USGBC?** USGBC LEED Certified Projects Scraper returns project name, URL, certification level, rating system version, location (country, state, city, postal code, geocoordinates), floor area, certification and registration dates, and total LEED points awarded. Per-category point breakdowns are shown on USGBC project scorecard pages but are not part of the search API — they will be null in the output. **Can I filter by certification level and country?** Yes. USGBC LEED Certified Projects Scraper supports filtering by country (ISO code), state, certification level (Certified, Silver, Gold, Platinum), rating system (New Construction, Homes, etc.), and keyword. Combine any number of filters in one run. **Does USGBC LEED Certified Projects Scraper need proxies?** No. The USGBC project search API accepts requests from any IP with the correct headers. No residential or datacenter proxies needed. ### Need More Features? Need custom fields, bulk filtering, or integration with another green-building data source? [File an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use USGBC LEED Certified Projects Scraper? - **Primary source** — data comes directly from the USGBC project database, the authoritative global LEED registry with 113k+ entries - **Clean output** — structured JSON with consistent field names and ISO date strings, sorted by certification date - **Efficient** — queries the search backend directly, no browser automation required # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `maxItems` (type: `integer`): Maximum number of records to scrape ## `searchQuery` (type: `string`): Optional keyword to search project names and locations (e.g. "hospital", "Chicago") ## `country` (type: `string`): Filter by 2-letter ISO country code (e.g. "US", "CA", "GB") ## `state` (type: `string`): Filter by state or province abbreviation (e.g. "CA", "NY", "TX") — applies to US/Canada ## `certificationLevel` (type: `array`): Filter by LEED certification level. Valid values — Certified, Silver, Gold, Platinum ## `ratingSystem` (type: `array`): Filter by LEED rating system (e.g. "New Construction", "Existing Buildings", "Homes", "Core and Shell") ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/usgbc-leed-certified-projects-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/usgbc-leed-certified-projects-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10 }' | apify call jungle_synthesizer/usgbc-leed-certified-projects-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/usgbc-leed-certified-projects-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "USGBC LEED Certified Projects Scraper", "description": "Scrapes the USGBC project database — the canonical global LEED certification registry — returning certification level, rating system, location, owner, LEED points, and more for 113k+ certified projects.", "version": "0.1", "x-build-id": "nCf96Xruemkb1q3wb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~usgbc-leed-certified-projects-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-usgbc-leed-certified-projects-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~usgbc-leed-certified-projects-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-usgbc-leed-certified-projects-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~usgbc-leed-certified-projects-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-usgbc-leed-certified-projects-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of records to scrape" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Optional keyword to search project names and locations (e.g. \"hospital\", \"Chicago\")" }, "country": { "title": "Country Code", "type": "string", "description": "Filter by 2-letter ISO country code (e.g. \"US\", \"CA\", \"GB\")" }, "state": { "title": "State / Province Code", "type": "string", "description": "Filter by state or province abbreviation (e.g. \"CA\", \"NY\", \"TX\") — applies to US/Canada" }, "certificationLevel": { "title": "Certification Level", "type": "array", "description": "Filter by LEED certification level. Valid values — Certified, Silver, Gold, Platinum", "items": { "type": "string" } }, "ratingSystem": { "title": "Rating System", "type": "array", "description": "Filter by LEED rating system (e.g. \"New Construction\", \"Existing Buildings\", \"Homes\", \"Core and Shell\")", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```