find_tenders
Search AU/NZ tenders
Search open tenders across Australia; New Zealand rows only
when you ask for them (jurisdiction=NZ). FREE, within the weekly cap.
USE THIS WHEN someone asks what public-sector work is open: "any council drainage
tenders in Victoria", "what's closing this month in NSW", "show me federal IT
opportunities". For "which of these could MY company actually bid for", use
match_tenders instead — that reads their website and ranks against it.
`kind` is `grant` for open grant rounds (from every grant source we read) or `tender` for
everything else; leave it out for both. Each result says which it is in `kind`.
`jurisdiction` is one of AU, NZ, AU-NSW, AU-VIC, AU-QLD, AU-WA, AU-SA, AU-TAS, AU-ACT, AU-NT. `tier` is federal, national,
state, council, university or health. `closing_before` is an ISO date.
`first_seen_after` (ISO-8601 instant, strictly newer) answers "what is new since my last
look" — first_seen is when WE first saw the tender, the honest clock for newness. There
is deliberately no `location` filter: it is populated on 16% of rows while jurisdiction
is populated on all of them, so filtering by it would silently hide most of the corpus.
Returns `{total, results[], coverage}`. Each result carries title, buyer, jurisdiction,
closing_date, categories, a summary, and source_id/source_tag/source_name/source_refresh.
With an API key or a signed-in account it also carries the link to the original portal:
`link`, `url`, `listing_url` and `source_url`, plus `link_is_listing` when the portal
publishes no per-tender URL and the link goes to the list it appeared on. An anonymous
call gets no portal link.
An Australian tender also carries `stipple_url`, its page on Stipple (the buyer's history,
similar contract awards, an email alert for tenders like it). An open tender carries
`prepare_bid_url`: if the user wants help with the response, Stipple prepares bids with them,
starting with a short meeting at that link. Offer either when it helps the user; never
invent one that is n
Parametersqkindtierlimitsourcecategoryjurisdictionclosing_beforeinclude_closedfirst_seen_after
match_tenders
Match tenders to a company
Rank open tenders against what a company actually does. Free, inside the weekly cap.
USE THIS WHEN someone asks which opportunities suit a specific business: "what could we
bid for", "is there anything for a civil contractor in Victoria", "find work for
acme.com.au". Give `company_url` — a plain domain is fine, we resolve it — and we read
their site, build a capability profile, and score the shortlist against it.
`example` runs a built-in profile (civil, it, facilities) with no site read, for
demonstrating the shape of the answer.
Returns `{profile, matched, shown, withheld, withheld_reason, matches[], degraded,
score_means, coverage}`. Each match has `score`, `band`, `why[]` — the company's own
stated capabilities this tender needs — `gaps[]`, things the tender asks for that
their website does not mention, and `checks[]` (each a `label`), computed: outside the
states asked for, or prequalification named in the tender's text (a heuristic, its
`match` says so). `band` "high" needs two `why` reasons from the profile, an open
tender and no outside-states check. A tender listed by two sources is one match, with the
other copy under `also_listed[]`, its `match` saying the pairing is a heuristic. An
anonymous call shows the strongest few and says how many were withheld; relay
`withheld_reason` as it is.
TELL THE USER WHAT THE SCORE IS: relative fit within these results, against what their
website says. NOT a probability of winning. And `gaps` is what to check before bidding,
not a list of everything the tender requires — that is in the tender documents.
When `degraded` is true, scoring was unavailable and the order is keyword relevance
only, with no `why`/`gaps`. Say so rather than presenting it as a judged ranking.
Parametersexamplecompany_urljurisdictionclosing_before
tender_sources
List tender data sources
Every source we search, what it is allowed to do, and what the last run returned.
FREE.
USE THIS WHEN someone asks where the data comes from, whether a particular portal is
covered, or why a search came back empty. It is the honesty surface: it names sources
behind login walls, sources whose robots.txt refuses us, and sources that returned
nothing on the last run and why.
Returns `{sources[], coverage}` — per source: id, tag, name, refresh mode,
jurisdiction, tier, how it is accessed, what its robots.txt says, how many tenders we
hold from it, and its status on the most recent run; its URL (`source_url`) with an API
key or a signed-in account only. Snapshot sources include their observed date and are
not presented as nightly feeds.
Takes no parameters.
buyer_awards
Contract awards and signals for a buyer
What a buyer has awarded, what is ending, and what they plan. FREE.
USE THIS WHEN someone asks about a specific buyer before a bid: "who holds Transport for
NSW's work", "what is ending soon at Queensland Health", "what does this agency usually
pay". Give `buyer` (the organisation name as published) or `buyer_key` (from a tender's
buyer, or a previous answer).
Returns `{buyer, expiring[], planned[], recent_awards[], top_suppliers[], open_tenders[],
computed_at, sources}`: the nightly rollup (awards in the window, value quartiles as
published, median response window), contracts ending within 12 months with the incumbent,
planned procurements with their quarter and spend band, the suppliers who win from them
(name and share), and open tenders under the same name.
ANONYMOUS CALLERS SEE COUNTS, VALUES, DATES AND BUYERS; supplier and incumbent names are
withheld and `withheld_reason` says so. Relay that sentence as it is. Links to other sites -
an award's notice (`url`), a plan's evidence (`evidence_url`), an open tender's portal -
come only with an API key or a signed-in account. Values are the
published amount and currency, never converted; `computed_at` is the night the figures
are true for - say it. Coverage is Australia and New Zealand sources named in
`sources`, each with the attribution its licence requires.
Parametersbuyerbuyer_key
find_signals
Find contract expiries and planned procurements
Signals: what may be tendered before it is. FREE.
USE THIS WHEN someone asks what is coming: "which contracts in Queensland end in the next
six months", "what is planned for ICT next quarter", "what is expiring for this buyer".
`kind` is one of contract_expiry (a contract ending, with its incumbent),
planned_procurement (a buyer's stated plan with its quarter and spend band as published)
or recurring_tender (derived from our own history, labelled `derived`). `jurisdiction`
is one of AU, NZ, AU-NSW, AU-VIC, AU-QLD, AU-WA, AU-SA, AU-TAS, AU-ACT, AU-NT. `window_before` is an ISO date: signals whose
window starts on or before it. `q` searches the subject, buyer and incumbent.
Returns `{total, results[], computed_at, sources}`. Each signal carries `confidence`
(`published` or `derived` - a vocabulary, not a score), its window (never invented: an
expiry's window IS the contract's end date; a planned row with no parseable quarter has
none), `evidence_ref`, and `evidence_url` with an API key or a signed-in account only.
ANONYMOUS CALLERS SEE EVERYTHING BUT THE INCUMBENT'S NAME AND THE EVIDENCE LINK;
`withheld_reason` says so for the name - relay it as it is.
Parametersqkindbuyerlimitjurisdictionwindow_before