# Diario da Republica Scraper - Portuguese Official Gazette (`studio-amba/diario-da-republica-scraper`) Actor Scrape Portuguese legislation, decrees, regulations, and official announcements from the Diario da Republica (dre.pt). Search by keyword, document type, date range, or series. Extract title, summary, full text, and PDF links. No login or cookies required. - **URL**: https://apify.com/studio-amba/diario-da-republica-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Diario da Republica Scraper - Portuguese Laws & Decrees Scrape Portuguese legislation, decrees, regulations, and official government announcements from the Diario da Republica (dre.pt). Search by keyword, document type, date range, or series. Extract document titles, summaries, full text, and PDF links. No login or cookies required. ### How to scrape Diario da Republica data This actor searches Portugal's official gazette, the Diario da Republica Electronico (DRE), at diariodarepublica.pt and extracts structured data from legal documents. The DRE publishes all Portuguese legislation — laws, decree-laws, portarias, regulations, resolutions, and administrative orders — dating back to 1910. #### Search by Keyword Enter a Portuguese search term such as "imposto" (tax), "habitacao" (housing), "trabalho" (labor), or "saude" (health). The actor searches across document titles, summaries, and content to find matching legislation. #### Filter by Document Type Narrow your search to specific types of legal documents: - **Lei** (Law) — Acts of Parliament - **Decreto-Lei** (Decree-Law) — Government legislation with force of law - **Portaria** (Administrative Order) — Ministerial orders - **Regulamento** (Regulation) — Regulatory instruments - **Resolucao** (Resolution) — Council of Ministers resolutions - **Aviso** (Notice) — Official notices and international treaties - **Despacho** (Order) — Administrative orders - **Declaracao** (Declaration) — Official declarations #### Filter by Date Range Specify start and end dates to focus on legislation from a specific period. #### Filter by Series - **Serie I** — Primary legislation and judicial acts (laws, decrees, portarias) - **Serie II** — Government and administrative announcements (tenders, appointments) ### What data does Diario da Republica Scraper extract? | Field | Type | Description | |-------|------|-------------| | **title** | String | Full title of the legal document | | **documentType** | String | Type: Lei, Decreto-Lei, Portaria, Regulamento, etc. | | **documentNumber** | String | Official document number (e.g., "61/2025") | | **date** | String | Publication date (YYYY-MM-DD) | | **series** | String | DR series (Serie I or Serie II) | | **issuingEntity** | String | Government body that issued the document | | **summary** | String | Official synopsis/summary of the document | | **fullText** | String | Full text content (when includeFullText is enabled) | | **pdfUrl** | String | URL to the official PDF version | | **url** | String | Document detail page URL | | **eli** | String | European Legislation Identifier (ELI) | | **drNumber** | String | Diario da Republica issue number | | **pages** | String | Page range in the official gazette | | **scrapedAt** | String | ISO timestamp of data extraction | ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | **Search Keywords** | String | — | Portuguese search term (e.g., "lei", "imposto") | | **Document Type** | Select | All | Filter by document type | | **Series** | Select | All | Serie I (legislation) or Serie II (administrative) | | **Date From** | String | — | Start date (YYYY-MM-DD) | | **Date To** | String | — | End date (YYYY-MM-DD) | | **Include Full Text** | Boolean | `false` | Extract complete document text | | **Max Results** | Integer | `100` | Maximum documents to return | | **Proxy Configuration** | Object | PT Residential | Proxy settings | ### Example output ```json { "title": "Decreto-Lei n.o 61/2025, de 2 de abril", "documentType": "Decreto Lei", "documentNumber": "61-2025", "date": "2025-04-02", "series": "Serie I", "issuingEntity": "Presidencia do Conselho de Ministros", "summary": "Altera o Decreto-Lei n.o 181/2012, de 6 de agosto, alterando o regime do acesso e exercicio das atividades de aluguer e partilha de veiculos.", "fullText": null, "pdfUrl": "https://files.diariodarepublica.pt/1s/2025/04/06500/0001200035.pdf", "url": "https://diariodarepublica.pt/dr/detalhe/decreto-lei/61-2025-913224267", "eli": null, "drNumber": "65", "pages": "12-35", "scrapedAt": "2026-05-23T10:30:00.000Z" } ```` ### Tips for best results - **Use Portuguese keywords**: Search in Portuguese for the best results. "imposto" (tax), "trabalho" (labor), "educacao" (education), "saude" (health), "ambiente" (environment). - **Date range searches**: Combine date range with document type to find all laws passed in a specific period. - **Serie I for laws**: If you only need primary legislation, filter by Serie I to skip administrative announcements. - **Full text extraction**: Enable "Include Full Text" when you need the actual content of laws, not just metadata. This is slower but provides complete document text. - **Recent legislation**: Use date filters to focus on recent changes — new laws and amendments from the current session. ### How much does it cost? Diario da Republica Scraper runs on the Apify platform. You pay only for compute resources used. This actor uses Playwright (headless browser), which uses more resources than HTTP-only scrapers. | Search size | Estimated time | Estimated cost | |-------------|---------------|----------------| | 10 documents (metadata only) | ~2 minutes | ~$0.03 | | 50 documents (metadata only) | ~8 minutes | ~$0.12 | | 10 documents (with full text) | ~5 minutes | ~$0.06 | | 100 documents (metadata only) | ~15 minutes | ~$0.20 | Apify's free tier includes $5 of monthly compute — enough to extract hundreds of legal documents at no cost. ### Can I integrate? Yes. Send Portuguese legislation data directly to your existing tools: - **Google Sheets** — Build a Portuguese legal database - **Notion** — Create a searchable legal knowledge base - **Slack** — Get notified about new legislation matching your criteria - **Webhooks** — Push to any HTTP endpoint for custom workflows ### Can I use it as an API? Yes. Call Diario da Republica Scraper programmatically: #### Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("studio-amba/diario-da-republica-scraper").call(run_input={ "searchQuery": "imposto", "documentType": "decreto-lei", "maxResults": 20, }) for doc in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{doc['documentType']} {doc['documentNumber']} - {doc['title']}") ``` #### JavaScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('studio-amba/diario-da-republica-scraper').call({ searchQuery: 'trabalho', series: '1', maxResults: 50, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(doc => console.log(`${doc.documentType} ${doc.documentNumber} | ${doc.date}`)); ``` ### FAQ #### What is the Diario da Republica? The Diario da Republica is Portugal's official gazette (journal). It publishes all legislation, government decrees, regulations, and official announcements. It has been published since 1820 and has been fully electronic since 2006. All content is free to access at dre.pt. #### What is Serie I vs Serie II? Serie I contains primary legislation and judicial acts — laws (leis), decree-laws (decretos-lei), government resolutions, and administrative orders (portarias). Serie II contains administrative announcements — public tenders, appointments, regulatory notices, and government decisions. #### How far back does the data go? The digital archive contains Serie I documents from 1910 and Serie II from 1980. Historical royal legislation from 1603-1910 is also available. #### What is ELI? ELI (European Legislation Identifier) is a standardized system for identifying and accessing legislation across EU member states. The DRE applies ELI to acts published since January 2, 1991, making it possible to cross-reference Portuguese legislation with EUR-Lex and other European databases. #### Can I get the full text of laws? Yes. Enable the "Include Full Text" option to extract the complete text content of each document. You can also access official PDFs via the pdfUrl field. ### Limitations - The site is a JavaScript SPA — this actor uses a headless browser (Playwright) for rendering, which is slower than HTTP-only scrapers - Very large date ranges may return too many results; use specific keywords to narrow down - Historical documents (pre-1991) may have limited structured metadata - Full text extraction adds processing time per document - Some documents may only be available as PDF without rendered text ### Other European legal gazette scrapers Working with European legal data? Combine with these tools: - **[Belgian Official Gazette (Staatsblad)](https://apify.com/studio-amba/staatsblad-scraper)** — Belgian Moniteur Belge legislation - **[BOAMP Scraper](https://apify.com/studio-amba/boamp-scraper)** — French public procurement notices - **[BODACC Scraper](https://apify.com/studio-amba/bodacc-scraper)** — French commercial gazette - **[German Company Register](https://apify.com/studio-amba/handelsregister-scraper)** — Handelsregister company data ### Your feedback Found a bug or want a feature? Open an issue on the [Issues tab](https://console.apify.com/actors/studio-amba~diario-da-republica-scraper/issues). Your feedback helps improve this actor. # Actor input Schema ## `searchQuery` (type: `string`): Search term in Portuguese (e.g. 'lei', 'imposto', 'habitacao', 'trabalho'). Searches across document titles, summaries, and full text. ## `documentType` (type: `string`): Filter by type of legal document. ## `series` (type: `string`): Serie I contains legislation and judicial acts. Serie II contains government and administrative announcements. ## `dateFrom` (type: `string`): Start date for search range (format: YYYY-MM-DD). Example: '2025-01-01'. ## `dateTo` (type: `string`): End date for search range (format: YYYY-MM-DD). Example: '2026-12-31'. ## `includeFullText` (type: `boolean`): Extract the full text of each document. Slower but gives complete content. Disable for faster metadata-only extraction. ## `maxResults` (type: `integer`): Maximum number of documents to scrape. ## `proxyConfiguration` (type: `object`): Select proxies to use for the scraper. ## Actor input object example ```json { "searchQuery": "lei", "documentType": "all", "series": "all", "includeFullText": false, "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PT" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "lei", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PT" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/diario-da-republica-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "lei", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "PT", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/diario-da-republica-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "lei", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PT" } }' | apify call studio-amba/diario-da-republica-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/diario-da-republica-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Diario da Republica Scraper - Portuguese Official Gazette", "description": "Scrape Portuguese legislation, decrees, regulations, and official announcements from the Diario da Republica (dre.pt). Search by keyword, document type, date range, or series. Extract title, summary, full text, and PDF links. No login or cookies required.", "version": "0.1", "x-build-id": "NX2FdloUS0oV1Xf9b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~diario-da-republica-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-diario-da-republica-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/studio-amba~diario-da-republica-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-diario-da-republica-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/studio-amba~diario-da-republica-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-diario-da-republica-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": { "searchQuery": { "title": "Search Keywords", "type": "string", "description": "Search term in Portuguese (e.g. 'lei', 'imposto', 'habitacao', 'trabalho'). Searches across document titles, summaries, and full text." }, "documentType": { "title": "Document Type", "enum": [ "all", "lei", "decreto-lei", "decreto", "portaria", "resolucao", "regulamento", "aviso", "despacho", "declaracao" ], "type": "string", "description": "Filter by type of legal document.", "default": "all" }, "series": { "title": "Series", "enum": [ "all", "1", "2" ], "type": "string", "description": "Serie I contains legislation and judicial acts. Serie II contains government and administrative announcements.", "default": "all" }, "dateFrom": { "title": "Date From", "type": "string", "description": "Start date for search range (format: YYYY-MM-DD). Example: '2025-01-01'." }, "dateTo": { "title": "Date To", "type": "string", "description": "End date for search range (format: YYYY-MM-DD). Example: '2026-12-31'." }, "includeFullText": { "title": "Include Full Text", "type": "boolean", "description": "Extract the full text of each document. Slower but gives complete content. Disable for faster metadata-only extraction.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of documents to scrape.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to use for the scraper.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PT" } } } }, "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 } } } } } } } } } } ```