# Szggzy — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-szggzy-com-api-a07b3f7d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-szggzy-com-api-a07b3f7d/get_announcement_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-szggzy-com-api-a07b3f7d/list_results_announcements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-szggzy-com-api-a07b3f7d/search_announcements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","limit":"<integer>","page":"<integer>","query":"<string>"}'
```