Gov APIbuy.nsw.gov.au ↗
Access NSW Government tender opportunities, contract award notices, and supplier hub data from buy.nsw.gov.au via a structured REST API.
What is the Gov API?
This API exposes 7 endpoints covering NSW Government procurement data from buy.nsw.gov.au, including open tender opportunities, contract award notices (CAN), and standing offer notices (SON). The list_opportunities endpoint returns paginated results filterable by keyword, opportunity type (RFT, RFQ, RFP), and sort order, while get_opportunity_details delivers full metadata, content sections, and associated file links for any individual tender by UUID.
curl -X GET 'https://api.parse.bot/scraper/bc2c3e8a-2ae7-4cf7-a718-71f6003213da/list_opportunities?page=1&sort=LastUpdated' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace buy-nsw-gov-au-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Buy NSW Government Procurement API — bounded, re-runnable."""
from parse_apis.Buy_NSW_Government_Procurement_API import (
BuyNSW, NotFoundError
)
client = BuyNSW()
# Search open tender opportunities filtered by keyword, capped at 5 items.
for opp in client.opportunities.search(query="construction", limit=5):
print(opp.title, "|", opp.agency, "|", opp.closing_date)
# Get the most recently updated opportunities as a quick snapshot.
top_opp = client.opportunities.top(limit=1).first()
if top_opp:
print(top_opp.title, top_opp.type, top_opp.category)
# Search contract award notices, capped at 3 items.
for notice in client.notices.search(query="transport", limit=3):
print(notice.title, notice.agency, notice.publish_date, notice.contract_period)
# List procurement categories and their counts.
for cat in client.categories.list(limit=5):
print(cat.label, cat.value, cat.opportunity_count)
# Get supplier hub info with typed error handling.
try:
hub = client.supplier_hubs.get()
print(hub.text[:120])
for link in hub.links[:3]:
print(link.text, link.url)
except NotFoundError as exc:
print(f"Hub not found: {exc}")
print("exercised: opportunities.search / opportunities.top / notices.search / categories.list / supplier_hubs.get")
Retrieve a paginated list of open tender opportunities. Supports filtering by keyword and opportunity type. Results are sorted by last updated date by default. Each page returns up to 8 items.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
| query | string | Search keyword to filter opportunities by title or description. |
| types | string | Comma-separated opportunity types to filter by (e.g. RFT, RFQ, RFP, EOI). |
{
"type": "object",
"fields": {
"items": "array of opportunity objects with title, opportunity_id, url, description, agency, type, category, closing_date, status",
"current_page": "integer, current page number",
"total_results": "integer, total number of matching opportunities"
},
"sample": {
"data": {
"items": [
{
"url": "https://buy.nsw.gov.au/prcOpportunity/AFA9A21A-9428-4FF9-B7A2C3D3CD29049D",
"type": "Request for tender (RFT)",
"title": "Hurstville West - Laydown Maintenance Area - Design Services",
"agency": "Transport Infrastructure Projects",
"status": "",
"category": "Professional Services (excl Consultancies)",
"description": "Transport for NSW has a requirement to engage a Contractor to provide design services.",
"closing_date": "23-Jun-2026 15:00",
"opportunity_id": "AFA9A21A-9428-4FF9-B7A2C3D3CD29049D"
}
],
"current_page": 1,
"total_results": 145
},
"status": "success"
}
}About the Gov API
Tender Opportunities
The list_opportunities endpoint returns an array of opportunity objects, each with fields including title, opportunity_id, agency, type, category, closing_date, and status. You can filter by query (keyword matching title and description), types (comma-separated values like RFT, RFQ, RFP), and page for pagination, with total_results returned alongside each response. For a zero-parameter snapshot, get_top_opportunities returns the 10 most recently updated open opportunities. To drill into a specific tender, pass its UUID to get_opportunity_details, which returns structured sections (description, scope, assessment_criteria), a details object (agency, type, category, locations), and an array of files with names and download URLs.
Contract Notices
list_notices covers both Contract Award Notices (CAN) and Standing Offer Notices (SON). Filter by noticeTypes, categories (comma-separated slugs such as building-and-property or healthcare), or a free-text query. Each notice object includes title, notice_id, agency, publish_date, and contract_period. Passing a notice UUID to get_notice_details returns the full details object, which includes estimated_amount_payable_inc_gst — useful for spend analysis.
Categories and Supplier Hub
list_opportunity_categories returns every procurement category available as a filter, with a human-readable label, a value slug, and an opportunity_count indicating how many open tenders sit in each category. This is useful for building category-driven dashboards without pre-hardcoding slugs. get_supplier_hub returns the main text content and a structured links array from the Supplier Hub landing page, covering navigation resources aimed at both suppliers and buyers.
The Gov API is a managed, monitored endpoint for buy.nsw.gov.au — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when buy.nsw.gov.au changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official buy.nsw.gov.au API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new open tenders by agency and type to automate business development alerts
- Track closing_date fields across open opportunities to surface expiring tenders before deadlines
- Aggregate estimated_amount_payable_inc_gst from contract award notices for government spend analysis
- Build a category-filtered procurement dashboard using opportunity_count from list_opportunity_categories
- Download tender documents programmatically using file URLs returned by get_opportunity_details
- Identify standing offer notice activity in specific categories like healthcare or building-and-property
- Compare contract award frequency by agency using notice publisher and type fields from list_notices
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does buy.nsw.gov.au have an official developer API?+
What does get_opportunity_details return beyond what list_opportunities provides?+
sections object with named content blocks (description, scope, assessment_criteria), a files array containing downloadable document names and URLs, and a fuller details object that includes location metadata. list_opportunities returns summary fields only — title, agency, type, category, closing_date, status.Can I filter opportunities by agency or closing date range?+
query), opportunity type (types), and procurement category (via list_opportunity_categories slugs fed to the search). Filtering by specific agency name or closing date range is not currently exposed as a dedicated parameter. The API covers keyword and type-based filtering. You can fork it on Parse and revise it to add agency-level or date-range filter parameters.Does the API cover historical closed or awarded tenders, or only active ones?+
How does pagination work across list_opportunities and list_notices?+
page parameter and return current_page and total_results in every response. There is no explicit page_size parameter — page size is fixed by the source. Divide total_results by the item count in a single response to calculate the number of pages needed to iterate the full result set.