{ "openapi": "3.0.1", "info": { "title": "JORF Scraper: French Official Journal API (Legifrance + DILA)", "description": "Scrape the Journal Officiel de la République Française (JORF). Get decrets, lois, arretes by date range or NOR. Full text, NATURE, NOR, ELI URI, MINISTERE, SIGNATAIRES, Legifrance URLs. Compliance, lawtech, public-affairs. $0.005/article.", "version": "1.0", "x-build-id": "zsa9AfXUpIYaGyM3x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dltik~jorf-bulletin-officiel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dltik-jorf-bulletin-officiel-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/dltik~jorf-bulletin-officiel-scraper/runs": { "post": { "operationId": "runs-sync-dltik-jorf-bulletin-officiel-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/dltik~jorf-bulletin-officiel-scraper/run-sync": { "post": { "operationId": "run-sync-dltik-jorf-bulletin-officiel-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": { "dateFrom": { "title": "Date from (YYYY-MM-DD)", "type": "string", "description": "Lower bound for publication date (DATE_PUBLI). Format YYYY-MM-DD. Defaults to yesterday if both dates left empty. DILA JORFSIMPLE retains the last ~10 months of daily archives." }, "dateTo": { "title": "Date to (YYYY-MM-DD)", "type": "string", "description": "Upper bound for publication date (DATE_PUBLI). Format YYYY-MM-DD inclusive. Defaults to today if left empty. Date range max 60 days per run for performance." }, "natureFilter": { "title": "Filter by NATURE", "type": "array", "description": "Restrict to specific JORF natures. Common values: DECRET, ARRETE, LOI, DECISION, DELIBERATION, ORDONNANCE, AVIS, CIRCULAIRE. Leave empty to return all natures.", "items": { "type": "string" }, "default": [] }, "ministereContains": { "title": "Ministry contains (case-insensitive)", "type": "string", "description": "Substring match on MINISTERE field. Example: 'interieur', 'economie', 'sante', 'justice'. Leave empty for no filter." }, "norPrefix": { "title": "NOR code prefix", "type": "string", "description": "Filter by NOR code prefix (4 letters identify the issuing ministry/body). Examples: 'INTD' = Interieur Direction, 'JUSD' = Justice, 'ECOI' = Economie. Leave empty for no filter." }, "norList": { "title": "Exact NOR codes (lookup mode)", "type": "array", "description": "Lookup specific articles by exact NOR code (12 chars, e.g. 'INTD2604081D'). When provided, the actor scans archives in the date range looking for these NORs and ignores natureFilter / ministereContains.", "items": { "type": "string" }, "default": [] }, "includeBodyText": { "title": "Include full body text", "type": "boolean", "description": "When true, includes the full BLOC_TEXTUEL article-by-article concatenation in the body_text field. Adds ~5-50KB per record. Disable for metadata-only runs.", "default": true }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of JORF articles to extract. Cap = 5000 per run. Start with 50 for testing, scale up once happy.", "default": 100 }, "proxyConfig": { "title": "Proxy (rarely needed)", "type": "object", "description": "Optional Apify proxy. DILA echanges.dila.gouv.fr is unmetered open data — datacenter proxy or none works fine.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }