Tools (5)

search_tenders
get_tender
get_awarded_contracts
search_by_winner
report_feedback

search_tenders

Search active public procurement notices (tenders) across EU, UK, and US sources.

Args:
query: Full-text search term (e.g. "software development", "road construction").
country: ISO 3166-1 alpha-2 country code to restrict search (e.g. "DE", "NO", "GB", "US").
Omit to search all EU countries via TED.
sector_cpv: CPV code prefix to filter by sector (e.g. "72000000" for IT services).
Only applied for EU/TED searches.
date_from: ISO 8601 date (YYYY-MM-DD) — only return notices published on or after this date.
value_min_eur: Minimum estimated contract value in EUR.
limit: Maximum number of results to return (1-50, default 10).

Returns:
List of tender notices with title, contracting authority, country, deadline,
estimated value, CPV codes, and source URL.

Parameter	Type	Required	Description
`query`	`string`	required	Full-text search term (e.g. "software development", "road construction").
`country`	`any`	optional	ISO 3166-1 alpha-2 country code to restrict search (e.g. "DE", "NO", "GB", "US"). Omit to search all EU countries via TED.
`sector_cpv`	`any`	optional	CPV code prefix to filter by sector (e.g. "72000000" for IT services). Only applied for EU/TED searches.
`date_from`	`any`	optional	ISO 8601 date (YYYY-MM-DD) — only return notices published on or after this date.
`value_min_eur`	`any`	optional	Minimum estimated contract value in EUR.
`limit`	`integer`	optional	Maximum number of results to return (1-50, default 10). (default: 10)

Request Body

{
  "query": "example"
}

get_tender

Get full details for a specific EU TED procurement notice by document number.

Args:
notice_id: TED notice document number (e.g. "123456-2024").
Retrieve this from search_tenders results.

Returns:
Full notice details including title, contracting authority, country,
published date, deadline, estimated value, CPV codes, and source URL.

Parameter	Type	Required	Description
`notice_id`	`string`	required	TED notice document number (e.g. "123456-2024"). Retrieve this from search_tenders results.

Request Body

{
  "notice_id": "123456789"
}

get_awarded_contracts

Get recently awarded public contracts from EU TED, UK Find a Tender, or US SAM.gov.

Args:
country: ISO 3166-1 alpha-2 country code (e.g. "DE", "NO", "GB", "US").
Omit for all EU countries.
sector_cpv: CPV code prefix to filter by sector. Only applied for EU/TED searches.
year: Calendar year to filter awards. Omit for most recent.
limit: Maximum number of results to return (1-50, default 10).

Returns:
List of awarded contracts with contracting authority, winner (where available),
value, award date, country, and CPV codes.

Parameter	Type	Required	Description
`country`	`any`	optional	ISO 3166-1 alpha-2 country code (e.g. "DE", "NO", "GB", "US"). Omit for all EU countries.
`sector_cpv`	`any`	optional	CPV code prefix to filter by sector. Only applied for EU/TED searches.
`year`	`any`	optional	Calendar year to filter awards. Omit for most recent.
`limit`	`integer`	optional	Maximum number of results to return (1-50, default 10). (default: 10)

Request Body

{
  "query": "example"
}

search_by_winner

Find public contracts won by a named company.

Args:
company_name: Company name to search for (e.g. "Accenture", "IBM").
country: ISO 3166-1 alpha-2 country code to restrict search.
year_from: Start year for award date filter (inclusive).
year_to: End year for award date filter (inclusive).
limit: Maximum number of results to return (1-50, default 10).

Returns:
List of award notices where the winner name matches the query.

Parameter	Type	Required	Description
`company_name`	`string`	required	Company name to search for (e.g. "Accenture", "IBM").
`country`	`any`	optional	ISO 3166-1 alpha-2 country code to restrict search.
`year_from`	`any`	optional	Start year for award date filter (inclusive).
`year_to`	`any`	optional	End year for award date filter (inclusive).
`limit`	`integer`	optional	Maximum number of results to return (1-50, default 10). (default: 10)

Request Body

{
  "company_name": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/global-tenders/search_tenders" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"query": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/global-tenders/search_tenders",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())