# EU Sanctions Map Scraper (`automation-lab/eu-sanctions-map-scraper`) Actor

Export EU Sanctions Map regimes, restrictive measures and legal acts for compliance, AML, KYC and export-control workflows.

- **URL**: https://apify.com/automation-lab/eu-sanctions-map-scraper.md
- **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

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

## EU Sanctions Map Scraper

Export EU Sanctions Map regimes, restrictive measures, and legal acts from the public EU sanctions API.

### What does EU Sanctions Map Scraper do?

EU Sanctions Map Scraper turns the official EU Sanctions Map JSON feed into a clean Apify dataset.
It collects sanctions regimes, country or thematic context, restrictive measures, legal acts, and source links.
The actor is HTTP-first and reads the public API directly, so it is fast and lightweight.

### Who is it for?

- Compliance teams building AML and KYC enrichment feeds.
- Export-control teams monitoring country restrictions.
- Legal operations teams tracking EU Council decisions and regulations.
- Risk analysts comparing sanctions regimes across countries.
- Data engineers who need a scheduled sanctions dataset in JSON, CSV, Excel, or via API.

### Why use this actor?

The EU Sanctions Map website is useful for humans, but compliance workflows need repeatable data exports.
This actor normalizes nested API data into records that are easier to filter, join, and monitor.
Each record keeps the source regime context, source URL, and fetch timestamp for auditability.

### Data you can extract

| Field | Description |
| --- | --- |
| `recordType` | `regime`, `measure`, or `legalAct` |
| `regimeId` | EU Sanctions Map regime ID |
| `regimeSpecification` | Official regime description |
| `countryCode` / `countryName` | Country context when available |
| `adoptedBy` | EU / UN adoption source |
| `measureType` | Restrictive measure category |
| `measureDescription` | Measure text from the API |
| `legalActTitle` | Legal act title |
| `legalActNumber` | Regulation, decision, or resolution number |
| `legalActUrl` | EUR-Lex or UN document URL |
| `fetchedAt` | Timestamp of the actor run |

### How much does it cost to scrape EU sanctions data?

The actor uses pay-per-event pricing.
You pay a small start fee and then a per-record fee for each sanctions record produced.
Use `maxItems` for trial runs before exporting the full feed.
Final live prices are shown on the Apify Store pricing tab.

### Input options

- `mode`: choose `all`, `regimes`, `measures`, or `legalActs`.
- `countryCodes`: optional ISO country-code filter such as `BY`, `RU`, or `IR`.
- `regimeIds`: optional numeric EU Sanctions Map regime IDs.
- `includeMeasures`: include one row per restrictive measure.
- `includeLegalActs`: include one row per legal act.
- `maxItems`: cap output for testing or scheduled jobs.

### Example input

```json
{
  "mode": "all",
  "countryCodes": ["BY", "RU"],
  "includeMeasures": true,
  "includeLegalActs": true,
  "maxItems": 150
}
````

### Example output

```json
{
  "recordType": "measure",
  "regimeId": 2,
  "regimeSpecification": "Restrictive measures in view of the situation in Belarus",
  "countryCode": "BY",
  "countryName": "Belarus",
  "measureType": "Financial measures",
  "measureDescription": "Transactions related to the management of reserves...",
  "sourceUrl": "https://www.sanctionsmap.eu/regimes/2",
  "fetchedAt": "2026-07-03T00:00:00.000Z"
}
```

### How to run it

1. Open the actor on Apify.
2. Choose an output mode.
3. Add country codes or regime IDs if you want a focused export.
4. Set `maxItems` for your budget.
5. Start the run.
6. Download the dataset or consume it through the Apify API.

### Scheduling and monitoring

Run the actor daily or weekly to keep an internal sanctions reference table fresh.
Use the `fetchedAt` field to compare snapshots.
For high-sensitivity workflows, keep the raw run dataset as an audit artifact.

### Compliance workflow ideas

- Join restrictive measures to customer-country risk rules.
- Monitor new legal-act URLs for internal legal review.
- Feed sanctions regime metadata into case-management systems.
- Export a country-specific sanctions pack before onboarding reviews.
- Compare EU sanctions with OFAC or OpenSanctions datasets.

### Integrations

Apify datasets can be exported as JSON, CSV, XML, RSS, Excel, or HTML.
You can send results to Google Sheets, S3, Snowflake, BigQuery, Make, Zapier, or your own webhook.
Compliance engineering teams often call the actor from CI jobs or scheduled ETL workflows.

### API usage with Node.js

```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/eu-sanctions-map-scraper').call({
  mode: 'measures',
  countryCodes: ['BY'],
  maxItems: 100,
});
console.log(run.defaultDatasetId);
```

### API usage with Python

```python
from apify_client import ApifyClient
client = ApifyClient('MY-APIFY-TOKEN')
run = client.actor('automation-lab/eu-sanctions-map-scraper').call(run_input={
    'mode': 'legalActs',
    'countryCodes': ['RU'],
    'maxItems': 100,
})
print(run['defaultDatasetId'])
```

### API usage with cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/automation-lab~eu-sanctions-map-scraper/runs?token=MY-APIFY-TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"mode":"all","countryCodes":["BY","RU"],"maxItems":150}'
```

### MCP usage

Use the Apify MCP server with Claude Desktop or Claude Code.
Configure the actor-specific tool URL as:

```text
https://mcp.apify.com/?tools=automation-lab/eu-sanctions-map-scraper
```

Claude Code setup:

```bash
claude mcp add apify-eu-sanctions "https://mcp.apify.com/?tools=automation-lab/eu-sanctions-map-scraper"
```

Claude Desktop JSON config:

