US ENERGY STAR Unique ID (pd_id) Portfolio Status Event Monitor

Watch a book of ENERGY STAR Unique IDs (pd_id) and emit typed APPEARED / DROPPED / MOST_EFFICIENT_GAINED / MOST_EFFICIENT_LOST events when the official EPA ENERGY STAR Model Index Socrata snapshot changes for keys on that book.

Not an EPA Safer Choice twin (#37). Not a TRI facility twin (#31). Not a flat certified-products dump billed as rows. Not unpaid energy-SaaS scrape.

Job (A1b wedge)

US utility rebate / retailer energy assortment / procurement / brand-compliance desks track a customer-owned ENERGY STAR Unique ID book and need Slack/JSON when a watched model appears on / drops off the certified Model Index, or flips Most Efficient criteria — without re-pulling the national table by hand.

A1b competitors cited from phase3-a1b-next3-v14.md only: 0 quiet ENERGY STAR pd_id portfolio / Most-Efficient event PPE products. Database dump (different job): nexgensignal/energy-star-product-records (1 MAU, created 2026-08-22 — “one row per product” flat extract). Precision “ENERGY STAR product status / portfolio monitor” returns only that dump. Distinct from Safer Choice (#37) and TRI (#31).

Source (official only)

Path	URL	Notes
Portfolio live	https://data.energystar.gov/resource/8wj2-sec8.json?$where=pd_id in(...)	Official ENERGY STAR Model Index Socrata; live-verified 200; SoQL pd_id in(...) batches (portfolio-safe — never downloads the ~1.8M-row national table)
Program	https://www.energystar.gov/	Attribution: ENERGY STAR / EPA

No API key. Cite ENERGY STAR + retrieval date. Default product fields = pd_id + partner + category + brand/model + UPC + Most Efficient flag (product/org data). CSV twin of the same resource is OK for offline research; this Actor uses JSON SoQL.

Matching honesty

• Primary key: pd_id (ENERGY STAR Unique ID) — exact match after normalize (digits-only).
• Brand / model / UPC are evidence fields on events, not primary watch keys in this SKU.
• Covers published currently certified Model Index rows — drop events mean removal from the published certified index, not a full disqualification docket mailer.
• Not Safer Choice / DfE partnership status (different EPA program, ID scheme, and buyer desk).
• Cadence follows daily ENERGY STAR Socrata refresh — scheduled snapshot poll, not streaming.
• First observation of a watch key = baseline only (no product charge).
• Quiet / unchanged books ≈ $0 product charge.
• National Model Index rows not on the book are never billed.

Events (PPE)

Event	When
ENERGY_STAR_APPEARED	Watched pd_id was missing, now present on Model Index
ENERGY_STAR_DROPPED	Watched pd_id no longer returned for the watch key
ENERGY_STAR_MOST_EFFICIENT_GAINED	meets_most_efficient_criteria flips No → Yes
ENERGY_STAR_MOST_EFFICIENT_LOST	meets_most_efficient_criteria flips Yes → No
RUN_STATUS	Non-billable health row every successful run (FIXTURE_HEALTH / MONITOR_IDLE / …)

Unknown/null Most Efficient transitions are not billed (honest — null ≠ a clear flip).

Modes

• sourceMode=fixture (default): Store auto-test / CI. With emitFixtureDemoEvents=false (default) emits only RUN_STATUS / FIXTURE_HEALTH → 0 product charges.
• sourceMode=live: Official ENERGY STAR Model Index Socrata (no API key). SoQL pd_id in(...) batches — not a flat dump SKU.

Pricing (Model A — ADR 0010)

• energy-star-status-event-delivered @ $0.02 / unique delivered event ($20 / 1k)
• apify-actor-start @ $0.00005
• Quiet / baseline days ≈ $0 product charge

Legal

GREEN — EPA ENERGY STAR open data (data.energystar.gov); cite ENERGY STAR + retrieval date. Default product = pd_id + partner + category + brand/model + UPC + Most Efficient (product/org data).

Input

See .actor/input_schema.json. Primary field: pdIds (ENERGY STAR Unique IDs). Optional signalGroups: presence, most_efficient.

Build order

Phase 3 #39 (v14 A1b PASS #2 / GO #39). Pattern: US EPA Safer Choice / Illinois IDFPR licence portfolio status monitors.