{ "openapi": "3.0.1", "info": { "title": "France Official Weather Station Data: Météo-France Daily Obs", "description": "Official Météo-France daily climatological station data (2025 onward): clean station-day rows with original quality codes, per-station degree days (DJU) and rain/frost/gust day counts, and a monitor feed of new and corrected station-days. Informational; not an official certificate.", "version": "1.0", "x-build-id": "2hrrokYcbpipcsjDO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plainworktools~meteo-france-daily-observations/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plainworktools-meteo-france-daily-observations", "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/plainworktools~meteo-france-daily-observations/runs": { "post": { "operationId": "runs-sync-plainworktools-meteo-france-daily-observations", "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/plainworktools~meteo-france-daily-observations/run-sync": { "post": { "operationId": "run-sync-plainworktools-meteo-france-daily-observations", "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": "Mode", "enum": [ "observations", "summary", "monitor" ], "type": "string", "description": "observations = one row per station and day; summary = per-station period summaries from RR-T-Vent; monitor = change feed against a stored snapshot (schedule it).", "default": "observations" }, "departments": { "title": "Departments", "type": "array", "description": "Department file codes: 01-95 (Corsica is one file: use 20, not 2A/2B), 971, 972, 973, 974, 975, 984, 985, 986, 987, 988. Mayotte (976) has no file. Selects every reviewed station in those files.", "default": [], "items": { "type": "string" } }, "stationIds": { "title": "Station IDs", "type": "array", "description": "8-digit Météo-France station numbers (NUM_POSTE) from the reviewed catalog, e.g. 31069001 (Toulouse-Blagnac). Max 500.", "default": [], "items": { "type": "string" } }, "nearLatitude": { "title": "Near latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Select the nearest stations to this point (give it with Near longitude)." }, "nearLongitude": { "title": "Near longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Longitude of the point (negative west of Greenwich)." }, "nearestCount": { "title": "Nearest stations", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many nearest stations to select (used only with the near point).", "default": 3 }, "maxDistanceKm": { "title": "Max distance (km)", "minimum": 1, "maximum": 200, "type": "number", "description": "Stations farther than this from the near point are not selected. If none is within range, the run fails before any request.", "default": 50 }, "families": { "title": "File families", "type": "array", "description": "Which daily files to read and join. Summary mode always uses RR-T-Vent only.", "items": { "type": "string", "enum": [ "RR-T-Vent", "autres-parametres" ], "enumTitles": [ "Rain, temperature, wind (RR-T-Vent)", "Other parameters (humidity, sunshine, snow, phenomena...)" ] }, "default": [ "RR-T-Vent" ] }, "dateFrom": { "title": "Date from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD, on or after 2025-01-01. Default: dateTo minus 30 days. Ignored in monitor mode." }, "dateTo": { "title": "Date to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD, not after today (UTC). Default: the newest date in the fetched files. Ignored in monitor mode." }, "summaryPeriod": { "title": "Summary period", "enum": [ "month", "range" ], "type": "string", "description": "Summary mode: one row per station per calendar month (intersected with the range), or one row for the whole range.", "default": "month" }, "heatingBaseC": { "title": "Heating degree-day base (°C)", "minimum": -10, "maximum": 30, "type": "number", "description": "HDD = max(0, base - (TN+TX)/2).", "default": 18 }, "coolingBaseC": { "title": "Cooling degree-day base (°C)", "minimum": -10, "maximum": 30, "type": "number", "description": "CDD = max(0, (TN+TX)/2 - base).", "default": 18 }, "rainThresholdMm": { "title": "Rain day threshold (mm)", "minimum": 0.1, "maximum": 500, "type": "number", "description": "Rain day: RR >= threshold.", "default": 1 }, "frostThresholdC": { "title": "Frost day threshold (°C)", "minimum": -40, "maximum": 10, "type": "number", "description": "Frost day: TN <= threshold.", "default": 0 }, "gustThresholdMs": { "title": "Gust day threshold (m/s)", "minimum": 1, "maximum": 100, "type": "number", "description": "Gust day: FXI (instantaneous gust at 10 m) >= threshold.", "default": 16 }, "excludeUnvalidated": { "title": "Exclude unvalidated values", "type": "boolean", "description": "Summaries: when on, only quality codes 0/1 count as usable; when off, 0/1/9. Quality 2 (doubtful) is never used.", "default": false }, "lookbackDays": { "title": "Monitor lookback (days)", "minimum": 3, "maximum": 90, "type": "integer", "description": "Monitor window: the newest available date and the days before it.", "default": 45 }, "emitQualityOnlyChanges": { "title": "Emit quality-only changes", "type": "boolean", "description": "Monitor: also output station-days whose values are unchanged but whose quality codes changed (charged as station-day).", "default": false }, "snapshotKey": { "title": "Snapshot key", "pattern": "^[a-z0-9-]{1,63}$", "type": "string", "description": "Monitor: name of the stored snapshot (named key-value store meteofrance-daily-snapshots). Default: derived from the query." }, "maxRows": { "title": "Max charged rows", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Upper bound on charged rows. Observations/summary stop cleanly (truncated); monitor fails before pushing if the change set is larger.", "default": 10000 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }