Τεκμηρίωση API BizList.gr

Καλώς ήρθατε στην τεκμηρίωση του API του BizList.gr. Αυτό το API παρέχει προγραμματιστική πρόσβαση σε δεδομένα ελληνικών επιχειρήσεων, συμπεριλαμβανομένων πληροφοριών εταιρειών, οικονομικών στοιχείων, προσώπων και δραστηριοτήτων.

Ξεκινώντας

Για να χρησιμοποιήσετε το API του BizList.gr, θα χρειαστείτε ένα API key. Ακολουθήστε τα παρακάτω βήματα:

Δημιουργήστε λογαριασμό ή συνδεθείτε στο bizlist.gr
Μεταβείτε στη σελίδα Λογαριασμός
Βρείτε την ενότητα "API Keys"
Κάντε κλικ στο "Δημιουργία Νέου API Key" και δώστε του ένα περιγραφικό όνομα
Αντιγράψτε το API key αμέσως - δεν θα μπορείτε να το δείτε ξανά!

Σημείωση: Μπορείτε να δημιουργήσετε έως 5 API keys ανά λογαριασμό. Κάθε key μπορεί να ανακληθεί ανεξάρτητα.

Αυθεντικοποίηση

Όλα τα API requests πρέπει να αυθεντικοποιούνται χρησιμοποιώντας το API key σας στο header:

X-API-Key: your_api_key_here

Παράδειγμα Request

curl https://bizlist.gr/api/v1/companies/gr/200000000000 \
  -H "X-API-Key: your_api_key_here"

Ασφάλεια: Κρατήστε τα API keys σας ασφαλή. Μην τα κάνετε commit σε version control ή μην τα μοιράζεστε δημόσια.

Όρια & Credits

Κάθε επιτυχημένη κλήση API (200 OK response) καταναλώνει 1 API credit από τον λογαριασμό σας.

Τα API credits αφαιρούνται πρώτα από τα προσωπικά σας credits, μετά από τα credits του οργανισμού (αν υπάρχει)
Ελέγξτε το υπόλοιπο credits στη σελίδα Λογαριασμός
Δεν χρεώνονται credits για αποτυχημένα requests (4xx, 5xx errors)

Endpoints που δεν καταναλώνουν Credits

Τα παρακάτω endpoints δεν καταναλώνουν API credits:

