{ "openapi": "3.0.1", "info": { "title": "Greece GEMI Company Registry Scraper (Officers, VAT, KAD)", "description": "Search the Greek company registry (GEMI) by name, number or VAT. Get GEMI number, VAT (AFM), legal form, status, address, share capital, activity (KAD/NACE) codes, officers, chamber, phone and email. Filter by type, status, city and activity. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "dbgpleI3bdP4BwHDw" }, "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 or VAT numbers (AFM) to look up. Each item runs its own search, so one run can cover many terms. You can also paste a single term. Leave empty to browse by the filters below only.", "items": { "type": "string" } }, "withDetails": { "title": "Fetch full company details", "type": "boolean", "description": "Fetch the full public record for each company: registered address, share capital, activity (KAD/NACE) codes, statutory officers, legal representatives, chamber membership and public phone and email. Turn off for a faster, listing-only result (name, GEMI number, VAT, legal form, status).", "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. Leave empty for all forms.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "8", "16", "19", "20", "11", "21", "10", "12", "13", "14", "15", "18", "65", "66", "67", "68", "69", "70" ], "enumTitles": [ "SA (Anonymi Etaireia)", "General Partnership (OE)", "Limited Liability Company", "Limited Partnership (EE)", "Private Company (IKE)", "Sole proprietorship", "PC", "LLSCo", "Cooperative", "Agricultural Partnership", "European Economic Interest Grouping", "European Company (SE)", "European Cooperative Society (SCE)", "Consortium", "Foreign Branch", "Civil Company 784 S.A.", "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. Leave empty for all statuses.", "items": { "type": "string", "enum": [ "3", "4", "5", "7", "15", "17", "18", "19", "20", "0" ], "enumTitles": [ "Active", "Dormant", "Bankruptcy", "Dissolution - Liquidation", "Conciliation procedure", "Deletion", "Deletion due to merger", "Forced Management", "Deletion due to division", "Other" ] } }, "kadCodes": { "title": "Activity codes (KAD / NACE)", "type": "array", "description": "Filter by activity code. Use 4-digit NACE/KAD prefixes such as \"4711\" (retail) or \"6201\" (software). Leave empty for all activities.", "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "Filter by registered city, e.g. \"ATHINA\", \"THESSALONIKI\". Optional." }, "postcode": { "title": "Postcode", "type": "string", "description": "Filter by registered postal code, e.g. \"15125\". Optional." }, "registeredFrom": { "title": "Registered from (date)", "type": "string", "description": "Only companies registered on or after this date. Format DD/MM/YYYY. Optional." }, "registeredTo": { "title": "Registered to (date)", "type": "string", "description": "Only companies registered on or before this date. Format DD/MM/YYYY. Optional." }, "personName": { "title": "Officer / person name", "type": "string", "description": "Filter to companies linked to a named person (officer, representative or partner). Optional." }, "language": { "title": "Language", "enum": [ "en", "el" ], "type": "string", "description": "Language for labels returned by the registry (legal form, status, activity descriptions).", "default": "en" } } }, "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 } } } } } } } } } }