Lead Generation

Alliance Française Chapters (US)

Every Alliance Française chapter in the United States — address, phone, general email and website from the Fondation des Alliances Françaises directory, merged with the AF-USA federation map and enriched with the president or director published on each chapter site.

alliance-francaise-chapterslead-generationeducationfrenchlanguage-schoolsnonprofitusab2b

105 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/alliance-francaise-chapters/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 105 rows, this download costs 2 credits when the data is fresh enough, or 4 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/alliance-francaise-chapters/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "CA",        "FL",        "NY"      ],      "maxItems": 1000,      "includeAfusaMap": true,      "enrichWebsites": true    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

states
string[]
States
Two-letter codes or state names. Empty means every chapter.
Default
none
Example
CA, FL, NY
maxItems
number
Max chapters
Default
1000
Range
1 to 1000

Sources

includeAfusaMap
boolean
Merge the AF-USA chapter map
Adds coordinates and federation membership from the Federation of Alliances Françaises USA map, and chapters missing from the Fondation directory.
Default
true

Enrichment

enrichWebsites
boolean
Visit chapter websites
Reads each chapter site and its contact/board pages for the president or executive director.
Default
true
maxPagesPerSite
number
Pages per website
Default
5
Range
1 to 12

Advanced

concurrency
number
Sites in parallel
Default
4
Range
1 to 10

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "states": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "States",      "description": "Two-letter codes or state names. Empty means every chapter.",      "default": [],      "examples": [        "CA, FL, NY"      ]    },    "maxItems": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Max chapters",      "default": 1000    },    "includeAfusaMap": {      "type": "boolean",      "title": "Merge the AF-USA chapter map",      "description": "Adds coordinates and federation membership from the Federation of Alliances Françaises USA map, and chapters missing from the Fondation directory.",      "default": true    },    "enrichWebsites": {      "type": "boolean",      "title": "Visit chapter websites",      "description": "Reads each chapter site and its contact/board pages for the president or executive director.",      "default": true    },    "maxPagesPerSite": {      "type": "number",      "minimum": 1,      "maximum": 12,      "title": "Pages per website",      "default": 5    },    "concurrency": {      "type": "number",      "minimum": 1,      "maximum": 10,      "title": "Sites in parallel",      "default": 4    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/alliance-francaise-chapters/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "CA",        "FL",        "NY"      ],      "maxItems": 1000,      "includeAfusaMap": true,      "enrichWebsites": true    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
address	string	98%
afusa_listed	boolean	100%
chapter_id	string	100%
city	string	99%
contact_page_url	string	59%
email	string	98%
emails	array	98%
fondation_id	string	99%
latitude	number	97%
leader_email	string	2%
leader_name	string	50%
leader_source_url	string	50%
leader_title	string	50%
listed_name	string	2%
longitude	number	97%
membership_size	number	10%
name	string	100%
pages_crawled	number	98%
phone	string	90%
phones	array	90%
source_url	string	1%
sources	array	100%
state	string	96%
street	string	98%
website	string	98%
website_final_url	string	86%
website_reachable	boolean	98%
website_status	number	91%
zip	string	96%
created_at	date	100%
enriched_at	date	98%
first_seen_at	date	100%
last_seen_at	date	100%
updated_at	date	100%
_id	string	100%