{ "openapi": "3.0.1", "info": { "title": "Greece GEMI Company Registry Scraper - Officers, VAT, Accounts", "description": "Search the Greek company registry (GEMI) by name, GEMI number, VAT (AFM) or officer. Get legal form, status, address, share capital, KAD activities, officers with shareholding, branches, published annual accounts with auditors, filings, chamber, phone and email. Export to JSON, CSV or Excel.", "version": "0.2", "x-build-id": "cemTscZbGu5qEIsSM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~greece-gemi-companies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-greece-gemi-companies-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapers_lat~greece-gemi-companies-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-greece-gemi-companies-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapers_lat~greece-gemi-companies-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-greece-gemi-companies-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Company names, GEMI numbers, VAT numbers (AFM) or officer names to look up. Each item runs its own search, so one run can cover many terms. Leave empty to browse by the filters below only.", "items": { "type": "string" } }, "searchMode": { "title": "Match the query against", "enum": [ "all", "company", "person" ], "type": "string", "description": "Companies and people (default), company names and numbers only, or people only. People-only turns the search into an officer lookup: it returns every company a matching director, partner or representative is linked to.", "default": "all" }, "withDetails": { "title": "Fetch full company details", "type": "boolean", "description": "Fetch the full public record for each company: registered address, share capital, activity (KAD) codes, statutory officers and their shareholding, legal representatives, branches, published annual accounts with auditors, filing history, chamber membership and public phone and email. Turn off for a faster, listing-only result.", "default": true }, "maxCompanies": { "title": "Max companies to scrape", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of companies to collect across the whole run." }, "legalTypes": { "title": "Legal types", "type": "array", "description": "Filter by legal form. Pick from the list; over the API pass the form's code, for example \"1\" for SA, \"19\" for PC, \"16\" for a sole proprietorship. Leave empty for all forms.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "8", "10", "11", "12", "13", "14", "15", "16", "18", "19", "20", "21", "65", "66", "67", "68", "69", "70" ], "enumTitles": [ "SA", "GP", "LLCo", "LP", "LLC", "European Economic Interest Grouping", "Cooperative", "European Company (SE)", "European Cooperative Society (SCE)", "Consortium", "Foreign Branch", "SOLE", "Civil Company 784 S.A.", "PC", "LLSCo", "Agricultural Partnership", "Energy Community", "SoCC", "Workers' Cooperatives", "Limited partnership by shares", "Renewable energy community", "Citizen energy communities" ] } }, "statuses": { "title": "Company statuses", "type": "array", "description": "Filter by company status. Pick from the list; over the API pass the status code, for example \"3\" for Active, \"5\" for Bankruptcy, \"17\" for Deletion. Leave empty for all statuses.", "items": { "type": "string", "enum": [ "0", "3", "4", "5", "7", "15", "17", "18", "19", "20" ], "enumTitles": [ "Other", "Active", "Dormant", "Bankruptcy", "Dissolution - Liquidation", "Conciliation procedure", "Deletion", "Deletion due to merger", "Forced Management", "Deletion due to division" ] } }, "kadCodes": { "title": "Activity codes (KAD)", "type": "array", "description": "Filter by business activity. Use a Greek KAD code or code prefix, for example \"62.10\" (computer programming), \"47.11\" (food retail) or the full \"62.10.11.01\". You can also type a plain-English activity, for example \"software development\". Every matching activity in the registry's own list is applied, and anything that does not match is reported in the log instead of being ignored.", "items": { "type": "string" } }, "chambers": { "title": "Chamber of commerce", "type": "array", "description": "Filter by the chamber the company is registered with, a good proxy for its region. Pick from the list; over the API pass the chamber's code. Leave empty for all chambers.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52", "53", "54", "55", "56", "57", "58", "59", "141", "999", "1127" ], "enumTitles": [ "ATHENS CHAMBER OF COMMERCE & INDUSTRY", "CHAMBER OF CRAFTS OF ATHENS", "ATHENS PROFESSIONAL CHAMBER OF COMMERCE", "CHAMBER OF COMMERCE & INDUSTRY OF THESSALONIKI", "CHAMBER OF CRAFTS OF THESSALONIKI", "PROFESSIONAL CHAMBER OF THESSALONIKI", "PIRAEUS CHAMBER OF COMMERCE & INDUSTRY", "CHAMBER OF CRAFTS OF PIRAEUS", "PROFESSIONAL CHAMBER OF PIRAEUS", "RODOPI CHAMBER OF COMMERCE & INDUSTRY", "PROFESSIONAL & CRAFTS CHAMBER OF RODOPI", "CHAMBER OF AITOLOAKARNANIA", "CHAMBER OF ARGOLIDA", "CHAMBER OF ARKADIA", "CHAMBER OF ARTA", "CHAMBER OF ACHAIA", "CHAMBER OF VOIOTIA", "CHAMBER OF GREVENA", "CHAMBER OF DRAMA", "CHAMBER OF DODEKANISA", "CHAMBER OF EVROS", "CHAMBER OF EVVOIA", "CHAMBER OF EVRYTANIA", "CHAMBER OF ZAKYNTHOS", "CHAMBER OF ILEIA", "CHAMBER OF IMATHIA", "CHAMBER OF IRAKLEIO", "CHAMBER OF THESPROTIA", "CHAMBER OF IOANNINA", "CHAMBER OF KAVALA", "CHAMBER OF KARDITSA", "CHAMBER OF KASTORIA", "CHAMBER OF KERKYRA", "CHAMBER OF KEFALLONIA-ITHAKI", "CHAMBER OF KILKIS", "CHAMBER OF KOZANI", "CHAMBER OF KORINTHIA", "CHAMBER OF KYKLADES", "CHAMBER OF LAKONIA", "CHAMBER OF LARISA", "CHAMBER OF LASITHI", "CHAMBER OF LESVOS", "CHAMBER OF LEFKADA", "CHAMBER OF MAGNISIA", "CHAMBER OF MESSINIA", "CHAMBER OF XANTHI", "CHAMBER OF PELLA", "CHAMBER OF PIERIA", "CHAMBER OF PREVEZA", "CHAMBER OF RETHYMNI", "CHAMBER OF SAMOS", "CHAMBER OF SERRES", "CHAMBER OF TRIKALA", "CHAMBER OF FTHIOTIDA", "CHAMBER OF FLORINA", "CHAMBER OF FOKIDA", "CHAMBER OF CHALKIDIKI", "CHAMBER OF CHANIA", "CHAMBER OF CHIOS", "D/nsi Etaireion (Geniki Grammateia Emporiou & Prostasias Katanaloti)", "KENTRIKI ENOSI EPIMELITIRION", "Υ.ΚΟΙ.Σ.Ο-Dieythinsi K.AL.O." ] } }, "listedOnly": { "title": "Stock-exchange listed companies only", "type": "boolean", "description": "Return only companies flagged by the registry as listed on the Athens Stock Exchange.", "default": false }, "city": { "title": "City", "type": "string", "description": "Filter by registered city, written in Latin characters as the registry stores it, for example \"ATHINA\" or \"THESSALONIKI\"." }, "postcode": { "title": "Postcode", "type": "string", "description": "Filter by registered postal code, for example \"15125\"." }, "registeredFrom": { "title": "Registered from (date)", "type": "string", "description": "Only companies registered on or after this date. Accepts DD/MM/YYYY or YYYY-MM-DD. If you set only one end of the range the other end is filled in automatically." }, "registeredTo": { "title": "Registered to (date)", "type": "string", "description": "Only companies registered on or before this date. Accepts DD/MM/YYYY or YYYY-MM-DD." }, "lastChangedFrom": { "title": "Last changed from (date)", "type": "string", "description": "Only companies with a registry change filed on or after this date. Use it to pull companies that moved, changed officers or changed capital recently. Accepts DD/MM/YYYY or YYYY-MM-DD." }, "lastChangedTo": { "title": "Last changed to (date)", "type": "string", "description": "Only companies with a registry change filed on or before this date." }, "closedFrom": { "title": "Closed from (date)", "type": "string", "description": "Only companies deleted or closed on or after this date. Accepts DD/MM/YYYY or YYYY-MM-DD." }, "closedTo": { "title": "Closed to (date)", "type": "string", "description": "Only companies deleted or closed on or before this date." }, "personName": { "title": "Officer / person name", "type": "string", "description": "Shortcut for an officer lookup: returns the companies a matching director, partner or representative is linked to. Same as setting the query and choosing \"People only\"." }, "maxOfficers": { "title": "Max officers per company", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many officers and representatives to return per company. Large companies can have hundreds of historical entries.", "default": 100 }, "maxFilings": { "title": "Max filings per company", "minimum": 0, "maximum": 500, "type": "integer", "description": "How many filing-history, decision and authority entries to return per company, newest first. Set 0 to skip the history arrays and keep only the counts and latest-filing summary.", "default": 50 }, "language": { "title": "Language", "enum": [ "en", "el" ], "type": "string", "description": "Language for labels returned by the registry (legal form, status, activity descriptions).", "default": "en" }, "withAiCompanySummary": { "title": "AI company summary (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Writes a plain-English KYB profile of each company from its registry record. Requires a paid Apify plan. Billed only when a summary is produced.", "default": false }, "withAiIndustry": { "title": "AI industry classification (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Maps each company to a normalized industry and sub-industry. Requires a paid Apify plan. Billed only when a classification is produced.", "default": false }, "withAiRiskFlags": { "title": "AI KYB risk flags (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Summarizes due-diligence risk flags (status, age, missing data, capital anomalies, no published accounts) with a risk level. Requires a paid Apify plan. Billed only when produced.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }