# Ffr Clubs Scraper (`corent1robert/ffr-clubs-scraper`) Actor

Extract all French hiking club contacts from FFRandonnée (FFR) in minutes. No browser required—pure API. Get club names, addresses, phones, emails, websites, GPS coordinates, activities (randonnée pédestre, marche nordique, raquette), and Rando Santé labels.

- **URL**: https://apify.com/corent1robert/ffr-clubs-scraper.md
- **Developed by:** [Corentin Robert](https://apify.com/corent1robert) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$9.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## 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

## FFRandonnée Clubs Scraper | Extract French Hiking Club Data

Extract all **FFRandonnée club contacts** (French Hiking Federation) in minutes: name, email, phone, address, GPS coordinates, activities, and Rando Santé labels. No browser required—pure API extraction. Ideal for sports marketing, event organizers, and CRM enrichment.

**Last updated**: February 2026

---

### Why use this scraper?

**Extract French hiking club data** in minutes with structured contacts. Perfect for:

- **Sports / outdoor marketing**: Reach FFR club decision-makers (presidents, treasurers)
- **Event organizers**: Map clubs by region for partnerships (randonnée, marche nordique)
- **Data enrichment**: Add club contacts to CRM or databases with GPS coordinates

---

### What you get

Each club includes:

| Data | Description |
|------|-------------|
| **Club info** | Name, structure number, region, department |
| **Contact** | Address, phone, email, website, Facebook |
| **Location** | GPS coordinates (latitude, longitude) |
| **Activities** | Randonnée pédestre, Marche nordique, Raquette, Longe Côte, etc. |
| **Labels** | Rando Santé, recruitment status |
| **Link** | Club page on ffrandonnee.fr |
| **Phase 2** *(optional)* | Jours de sortie, durée sorties, lieux, tarif adhésion, transports, publics, téléphone permanence |

Output: **Apify dataset** (JSON) + **output.csv** (local runs).

---

### Key features

- **Fast**: API-based, no browser—scrape ~3000 clubs in minutes
- **Complete**: All 101 French departments (01–95, 2A, 2B, DOM-TOM)
- **Structured**: Deduplicated, validated, CSV-ready
- **Flexible**: Filter by department or scrape all

---

### How it works

1. Iterates over French department codes (01–95, 2A, 2B, 971–976)
2. Calls `POST /api/searchclub` with `Department` and `PageNumber`
3. Stops pagination using `TotalRecordCount` from the API
4. Deduplicates by structure number
5. Pushes to dataset + writes to `output.csv` (local)

---

### Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `departments` | string[] | `[]` | Department codes (e.g. `["01","75","69"]`). Empty = all |
| `maxConcurrency` | number | 15 | Departments in parallel (1–30) |
| `delayBetweenRequests` | number | 80 | Ms between API requests per department |
| `scrapeDetails` | boolean | `false` | **Phase 2**: Visit each club page to fetch extra fields (jours sortie, durée, lieux, tarif, transports, publics, tél. permanence). Slower but more complete. |
| `detailConcurrency` | number | 5 | Detail pages in parallel when Phase 2 enabled (1–10) |
| `detailDelayBetweenRequests` | number | 150 | Ms between detail page requests |

#### Example: all departments

```json
{
  "departments": [],
  "maxConcurrency": 5
}
````

#### Example: specific departments

```json
{
  "departments": ["01", "75", "69"],
  "maxConcurrency": 3
}
```

#### Example: Phase 2 — full details

```json
{
  "departments": ["05"],
  "scrapeDetails": true,
  "detailConcurrency": 5
}
```

***

### Usage

#### Local

```bash
apify run
```

Results: `output.csv` + `storage/datasets/default/` (not synced to Apify).

#### Apify Platform

```bash
apify push
```

Run from the Console. Results in Output tab and dataset.

***

### Output fields

| Field | Description |
|------|-------------|
| `id` | Unique club ID |
| `structureNumber` | FFR structure number |
| `structureName` | Club name |
| `regionName`, `departmentName` | Location |
| `contact` | name, firstName, addressLine1, town, postalCode, phoneNumber1, email, websiteUrl |
| `latitude`, `longitude` | GPS coordinates |
| `labelRandoSante` | Rando Santé label |
| `recrute` | Club recruiting |
| `clubActivityList` | Activities practiced |
| `url` | Club page on ffrandonnee.fr |
| `jours_sortie` | *(Phase 2)* Days of outings (Lundi, Mardi, …) |
| `duree_sorties` | *(Phase 2)* Half-day, full day, multi-day |
| `lieux` | *(Phase 2)* Main locations (Moyenne montagne, Montagne, …) |
| `tarif_adhesion` | *(Phase 2)* Membership fee (€) |
| `transports` | *(Phase 2)* Car, co-voiturage, etc. |
| `publics` | *(Phase 2)* Target audiences (Actifs, Retraités) |
| `telephone_permanence` | *(Phase 2)* Permanence phone number |

***

### Resources

- [FFRandonnée - Trouver un club](https://www.ffrandonnee.fr/nos-clubs/trouver-un-club)
- [Apify SDK](https://docs.apify.com/sdk/js)

# Actor input Schema

## `departments` (type: `array`):

Department codes to scrape (e.g. 01, 75, 69). Empty = all 99 departments (2A/2B excluded).

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

Departments processed in parallel (1–30). Higher = faster.

## `delayBetweenRequests` (type: `integer`):

Delay between API requests per department. Increase if rate limited.

## `scrapeDetails` (type: `boolean`):

Visit each club page to fetch extra fields: jours sortie, durée, lieux, tarif adhésion, transports, publics, téléphone permanence. Slower but more complete.

## `detailConcurrency` (type: `integer`):

Club detail pages fetched in parallel when Phase 2 enabled (1–10).

## `detailDelayBetweenRequests` (type: `integer`):

Delay between detail page requests when Phase 2 enabled.

## Actor input object example

```json
{
  "departments": [],
  "maxConcurrency": 15,
  "delayBetweenRequests": 80,
  "scrapeDetails": false,
  "detailConcurrency": 5,
  "detailDelayBetweenRequests": 150
}
```

# Actor output Schema

## `dataset` (type: `string`):

Access dataset items via API

# 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 = {
    "departments": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("corent1robert/ffr-clubs-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 = { "departments": [] }

# Run the Actor and wait for it to finish
run = client.actor("corent1robert/ffr-clubs-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 '{
  "departments": []
}' |
apify call corent1robert/ffr-clubs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=corent1robert/ffr-clubs-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Ffr Clubs Scraper",
        "description": "Extract all French hiking club contacts from FFRandonnée (FFR) in minutes. No browser required—pure API. Get club names, addresses, phones, emails, websites, GPS coordinates, activities (randonnée pédestre, marche nordique, raquette), and Rando Santé labels.",
        "version": "0.1",
        "x-build-id": "lj9z04Fmm0VSLzkUW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/corent1robert~ffr-clubs-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-corent1robert-ffr-clubs-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/corent1robert~ffr-clubs-scraper/runs": {
            "post": {
                "operationId": "runs-sync-corent1robert-ffr-clubs-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/corent1robert~ffr-clubs-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-corent1robert-ffr-clubs-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": {
                    "departments": {
                        "title": "Departments",
                        "type": "array",
                        "description": "Department codes to scrape (e.g. 01, 75, 69). Empty = all 99 departments (2A/2B excluded).",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxConcurrency": {
                        "title": "Max parallel departments",
                        "minimum": 1,
                        "maximum": 30,
                        "type": "integer",
                        "description": "Departments processed in parallel (1–30). Higher = faster.",
                        "default": 15
                    },
                    "delayBetweenRequests": {
                        "title": "Delay (ms)",
                        "minimum": 0,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Delay between API requests per department. Increase if rate limited.",
                        "default": 80
                    },
                    "scrapeDetails": {
                        "title": "Scrape detail pages (Phase 2)",
                        "type": "boolean",
                        "description": "Visit each club page to fetch extra fields: jours sortie, durée, lieux, tarif adhésion, transports, publics, téléphone permanence. Slower but more complete.",
                        "default": false
                    },
                    "detailConcurrency": {
                        "title": "Detail pages concurrency",
                        "minimum": 1,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Club detail pages fetched in parallel when Phase 2 enabled (1–10).",
                        "default": 5
                    },
                    "detailDelayBetweenRequests": {
                        "title": "Detail delay (ms)",
                        "minimum": 50,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Delay between detail page requests when Phase 2 enabled.",
                        "default": 150
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```