# Govconwire — 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.

> Access the latest government contracting news, articles, and industry insights by browsing categories, searching stories, and discovering the most popular content. Get detailed information about companies and executives in the government contracting space, including company news and professional profiles.

**Category:** Government & Public Data | **Website:** [govconwire.com/](https://govconwire.com/) | **Docs:** [parse.bot/marketplace/be691290-17c6-4e3d-ab54-b969a525d01f/govconwire-com-api](https://parse.bot/marketplace/be691290-17c6-4e3d-ab54-b969a525d01f/govconwire-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/govconwire/`
**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 article

Retrieve the full content of an article by its slug. Returns article metadata (title, date, categories, tags) plus the full body text extracted from the HTML content. The slug is obtained from get_latest_stories, search_stories, or get_category_stories results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The article slug (e.g. 'ice-homeland-security-task-force-sole-source-trm-labs'). Obtain from get_latest_stories, search_stories, or get_category_stories results. |

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

### Get category stories

Retrieve stories for a specific category. Returns paginated results with total count and total pages. The category slug must match an existing WordPress category on the site. Each story includes metadata but not full body text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | The category slug. Confirmed working values include: 'contract-awards', 'exec-moves', 'ma-activity', 'technology', 'press-releases'. |
| `limit` | integer | No | Number of stories per page (max 100). |
| `page` | integer | No | Page number for pagination. |

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

### Get company news

Retrieve news articles tagged with a specific company. Uses WordPress tags to find company-related stories. Returns paginated results with total count and optional company metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company` | string | Yes | The company tag slug (e.g. 'leidos', 'booz-allen-hamilton'). Must match an existing tag on the site. |
| `limit` | integer | No | Number of stories per page (max 100). |
| `page` | integer | No | Page number for pagination. |

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

### Get executive profile

Retrieve profile information for a GovCon executive. Returns biographical details, company, title, and industry. The slug must correspond to an existing expert; obtain valid slugs from get_executives_list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The executive name slug (e.g. 'megin-kennett', 'chris-burton'). Obtain from get_executives_list results. |

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

### Get executives list

Retrieve a paginated list of GovCon executives available in the system. Returns name, slug, and URL for each executive. Use the slug with get_executive_profile to fetch full biographical details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of executives per page (max 100). |
| `page` | integer | No | Page number for pagination. |

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

### Get latest stories

Retrieve the latest stories from the GovConWire homepage in reverse chronological order. Returns up to 100 stories per call. Each story includes metadata (title, slug, date, excerpt, categories, tags) but not the full article body — use get_article with the slug to fetch full content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of stories to return (max 100). |

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

### Get most popular stories

Retrieve the most popular stories displayed on the GovConWire homepage sidebar. Returns a list of stories with title and URL only (no full metadata).

**Estimated cost:** Metered

_No parameters required._

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

### Search stories

Search for stories by keyword. Returns paginated results matching the query across title and body content. Results include total count for pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of stories per page (max 100). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/govconwire/search-stories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<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.