Lead Generation

French Language Meetup Groups (US)

Meetup groups for French conversation, language practice and francophile culture across the top 100 US metros — member count, organizer, founding date, activity and description.

french-meetup-groupslead-generationmeetupfrenchlanguage-learningcommunitiesusa

255 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/french-meetup-groups/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 255 rows, this download costs 3 credits when the data is fresh enough, or 6 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/french-meetup-groups/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "keywords": [        "french",        "francais"      ],      "states": [        "FL",        "AZ"      ],      "metros": [        "Boston",        "Miami"      ],      "includeMultilingual": 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

keywords
string[]
Search keywords
Each keyword is searched around every metro; results are kept only when the group name or description is actually about French.
Default
["french","francais"]
Example
french, francais
states
string[]
States
Limits the metros searched. Empty means every metro.
Default
none
Example
FL, AZ
metros
string[]
Metros
Metro names from the built-in top-100 list. Empty means all.
Default
none
Example
Boston, Miami
includeMultilingual
boolean
Include multilingual groups
Keeps language-exchange groups that mention French alongside other languages.
Default
true
maxItems
number
Max groups
Default
10000
Range
1 to 10000

Advanced

maxMetros
number
Max metros
Default
200
Range
1 to 200
radiusMiles
number
Search radius (miles)
Default
30
Range
5 to 100
maxPagesPerQuery
number
Result pages per search
Default
4
Range
1 to 10
concurrency
number
Searches in parallel
Default
2
Range
1 to 4
requestDelayMs
number
Delay between requests (ms)
Default
400
Range
0 to 10000

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": {    "keywords": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Search keywords",      "description": "Each keyword is searched around every metro; results are kept only when the group name or description is actually about French.",      "default": [        "french",        "francais"      ],      "examples": [        "french, francais"      ]    },    "states": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "States",      "description": "Limits the metros searched. Empty means every metro.",      "default": [],      "examples": [        "FL, AZ"      ]    },    "metros": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Metros",      "description": "Metro names from the built-in top-100 list. Empty means all.",      "default": [],      "examples": [        "Boston, Miami"      ]    },    "includeMultilingual": {      "type": "boolean",      "title": "Include multilingual groups",      "description": "Keeps language-exchange groups that mention French alongside other languages.",      "default": true    },    "maxItems": {      "type": "number",      "minimum": 1,      "maximum": 10000,      "title": "Max groups",      "default": 10000    },    "maxMetros": {      "type": "number",      "minimum": 1,      "maximum": 200,      "title": "Max metros",      "default": 200    },    "radiusMiles": {      "type": "number",      "minimum": 5,      "maximum": 100,      "title": "Search radius (miles)",      "default": 30    },    "maxPagesPerQuery": {      "type": "number",      "minimum": 1,      "maximum": 10,      "title": "Result pages per search",      "default": 4    },    "concurrency": {      "type": "number",      "minimum": 1,      "maximum": 4,      "title": "Searches in parallel",      "default": 2    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 10000,      "title": "Delay between requests (ms)",      "default": 400    }  }}

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/french-meetup-groups/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "keywords": [        "french",        "francais"      ],      "states": [        "FL",        "AZ"      ],      "metros": [        "Boston",        "Miami"      ],      "includeMultilingual": 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
city	string	100%
country	string	100%
description_excerpt	string	100%
founded_date	date	100%
french_match_in	string	100%
group_id	string	100%
is_private	boolean	100%
language_focus	string	100%
latitude	number	100%
longitude	number	100%
member_count	number	100%
name	string	100%
organizer_name	string	100%
search_metros	array	100%
state	string	100%
timezone	string	100%
topic_category	string	99%
upcoming_event_count	number	100%
urlname	string	100%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
updated_at	date	100%
_id	string	100%