User info endpoint (/api/v1/user)
Export endpoints (/api/v1/export/leads/*)

API Endpoints

Αναζήτηση Εταιρειών

GET /api/v1/search

Αναζήτηση εταιρειών με βάση επωνυμία, ΑΦΜ ή άλλα κριτήρια.

Query Parameters

`query`	string	Ερώτημα αναζήτησης (επωνυμία, ΑΦΜ, κλπ.)
`count`	number	Αριθμός αποτελεσμάτων (default: 30)
`page`	number	Αριθμός σελίδας για pagination (default: 1)

Παράδειγμα Response

{
  "results": [
    {
      "type": "company",
      "id": 12345,
      "vat": "EL123456789",
      "ar_gemh": 100000000000,
      "name": "EXA... AUTOMATION SERVICES Ι.Κ.Ε.",
      "namei18n": "EXA... AUTOMATION SERVICES I.K.E.",
      "status": 1,
      "legal_type": {"name": "ΙΚΕ", "name_i18n": "Private Company", "abbr_i18n": "PC"},
      "region": "ΑΘΗ...",
      "city": "ΑΘΗ..."
    }
  ],
  "total_count": 2
}

Λήψη Εταιρείας με Αριθμό Μητρώου

GET /api/v1/companies/:country/:ar_gemh

Λήψη λεπτομερών πληροφοριών εταιρείας χρησιμοποιώντας τον κωδικό χώρας και τον αριθμό μητρώου.

URL Parameters

`country`	string	Κωδικός χώρας (gr, cy, ie, bg)
`ar_gemh`	string	Αριθμός μητρώου εταιρείας

Query Parameters

update boolean Ορίστε true για ανανέωση δεδομένων από την πηγή (προαιρετικό)

Παράδειγμα Response

{
  "id": 98765,
  "vat": "EL987654321",
  "ar_gemh": 200000000000,
  "name": "EXA... COMPANY Ι.Κ.Ε.",
  "namei18n": "EXA... COMPANY I.K.E.",
  "status": 1,
  "date_start": "2020-01-15 00:00:00",
  "legal_type": {"name": "ΙΚΕ", "name_i18n": "Private Company", "abbr_i18n": "PC"},
  "region": "ΑΘΗ...",
  "city": "ΑΘΗ...",
  "municipality": "ΑΘΗ... / ΑΘΗ...",
  "zip_code": "10000",
  "street": "ΠΑΝ...",
  "street_number": "12",
  "website": "www.exa...com",
  "email": "inf...@exa...com",
  "phone": "210123...",
  "email_is_accountant": 0,
  "phone_is_accountant": 0,
  "chamber": null,
  "last_update": "2025-11-20 10:00:00",
  "data_source": "Γενικό Εμπορικό Μητρώο",
  "registration_suspended": 0,
  "objective": "Η σχε..., κατ..., ανά..., εισ..., εξα..., εκμ... και εμπ... ηλε... και ηλε... συσ...",
  "activities": [
    {
      "activity": 123,
      "is_main": 1,
      "id": 123,
      "code": "62011200",
      "description": "ΥΠΗ... ΣΧΕ... ΚΑΙ ΑΝΑ... ΤΕΧ... ΤΗΣ ΠΛΗ... ΓΙΑ ΔΙΚ... ΚΑΙ ΣΥΣ..."
    }
  ],
  "titles": ["EXA... CO."],
  "people": [
    {
      "person": {
        "id": 54321,
        "vat": "EL111222333",
        "first_name": "ΓΙΑ...",
        "last_name": "ΠΑΠ...",
        "is_company": 0
      },
      "company": 98765,
      "date_from": "2020-01-15T00:00:00.000Z",
      "date_to": null,
      "is_active": 1,
      "capacity": "Μέλος & Διαχειριστής",
      "percentage": "100.00000"
    }
  ],
  "documents": [
    {
      "id": 11111,
      "name": "B5 2024",
      "period_start": "2024-01-01T00:00:00.000Z",
      "period_end": "2024-12-31T00:00:00.000Z",
      "upload_time": "2025-01-15T10:00:00.000Z",
      "filename": "~/uploads/00/200000000000/B5 2024.pdf",
      "url": "https://publicity.businessportal.gr/api/download/financial/1234567?companyId=200000000000",
      "balance_sheet_id": 99999
    }
  ],
  "financials": [],
  "related_companies": [],
  "public_debtor": [],
  "connected_public_debtors": [],
  "is_authenticated": false
}

Λήψη Εταιρείας με ΑΦΜ

GET /api/v1/companies/by-vat/:vat_id

Λήψη λεπτομερών πληροφοριών εταιρείας χρησιμοποιώντας το ΑΦΜ. Το ΑΦΜ μπορεί να δοθεί με ή χωρίς το πρόθεμα "EL".

URL Parameters

vat_id string ΑΦΜ εταιρείας (με ή χωρίς πρόθεμα "EL")

Query Parameters

update boolean Ορίστε true για ανανέωση δεδομένων από την πηγή (προαιρετικό)

Παράδειγμα Response

{
  "id": 98765,
  "vat": "",
  "ar_gemh": 200000000000,
  "name": "EXA... COMPANY Ι.Κ.Ε.",
  "namei18n": "EXA... COMPANY I.K.E.",
  "status": 1,
  "date_start": "2020-01-15 00:00:00",
  "legal_type": {"name": "ΙΚΕ", "name_i18n": "Private Company", "abbr_i18n": "PC"},
  "region": "ΑΘΗ...",
  "city": "ΑΘΗ...",
  "municipality": "ΑΘΗ... / ΑΘΗ...",
  "zip_code": "10000",
  "street": "ΠΑΝ...",
  "street_number": "12",
  "website": "www.exa...com",
  "email": "inf...@exa...com",
  "phone": "210123...",
  "email_is_accountant": 0,
  "phone_is_accountant": 0,
  "chamber": null,
  "last_update": "2025-11-20 10:00:00",
  "data_source": "Γενικό Εμπορικό Μητρώο",
  "registration_suspended": 0,
  "objective": "Η σχε..., κατ..., ανά..., εισ..., εξα..., εκμ... και εμπ... ηλε... και ηλε... συσ...",
  "activities": [
    {
      "activity": 123,
      "is_main": 1,
      "id": 123,
      "code": "62011200",
      "description": "ΥΠΗ... ΣΧΕ... ΚΑΙ ΑΝΑ... ΤΕΧ... ΤΗΣ ΠΛΗ... ΓΙΑ ΔΙΚ... ΚΑΙ ΣΥΣ..."
    }
  ],
  "titles": ["EXA... CO."],
  "people": [
    {
      "person": {
        "id": 54321,
        "vat": "EL111222333",
        "first_name": "ΓΙΑ...",
        "last_name": "ΠΑΠ...",
        "is_company": 0
      },
      "company": 98765,
      "date_from": "2020-01-15T00:00:00.000Z",
      "date_to": null,
      "is_active": 1,
      "capacity": "Μέλος & Διαχειριστής",
      "percentage": "100.00000"
    }
  ],
  "documents": [
    {
      "id": 11111,
      "name": "B5 2024",
      "period_start": "2024-01-01T00:00:00.000Z",
      "period_end": "2024-12-31T00:00:00.000Z",
      "upload_time": "2025-01-15T10:00:00.000Z",
      "filename": "~/uploads/00/200000000000/B5 2024.pdf",
      "url": "https://publicity.businessportal.gr/api/download/financial/1234567?companyId=200000000000",
      "balance_sheet_id": 99999
    }
  ],
  "financials": [],
  "related_companies": [],
  "public_debtor": [],
  "connected_public_debtors": [],
  "is_authenticated": false
}

Λήψη Στοιχείων Προσώπου

GET /api/v1/people/:person_id

Λήψη πληροφοριών προσώπου με βάση το ID του.

URL Parameters

person_id number Μοναδικό αναγνωριστικό προσώπου

Παράδειγμα Response

{
  "id": 54321,
  "vat": "EL111222333",
  "first_name": "ΓΙΑ...",
  "last_name": "ΠΑΠ...",
  "is_company": 0,
  "companies": [
    {
      "person": 54321,
      "company": 98765,
      "date_from": "2020-01-15T00:00:00.000Z",
      "date_to": null,
      "is_active": true,
      "capacity": "Μέλος & Διαχειριστής",
      "percentage": "100.00000",
      "id": 98765,
      "vat": "",
      "ar_gemh": 200000000000,
      "name": "EXA... COMPANY Ι.Κ.Ε.",
      "namei18n": "EXA... COMPANY I.K.E.",
      "status": 1,
      "date_start": "2020-01-15 00:00:00",
      "legal_type": {"name": "ΙΚΕ", "name_i18n": "Private Company", "abbr_i18n": "PC"},
      "region": "ΑΘΗ...",
      "city": "ΑΘΗ...",
      "municipality": "ΑΘΗ... / ΑΘΗ...",
      "zip_code": "10000",
      "street": "ΠΑΝ...",
      "street_number": "12",
      "website": "www.exa...com",
      "email": "inf...@exa...com",
      "phone": "210123...",
      "email_is_accountant": 0,
      "phone_is_accountant": 0,
      "chamber": 1,
      "last_update": "2025-11-20 10:00:00",
      "data_source": "Γενικό Εμπορικό Μητρώο",
      "registration_suspended": 0,
      "activities": [
        {
          "activity": 123,
          "is_main": 1,
          "id": 123,
          "code": "62011200",
          "description": "ΥΠΗ... ΣΧΕ... ΚΑΙ ΑΝΑ... ΤΕΧ... ΤΗΣ ΠΛΗ... ΓΙΑ ΔΙΚ... ΚΑΙ ΣΥΣ..."
        }
      ],
      "titles": ["EXA... CO."],
      "public_debtor": [],
      "connected_public_debtors": [],
      "people": [54321]
    }
  ]
}

Έλεγχος ΑΦΜ στο VIES

GET /api/v1/vies/:vat_id

Επαλήθευση ευρωπαϊκού ΑΦΜ μέσω VIES, με επωνυμία και διεύθυνση όπου τα δημοσιεύει το κράτος μέλος. Τα αποτελέσματα είναι cached, οπότε επαναλαμβανόμενοι έλεγχοι του ίδιου ΑΦΜ δεν χτυπούν κάθε φορά την υπηρεσία της Επιτροπής.

Scope: vat_check. Δέχεται μορφή EL094002320 ή ELEL094002320 για κάθε κράτος μέλος.

Παράδειγμα Response

{
  "vat_id": "EL094002320",
  "country_code": "EL",
  "is_valid": 1,
  "name": "UNIBIOS ΑΝΩΝΥΜΟΣ ΕΤΑΙΡΕΙΑ ΣΥΜΜΕΤΟΧΩΝ||UNIBIOS",
  "address": "1Η ΚΑΙ 18Η ΟΔΟΣ 0  13341 - ΑΝΩ ΛΙΟΣΙΑ",
  "verified_at": "2026-09-03T12:14:56.000Z",
  "last_checked_at": "2026-09-03T12:14:56.000Z"
}

Νέες Εγγραφές ΓΕΜΗ

GET /api/v1/companies/new

Εταιρείες που συστάθηκαν μέσα σε ένα διάστημα. Χρήσιμο για παρακολούθηση νέων επιχειρήσεων ανά κλάδο ή περιοχή.

Scope: search.

Query Parameters

`days`	number	Τελευταίες Χ ημέρες. Εναλλακτικά χρησιμοποιήστε start_date / end_date
`start_date`	string	Ημερομηνία από, μορφή YYYY-MM-DD
`end_date`	string	Ημερομηνία έως, μορφή YYYY-MM-DD
`count`	number	Αριθμός αποτελεσμάτων (default: 100)
`start`	number	Offset για pagination (default: 0)
`status`	string	Κατάσταση εταιρείας (default: active)
`has_email`	boolean	Μόνο εταιρείες με email (default: true)
`address`	string	Φιλτράρισμα με βάση τη διεύθυνση
`country`	string	Κωδικός χώρας μητρώου
`sort` / `order`	string	Πεδίο ταξινόμησης (default: date_start) και κατεύθυνση (default: desc)

Δημόσιες Συμβάσεις Εταιρείας

GET /api/v1/procurements/:vat

Κατακυρώσεις, συμβάσεις και πληρωμές του Δημοσίου προς μια εταιρεία, με συγκεντρωτικά μεγέθη. Το :vat είναι ελληνικό ΑΦΜ εννέα ψηφίων, με ή χωρίς το πρόθεμα EL.

Απαιτεί ενεργή συνδρομή. Scope: procurements.

Σχετικά Endpoints

`/api/v1/procurements/:vat/:category/:page`	GET	Σελιδοποίηση ανά κατηγορία: awards, contracts, payments, requests, announcements
`/api/v1/procurements/item/:adam`	GET	Λεπτομέρειες μεμονωμένης πράξης με βάση τον ΑΔΑΜ
`/api/v1/procurements/connected/:adam`	GET	Συνδεδεμένες πράξεις (τροποποιήσεις, εκτελεστικές συμβάσεις)

Λήψη Τρέχοντος Χρήστη

GET /api/v1/user

Λήψη πληροφοριών για τον τρέχοντα αυθεντικοποιημένο χρήστη (εσάς).

Παράδειγμα Response

{
  "id": 999,
  "email": "use...@exa...com",
  "is_premium": true,
  "credits": {
    "user": {
      "ai_credits": 5,
      "lead_credits": 10,
      "api_credits": 15
    },
    "org": {
      "ai_credits": 100,
      "lead_credits": 500,
      "api_credits": 250
    }
  },
  "organization": {
    "id": 50,
    "name": "EXA... Systems",
    "domain": "exa...com"
  },
  "org_permissions": {
    "is_admin": 0,
    "can_spend_ai_credits": 1,
    "can_spend_leads_credits": 1,
    "can_spend_api_credits": 1
  }
}

Πλήρες Προφίλ Εταιρείας για LLM (Markdown)

GET /api/v1/companies/:country/:ar_gemh/llm

Όλα τα στοιχεία της εταιρείας σε ένα αρχείο text/plain, φτιαγμένο για κατανάλωση από γλωσσικά μοντέλα και agents. Μία κλήση αντικαθιστά πέντε: περιλαμβάνει ταυτότητα, ΚΑΔ, σκοπό, έως έξι χρήσεις ισολογισμών με όλες τις στήλες, υπολογισμένους δείκτες, κλαδικές διαμέσους, διοίκηση, συνδεδεμένες εταιρείες, υποκαταστήματα, δημόσιες συμβάσεις, επιδοτήσεις, αγγελίες εργασίας, χρηματιστήριο και δημοσιεύματα.

Η απάντηση είναι περίπου 12-15 KB, έναντι 100-400 KB του /api/v1/companies/:country/:ar_gemh σε JSON, χωρίς τα βαριά πεδία (γράφος, χρονολόγιο, έγγραφα) που ένα μοντέλο δεν χρειάζεται.

Απαιτεί ενεργή συνδρομή. Scope: search. Κοστίζει 1 API credit ανά κλήση.

Παράδειγμα

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.bizlist.gr/api/v1/companies/gr/757001000/llm

Παράδειγμα Response

# ΕΤΑΙΡΕΙΑ ΑΕ

- **ΑΦΜ:** EL123456789
- **ΓΕΜΗ:** 757001000
- **Νομική μορφή:** ΑΕ
- **Κατάσταση:** Ενεργή
- **Κύριος ΚΑΔ:** 62011100 ΥΠΗΡΕΣΙΕΣ ΣΧΕΔΙΑΣΜΟΥ ΛΟΓΙΣΜΙΚΟΥ

## Οικονομικά στοιχεία

| Χρήση | Τζίρος | Κέρδη προ φόρων | Ενεργητικό | Ίδια κεφάλαια |
| --- | --- | --- | --- | --- |
| 2024 | 14.233.504 | 2.852.493 | 18.897.849 | 6.120.000 |

### Δείκτες

| Χρήση | Μεικτό % | Καθαρό % | ROA % | Health 0-100 |
| --- | --- | --- | --- | --- |
| 2024 | 43,93 | 20,04 | 15,09 | 71 |
...

Διαχείριση Σφαλμάτων

Το API χρησιμοποιεί τυπικούς HTTP status codes για να δηλώσει επιτυχία ή αποτυχία:

Status Code	Περιγραφή
`200`	Επιτυχία - Το request ολοκληρώθηκε επιτυχώς
`400`	Bad Request - Μη έγκυρες παράμετροι ή κακοσχηματισμένο request
`401`	Unauthorized - Μη έγκυρο ή απόν API key
`402`	Payment Required - Ανεπαρκή API credits
`404`	Not Found - Ο πόρος δεν υπάρχει
`429`	Too Many Requests - Υπέρβαση ορίου requests
`500`	Internal Server Error - Κάτι πήγε στραβά στο server

Μορφή Error Response

{
  "error": "Περιγραφή μηνύματος σφάλματος"
}

Χρειάζεστε Βοήθεια;

Αν έχετε ερωτήσεις ή χρειάζεστε βοήθεια με το API, επικοινωνήστε μαζί μας.

Διαθέσιμο και στο RapidAPI marketplace.