FFHandball Clubs · French Directory

Export French handball club contacts from the public FFHandball (Fédération Française de Handball) directory. Pick a department (or nationwide) and get one row per club: name, address, published email, phone, GPS, website and club page.

No login. No API key. No federation account.

Who is this for?

You are…	Typical goal	Suggested setup
Sportswear or equipment brand	Prospect list of FFHandball clubs	One department first, then All departments
Event or tournament organiser	Clubs that can host or relay a match	Your département + neighbouring codes
Agency / outbound	CRM feed with email, phone and website	Overview or Outreach CRM view
Local authority / school sport	Territory map of handball clubs	One code, then neighbours
Data / ops	Scheduled master table of the federation	departments: ["ALL"], maxItems: 0

What you get by default. Club name, department, address, GPS and public club page. Email is the mailbox published on the club sheet — including the club’s Gesthand address (1234567@ffhandball.net). HQ inboxes (contact@ffhandball.net) are omitted. Phone, website, Facebook and Instagram follow what the club published. This Actor never invents a mailbox.

When to go nationwide. Use All departments on a paid plan with maxItems: 0. Corsica (2A / 2B) and overseas departments (including Réunion 974) are included.

How to use

1. Open the Actor in Apify Console.
2. Pick one or more departments, or All departments.
3. Keep Max clubs at 20 for a first run (Free plan is always 20 per run). Set 0 on a paid plan for a full export of the selection.
4. Click Start. Rows appear in the Dataset as club pages are opened.

Ready-made examples (published tasks)

Example	Best for
Find Paris handball clubs with published contacts	First run / Île-de-France
Rhône handball clubs, CRM-ready emails and phones	CRM import
La Réunion FFHandball club directory	Overseas department
Find Ain handball clubs from the FFHandball directory	B2B test / Auvergne-Rhône-Alpes

What it extracts

Category	Fields
Identity	Club name, federation club id
Location	Department, town, postcode, address, GPS
Contact	Email (club Gesthand inbox when that is what the federation lists), phone
Web	Club website (including Facebook when that is the URL on the club sheet), Instagram when published
Page	Link to the public Mon Club profile

Typical coverage

On a 20-club Paris export, every row has a club name, department, profile URL and the published Gesthand mailbox. Phone, website and social links follow what the federation shows — empty when the club did not publish them.

Input

Field	Type	Default	Notes
departments	array	["75"]	Department codes, or ALL for nationwide including Corsica. Omitted = Paris. Empty array = nationwide.
maxItems	integer	20	0 = no row ceiling. Free plan: 20 / run.

API-only keys

Not shown on the Console form. Safe defaults are already in code.

Key	Type	Default	Notes
delayBetweenRequests	integer	80	Pause between club pages (ms)

Examples

Paris (Try):

{ "departments": ["75"], "maxItems": 20 }

Nationwide, paid plan, no row ceiling:

{ "departments": ["ALL"], "maxItems": 0 }

Output sample

Download in JSON, CSV, Excel, or HTML from the Dataset tab.

{
  "clubId": "3214",
  "structureName": "PARIS SAINT-GERMAIN HANDBALL",
  "departmentNumber": "75",
  "town": "PARIS 16e",
  "postalCode": "75016",
  "address": "82 avenue georges lafont",
  "latitude": 48.85711,
  "longitude": 2.26286,
  "contactPhone": "06 09 56 31 66",
  "website": "https://www.psghandasso.com",
  "url": "https://monclub.ffhandball.fr/clubs/paris-saint-germain-handball/"
}

How it works

1. Reads the public FFHandball club directory for the selected departments.
2. Keeps clubs whose postcode maps to that department (Réunion is 974, not 97; Corsica is 2A / 2B).
3. Opens each public club page for published contacts (HQ federation mailboxes skipped; club Gesthand inboxes kept).
4. Writes each row to the dataset as soon as it is complete.

How much does it cost to scrape FFHandball clubs?

HTTP-only — no browser. You pay pay-per-event on the Store: about $0.00749 per exported club plus a negligible run start.

Scenario	Approx. cost
20 clubs (Try / Free plan)	~$0.15
1,000 clubs	~$7.49
Full selection with maxItems: 0	$0.00749 × clubs exported

Tiers (per club row, list prices): FREE $0.00749 · Bronze $0.00749 · Silver $0.00749 · Gold $0.00749. Actor start is $0.00005 per GB of memory (minimum one event).

Is scraping FFHandball free?

Apify Free plan users get 20 clubs per run. Paid plans follow PPE and your max charge. Compute is cheap because this Actor does not launch a browser.

Is it legal to scrape FFHandball?

This Actor only accesses data that FFHandball makes publicly available in its club directory. As with any data containing personal information, ensure your use complies with GDPR and relevant regulations.

Local development

cd ffhandball-clubs-scraper
npm install
apify run --input-file=./.actor/INPUT.json

storage/key_value_stores/default/INPUT.json must satisfy the input schema, or pass --input-file. On local apify run, platform/CLI input overwrites overlapping keys from a root input.json.

Support

Contact corentin@outreacher.fr if you need a custom scraper or tailored automation.

Also available

Also available as a pack: France Sports Clubs hub — merge several federations into one dataset.

Same job (French department → published club contacts). One Actor per federation.

Sport	Actor
Hiking (FFRandonnée)	ffr-clubs-scraper
Athletics (FFA)	ffa-clubs-scraper
Judo (FFJDA)	ffjda-clubs-scraper
Rugby (FFR)	ffr-rugby-clubs-scraper
Equestrian (FFE)	ffe-clubs-scraper
Swimming (FFN)	ffn-clubs-scraper
Basketball (FFBB)	ffbb-clubs-scraper
Handball (FFHandball)	ffhandball-clubs-scraper
Volleyball (FFVolley)	ffvolley-clubs-scraper
Climbing (FFME)	ffme-clubs-scraper
Canoe (FFCK)	ffck-clubs-scraper
Golf (FFGolf)	ffgolf-clubs-scraper
Chess (FFÉchecs)	ffechecs-clubs-scraper
Gymnastics (FFGym)	ffgym-clubs-scraper
Badminton (FFBaD)	ffbad-clubs-scraper
Football (FFF)	fff-clubs-scraper