{ "openapi": "3.0.1", "info": { "title": "EU EUR-Lex Legislation & Legal Acts Scraper", "description": "Scrape EU legal acts from EUR-Lex: regulations, directives and decisions with CELEX number, title, document type, dates of document and entry into force, author institution, EuroVoc subject descriptors and Official Journal reference. Filter by keyword, type and date. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "AIdr4TSCpmv4oQ38n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~eu-eurlex-legislation-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-eu-eurlex-legislation-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~eu-eurlex-legislation-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-eu-eurlex-legislation-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~eu-eurlex-legislation-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-eu-eurlex-legislation-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 keywords", "type": "array", "description": "One or more keywords to match in the legal act title (for example 'energy', 'data protection', 'fisheries'). Each keyword runs a separate search. Leave empty to return all acts within the type and date filters.", "items": { "type": "string" } }, "documentTypes": { "title": "Document types", "type": "array", "description": "Which kinds of legal act to include. Leave all selected to include every type.", "items": { "type": "string", "enum": [ "regulation", "directive", "decision", "recommendation" ], "enumTitles": [ "Regulation", "Directive", "Decision", "Recommendation" ] }, "default": [ "regulation", "directive", "decision" ] }, "fromDate": { "title": "From date", "type": "string", "description": "Include acts with a document date on or after this date (YYYY-MM-DD). Defaults to 2024-01-01." }, "toDate": { "title": "To date", "type": "string", "description": "Include acts with a document date on or before this date (YYYY-MM-DD). Defaults to today." }, "maxActs": { "title": "Max Acts To Scrape", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of legal acts to collect across all searches. Optional." }, "withFullText": { "title": "Fetch full act text (paid add-on)", "type": "boolean", "description": "Optional paid add-on, off by default. Fetches the full plain text of each legal act from EUR-Lex as an extra step. Billed only when text is retrieved. Requires a paid Apify plan.", "default": false }, "withSummary": { "title": "AI legislation summary (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Adds a plain-English summary of each legal act (what it does, who it applies to, key obligations). Billed only when produced. Requires a paid Apify plan.", "default": false }, "withExtract": { "title": "AI structured extract (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Extracts structured data: subject matter, who it applies to, key obligations, amendments/repeals, effective date and penalties. Billed only when produced. Requires a paid Apify plan.", "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 } } } } } } } } } }