```json
{
  "mcpServers": {
    "apify-eu-sanctions": {
      "url": "https://mcp.apify.com/?tools=automation-lab/eu-sanctions-map-scraper"
    }
  }
}
```

Example prompts:

- "Run the EU sanctions scraper for Belarus and summarize the restrictive measures."
- "Export legal acts for Russia sanctions and list EUR-Lex URLs."
- "Compare current EU sanctions measures for BY and IR."

### Tips for best results

- Start with `maxItems` around 100 to inspect output shape.
- Use `countryCodes` when your workflow is country-specific.
- Use `mode: legalActs` when you only need legal references.
- Use `mode: measures` when building rules or screening enrichment.
- Leave filters empty for a full EU Sanctions Map export.

### Troubleshooting

If you get zero records, check whether your country code or regime ID filter is too narrow.
If you need every record, remove filters and raise `maxItems`.
If a source field is blank, the EU API did not provide that value for the regime.

### Data source

The source is the EU Sanctions Map public API at `sanctionsmap.eu`.
This actor does not bypass login systems or collect private data.
It only exports records available through public endpoints.

### Legality

Sanctions regime and legal-act metadata is public government information.
You are responsible for using the output according to your compliance, legal, and data-retention obligations.
The actor is a data extraction tool, not legal advice.

### Related scrapers

- https://apify.com/automation-lab/ofac-sanctions-scraper
- https://apify.com/automation-lab/hhs-exclusions-scraper
- https://apify.com/automation-lab/website-contact-finder

### FAQ

#### Can I export only one country?

Yes. Add one or more ISO country codes in `countryCodes`.

#### Can I export legal acts only?

Yes. Set `mode` to `legalActs`.

#### Does this actor scrape sanctioned persons or entities?

This MVP focuses on regimes, measures, and legal acts exposed by the regime endpoint.
Fields such as `hasMembers` and `hasFsdMembers` indicate whether lists exist for a regime.

#### Does it need a proxy?

No proxy is needed for the public JSON endpoint in normal operation.

#### How often should I run it?

Most monitoring workflows run daily or weekly depending on internal review cadence.

### Changelog

Initial version exports EU sanctions regimes, restrictive measures, and legal acts from the public API.

### Support

Open an Apify issue if you need a missing field, a new output mode, or help with a failed run.

# Actor input Schema

## `mode` (type: `string`):

Select regimes only, restrictive measures only, legal acts only, or all records flattened into one dataset.

## `countryCodes` (type: `array`):

Optional ISO country codes to include, for example BY, RU, IR. Leave empty to export all regimes.

## `regimeIds` (type: `array`):

Optional EU Sanctions Map regime IDs. Leave empty to use country filters or export all regimes.

## `includeMeasures` (type: `boolean`):

When enabled, export one item per restrictive measure attached to each matching regime.

## `includeLegalActs` (type: `boolean`):

When enabled, export one item per legal act attached to each matching regime.

## `maxItems` (type: `integer`):

Maximum dataset records to emit. Use a low number for trial runs and increase for complete exports.

## Actor input object example

```json
{
  "mode": "all",
  "countryCodes": [
    "BY",
    "RU"
  ],
  "includeMeasures": true,
  "includeLegalActs": true,
  "maxItems": 20
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "mode": "all",
    "countryCodes": [
        "BY",
        "RU"
    ],
    "includeMeasures": true,
    "includeLegalActs": true,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("automation-lab/eu-sanctions-map-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 = {
    "mode": "all",
    "countryCodes": [
        "BY",
        "RU",
    ],
    "includeMeasures": True,
    "includeLegalActs": True,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("automation-lab/eu-sanctions-map-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 '{
  "mode": "all",
  "countryCodes": [
    "BY",
    "RU"
  ],
  "includeMeasures": true,
  "includeLegalActs": true,
  "maxItems": 20
}' |
apify call automation-lab/eu-sanctions-map-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=automation-lab/eu-sanctions-map-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "EU Sanctions Map Scraper",
        "description": "Export EU Sanctions Map regimes, restrictive measures and legal acts for compliance, AML, KYC and export-control workflows.",
        "version": "0.1",
        "x-build-id": "GgC4K6RXc9ErNdWXj"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/automation-lab~eu-sanctions-map-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-automation-lab-eu-sanctions-map-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/automation-lab~eu-sanctions-map-scraper/runs": {
            "post": {
                "operationId": "runs-sync-automation-lab-eu-sanctions-map-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/automation-lab~eu-sanctions-map-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-automation-lab-eu-sanctions-map-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": {
                    "mode": {
                        "title": "Output mode",
                        "enum": [
                            "regimes",
                            "measures",
                            "legalActs",
                            "all"
                        ],
                        "type": "string",
                        "description": "Select regimes only, restrictive measures only, legal acts only, or all records flattened into one dataset.",
                        "default": "all"
                    },
                    "countryCodes": {
                        "title": "Country codes",
                        "type": "array",
                        "description": "Optional ISO country codes to include, for example BY, RU, IR. Leave empty to export all regimes.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "regimeIds": {
                        "title": "Regime IDs",
                        "type": "array",
                        "description": "Optional EU Sanctions Map regime IDs. Leave empty to use country filters or export all regimes.",
                        "items": {
                            "type": "integer"
                        }
                    },
                    "includeMeasures": {
                        "title": "Include restrictive measures",
                        "type": "boolean",
                        "description": "When enabled, export one item per restrictive measure attached to each matching regime.",
                        "default": true
                    },
                    "includeLegalActs": {
                        "title": "Include legal acts",
                        "type": "boolean",
                        "description": "When enabled, export one item per legal act attached to each matching regime.",
                        "default": true
                    },
                    "maxItems": {
                        "title": "Maximum records",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum dataset records to emit. Use a low number for trial runs and increase for complete exports.",
                        "default": 500
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```