# UN Global Marketplace · Search notices

Find companies, people and contact details with UN Global Marketplace · Search notices from Alexandria through one Spiral API key. Start here to find open UN tenders by keyword, agency (e.g. `UNDP`), country or deadline window; pass a row's `notice_id` to get_notice for the full notice with description, contacts, links and UNSPSC codes. Use search_unspsc to find UNSPSC node ids for the `unspsc_ids` filter. 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` / `ungm-org/public-tenders/search_notices`
- Page: https://spiral.ai/tools/alexandria/ungm-org/public-tenders/search_notices

## 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 |
| --- | --- | --- | --- | --- |
| `page` | number | 1 to 1000 | 1 | 1-based page of 15 rows; `next_page` in the output gives the next one. |
| `sort` | one of | deadline_asc, deadline_desc, published_desc, published_asc | deadline_asc | Sort order. Default: soonest deadline first, as on the site. |
| `title` | text |  | — | Text the notice title must contain (the site's Title filter). |
| `agencies` | list |  | — | Publishing UN organizations: an abbreviation as shown on UNGM (`UNDP`, `UNICEF`, `WFP`, case-insensitive) or a numeric UNGM agency id (`1` = UNDP). Resolved against the search page's organization list; an unknown value is invalid_input. |
| `countries` | list |  | — | Beneficiary countries or territories: the English name as listed on UNGM (`Kenya`, `Lao People's Democratic Republic`, case-insensitive) or a numeric UNGM country id (`2403`). An unknown value is invalid_input. |
| `reference` | text |  | — | Agency reference text, e.g. `UNDP-LAO-00748`. |
| `unspsc_ids` | list |  | — | UNSPSC node ids (`node_id` from search_unspsc, not the 8-digit UNSPSC code). |
| `deadline_to` | text |  | — | Latest deadline date, ISO `YYYY-MM-DD`. Pattern: ^\d{4}-\d{2}-\d{2}$. |
| `description` | text |  | — | Text the notice description must contain. |
| `notice_types` | list |  | — | Types of opportunity, the site's enum values. |
| `published_to` | text |  | — | Latest publication date, ISO `YYYY-MM-DD` (inclusive). Pattern: ^\d{4}-\d{2}-\d{2}$. |
| `deadline_from` | text |  | — | Earliest deadline date, ISO `YYYY-MM-DD`. The site's own default search uses today's date here; when omitted, no lower bound is sent. Pattern: ^\d{4}-\d{2}-\d{2}$. |
| `published_from` | text |  | — | Earliest publication date, ISO `YYYY-MM-DD` (inclusive). Pattern: ^\d{4}-\d{2}-\d{2}$. |
| `include_expired` | true or false |  | — | `true` also returns notices whose deadline has passed (the site's IsActive=false). Default: active notices only. |

## 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": "ungm-org/public-tenders/search_notices",
    "input": {
      "page": 1
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=ungm-org%2Fpublic-tenders%2Fsearch_notices

## Common questions

### UN Global Marketplace · Search notices

**How much does UN Global Marketplace · Search notices 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 UN Global Marketplace · Search notices through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "ungm-org/public-tenders/search_notices"` 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 UN Global Marketplace · Search notices?**

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

**Can my AI agent use UN Global Marketplace · Search notices?**

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

