# Alberta Purchasing Connection · Search postings

Find companies, people and contact details with Alberta Purchasing Connection · Search postings from Alexandria through one Spiral API key. Discover tenders, notices and awards; take `reference_number` into `get_posting`. Use `list_codes`, `list_organizations` and `search_unspsc_codes` to find valid filter values. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `purchasing-alberta-ca/public-tenders/search_postings`
- Page: https://spiral.ai/tools/alexandria/purchasing-alberta-ca/public-tenders/search_postings

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | text |  | — | Free text matched against titles, descriptions and solicitation numbers (e.g. 'wildfire', '935775'). Omit or leave blank to list everything. |
| `cursor` | text |  | — | Continuation from a previous call's next_cursor (the 0-based page index). Use the same filters and page_size. Pattern: ^[0-9]{1,6}$. |
| `sort_by` | one of | post_date, close_date | post_date | Sort field (the only two the site offers). |
| `statuses` | list |  | — | Status codes from list_codes('opportunity-status'): OPEN, CLOSED, EVALUATION, SELECTION, AWARD, CANCELLED, UNAWARDABLE, EXPIRED. |
| `page_size` | number | 1 to 100 | 20 | Rows per page. |
| `categories` | list |  | — | Category codes from list_codes('opportunity-category'): SRV (services), GD (goods), CNST (construction). |
| `query_mode` | one of | standard, enhanced | standard | 'standard' is the site's default keyword search; 'enhanced' adds the site's semantic matching (more, looser results). |
| `post_date_to` | text |  | — | Latest post date (inclusive), YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `unspsc_codes` | list |  | — | 8-digit UNSPSC codes as strings (segment, family, class or commodity level), e.g. '77000000'. See search_unspsc_codes. |
| `close_date_to` | text |  | — | Latest close date (inclusive), YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `organizations` | list |  | — | Contracting organization display names exactly as the site spells them (facet values or list_organizations names), e.g. 'City of Calgary'. |
| `include_facets` | true or false |  | — | Return facet counts (status, category, organization, region, solicitation/opportunity/agreement type, UNSPSC) for the filtered result set. Organization and UNSPSC facets can be several hundred rows. |
| `post_date_from` | text |  | — | Earliest post date (inclusive), YYYY-MM-DD, Alberta local date. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `sort_direction` | one of | asc, desc | desc | sort_direction |
| `agreement_types` | list |  | — | Trade agreement codes from list_codes('trade-agreement'), e.g. TA-01 (not applicable), APC-TA-NWPTA. |
| `close_date_from` | text |  | — | Earliest close date (inclusive), YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `delivery_regions` | list |  | — | Region of delivery display names (facet values or list_codes('region-of-delivery') display values), e.g. 'Edmonton', 'Alberta'. |
| `opportunity_types` | list |  | — | Posting type codes from list_codes('opportunity-posting-type'): OPEN-COMPETITIVE, LIMITED, NOTICE, INFORMATIONAL, UNDER-THRESHOLD, LIMITED-UNDER-THRESHOLD. |
| `solicitation_types` | list |  | — | Solicitation type codes from list_codes('opportunity-solicitation-type'): RFP, ITB, RFQ, NRFP, NOA, ACAN, RFEI, NOI, NOS, NPP, SOW, PQR, RFQual, APC-NA. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "purchasing-alberta-ca/public-tenders/search_postings",
    "input": {
      "query": "<query>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=purchasing-alberta-ca%2Fpublic-tenders%2Fsearch_postings

## Common questions

### Alberta Purchasing Connection · Search postings

**How much does Alberta Purchasing Connection · Search postings cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Alberta Purchasing Connection · Search postings through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "purchasing-alberta-ca/public-tenders/search_postings"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Alberta Purchasing Connection · Search postings?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Alberta Purchasing Connection · Search postings?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

