# EU & International Law Search: EUR-Lex, DE, AT, NL, ES, JP (`henrycrawl/law-regulation-search`) Actor

Search official law databases (EUR-Lex, Germany, Austria, Netherlands, Spain, Japan) by keyword or document id. Clean JSON per law: title, type, number, dates, in force or repealed, ELI, links, optional full text. For AI agents, legal research and compliance. Pay per law.

- **URL**: https://apify.com/henrycrawl/law-regulation-search.md
- **Developed by:** [Henry Crawl](https://apify.com/henrycrawl) (community)
- **Categories:** AI, Developer tools, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 law founds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

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

## EU & International Law Search: EUR-Lex, Germany, Austria, Netherlands, Spain, Japan

**Search six official law databases with one call** and get clean JSON per law: official id, title, type,
number, adoption and entry-into-force dates, whether it is **in force or repealed**, ELI, link to the official
page and, on request, the **full consolidated text** as plain text ready for an LLM.

Built for AI agents, legal research, compliance checks and RAG pipelines that need the actual law from the
official source, not a summary.

### Databases covered

| Jurisdiction | Official source | Search language | Document id |
|---|---|---|---|
| 🇪🇺 European Union | EUR-Lex / Publications Office (CELLAR) | any of 24 EU languages | CELEX, e.g. `32016R0679` |
| 🇩🇪 Germany (federal) | gesetze-im-internet.de (Federal Ministry of Justice) | German | slug, e.g. `bdsg_2018` |
| 🇦🇹 Austria (federal) | RIS (Federal Chancellery) | German | Gesetzesnummer, e.g. `10001597` |
| 🇳🇱 Netherlands | wetten.overheid.nl (BWB) | Dutch | BWB id, e.g. `BWBR0040940` |
| 🇪🇸 Spain | BOE consolidated legislation | Spanish | BOE id, e.g. `BOE-A-2018-16673` |
| 🇯🇵 Japan | e-Gov 法令検索 (Digital Agency) | Japanese | law id, e.g. `415AC0000000057` |

### Input

```json
{
  "query": "data protection",
  "jurisdictions": ["EU", "DE", "ES", "JP"],
  "queryByJurisdiction": {"DE": "Datenschutz", "ES": "protección de datos", "JP": "個人情報"},
  "status": "in-force",
  "maxResultsPerJurisdiction": 5,
  "includeFullText": false
}
```

- **Search words** must all appear in the title. National databases are searched in their own language, so
  give per-jurisdiction words with `queryByJurisdiction` (an agent can translate the words first).
- **Look up exact documents** with `documentIds`, e.g. `["EU:32016R0679", "ES:BOE-A-2018-16673", "JP:415AC0000000057"]`.
- Results are ranked so the main act comes first: EU regulations and directives whose title contains the exact
  phrase before decisions; national acts (Ley Orgánica, Bundesgesetz, wet) before ministerial rules.

### Output (one row per law)

```json
{
  "type": "law",
  "status": "OK",
  "jurisdiction": "EU",
  "documentId": "32016R0679",
  "title": "Regulation (EU) 2016/679 of the European Parliament and of the Council of 27 April 2016 on the protection of natural persons with regard to the processing of personal data ... (General Data Protection Regulation)",
  "documentType": "Regulation",
  "officialNumber": "2016/679",
  "dateAdopted": "2016-04-27",
  "dateInForce": "2016-05-24",
  "inForce": true,
  "eli": "http://data.europa.eu/eli/reg/2016/679/oj",
  "url": "https://eur-lex.europa.eu/legal-content/EN/ALL/?uri=CELEX:32016R0679",
  "fullText": "REGULATION (EU) 2016/679 OF THE EUROPEAN PARLIAMENT AND OF THE COUNCIL ...",
  "fullTextChars": 354162,
  "fullTextTruncated": true,
  "missingFields": [],
  "scrapedAt": "2026-11-16T05:00:00Z"
}
```

National rows add what each database publishes: `abbreviation` (BDSG, DSG), `lastAmended`, `subjects`
(legal areas), `issuingBody` (Spain), `ministry` (Netherlands), `titleReading` (Japanese kana).
`missingFields` lists what a database does not provide, so an agent knows a field is absent rather than empty.

Searches that find nothing return a free `error` row (`NO_RESULTS`, `NOT_FOUND`, `BAD_DOCUMENT_ID`), so every
request gets an answer.

### Pricing

- **$0.003 per law** returned (metadata row).
- **$0.01 per full text** (only when `includeFullText` is on).
- Error rows are never charged.

### Use with AI agents (MCP)

`https://mcp.apify.com/?tools=henrycrawl/law-regulation-search` — agents call it with
`{"query": "...", "jurisdictions": ["EU"]}` or `{"documentIds": ["EU:32016R0679"], "includeFullText": true}`.

### Limits

- Germany: federal law in force only (the official site does not publish repealed versions); no adoption dates in the index.
- Austria: federal law; the full text is assembled section by section from the open-data API (a large law takes a few seconds).
- Title search only (not the body text). Use specific words from the law's name.
- The UK, France, Korea and Vietnam are not included yet: their official sites require registration or block automated access.

# Actor input Schema

## `query` (type: `string`):

Words that must ALL appear in the law's title. Use the official language of each jurisdiction (EU: any EU language set in 'EU language', DE/AT: German, NL: Dutch, ES: Spanish, JP: Japanese), or give per-jurisdiction words below.

## `jurisdictions` (type: `array`):

Which official databases to search. Default: all six.

## `queryByJurisdiction` (type: `object`):

Optional: different search words per jurisdiction, e.g. {"DE": "Datenschutz", "ES": "protección de datos", "JP": "個人情報"}. Overrides 'Search words' for that jurisdiction.

## `documentIds` (type: `array`):

Exact documents as JURISDICTION:id, e.g. EU:32016R0679 (CELEX), DE:bdsg_2018, AT:10001597 (Gesetzesnummer), NL:BWBR0040940, ES:BOE-A-2018-16673, JP:415AC0000000057.

## `status` (type: `string`):

Return only laws currently in force (default), all, or only repealed ones. Germany publishes only laws in force.

## `maxResultsPerJurisdiction` (type: `integer`):

Best matches per jurisdiction (EU: exact phrase and regulations / directives first; national: main acts first).

## `includeFullText` (type: `boolean`):

Also return the full consolidated text of each law as plain text (charged separately per document).

## `fullTextMaxChars` (type: `integer`):

Cut long laws to this many characters (fullTextTruncated tells you). 0 = no limit.

## `euLanguage` (type: `string`):

Language of EU titles, search words and full text.

## Actor input object example

```json
{
  "query": "data protection",
  "jurisdictions": [
    "EU",
    "DE"
  ],
  "queryByJurisdiction": {
    "DE": "Datenschutz"
  },
  "documentIds": [
    "EU:32016R0679",
    "ES:BOE-A-2018-16673"
  ],
  "status": "in-force",
  "maxResultsPerJurisdiction": 5,
  "includeFullText": false,
  "fullTextMaxChars": 50000,
  "euLanguage": "en"
}
```

# Actor output Schema

## `results` (type: `string`):

One row per law, plus free error rows (NO_RESULTS, NOT_FOUND, SOURCE_UNAVAILABLE...).

## `summary` (type: `string`):

Counts for this run (SUMMARY record).

# 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 = {
    "query": "data protection",
    "jurisdictions": [
        "EU",
        "DE"
    ],
    "queryByJurisdiction": {
        "DE": "Datenschutz"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("henrycrawl/law-regulation-search").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 = {
    "query": "data protection",
    "jurisdictions": [
        "EU",
        "DE",
    ],
    "queryByJurisdiction": { "DE": "Datenschutz" },
}

# Run the Actor and wait for it to finish
run = client.actor("henrycrawl/law-regulation-search").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 '{
  "query": "data protection",
  "jurisdictions": [
    "EU",
    "DE"
  ],
  "queryByJurisdiction": {
    "DE": "Datenschutz"
  }
}' |
apify call henrycrawl/law-regulation-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,henrycrawl/law-regulation-search"
        }
    }
}
```

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/GnxYGDBYT6OKcIBKW/builds/9CbX4KZSsgGgpFAwy/openapi.json
