Τεκμηρίωση 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]
    }
  ]
}

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

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
  }
}

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

Το 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, επικοινωνήστε μαζί μας.