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

> Browse and search public procurement and trading announcements from Shenzhen, including detailed information about winning bids, parties involved, and bid amounts. Access comprehensive listings, filter announcements by keywords, and retrieve full details on specific procurement transactions.

**Category:** Government & Public Data | **Website:** [szggzy.com/](https://szggzy.com/) | **Docs:** [parse.bot/marketplace/a07b3f7d-121d-4fcc-be04-d56b5a64de26/szggzy-com-api](https://parse.bot/marketplace/a07b3f7d-121d-4fcc-be04-d56b5a64de26/szggzy-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/szggzy/`
**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 announcement detail

Retrieve full details for a single announcement by its content ID, including parsed winning party name and transaction amount extracted from the announcement HTML content. Returns structured metadata (project number, project name, source) plus key-value attributes from the original notice.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `content_id` | string | Yes | Unique ID of the announcement (numeric string, from contentId in list/search results) |

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

### List results announcements

List trading result announcements (中标/成交结果公告) with pagination and category filtering. Returns paginated results sorted by publish time descending. Each page returns up to `limit` announcement summaries. The total result count is capped at 1000 by the upstream system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID (e.g., 2850 for Government Procurement/政府采购) |
| `limit` | integer | No | Number of items per page |
| `page` | integer | No | Page number (0-indexed) |
| `query` | string | No | Optional keyword search within results |

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

### Search announcements

Search for trading announcements by keyword across categories. Returns paginated results matching the query sorted by relevance. Uses the same underlying API as list_results_announcements but requires a query keyword.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID filter (e.g., 2850 for Government Procurement/政府采购) |
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page index (0-indexed) |
| `query` | string | Yes | Search keyword |

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