Tendersight API
Δεδομένα διαγωνισμών για τα συστήματά σαςκαι τους πράκτορές σας.
Αναζητήστε προκηρύξεις και διαβάστε τα έγγραφα, τις προσφορές και τις αναθέτουσες αρχές τους από το δικό σας λογισμικό, μέσω ενός API. Οι κλήσεις χρησιμοποιούν τις ίδιες πιστώσεις με την εφαρμογή.
curl https://api.tendersight.ai/v1/notices/search \
-H "Authorization: Bearer $TENDERSIGHT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filters": {
"searchText": "lift maintenance",
"contractTypes": ["services"],
"buyer": { "countries": ["AUT", "DEU"] },
"deadline": { "from": "2026-11-16T00:00:00Z" },
"estimatedValue": { "min": 250000 }
},
"pageSize": 20
}'{
"items": [
{
"key": "not_01kf3m8q2vx7d9hk4tz6rbn5cw",
"title": "Maintenance of lifts in federal buildings, 3 lots",
"publicationDate": "2026-11-03T08:00:00+00:00",
"estimatedValue": {
"minAmount": null,
"maxAmount": 1800000,
"currency": "EUR",
"minAmountEur": null,
"maxAmountEur": 1800000
},
"buyers": [
{
"organizationKey": "org_01jz8r5t2kw4n6p9c3x7v1hmqd",
"name": "Federal property agency",
"country": "AUT",
"fiscalId": "ATU12345678"
}
],
"milestones": [
{
"type": "deadline",
"name": "Time limit for receipt of tenders",
"date": "2026-12-01T10:00:00+00:00"
}
],
"contractType": "services",
"primaryCpv": {
"code": "50750000-7",
"description": "Lift-maintenance services"
},
"biddability": "biddable",
"nextDeadlineAt": "2026-12-01T10:00:00+00:00"
}
],
"continuationToken": "eyJhZnRlciI6WzEuOTQs…",
"totalCount": 23
}Προκηρύξεις από 28+ επίσημες πηγές
REST και MCP με ένα κλειδί
Πιστώσεις ανά κλήση, σε κάθε πακέτο
Οι προκηρύξεις που διαβάζει η ομάδα σας στο Tendersight, παραδομένες στο CRM σας, στην αποθήκη δεδομένων σας ή στον δικό σας πράκτορα.
Το API διαβάζει το ίδιο ευρετήριο με το Tendersight Leads. Χρησιμοποιήστε το για να τροφοδοτήσετε ένα pipeline πωλήσεων, να εμπλουτίσετε τις εγγραφές αγοραστών και προμηθευτών ή να δώσετε σε έναν πράκτορα τη δική του αναζήτηση διαγωνισμών.
Τι επιστρέφει το API.
Έξι είδη δεδομένων, σε 9 endpoints.
Αναζήτηση προκηρύξεων
Φιλτράρετε κατά κείμενο, κωδικό CPV, χώρα και περιφέρεια της αναθέτουσας αρχής, εκτιμώμενη αξία σε ευρώ, προθεσμία, ημερομηνία δημοσίευσης και τύπο προκήρυξης.
Στοιχεία προκήρυξης
Μία προκήρυξη με βάση το κλειδί της, με τις αναθέτουσες αρχές, την εκτιμώμενη αξία, τις προθεσμίες, τα κριτήρια ανάθεσης, τον κωδικό CPV και την κατάσταση της διαδικασίας.
Έγγραφα διαγωνισμού
Η λίστα με τα έγγραφα μιας προκήρυξης και κάθε αρχείο, με λήψη μέσω του API.
Προσφορές και ανάδοχοι
Ποιος υπέβαλε προσφορά σε μια προκήρυξη, η αξία κάθε προσφοράς και ποιος κέρδισε, όπου η πηγή τα δημοσιεύει.
Αγοραστές και προμηθευτές
Αναζητήστε τους αγοραστές που έχουν δημοσιεύσει προκηρύξεις με οποιοδήποτε μέρος της επωνυμίας ή με το φορολογικό τους αναγνωριστικό. Κάθε αγοραστής ή προμηθευτής εντοπίζεται με το φορολογικό του αναγνωριστικό ή το κλειδί του.
Μεταδεδομένα φίλτρων
Οι τιμές φίλτρων που δέχεται η αναζήτηση και πόσες προκηρύξεις περιέχει η καθεμία. Αυτή η κλήση δεν χρησιμοποιεί πιστώσεις.
Από την εγγραφή στην πρώτη σας κλήση.
Ένας λογαριασμός, ένα κλειδί και μία κεφαλίδα. Η τεκμηρίωση του API περιγράφει κάθε endpoint, πεδίο και σφάλμα.
01
Δημιουργήστε δωρεάν λογαριασμό
Εγγραφείτε δωρεάν. Κάθε πακέτο περιλαμβάνει το API και οι κλήσεις αντλούν από τις ίδιες πιστώσεις με το υπόλοιπο Tendersight.
02
Δημιουργήστε κλειδί API
Ένας κάτοχος της ομάδας ανοίγει την ενότητα των κλειδιών API στις ρυθμίσεις της ομάδας, δίνει όνομα στο κλειδί και επιλέγει τα δικαιώματα πρόσβασής του. Το κλειδί εμφανίζεται μία φορά, οπότε φυλάξτε το με ασφάλεια.
03
Κάντε την πρώτη σας κλήση
Στείλτε το κλειδί ως token Bearer. Ξεκινήστε με μια αναζήτηση προκηρύξεων και μετά ανοίξτε τις προκηρύξεις, τα έγγραφα και τις προσφορές που επιστρέφει.
- Έλεγχος ταυτότητας
Authorization: Bearer tsk_live_…Στείλτε το κλειδί σε κάθε κλήση. Παύει να λειτουργεί μόλις ανακληθεί.
- Δικαιώματα πρόσβασης
notices:readdocuments:readawards:readorganizations:readΈνα κλειδί έχει μόνο τα δικαιώματα πρόσβασης που επιλέγετε. Μια κλήση εκτός αυτών λαμβάνει 403.
- Σελιδοποίηση
continuationTokenΜια αναζήτηση επιστρέφει έως 100 προκηρύξεις ανά σελίδα και ένα token για την επόμενη. Στείλτε πίσω το token για να συνεχίσετε.
- Όρια αιτημάτων
429Retry-AfterΑπό προεπιλογή, 10 αιτήματα το δευτερόλεπτο και 100.000 την ημέρα ανά κλειδί. Πέρα από το όριο, το API απαντά 429 και δείχνει πότε να δοκιμάσετε ξανά.
- Σφάλματα
application/problem+jsonΛεπτομέρειες προβλήματος σε JSON: 401 για κλειδί που λείπει, είναι άγνωστο ή έχει ανακληθεί, 402 όταν οι πιστώσεις της ομάδας δεν καλύπτουν την κλήση, 403 για δικαίωμα πρόσβασης που λείπει, 429 για υπερβολικά πολλά αιτήματα.
- Πιστώσεις
X-Credits-ChargedX-RateLimit-RemainingΚάθε απάντηση δείχνει πόσες πιστώσεις χρησιμοποίησε η κλήση και πόσα αιτήματα απομένουν. Πιστώσεις χρησιμοποιούν μόνο οι επιτυχείς κλήσεις.
Πληρωμή ανά κλήση, σε πιστώσεις.
Οι κλήσεις αντλούν από το υπόλοιπο πιστώσεων της ομάδας σας, το ίδιο που χρησιμοποιεί το Flow στην εφαρμογή. Στο Team, 1.000 πιστώσεις κοστίζουν 2,50 €. Ένας δωρεάν λογαριασμός παίρνει 2.000 πιστώσεις με την εγγραφή.
Δείτε πακέτα και τιμές| Κλήση | Πιστώσεις ανά κλήση |
|---|---|
Αναζήτηση προκηρύξεων POST /v1/notices/search | 2 |
Μία προκήρυξη GET /v1/notices/{noticeKey} | 1 |
Λίστα εγγράφων μιας προκήρυξης GET /v1/notices/{noticeKey}/documents | 1 |
Λήψη ενός εγγράφου GET /v1/notices/{noticeKey}/documents/{documentId} | 5 |
Οι προσφορές μιας προκήρυξης GET /v1/notices/{noticeKey}/bids | 5 |
Αναζήτηση αγοραστών GET /v1/buyers?query=&limit= | 1 |
Αναζήτηση αγοραστών ή προμηθευτών με φορολογικό αναγνωριστικό GET /v1/organizations?fiscalId=&limit= | 1 |
Ένας αγοραστής ή προμηθευτής GET /v1/organizations/{organizationKey} | 1 |
Οι τιμές φίλτρων της αναζήτησης GET /v1/meta/filters | 0 |
Πιστώσεις χρησιμοποιούν μόνο οι επιτυχείς κλήσεις.
Τα ίδια δεδομένα για τους πράκτορές σας, μέσω MCP.
Συνδέστε οποιονδήποτε client MCP στον διακομιστή της Tendersight με το ίδιο κλειδί. Τα εργαλεία ακολουθούν τα endpoints του REST και χρησιμοποιούν τα ίδια δικαιώματα πρόσβασης και τις ίδιες πιστώσεις.
{
"mcpServers": {
"tendersight": {
"url": "https://api.tendersight.ai/mcp",
"headers": {
"Authorization": "Bearer tsk_live_…"
}
}
}
}- search_noticesΑναζήτηση προκηρύξεων με τα ίδια φίλτρα όπως στο API
- get_noticeΑνάγνωση μίας προκήρυξης
- list_notice_documentsΛίστα με τα έγγραφα μιας προκήρυξης
- list_notice_bidsΛίστα με τις προσφορές μιας προκήρυξης
- search_buyersΕύρεση αγοραστών με επωνυμία ή φορολογικό αναγνωριστικό
- get_organizationΑνάγνωση ενός αγοραστή ή προμηθευτή
- search_organizationsΕύρεση αγοραστών και προμηθευτών με φορολογικό αναγνωριστικό
Σχετικά
Δεδομένα διαγωνισμών
Συνδέσεις
Πακέτα
Ερωτήσεις για το Tendersight API
Ποιους διαγωνισμούς καλύπτει το API;
Τις ίδιες προκηρύξεις με το Tendersight Leads: δημόσιους διαγωνισμούς από 28+ επίσημες πηγές, με τα έγγραφά τους, τους αγοραστές και τους προμηθευτές που εμπλέκονται και, όπου η πηγή τα δημοσιεύει, τις προσφορές και τους αναδόχους.
Πόσο κοστίζει μια κλήση;
Κάθε επιτυχής κλήση χρησιμοποιεί από 0 έως 5 πιστώσεις από το υπόλοιπο της ομάδας σας, ανάλογα με το endpoint. Ο πίνακας σε αυτή τη σελίδα περιλαμβάνει κάθε endpoint, και οι αποτυχημένες κλήσεις δεν χρησιμοποιούν καμία.
Μπορώ να δοκιμάσω το API δωρεάν;
Ναι. Το API υπάρχει σε κάθε πακέτο, και στο Δωρεάν. Ένας δωρεάν λογαριασμός παίρνει 2.000 πιστώσεις με την εγγραφή, και οι κλήσεις API αντλούν από αυτές όπως και το υπόλοιπο Tendersight.
Ποια είναι τα όρια αιτημάτων;
Από προεπιλογή, 10 αιτήματα το δευτερόλεπτο και 100.000 την ημέρα ανά κλειδί. Πέρα από το όριο, το API απαντά 429 με κεφαλίδα Retry-After, και οι απαντήσεις περιέχουν τις κεφαλίδες X-RateLimit-Limit και X-RateLimit-Remaining.
Πόσο ενημερωμένα είναι τα δεδομένα;
Κάθε κλήση διαβάζει το ίδιο ευρετήριο στο οποίο αναζητά η εφαρμογή Tendersight, και αυτό το ευρετήριο ενημερώνεται καθημερινά από τις επίσημες πηγές.
Ποιος μπορεί να δημιουργεί και να ανακαλεί κλειδιά API;
Οι κάτοχοι της ομάδας, στις ρυθμίσεις της ομάδας. Κάθε κλειδί έχει όνομα και δικά του δικαιώματα πρόσβασης, εμφανίζεται μία φορά κατά τη δημιουργία του και παύει να λειτουργεί μόλις ανακληθεί.
Δημιουργήστε ένα κλειδί και κάντε την πρώτη σας κλήση.
Ξεκινήστε δωρεάν, δημιουργήστε κλειδί API στις ρυθμίσεις της ομάδας και ακολουθήστε την τεκμηρίωση του API.