FFBB Basketball Clubs · French Directory

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

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 clubs that buy kits, balls, flooring	One department first, then All departments
Event or 3x3 organiser	Clubs that can host or fill a tournament	Your département + neighbouring codes
Agency / outbound	CRM feed with mailbox and phone	Overview or Outreach CRM view
Local authority / school sport	Territory map of basketball 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, federation club page, website when the club published one. Email and phone only when the federation published them — generic federation mailboxes are skipped. 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 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 while the run is still listing other departments.

Ready-made examples (published tasks)

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

What it extracts

Category	Fields
Identity	Club name, structure code, FFBB club id
Location	Department, town, postcode, address, GPS
Contact	Email, phone (when published)
Web	Club website, federation club page

Typical coverage

On a 20-club Paris export, every row has a club name, department and directory URL. Email, phone, GPS and website follow what the federation shows — empty fields are omitted. This Actor never invents a mailbox or a number.

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
maxConcurrency	integer	4	Departments in parallel (1–8)
delayBetweenRequests	integer	80	Pause between listing pages (ms)

Examples

Paris (Try):

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

Nationwide, paid plan, no row ceiling:

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

Corsica (2A / 2B) and Alsace:

{ "departments": ["2A", "2B", "67", "68"], "maxItems": 0 }

Output sample

{
  "clubId": "10000",
  "structureNumber": "CVL0045063",
  "structureName": "PUISEAUX AS",
  "departmentNumber": "45",
  "town": "PUISEAUX",
  "postalCode": "45390",
  "address": "MAIRIE",
  "latitude": 48.20426,
  "longitude": 2.47008,
  "contactEmail": "contact@as-puiseaux-45-basket.fr",
  "contactPhone": "02 38 33 52 75",
  "website": "https://as-puiseaux-45-basket.fr/",
  "url": "https://competitions.ffbb.com/ligues/cvl/comites/0045/clubs/cvl0045063"
}

You can download the dataset as JSON, HTML, CSV or Excel.

How it works

1. Reads the public FFBB club directory for each selected department.
2. Deduplicates clubs by identifier.
3. Writes each row to the dataset as soon as it is complete.

How much does it cost to scrape FFBB 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

Is scraping FFBB 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 FFBB?

This Actor only accesses data that FFBB 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 ffbb-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