# Constructconnect — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track construction market trends and project activity across the US and Canada by accessing national and state-level reports, industry events, and economic insights. Stay informed on the construction industry with blog content, upcoming trade shows, and real-time visibility into active project volumes.

**Category:** Business Directories | **Website:** [constructconnect.com/](https://constructconnect.com/) | **Docs:** [parse.bot/marketplace/7a52ab73-f743-4b79-8b50-ba8aaf8a2a2d/constructconnect-com-api](https://parse.bot/marketplace/7a52ab73-f743-4b79-8b50-ba8aaf8a2a2d/constructconnect-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/constructconnect/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get blog post details

Retrieve the full content of a specific blog post by its URL. Returns the title and full text content of the post.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `post_url` | string | Yes | Full URL of the blog post (e.g. from get_blog_posts results). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/constructconnect/get-blog-post-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"post_url":"<string>"}'
```

### Get blog posts

Retrieve recent blog articles from the ConstructConnect blog. Optionally filter by category tag slug. Returns post titles, URLs, and excerpts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category tag slug to filter posts (e.g. 'construction-news', 'estimating'). Omitting returns all recent posts. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/constructconnect/get-blog-posts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### Get economic insights

Retrieve construction economic reports and industry analysis links from the ConstructConnect economics resources page. Returns titles and URLs of reports and forecasts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/constructconnect/get-economic-insights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get industry events

Retrieve upcoming construction industry events and trade shows listed on the ConstructConnect events page. Returns event names, dates, and locations.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/constructconnect/get-industry-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get market report

Retrieve national market report data showing total active projects and counts by state and county. Returns aggregated project counts across all US states and counties. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/constructconnect/get-market-report \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get pricing plans

Retrieve available subscription and pricing plans from the ConstructConnect pricing page. Returns plan names and their included features.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/constructconnect/get-pricing-plans \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get projects by state

List construction projects for a specific state, sorted by most recently reported. Returns project details including name, location, type, value, description, and more. Paginates via the limit parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of projects to return (1-100). |
| `state` | string | Yes | US state name (e.g. 'utah', 'california') or 2-letter abbreviation (e.g. 'UT', 'CA'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/constructconnect/get-projects-by-state \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","state":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.