{"tool":"tenders-search","title":"TenderGraph Search","what":"Search public tenders and procurement notices published in TED (EU Official Journal S, all EU/EEA countries plus EU-funded procurement such as Serbia): keywords, buyer country, CPV code, contracting authority, awarded supplier, notice type, publication and deadline date ranges and estimated value. Each notice normalized: title, buyer, CPV, procedure, estimated value with currency, lot deadlines, lifecycle stage, winners as published, and the official TED links.","endpoint":"https://yruz.one/api/tenders/search","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.005"},"params":[{"name":"q","required":false,"description":"keywords in the notice text, e.g. cloud software","example":"software"},{"name":"country","required":false,"description":"buyer country, ISO code (DE, DEU, RS, SRB ...)","example":"RS"},{"name":"cpv","required":false,"description":"CPV code or prefix, 2-8 digits, e.g. 72 or 72000000","example":null},{"name":"buyer","required":false,"description":"contracting authority name contains","example":null},{"name":"supplier","required":false,"description":"awarded supplier name contains (award notices)","example":null},{"name":"type","required":false,"description":"competition (calls), result (awards), change (amendments), planning (prior information) or all (default)","example":null},{"name":"published_from","required":false,"description":"date YYYY-MM-DD","example":null},{"name":"published_to","required":false,"description":"date YYYY-MM-DD","example":null},{"name":"deadline_from","required":false,"description":"date YYYY-MM-DD","example":null},{"name":"deadline_to","required":false,"description":"date YYYY-MM-DD","example":null},{"name":"value_min","required":false,"description":"estimated procedure value at least (in its own currency)","example":null},{"name":"value_max","required":false,"description":"estimated procedure value at most","example":null},{"name":"limit","required":false,"description":"notices per page, 1-50 (default 20)","example":"10"},{"name":"page","required":false,"description":"page, 1-100 (default 1)","example":null},{"name":"lang","required":false,"description":"language of titles, 2 letters (default en)","example":null}],"valid_request":{"get":"https://yruz.one/api/tenders/search?q=software&country=RS&limit=10","post":{"url":"https://yruz.one/api/tenders/search","body":{"q":"software","country":"RS","limit":"10"}}},"how_to_pay":["1. Send the request without payment: the answer is HTTP 402 with the exact price (x402 v2 in the PAYMENT-REQUIRED header, x402 v1 in the JSON body).","2. Sign one offer of \"accepts\" with an x402 client (USDC on Base eip155:8453 or on Solana mainnet; the facilitator pays the network fee).","3. Resend the identical request (same method, parameters and body) with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).","4. The answer carries the receipt in PAYMENT-RESPONSE. Any changed parameter needs a new 402."],"response_shape":{"product":"string","result":{"product":"string","task":"string","task_version":"number","api_version":"string","data":{"filters":{"q":"string","country":"string"},"order":"string","total_matching":"number","page":"number","limit":"number","next_page":"number","notices":[{"id":"string","source":"string","source_record_id":"string","notice_type":"string","form_type":"string","stage":"string","published_on":"string","title":"string","buyer":{"…":"…"},"cpv":["…"],"contract_nature":["…"],"procedure_type":"null","procedure_id":"null","place_of_performance":["…"],"estimated_value":{"…":"…"},"lot_deadlines":["…"],"links":{"…":"…"}}]},"provenance":[{"source":"string","name":"string","source_url":"string","record_urls":["string"],"retrieved_at":"string","retrieved_until":"string","served_from_cache":"boolean","licence":"string","attribution":"string"}],"data_as_of":"string","freshness_status":"string","coverage":"string","partial":"boolean","warnings":[],"usage":{"units":"number","unit":"string","records":"number","upstream_requests":"number","retries":"number","cache_hits":"number","runtime_ms":"number"}},"payment":{"payment_id":"string","transaction":"string"}},"refusals":{"400":"invalid input: the message names the field and the expected format; nothing is charged","402":"payment required, or the payment was refused (reason in \"error\"); nothing is charged","403/404":"not your item, or the asked item does not exist; nothing is charged","409/422":"not allowed right now (state or destination safety); nothing is charged","503":"a source or the payment rail is unavailable; nothing is charged, retry after Retry-After"},"mcp":{"server":"https://yruz.one/mcp/x402","payment":"params._meta[\"x402/payment\"] = PaymentPayload"},"related":{"tools":[{"tool":"tenders-deadlines","url":"https://yruz.one/api/tenders/deadlines","why":"calls closing soon","usd":"0.003","how":"https://yruz.one/api/instructions?tool=tenders-deadlines"},{"tool":"tenders-awards","url":"https://yruz.one/api/tenders/awards","why":"awarded value per currency","usd":"0.02","how":"https://yruz.one/api/instructions?tool=tenders-awards"},{"tool":"tenders-monitor","url":"https://yruz.one/api/tenders/monitor","why":"has a procedure changed","usd":"0.003","how":"https://yruz.one/api/instructions?tool=tenders-monitor"}],"more_x402_apis":{"402index":"https://402index.io","x402scan":"https://www.x402scan.com","agent402":"https://agent402.tools","x402_protocol":"https://www.x402.org"},"all_yruz_tools":"https://yruz.one/api/instructions"}}