# French EV Subsidy Eligibility Checker (ADEME) (`vigilant_jasmine/french-ev-subsidy-eligible-vehicles`) Actor Check which electric cars, vans and trucks are on the official ADEME lists eligible for French purchase subsidies. Search by brand or model, or export the full lists with TVV homologation codes and EEA manufacturing flags. Free. - **URL**: https://apify.com/vigilant\_jasmine/french-ev-subsidy-eligible-vehicles.md - **Developed by:** [DEV DEV](https://apify.com/vigilant_jasmine) (community) - **Categories:** Business, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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 ## French EV Subsidy Eligibility Checker (ADEME) ### What it does This Actor tells you **which electric vehicles are eligible for French purchase subsidies**, straight from the **official ADEME eligibility lists**. France only grants its EV incentives to vehicles that appear on a government-published list, and that list changes as models and manufacturing criteria evolve. This Actor makes all three lists searchable and exportable in one place: - **`car`** — passenger cars eligible for the *leasing social* scheme - **`van`** — light commercial vehicles (*VUL*) eligible for enhanced purchase aid - **`truck`** — heavy goods vehicles eligible for enhanced purchase aid Search by **brand or model**, or pass `*` to export a whole list. Each result includes the type-variant-version (TVV) homologation code and, where the source provides it, whether the **motor and battery are manufactured within the EEA** — the criteria driving eligibility. ### Input | Field | Type | Required | Description | |---|---|---|---| | `queries` | array of strings | no | Brands/models to check (e.g. `RENAULT`). Use `*` or leave empty to export the full list. Default `*`. | | `vehicleTypes` | array of strings | no | Any of `car`, `van`, `truck`. Empty = all three. | | `maxResultsPerQuery` | integer | no | Max vehicles per query and category, 1–1000. Default `100`. | ### Output One dataset item per eligible vehicle. Every item carries a `status` field: `found` (eligible), `not_found` (no vehicle matched — i.e. not on the list) or `error`. ```json { "query": "IVECO", "status": "found", "vehicleType": "truck", "categoryLabel": "Heavy goods vehicle — enhanced purchase aid", "subsidyScheme": "Aides bonifiees a l acquisition (poids lourds)", "isEligible": true, "brand": "IVECO", "model": "eDAILY", "group": "IVECO Group", "typeVariantVersion": "IS56CC2BA-FL21E3E", "eligibilityPeriod": "2026-06-01", "motorMadeInEea": null, "batteryMadeInEea": null, "source": "ADEME - Listes officielles des vehicules electriques eligibles aux aides (open data)" } ```` ### Use cases - **Fleet purchasing**: check before ordering whether a van or truck qualifies for the enhanced aid, and export the full list to build a shortlist. - **Dealership & leasing tools**: power an eligibility checker on a sales configurator, keyed on brand/model. - **Subsidy verification**: confirm a specific TVV homologation code is on the official list before filing an aid application. - **Market monitoring**: track which manufacturers gain or lose eligibility as the EEA manufacturing criteria are applied. ### Limitations & fair use - Eligibility is defined by the **official ADEME lists at the moment of the run**; these are updated by the administration, and a vehicle absent today may appear later (and vice versa). Always re-run before relying on the result for a filing. - A `not_found` result means no vehicle matched your query in that list — it is a strong hint that the model is not eligible, but check the brand spelling first. - The `motorMadeInEea` / `batteryMadeInEea` flags are only populated in the passenger-car list; they are `null` for vans and trucks because the source does not publish them. - This Actor reports **eligibility only**. It does not compute the subsidy amount, which depends on the buyer's situation. - Source: ADEME open data, **Licence Ouverte / Open Licence (Etalab)**. Attribution to ADEME is expected on redistribution. ### Pricing This Actor is **free**. You only pay your own Apify platform consumption (compute units), typically a fraction of a cent per run. ### More actors by this developer Reliable tools built on official French & EU open-data APIs — company data, compliance checks and B2B enrichment, including a **French EV charging stations finder (IRVE)**: **[see all actors by vigilant\_jasmine](https://apify.com/vigilant_jasmine)**. # Actor input Schema ## `queries` (type: `array`): One brand or model per line (e.g. RENAULT, eDAILY). Use \* (or leave empty) to export the whole eligibility list. ## `vehicleTypes` (type: `array`): Which official ADEME lists to search: car (passenger car, social leasing), van (light commercial vehicle) and/or truck (heavy goods vehicle). Leave empty to search all three. ## `maxResultsPerQuery` (type: `integer`): Maximum number of vehicles returned per query and per category (1-1000). ## Actor input object example ```json { "queries": [ "ALFA ROMEO", "*" ], "vehicleTypes": [ "car", "van", "truck" ], "maxResultsPerQuery": 10 } ``` # 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 = { "queries": [ "RENAULT", "IVECO" ], "vehicleTypes": [ "car", "van", "truck" ], "maxResultsPerQuery": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("vigilant_jasmine/french-ev-subsidy-eligible-vehicles").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 = { "queries": [ "RENAULT", "IVECO", ], "vehicleTypes": [ "car", "van", "truck", ], "maxResultsPerQuery": 10, } # Run the Actor and wait for it to finish run = client.actor("vigilant_jasmine/french-ev-subsidy-eligible-vehicles").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 '{ "queries": [ "RENAULT", "IVECO" ], "vehicleTypes": [ "car", "van", "truck" ], "maxResultsPerQuery": 10 }' | apify call vigilant_jasmine/french-ev-subsidy-eligible-vehicles --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=vigilant_jasmine/french-ev-subsidy-eligible-vehicles", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "French EV Subsidy Eligibility Checker (ADEME)", "description": "Check which electric cars, vans and trucks are on the official ADEME lists eligible for French purchase subsidies. Search by brand or model, or export the full lists with TVV homologation codes and EEA manufacturing flags. Free.", "version": "0.0", "x-build-id": "lGxOMQLSVJSfXQRdO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vigilant_jasmine~french-ev-subsidy-eligible-vehicles/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vigilant_jasmine-french-ev-subsidy-eligible-vehicles", "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/vigilant_jasmine~french-ev-subsidy-eligible-vehicles/runs": { "post": { "operationId": "runs-sync-vigilant_jasmine-french-ev-subsidy-eligible-vehicles", "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/vigilant_jasmine~french-ev-subsidy-eligible-vehicles/run-sync": { "post": { "operationId": "run-sync-vigilant_jasmine-french-ev-subsidy-eligible-vehicles", "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": { "queries": { "title": "Brands or models to check", "type": "array", "description": "One brand or model per line (e.g. RENAULT, eDAILY). Use * (or leave empty) to export the whole eligibility list.", "items": { "type": "string" } }, "vehicleTypes": { "title": "Vehicle types", "type": "array", "description": "Which official ADEME lists to search: car (passenger car, social leasing), van (light commercial vehicle) and/or truck (heavy goods vehicle). Leave empty to search all three.", "items": { "type": "string", "enum": [ "car", "van", "truck" ], "enumTitles": [ "Passenger car (social leasing)", "Light commercial vehicle", "Heavy goods vehicle" ] } }, "maxResultsPerQuery": { "title": "Max results per query and category", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of vehicles returned per query and per category (1-1000).", "default": 100 } } }, "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 } } } } } } } } } } ```