# JORF Scraper — French Official Gazette, No Login Required (`studio-amba/jorf-scraper`) Actor Scrape the Journal Officiel de la Republique Francaise (JORF) from Legifrance. Extract laws, decrees, ordinances, and orders with full text, NOR numbers, publication dates, and signatories. Filter by text type, date range, or keyword. No cookies, no login. - **URL**: https://apify.com/studio-amba/jorf-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 0.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 ## JORF Scraper — French Official Gazette Laws & Decrees Extract laws, decrees, ordinances, orders, and official notices from France's Journal Officiel de la Republique Francaise (JORF) via Legifrance. Returns structured data including full text, NOR numbers, publication dates, signature dates, and signatories. Filter by text type, date range, or keyword. No cookies, no login required. ### How to scrape JORF data This actor scrapes the Journal Officiel section of Legifrance, France's official legal database maintained by DILA (Direction de l'Information Legale et Administrative). The JORF has published every French law, decree, and regulation since 1868, with digital archives going back to 1990. #### Search by Keyword Enter a keyword to search across all JORF texts. The search covers titles, text bodies, NOR numbers, and related metadata. Examples: "energie renouvelable", "code du travail", "nomination prefet". #### Filter by Text Type Narrow results to specific types of legal texts: - **LOI** — Laws voted by Parliament - **ORDONNANCE** — Government ordinances (legislative delegation) - **DECRET** — Decrees issued by the President or Prime Minister - **ARRETE** — Ministerial or prefectoral orders - **AVIS** — Official notices and opinions - **DECISION** — Decisions from constitutional and administrative bodies - **CIRCULAIRE** — Administrative circulars and instructions #### Filter by Date Range Restrict results to a specific period using signature date (when the text was signed) and publication date (when it appeared in the JORF). ### What data does JORF Scraper extract? | Field | Type | Description | |-------|------|-------------| | **title** | String | Full official title of the text | | **nature** | String | Type: LOI, DECRET, ARRETE, ORDONNANCE, AVIS, DECISION, CIRCULAIRE | | **norNumber** | String | NOR identifier (unique administrative reference, e.g., JUSC2421685A) | | **jorfNumber** | String | JORF issue number (e.g., JORF n0194) | | **publicationDate** | String | Date of publication in the Journal Officiel | | **signatureDate** | String | Date the text was signed by the authority | | **textNumber** | String | Position within the JORF issue (e.g., Texte n31) | | **jorfTextId** | String | Unique Legifrance identifier (JORFTEXT...) | | **fullText** | String | Complete body text (optional, can be disabled for metadata-only runs) | | **signatory** | String | Signing authority (minister, president, etc.) | | **url** | String | Direct link to the text on Legifrance | | **scrapedAt** | String | ISO timestamp of extraction | ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | **Search Keywords** | String | — | Search JORF texts by keyword | | **Text Type (Nature)** | Array | All types | Filter by LOI, DECRET, ARRETE, etc. | | **Date From** | String | — | Signature date filter (DD/MM/YYYY) | | **Date To** | String | — | Publication date filter (DD/MM/YYYY) | | **Include Full Text** | Boolean | `true` | Include complete text body | | **Max Results** | Integer | `50` | Maximum texts to extract | | **Proxy Configuration** | Object | FR Residential | Proxy settings | ### Example output ```json { "title": "Decret n 2024-567 du 20 juin 2024 relatif a la transition energetique", "nature": "DECRET", "norNumber": "TRER2412345D", "jorfNumber": "JORF n0145", "publicationDate": "21 juin 2024", "signatureDate": "20 juin 2024", "textNumber": "Texte n12", "jorfTextId": "JORFTEXT000049876543", "fullText": "Le Premier ministre, Sur le rapport du ministre de la transition energetique...", "signatory": "Le Premier ministre", "url": "https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000049876543", "scrapedAt": "2026-05-23T10:00:00.000Z" } ```` ### Use cases - **Legal monitoring** — Track new laws and decrees in your sector (environment, labor, finance, health) - **Regulatory compliance** — Get notified when regulations change affecting your business - **Legal research** — Build a searchable database of French legislation for law firms and academics - **Government affairs** — Monitor nominations, appointments, and institutional decisions - **Data journalism** — Analyze legislative trends, decree frequency, and policy patterns over time - **Business intelligence** — Track government procurement rules, tax changes, and industry regulations ### Tips for best results - **Track legislation by sector**: Search with domain-specific keywords like "sante publique", "environnement", "numerique", or "finances publiques" - **Monitor nominations**: Search for "nomination" or "arrete portant nomination" to track government appointments - **Metadata-only mode**: Disable "Include Full Text" for faster runs when you only need titles, dates, and NOR numbers - **Date filtering**: Use date ranges to get a specific period's legislation — useful for regulatory audits - **NOR number lookup**: Every JORF text has a unique NOR number. Use it to reference specific texts across systems ### How much does it cost? JORF Scraper runs on the Apify platform. You pay only for compute resources used. | Search size | Estimated time | Estimated cost | |-------------|---------------|----------------| | 10 texts | ~30 seconds | ~$0.01 | | 50 texts | ~2 minutes | ~$0.05 | | 200 texts | ~8 minutes | ~$0.20 | | 1,000 texts | ~40 minutes | ~$0.80 | Legifrance is a public government website with no rate limiting. Costs are purely Apify compute. Apify's free tier includes $5 of monthly compute — enough to extract thousands of texts. ### Can I integrate? Yes. Send JORF data directly to your tools: - **Google Sheets** — Build a legislative monitoring dashboard updated on schedule - **Slack** — Get notified when new laws or decrees matching your keywords are published - **Webhooks** — Push to any HTTP endpoint for custom regulatory compliance pipelines - **Email** — Receive daily or weekly digests of new JORF publications ### Can I use it as an API? Yes. Call JORF Scraper programmatically: #### Python — Monitor new energy decrees ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("studio-amba/jorf-scraper").call(run_input={ "searchQuery": "energie renouvelable", "nature": ["DECRET", "LOI"], "maxResults": 20, }) for text in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{text['nature']} | {text['publicationDate']} | {text['title'][:80]}") ``` #### JavaScript — Get latest laws ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('studio-amba/jorf-scraper').call({ searchQuery: 'loi', nature: ['LOI'], maxResults: 10, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(t => console.log(`${t.publicationDate} | ${t.norNumber} | ${t.title}`)); ``` ### FAQ #### What is the Journal Officiel (JORF)? The Journal Officiel de la Republique Francaise is France's official gazette, published daily by DILA. Every law, decree, ordinance, and official government act must be published in the JORF to take legal effect. It has been published continuously since 1868. #### What is a NOR number? NOR (Nomenclature des actes publiees au Journal Officiel) is a unique 12-character identifier assigned to every text published in the JORF. It encodes the issuing ministry, year, and sequence. Example: JUSC2421685A = Justice ministry, 2024, sequence 21685, type A (arrete). #### How current is the data? Texts are published on Legifrance within 24 hours of their official JORF publication. The digital archive goes back to 1990 for most text types. #### What about the Legifrance API? The official Legifrance API (via PISTE) requires OAuth registration. This actor scrapes the public website directly, requiring no registration or API keys. All data is published under Open Licence 2.0 (etalab). #### Does this include court decisions? No. This actor focuses specifically on the JORF (laws, decrees, regulations). Court decisions are published separately in other Legifrance databases (JURI, CETAT, CONSTIT). ### Limitations - Historical texts before June 2004 may lack HTML versions and have limited content extraction - Very long texts (e.g., full budget laws) may have truncated full text - The NOR number is not available for all texts (some older texts lack it) - Date formats are in French (e.g., "15 aout 2024") — parse accordingly ### Other French government scrapers Working with French public data? Combine with these tools: - **[French Company Enrichment](https://apify.com/studio-amba/french-company-enrichment)** — SIREN/SIRET company lookup - **[BOAMP Scraper](https://apify.com/studio-amba/boamp-scraper)** — French public procurement announcements - **[BODACC Scraper](https://apify.com/studio-amba/bodacc-scraper)** — French business legal announcements ### Your feedback Found a bug or want a feature? Open an issue on the [Issues tab](https://console.apify.com/actors/studio-amba~jorf-scraper/issues). Your feedback helps improve this actor. # Actor input Schema ## `searchQuery` (type: `string`): Search JORF texts by keyword. Example: 'energie renouvelable', 'code du travail', 'nomination'. ## `nature` (type: `array`): Filter by type of legal text. Leave empty for all types. ## `dateFrom` (type: `string`): Filter texts signed after this date. Format: DD/MM/YYYY. Example: '01/01/2024'. ## `dateTo` (type: `string`): Filter texts published before this date. Format: DD/MM/YYYY. Example: '31/12/2024'. ## `includeFullText` (type: `boolean`): Include the complete text body of each JORF entry. Disable to get metadata only (faster, smaller output). ## `maxResults` (type: `integer`): Maximum number of JORF texts to extract. ## `proxyConfiguration` (type: `object`): Select proxies to use for the scraper. ## Actor input object example ```json { "searchQuery": "decret", "nature": [], "includeFullText": true, "maxResults": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } ``` # 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": "decret", "maxResults": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/jorf-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": "decret", "maxResults": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "FR", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/jorf-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": "decret", "maxResults": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } }' | apify call studio-amba/jorf-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/jorf-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "JORF Scraper — French Official Gazette, No Login Required", "description": "Scrape the Journal Officiel de la Republique Francaise (JORF) from Legifrance. Extract laws, decrees, ordinances, and orders with full text, NOR numbers, publication dates, and signatories. Filter by text type, date range, or keyword. No cookies, no login.", "version": "0.0", "x-build-id": "rMVd72S1j9V3GOyYq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~jorf-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-jorf-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~jorf-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-jorf-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~jorf-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-jorf-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 JORF texts by keyword. Example: 'energie renouvelable', 'code du travail', 'nomination'." }, "nature": { "title": "Text Type (Nature)", "type": "array", "description": "Filter by type of legal text. Leave empty for all types.", "items": { "type": "string", "enum": [ "LOI", "ORDONNANCE", "DECRET", "ARRETE", "AVIS", "DECISION", "CIRCULAIRE" ], "enumTitles": [ "Loi (Law)", "Ordonnance (Ordinance)", "Decret (Decree)", "Arrete (Order)", "Avis (Notice)", "Decision", "Circulaire (Circular)" ] }, "default": [] }, "dateFrom": { "title": "Date From", "type": "string", "description": "Filter texts signed after this date. Format: DD/MM/YYYY. Example: '01/01/2024'." }, "dateTo": { "title": "Date To", "type": "string", "description": "Filter texts published before this date. Format: DD/MM/YYYY. Example: '31/12/2024'." }, "includeFullText": { "title": "Include Full Text", "type": "boolean", "description": "Include the complete text body of each JORF entry. Disable to get metadata only (faster, smaller output).", "default": true }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of JORF texts to extract.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to use for the scraper.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } } }, "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 } } } } } } } } } } ```