ConstructConnect APIconstructconnect.com ↗

"""Walkthrough: ConstructConnect SDK — construction project data and market insights."""
from parse_apis.constructconnect_api import ConstructConnect, State_, StateNotFound

client = ConstructConnect()

# Get the national market report — singleton fetch, no params needed.
report = client.marketreports.get()
print(f"Total active projects: {report.total_active_projects}")
print(f"States tracked: {len(report.states)}, Counties tracked: {len(report.counties)}")

# List projects for a specific state using constructible State resource.
for project in client.state(State_.UTAH).projects(limit=3):
    print(f"  {project.name} | {project.city}, {project.state} | {project.primary_project_type}")

# Browse blog posts, then drill into the first one for full content.
post = client.blogposts.list(limit=1).first()
if post:
    detail = post.details()
    print(f"Blog: {detail.title}")
    print(f"  Content preview: {detail.content[:120]}...")

# Upcoming industry events.
for event in client.events.list(limit=3):
    print(f"Event: {event.name} — {event.date}, {event.location}")

# Economic insights and pricing plans.
for insight in client.insights.list(limit=2):
    print(f"Insight: {insight.title} -> {insight.url}")

for plan in client.pricingplans.list(limit=3):
    print(f"Plan: {plan.name} — {len(plan.features)} features")

# Typed error handling for an invalid state.
try:
    for p in client.state("invalidstate").projects(limit=1):
        print(p.name)
except StateNotFound as exc:
    print(f"State not found: {exc.state}")

print("Exercised: marketreports.get / state.projects / blogposts.list / post.details / events.list / insights.list / pricingplans.list")