This tutorial shows how to scrape HelloAsso association emails into a reviewable CSV with the HelloAsso Association Emails Scraper for UScraper. You will prepare input URLs, import the workflow, set the export path, validate rows, and decide when the official API or a hosted scraper is a better fit.
Scope
Prerequisites for scraping HelloAsso emails
You need UScraper installed as a local desktop app, the published JSON from the template page, and a short list of HelloAsso URLs you are allowed to review. Start with one category URL and one direct association profile. This keeps the first run small enough to compare against the browser before you trust a larger export.
Use this tutorial for visible association research, partnership mapping, nonprofit directory review, and contact list validation. Do not use it to bypass login walls, defeat anti-bot controls, collect private data, or build spam campaigns.
The useful unit is not "every HelloAsso email." It is an approved input URL, a traceable detail URL, and a CSV row your team can audit later.
Before running commercial outreach, review HelloAsso's live pages and terms, Google's robots.txt guidance, CNIL guidance on web scraping and legitimate interest, and CNIL's French guidance on commercial prospecting. Legal review matters more than any scraper setting.
Workflow anatomy
How the HelloAsso association email scraper works
The workflow definition is maintained on the HelloAsso Association Emails Scraper template page. Import that JSON instead of rebuilding the graph from screenshots or copying selectors from an old article.
| Block | What it does | What to check |
|---|---|---|
Navigate | Opens your HelloAsso search, category, or detail URLs | Replace sample URLs with approved research inputs. |
Wait for Page Load and Sleep | Gives dynamic profile content time to render | Increase waits for slow pages or partial rows. |
Inject JavaScript | Discovers association detail URLs and builds hidden export rows | Confirm row count before scaling beyond a test batch. |
Structured Export | Writes CSV rows from .uscraper-ha-row elements | Check filename, save folder, headers, and append mode. |
Element Exists and Click | Follows the generated next-page control when present | Stop when pagination disappears or rows repeat. |
Loop Continue | Advances to the next configured input URL | Keep source URLs beside exported rows for audit. |
The export shape comes from the JSON workflow. The bundle does not include a separate CSV sample, so your first browser-verified run is the sample that matters.
{
"project": {
"name": "Helloasso Association Emails Scraper"
},
"blocks": [
{
"title": "Navigate",
"config": {
"urls": [
"https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement",
"https://www.helloasso.com/e/recherche/associations?category_tags=animaux"
]
}
},
{
"title": "Structured Export",
"config": {
"rowSelector": ".uscraper-ha-row",
"fileName": "helloasso-association-emails-scraper.csv",
"includeHeaders": true,
"fileMode": "append",
"columns": [
{ "name": "url_entree", "selector": ".url_entree", "attribute": "text" },
{ "name": "titre", "selector": ".titre", "attribute": "text" },
{ "name": "email", "selector": ".email", "attribute": "text" },
{ "name": "telephone", "selector": ".telephone", "attribute": "text" },
{ "name": "url_detail", "selector": ".url_detail", "attribute": "text" }
]
}
}
]
}
Runbook
Step-by-step tutorial: extract HelloAsso association contacts
Choose approved HelloAsso inputs
Use the HelloAsso directory, category pages, search pages, or known association profile URLs. Keep the research purpose and source category beside each input.
Import the maintained template
Open HelloAsso Association Emails Scraper, download the JSON, and import it into UScraper.
Edit Navigate URLs
Replace the starter URLs with your approved HelloAsso list. Run one direct profile and one listing URL before adding more categories.
Set the export location
In Structured Export, confirm helloasso-association-emails-scraper.csv, choose your save folder, keep headers enabled, and keep append mode on for multi-page batches.
Run and verify
Compare the CSV with the source profile, check detail URLs, deduplicate repeated associations, and expand only after the first rows match the browser.
If a listing page returns zero rows, test a direct profile URL next. That separates "the profile has no visible contact field" from "the listing did not expose profile links in the DOM."
Validate the CSV export
helloasso-association-emails-scraper.csvColumn
url_entree
The search, category, or detail URL that started the current pass.
Column
titre
Association name from the page heading or metadata.
Column
description
Mission or profile summary when visible.
Column
adresse
Postal address inferred from structured data or page text.
Column
Visible public email address detected on the profile.
Column
telephone
Phone number pattern detected from visible text.
Column
site
External association website linked from the profile.
Column
url_detail
Canonical HelloAsso association profile URL for audit and deduplication.
Your validation pass should answer four questions: did every row keep its source URL, did each email appear on the linked detail page, did pagination create duplicates, and are blank fields explainable by the source page? Save that note with the CSV so a teammate can reproduce the decision.
Alternatives
HelloAsso API vs scraping vs hosted tools
HelloAsso provides an official API overview, a directory organizations endpoint, a public organization details endpoint, an OpenAPI repository, and an official Python SDK. Use those paths first when you have credentials, partner approval, or an integration requirement.
| Approach | Best fit | Trade-off |
|---|---|---|
| UScraper local desktop app | Reviewable CSV exports from approved public URLs | You maintain input lists, waits, selectors, and compliance notes. |
| Official HelloAsso API | Sanctioned integrations, account workflows, and developer-maintained access | Requires API setup, credentials, and endpoint fit for your data need. |
| Hosted scrapers and AI agents | Managed runs, scheduling, or cloud delivery | Data passes through another vendor and costs may scale by run or row. |
| Custom Python scripts | Engineering teams that want full control | You own code, retries, selectors, storage, and legal review. |
Hosted tools such as Octoparse, Spider.cloud, and AgentQL can be useful when you want managed infrastructure or a cloud workflow. The UScraper template is better when the priority is a local CSV, small reviewed batches, and transparent workflow edits inside a desktop app.
Common issues when HelloAsso contacts are missing
The association may not publish that field, the field may be behind a contact form, or the page may render it after the current wait time. Increase the sleep, inspect the profile manually, and avoid inventing missing contact data.
Download the HelloAsso scraper template
Use the template page as the download and maintenance path: HelloAsso Association Emails Scraper. For adjacent workflows, browse the UScraper templates library or the broader UScraper blog for CSV export tutorials.
Run the first batch slowly, keep the source URLs in the export, and treat every email as a record that needs a lawful purpose before outreach.