# Helloasso Association Emails Scraper

Scrape email addresses of associations on the helloasso website using URLs.

- Template page: [https://www.octoparse.com/template/helloasso-association-emails-scraper](https://www.octoparse.com/template/helloasso-association-emails-scraper)
- Categories: Lead Generation, Directories
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$2/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages, detail pages.

## Output

The current workflow extracts 8 fields, including `Adresse`, `Description`, `Email`, `Site`, `Titre`, `Téléphone`, `URL_détail`, `URL_entrée`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete URLs (up to 300), PageSize and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URLs (up to 300)

Required. urls Constraints: minItems=1; maxItems=300; items.minLength=1; items.maxLength=1000.

### PageSize

Optional. PageSize

## How to Use

## Helloasso Association Emails Scraper

Collects email addresses of associations from Helloasso (`https://www.helloasso.com/`) using provided URLs.

### Input

- **URLs** (required, up to 300): One URL per line.
- **PageSize** (optional): Enter a number.

### Output

Each row contains these fields:

- `URL_entrée`
- `Titre`
- `Description`
- `Adresse`
- `Email`
- `Téléphone`
- `Site`
- `URL_détail`

### Pricing

**$2 / 1,000 lines** – billed by the number of output lines produced.

### How to Use

1. Open the template and select **Try it** or **Start**.
2. Enter the input values.
3. Run the task in the cloud.
4. Review the output rows and export or process the data.

### Limitations

- Only collects data that Helloasso displays on detail pages.
- Fields such as `Téléphone`, `Site`, and `URL_détail` may be empty if the source does not provide them.

### Tips

- Start with a few inputs and review results before scaling.
- Use the most specific valid URLs (up to 300) to reduce unrelated or duplicate records.
- Use a stable identifier from the output fields as a deduplication key.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Pagesjaunes Emails Scraper](https://www.octoparse.com/template/pagesjaunes_emails_scraper)
- [eBay Listing Page Scraper (by keyword)](https://www.octoparse.com/template/ebay-product-list-scraper-by-keyword)
- [eBay Scraper](https://www.octoparse.com/template/ebay-scraper)
- [Google Search Scraper](https://www.octoparse.com/template/google-search-scraper)

## Input Schema

```json
{
  "title": "Helloasso Association Emails Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRLs": {
      "title": "URLs (up to 300)",
      "description": "urls",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1000
      },
      "minItems": 1,
      "maxItems": 300,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "pageSize": {
      "title": "PageSize",
      "description": "PageSize",
      "type": "integer",
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "uRLs": [
    "https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement",
    "https://www.helloasso.com/e/recherche/associations?category_tags=animaux"
  ]
}
```

Example 2

```json
{
  "uRLs": [
    "https://www.helloasso.com/e/recherche/associations?category_tags=animaux"
  ]
}
```

Example 3

```json
{
  "pageSize": 20,
  "uRLs": [
    "https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement",
    "https://www.helloasso.com/e/recherche/associations?category_tags=animaux"
  ]
}
```

Example 4

```json
{
  "pageSize": 10,
  "uRLs": [
    "https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement",
    "https://www.helloasso.com/e/recherche/associations?category_tags=animaux"
  ]
}
```

Example 5

```json
{
  "uRLs": [
    "https://www.helloasso.com/e/recherche/associations?category_tags=animaux"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Adresse": {
      "type": "string",
      "description": ""
    },
    "Description": {
      "type": "string",
      "description": ""
    },
    "Email": {
      "type": "string",
      "description": ""
    },
    "Site": {
      "type": "string",
      "description": ""
    },
    "Titre": {
      "type": "string",
      "description": ""
    },
    "Téléphone": {
      "type": "string",
      "description": ""
    },
    "URL_détail": {
      "type": "string",
      "description": ""
    },
    "URL_entrée": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Helloasso Association Emails Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Adresse": "Route de la Laupie 26160 Bonlieu-sur-Roubion",
  "Description": "L'ADAF est un espace ressource, de formation, de conseil et d'accompagnement pour les projets en agroforesterie et agroécologie. Nous œuvrons pour une agriculture viable, respectueuse de l'environnement ET du vivant !",
  "Email": "contact@adaf26.org",
  "Site": "www.adaf26.org",
  "Titre": "ADAF - Arbre et Sol Vivant",
  "Téléphone": "06 28 78 68 67",
  "URL_détail": "https://www.helloasso.com/associations/adaf-arbre-et-sol-vivant",
  "URL_entrée": "https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement"
}
```

Example 2

```json
{
  "Adresse": "185 Chemin des Agriculteurs 26700 Pierrelatte",
  "Description": "Le Refuge de l’Espoir / SPA de Pierrelatte et du Tricastin a pour vocation d’accueillir, d’héberger, de soigner et de replacer les animaux abandonnés, saisis ou trouvés errants après leur délai de fourrière",
  "Email": "espoir.spa26@gmail.com",
  "Site": "https://www.refuge-animaux-pierrelatte.com/",
  "Titre": "Refuge de l'Espoir / SPA de Pierrelatte et du Tricastin",
  "Téléphone": "0682367711",
  "URL_détail": "https://www.helloasso.com/associations/refuge-de-l-espoir-spa-de-pierrelatte-et-du-tricastin",
  "URL_entrée": "https://www.helloasso.com/e/recherche/associations?category_tags=animaux"
}
```

Example 3

```json
{
  "Adresse": "Le Helleux 97180 Sainte-Anne",
  "Description": "Association loi 1901 de protection de l'environnement et de promotion et expérimentation d'alternatives durables (permaculture, bioconstruction, transition énergétique, autonomie).\n\nRetrouvez notre programme ici : koudmen, stages pratiques en permaculture, ateliers parent-enfants, koudmen etc.",
  "Email": "rezilyans971@gmail.com",
  "Site": "http://www.rezilyans-guadeloupe.org",
  "Titre": "Rézilyans 971",
  "Téléphone": "0637114045",
  "URL_détail": "https://www.helloasso.com/associations/rezilyans-971",
  "URL_entrée": "https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement"
}
```

Example 4

```json
{
  "Adresse": "Le Helleux 97180 Sainte-Anne",
  "Description": "Association loi 1901 de protection de l'environnement et de promotion et expérimentation d'alternatives durables (permaculture, bioconstruction, transition énergétique, autonomie).\n\nRetrouvez notre programme ici : koudmen, stages pratiques en permaculture, ateliers parent-enfants, koudmen etc.",
  "Email": "rezilyans971@gmail.com",
  "Site": "http://www.rezilyans-guadeloupe.org",
  "Titre": "Rézilyans 971",
  "Téléphone": "0637114045",
  "URL_détail": "https://www.helloasso.com/associations/rezilyans-971",
  "URL_entrée": "https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement"
}
```

Example 5

```json
{
  "Adresse": "5 Rue Lucie Aubrac 69310 Pierre-Bénite",
  "Description": "Initiez-vous ou perfectionnez-vous à la danse, dans un club à taille humaine mais plein d'ambition. \nDans un cadre privilégiez de 100 m² venez faire vos premiers pas de bachata ou Modern'Jazz entre autres.\nNous accueillons les enfants à partir de 4 ans et à tout âge sans niveaux particuliers",
  "Email": "plpbdanse@gmail.com",
  "Site": "https://www.plpbdanse.com",
  "Titre": "PLPB Danse",
  "Téléphone": "0650664831",
  "URL_détail": "https://www.helloasso.com/associations/plpb-danse",
  "URL_entrée": "https://www.helloasso.com/e/recherche/associations?category_tags=animaux"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "helloasso-association-emails-scraper",
  "taskName": "Helloasso Association Emails Scraper",
  "parameters": "{\"uRLs\":[\"https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement\",\"https://www.helloasso.com/e/recherche/associations?category_tags=animaux\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"uRLs\":[\"https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement\",\"https://www.helloasso.com/e/recherche/associations?category_tags=animaux\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "helloasso-association-emails-scraper",
        "taskName": "Helloasso Association Emails Scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "helloasso-association-emails-scraper",
  "taskName": "Helloasso Association Emails Scraper",
  "parameters": "{\"uRLs\":[\"https://www.helloasso.com/e/recherche/associations?category_tags=ecologie--et--environnement\",\"https://www.helloasso.com/e/recherche/associations?category_tags=animaux\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `helloasso-association-emails-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/helloasso-association-emails-scraper.json)
- [Manifest](https://www.octoparse.com/templates/helloasso-association-emails-scraper-manifest.json)
