# Chargefinder Scraper (`datascrapers/chargefinder-scraper`) Actor

Scrape EV charging stations from Chargefinder by location search or charger URL. Extract map listings and optional outlet-level charger details.

- **URL**: https://apify.com/datascrapers/chargefinder-scraper.md
- **Developed by:** [Data Scrapers](https://apify.com/datascrapers) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 chargers

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

**Chargefinder Scraper** creates a structured dataset of electric-vehicle charging stations collected from Chargefinder. Each dataset item is one station and can include the station id, title, public URL, address, city, country, coordinates, operator, kilowatt range, plug counts, and a details flag. Query the source with `searchQueries` such as a city or island, or with Chargefinder `startUrls`. Set `maxItems` to cap the run, and turn on `scrapeChargerDetails` when outlet lists are needed. Retrieve records through the Apify Dataset API or export them as JSON, CSV, Excel, or XML.

[![Chargefinder Scraper — input to structured data](https://raw.githubusercontent.com/faizanalii/apify-actor-assets/main/chargefinder-scraper/chargefinder-scraper-value-demo.gif)](https://apify.com/datascrapers/chargefinder-scraper)

### Dataset at a glance

| Property | Value |
|---|---|
| Source | chargefinder.com |
| Record unit | One charging station |
| Input methods | `searchQueries`, `startUrls` |
| Main identifiers | `id`, `url` |
| Delivery | Apify Dataset and API |
| Export formats | JSON, CSV, Excel, XML |
| Update model | Fresh records per Actor run |
| Pricing | $1.50 per 1,000 `charger` events; $2.00 per 1,000 `charger-details` events. Platform usage is not billed. |

### Coverage and available records

Supported starts are place names (`Ibiza`, `Paris`, `Italy`) and Chargefinder charger or location URLs. Country searches stay inside that country. City and island queries use the matching map extent. `language` controls the site language used for search and constructed station links (`en`, `de`, `fr`, `es`, `it`, `nl`, `sv`, `no`, `da`, `fi`, `pl`, `is`).

`maxItems` of `0` means no charger cap. `scrapeChargerDetails` is off by default. When it is on, a successful detail fetch adds outlet groups, hours, access, and live status and fires `charger-details`. A station that fails the detail request is still saved from the map card and is not charged for details.

### Data dictionary

| Field | Type | Nullable | Description | Example |
|---|---|---:|---|---|
| id | string | no | Chargefinder station slug. Deduplication key. | mz7622 |
| title | string | yes | Station name on Chargefinder | Hotel Melia ME Ibiza |
| url | string | yes | Public charger page | https://chargefinder.com/en/charging-station-s-argamassa-hotel-melia-me-ibiza/mz7622 |
| address | string | yes | Street address | Avinguda de s Argamassa, 153, S Argamassa, Spain |
| city | string | yes | Locality | S Argamassa |
| country | string | yes | Country name | Spain |
| countryCode | string | yes | Country code | ES |
| latitude | number | yes | Latitude | 38.992292 |
| longitude | number | yes | Longitude | 1.569429 |
| operator | string | yes | Network operator | Wenea |
| minCapacityKw | number | yes | Lowest posted power | 22 |
| maxCapacityKw | number | yes | Highest posted power | 100 |
| mapInfo | string | yes | Map card summary | Wenea 22-100kW |
| detailsFetched | boolean | no | True when charger details were attached | true |
| sourceQuery | string | yes | Query that produced the station | Ibiza |
| outletList | array | yes | Outlet groups. Present when details were fetched. | CCS, 100 kW |

### Example dataset record

This row is a saved Chargefinder station from an Ibiza search with details enabled. Outlet identifiers that are equipment names are omitted here.

```json
{
  "id": "mz7622",
  "title": "Hotel Melia ME Ibiza",
  "url": "https://chargefinder.com/en/charging-station-s-argamassa-hotel-melia-me-ibiza/mz7622",
  "latitude": 38.992292,
  "longitude": 1.569429,
  "city": "S Argamassa",
  "country": "Spain",
  "countryCode": "ES",
  "address": "Avinguda de s Argamassa, 153, S Argamassa, Spain",
  "operator": "Wenea",
  "access": "visitors",
  "openingHours": "24/7",
  "minCapacityKw": 22,
  "maxCapacityKw": 100,
  "mapInfo": "Wenea 22-100kW",
  "detailsFetched": true,
  "sourceQuery": "Ibiza",
  "outletCount": 1
}
```

### Query and input reference

| Field | Type | Description |
|---|---|---|
| searchQueries | array of strings | Places to search. The best matching country, city, or island becomes the map area. |
| startUrls | array | Chargefinder charger or location URLs. |
| language | string | Site language. Default `en`. |
| scrapeChargerDetails | boolean | Fetch outlets and live status. Default `false`. Charges `charger-details` only when extras attach. |
| maxItems | integer | Maximum chargers. `0` means no cap. |
| maxConcurrency | integer | Parallel workers, 1 to 20. Default `10`. |
| proxyConfiguration | object | Apify proxy settings. Residential is the intended default. |

### Retrieve the data through the API

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR-APIFY-TOKEN")
run = client.actor("datascrapers/chargefinder-scraper").call(run_input={
    "searchQueries": ["Ibiza"],
    "scrapeChargerDetails": True,
    "language": "en",
    "maxItems": 8,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["id"], item["title"], item["maxCapacityKw"])
```

### Data quality and record handling

Deduplicate on `id`. The same station can appear again on a later run if it is still inside the map area. `detailsFetched` is false when the detail request did not attach extras, and that station is not charged `charger-details`. Coordinates and power values are taken from Chargefinder as returned. A missing operator or address stays null.

### Pricing and cost examples

| Event | When it fires | Free | Bronze | Silver | Gold |
|---|---|---:|---:|---:|---:|
| charger | Every station saved | $1.50 / 1,000 | $1.40 / 1,000 | $1.30 / 1,000 | $1.20 / 1,000 |
| charger-details | Details attached | $2.00 / 1,000 | $1.90 / 1,000 | $1.80 / 1,000 | $1.70 / 1,000 |

Platinum and Diamond use the Gold rates. Platform usage is not billed to the user.

A run that saves 1,000 stations with details off costs $1.50 on the Free plan. The same 1,000 stations with details attached cost $1.50 plus $2.00 on Free, or $1.20 plus $1.70 on Gold.

### Limitations and responsible data use

Chargefinder can change map tiles, station slugs, and live status without notice. Live outlet status is a point-in-time reading, not a reservation. Use the data for network research and routing analysis. Do not present a scraped status as a guarantee that a stall is free.

### Dataset questions

#### What is one record?

One Chargefinder charging station, identified by `id`.

#### Does every record include live outlet status?

Only when `scrapeChargerDetails` is on and `detailsFetched` is true.

#### Which field should a pipeline use as the key?

`id`.

### Related datasets from Data Scrapers

- [AutoScout24 Scraper](https://apify.com/datascrapers/autoscout24-scraper)
- [Autotrader Scraper](https://apify.com/datascrapers/autotrader-scraper)
- [Cars Scraper](https://apify.com/datascrapers/cars-scraper)
- [CarMax Scraper](https://apify.com/datascrapers/carmax-scraper)

### Data Scrapers support

Questions about this dataset: stardustspotlight@gmail.com.

# Actor input Schema

## `searchQueries` (type: `array`):

Places to scrape on Chargefinder (e.g. "Ibiza", "Paris", "Italy"). Primary input for AI agents — no URL required. The best matching country, city, or island is used as the map area.

## `startUrls` (type: `array`):

Chargefinder charger or location URLs (e.g. "https://chargefinder.com/en/charging-station-ibiza-port/abc123"). Optional — use search locations when you do not have a URL.

## `language` (type: `string`):

Chargefinder site language for search and constructed charger URLs (e.g. en, de, fr, es, it).

## `scrapeChargerDetails` (type: `boolean`):

When enabled, fetch outlet lists, contact info, and live status for each charger (charged as a separate charger-details event). Disabled by default.

## `maxConcurrency` (type: `integer`):

Parallel HTTP workers for map tiles and charger details (e.g. 10). Higher is faster; keep moderate to avoid blocks.

## `maxItems` (type: `integer`):

Maximum chargers to scrape (0 = unlimited)

## `proxyConfiguration` (type: `object`):

Proxy settings. Apify Residential is recommended.

## Actor input object example

```json
{
  "searchQueries": [
    "Ibiza"
  ],
  "startUrls": [
    {
      "url": "https://chargefinder.com/de/stromtankstelle-valga-valga-selver/qj5ye5"
    }
  ],
  "language": "en",
  "scrapeChargerDetails": false,
  "maxConcurrency": 10,
  "maxItems": 0,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

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

Dataset of scraped Chargefinder charging stations

## `runStats` (type: `string`):

Aggregate scrape statistics including charger and details counts

# 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 = {
    "searchQueries": [
        "Ibiza"
    ],
    "startUrls": [
        {
            "url": "https://chargefinder.com/de/stromtankstelle-valga-valga-selver/qj5ye5"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("datascrapers/chargefinder-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["Ibiza"],
    "startUrls": [{ "url": "https://chargefinder.com/de/stromtankstelle-valga-valga-selver/qj5ye5" }],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("datascrapers/chargefinder-scraper").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 '{
  "searchQueries": [
    "Ibiza"
  ],
  "startUrls": [
    {
      "url": "https://chargefinder.com/de/stromtankstelle-valga-valga-selver/qj5ye5"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call datascrapers/chargefinder-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datascrapers/chargefinder-scraper"
        }
    }
}
```

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/Xx9XFGmBtK8PYYD5F/builds/OzVGcBwWKU51RqQNv/openapi.json