# Gazzetta Ufficiale Scraper - Italian Official Gazette (`studio-amba/gazzetta-ufficiale-scraper`) Actor

Scrape laws, decrees, regulations, and public notices from Italy's official gazette (Gazzetta Ufficiale). Extract act titles, types, numbers, dates, issuing authorities, full text, and PDF links. Browse recent issues or search by keyword. No login or cookies required.

- **URL**: https://apify.com/studio-amba/gazzetta-ufficiale-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 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/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Gazzetta Ufficiale Scraper - Italian Official Gazette Data

Extract laws, decrees, regulations, and public notices from Italy's official gazette (Gazzetta Ufficiale della Repubblica Italiana). Browse recent issues or search by keyword across all gazette series. Returns act titles, types, numbers, dates, issuing authorities, full text, and PDF links. No login or cookies required.

### How to scrape Gazzetta Ufficiale data

This actor scrapes the official Italian government gazette at gazzettaufficiale.it and extracts structured data from published legislative acts. The Gazzetta Ufficiale is Italy's official publication for all laws, legislative decrees, presidential decrees, ministerial orders, public competitions, and government notices.

#### Browse Recent Issues

Enable "Browse Recent Issues" to automatically scrape acts from the last 30 days of gazette publications. The actor navigates through each issue's table of contents (sommario) and extracts every published act with its full text.

#### Search by Keywords

Enter Italian keywords to search across act titles. For example, search for "sicurezza" (security), "ambiente" (environment), "lavoro" (employment), or "decreto legislativo" (legislative decree) to find specific legislation.

#### Filter by Act Type

Narrow results to specific types of legislative acts:

- **Legge** — Parliamentary law
- **Decreto Legislativo** — Legislative decree (delegated legislation)
- **Decreto-Legge** — Decree-law (emergency legislation)
- **Decreto del Presidente della Repubblica** — Presidential decree
- **Decreto** — Ministerial or interministerial decree
- **Delibera** — Resolution
- **Ordinanza** — Ordinance
- **Comunicato** — Official notice
- **Regolamento** — Regulation

#### Choose Gazette Series

The Gazzetta Ufficiale is published in seven series:

- **Serie Generale** — Main legislation (most common)
- **Corte Costituzionale** — Constitutional Court decisions
- **Unione Europea** — EU-related materials
- **Regioni** — Regional legislation
- **Concorsi ed Esami** — Public competitions and exams (government jobs)
- **Contratti Pubblici** — Public contracts and tenders
- **Parte II** — Notices and insertions

### What data does the Gazzetta Ufficiale Scraper extract?

| Field | Type | Description |
|-------|------|-------------|
| **title** | String | Full title of the legislative act |
| **actType** | String | Type (Legge, Decreto Legislativo, Decreto, etc.) |
| **actNumber** | String | Official act number (e.g. "83/2026") |
| **actDate** | String | Date the act was signed |
| **issuingAuthority** | String | Government body that issued the act |
| **publicationDate** | String | Date published in the Gazzetta Ufficiale |
| **gazetteNumber** | String | Issue number of the gazette |
| **series** | String | Gazette series (Serie Generale, Concorsi, etc.) |
| **codiceRedazionale** | String | Unique editorial code (e.g. "26A03143") |
| **fullText** | String | Full text content of the act (up to 50K characters) |
| **pdfUrl** | String | Direct link to the PDF version |
| **url** | String | Source URL on gazzettaufficiale.it |
| **scrapedAt** | String | ISO 8601 timestamp of extraction |

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| **Search Query** | String | — | Keywords to search in act titles (Italian) |
| **Act Type** | Select | All types | Filter by type of legislative act |
| **Gazette Series** | Select | Serie Generale | Which gazette series to search |
| **Browse Recent** | Boolean | true | Browse last 30 days instead of searching |
| **Date From** | String | — | Start date for search (dd/mm/yyyy) |
| **Date To** | String | — | End date for search (dd/mm/yyyy) |
| **Max Results** | Integer | 100 | Maximum number of acts to scrape |
| **Proxy Configuration** | Object | IT Residential | Proxy settings (Italian residential recommended) |

### Example Output

```json
{
    "title": "DECRETO LEGISLATIVO 16 aprile 2026, n. 83",
    "actType": "DECRETO LEGISLATIVO",
    "actNumber": "83",
    "actDate": "16 aprile 2026",
    "issuingAuthority": "PRESIDENZA DELLA REPUBBLICA",
    "publicationDate": "2026-05-20",
    "gazetteNumber": "115",
    "series": "Serie Generale",
    "codiceRedazionale": "26A03001",
    "fullText": "IL PRESIDENTE DELLA REPUBBLICA Visti gli articoli 76 e 87...",
    "pdfUrl": "https://www.gazzettaufficiale.it/do/gazzetta/downloadPdf?...",
    "url": "https://www.gazzettaufficiale.it/atto/serie_generale/caricaDettaglioAtto/originario?...",
    "scrapedAt": "2026-05-23T10:30:00.000Z"
}
```

### Use Cases

- **Legal research** — Monitor new legislation and regulatory changes in Italy
- **Compliance monitoring** — Track decrees and regulations affecting your industry
- **Government job tracking** — Scrape public competitions from the Concorsi series
- **Public procurement** — Monitor new tenders and contracts from the Contratti series
- **Academic research** — Build datasets of Italian legislative history
- **EU law transposition** — Track implementation of EU directives into Italian law

### Technical Notes

- The site uses a WAF that blocks raw HTTP requests, so this actor uses Playwright (headless browser)
- Italian residential proxies are strongly recommended for reliable operation
- The actor supports two modes: browsing recent issues (last 30 days) and keyword search
- Full text is capped at 50,000 characters per act to keep dataset sizes manageable
- Rate limiting is built in to avoid triggering anti-bot measures
- The Gazzetta Ufficiale textual archive covers publications from 1988 onwards

### Proxy Configuration

This actor requires Italian residential proxies for reliable operation. The default configuration uses Apify's residential proxy pool with Italy as the country. If you experience blocking, try reducing `maxResults` or increasing the delay between requests.

### Cost Estimation

- Browsing 30 days of gazette issues: ~500-1500 acts depending on series
- Each act detail page adds one request
- Typical run: 100 acts in ~5-10 minutes
- Uses Playwright (higher compute cost than HTTP-only actors)

### Legal Notice

This actor scrapes publicly available data from the official Italian government gazette. The Gazzetta Ufficiale is a public record. Users are responsible for complying with applicable laws and the website's terms of service.

# Actor input Schema

## `searchQuery` (type: `string`):

Search by keywords in act titles (e.g. 'decreto legislativo', 'sicurezza', 'ambiente'). Leave empty and enable 'Browse Recent' to scrape the latest gazette issues.

## `actType` (type: `string`):

Filter by type of act. Only used in search mode.

## `series` (type: `string`):

Which series of the Gazzetta Ufficiale to search.

## `browseRecent` (type: `boolean`):

Browse the last 30 days of gazette issues instead of searching. Recommended for getting the latest publications.

## `dateFrom` (type: `string`):

Start date for search (format: dd/mm/yyyy). Only used in search mode.

## `dateTo` (type: `string`):

End date for search (format: dd/mm/yyyy). Only used in search mode.

## `maxResults` (type: `integer`):

Maximum number of acts to scrape.

## `proxyConfiguration` (type: `object`):

Select proxies to use for the scraper.

## Actor input object example

```json
{
  "actType": "",
  "series": "serie_generale",
  "browseRecent": true,
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "IT"
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "browseRecent": true,
    "maxResults": 5,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "IT"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/gazzetta-ufficiale-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "browseRecent": True,
    "maxResults": 5,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "IT",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/gazzetta-ufficiale-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "browseRecent": true,
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "IT"
  }
}' |
apify call studio-amba/gazzetta-ufficiale-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/gazzetta-ufficiale-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Iudsker7iYipQqp5w/builds/hbwPk30HFzsJfI3rJ/openapi.json