# WhatsApp Group Links Scraper (`scrapier/whatsapp-group-links-scraper`) Actor Find and extract public WhatsApp group invite links from websites, search results, and online directories. Collect group names, invite URLs, categories, and related details for research, community discovery, market analysis, and lead generation workflows. - **URL**: https://apify.com/scrapier/whatsapp-group-links-scraper.md - **Developed by:** [Scrapier](https://apify.com/scrapier) (community) - **Categories:** Automation, Lead generation, Other - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## πŸ’¬ WhatsApp Group Links Scraper Discover **public WhatsApp group & channel invite links** at scale across the major social networks β€” **Facebook, Instagram, TikTok, LinkedIn, Twitter/X, YouTube, Pinterest, and Reddit**. Feed the Actor your keywords, choose a platform and country, and it hunts down `chat.whatsapp.com` join-links in real time, streaming each result straight to your dataset. πŸš€ > ⚑ Endless leads for marketing, recruiting, community growth, and research β€” built for speed and reliability. --- ### ✨ Why Choose This Actor? - 🟒 **Real-time results** β€” every link is saved the moment it's found, never at the end. A mid-run stop still leaves you a full partial dataset. - πŸ›‘οΈ **Smart proxy ladder** β€” automatically escalates **direct β†’ datacenter β†’ residential (sticky)** when the search engine pushes back, so you keep getting data. - πŸ” **Built-in retries** β€” up to 3 attempts per page with exponential backoff. - 🌍 **Geo-targeting** β€” restrict results to any of 100+ countries. - πŸ“Š **Clean, grouped output** β€” results are tagged by keyword and platform and rendered as a tidy table. - 🧹 **Smart de-duplication** β€” every source URL is returned once. --- ### πŸ”‘ Key Features | Feature | Description | |--------|-------------| | πŸ”Ž Multi-keyword search | Each keyword is searched independently and grouped in the output. | | 🌐 8 social platforms | Facebook, LinkedIn, Instagram, Twitter/X, YouTube, Reddit, Pinterest, TikTok. | | πŸ’¬ Group **and** channel links | Detects both `chat.whatsapp.com/` invites and `whatsapp.com/channel/` links. | | πŸ“‘ Live logging | Engaging, real-time progress so you always know what's being collected. | | πŸ›‘οΈ Proxy fallback | Direct β†’ Datacenter β†’ Residential, with clear log events at every switch. | --- ### πŸ“₯ Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `keywords` | array | βœ… | One or more search terms. | | `platform` | string | βœ… | Social network to scan. | | `country` | string | βœ… | FIPS 10-4 country code for geo-targeting. | | `limit` | integer | βž– | Max number of records to collect (omit for no limit). | | `proxyConfiguration` | object | βž– | Proxy settings. `GOOGLE_SERP` group recommended. | #### Example input ```json { "keywords": ["marketing", "jobs"], "platform": "facebook.com", "country": "us", "limit": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["GOOGLE_SERP"] } } ```` *** ### πŸ“€ Output Each record contains: | Field | Description | |-------|-------------| | `keyword` | The keyword that produced this result. | | `platform` | The platform searched. | | `country` | Country code used. | | `title` | Title of the source post/profile. | | `desc` | Snippet text where the link was found. | | `url` | The source URL on the social platform. | | `groupUrl` | Array of normalized WhatsApp group/channel links. | #### Example output ```json [ { "keyword": "marketing", "platform": "facebook.com", "country": "us", "title": "WhatsApp Business Marketing", "desc": "WhatsApp Business Marketing. Join group. ... chat.whatsapp.com/HsOmSeLn8vvCoII4Vds0UL ...", "url": "https://www.facebook.com/groups/645308090352562/", "groupUrl": ["https://chat.whatsapp.com/HsOmSeLn8vvCoII4Vds0UL"] } ] ``` *** ### πŸš€ How to Use (Apify Console) 1. Log in at [console.apify.com](https://console.apify.com) β†’ **Actors**. 2. Open **WhatsApp Group Links Scraper**. 3. Enter your **keywords**, pick a **platform** and **country**, set a **limit**. 4. Keep the **GOOGLE\_SERP** proxy group enabled for best results. 5. Click **Start** ▢️. 6. Watch links stream into the log and **Output** tab in real time. 7. Export to **JSON / CSV / XLSX** or pull via API. ### πŸ€– Use via API ```bash curl -X POST "https://api.apify.com/v2/acts//run-sync-get-dataset-items?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"keywords":["marketing"],"platform":"facebook.com","country":"us","limit":10}' ``` *** ### πŸ’‘ Best Use Cases - 🎯 **Lead generation** β€” build outreach lists from niche WhatsApp communities. - πŸ“£ **Marketing & sales** β€” find active groups in your industry. - πŸ§‘β€πŸ’Ό **Recruiting** β€” discover job-sharing groups by keyword and region. - πŸ”¬ **Research** β€” map community activity around a topic or brand. ### πŸ’° Pricing This Actor uses the **Pay-Per-Event** model: - **Actor start** β€” a small one-time startup charge. - **Result** β€” charged per WhatsApp link record written to the dataset. You only pay for the leads you get. πŸŽ‰ ### ❓ FAQ **Why do some results have multiple links?** A single post can advertise several groups β€” all detected links are returned in `groupUrl`. **Why no results for my keyword?** Try broader keywords, a different platform, or make sure the **GOOGLE\_SERP** proxy group is enabled. **Is this legal?** The Actor only collects **publicly available** search-engine data. You are responsible for compliance with local laws (GDPR, CCPA, anti-spam) and platform ToS. ### πŸ›Ÿ Support & Feedback Open an issue on the Actor's **Issues** tab β€” real questions get real answers. πŸ™Œ # Actor input Schema ## `keywords` (type: `array`): Add one or more search terms (e.g. "marketing", "crypto jobs", "real estate"). Each keyword is searched separately and results are grouped by keyword in the output. ✍️ ## `platform` (type: `string`): Pick the social platform to scan for public WhatsApp invite links. πŸ“² ## `country` (type: `string`): Geo-target the search to a specific country (FIPS 10-4 code, mapped to Google's country restriction). 🌍 ## `limit` (type: `integer`): Maximum number of WhatsApp link records to collect (across all keywords). Leave empty for no limit. πŸ“Š ## `proxyConfiguration` (type: `object`): Proxy used to reach the search engine. The Actor starts direct (no proxy), and if the search engine blocks the request it automatically escalates: 🟒 direct β†’ 🟑 datacenter β†’ πŸ”΄ residential (sticky). For best Google results, keep the GOOGLE\_SERP group enabled. πŸ” ## Actor input object example ```json { "keywords": [ "marketing", "jobs" ], "platform": "facebook.com", "country": "us", "limit": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "marketing", "jobs" ], "platform": "facebook.com", "country": "us", "limit": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapier/whatsapp-group-links-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "marketing", "jobs", ], "platform": "facebook.com", "country": "us", "limit": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["GOOGLE_SERP"], }, } # Run the Actor and wait for it to finish run = client.actor("scrapier/whatsapp-group-links-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "marketing", "jobs" ], "platform": "facebook.com", "country": "us", "limit": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } }' | apify call scrapier/whatsapp-group-links-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapier/whatsapp-group-links-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "WhatsApp Group Links Scraper", "description": "Find and extract public WhatsApp group invite links from websites, search results, and online directories. Collect group names, invite URLs, categories, and related details for research, community discovery, market analysis, and lead generation workflows.", "version": "0.1", "x-build-id": "oBD89eSZH20A4VDgn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~whatsapp-group-links-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-whatsapp-group-links-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapier~whatsapp-group-links-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-whatsapp-group-links-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapier~whatsapp-group-links-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-whatsapp-group-links-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "keywords", "platform", "country" ], "properties": { "keywords": { "title": "πŸ”‘ Keywords", "type": "array", "description": "Add one or more search terms (e.g. \"marketing\", \"crypto jobs\", \"real estate\"). Each keyword is searched separately and results are grouped by keyword in the output. ✍️", "items": { "type": "string" } }, "platform": { "title": "🌐 Social Network", "enum": [ "facebook.com", "linkedin.com", "instagram.com", "twitter.com", "youtube.com", "reddit.com", "pinterest.com", "tiktok.com" ], "type": "string", "description": "Pick the social platform to scan for public WhatsApp invite links. πŸ“²", "default": "facebook.com" }, "country": { "title": "πŸ—ΊοΈ Country", "enum": [ "us", "uk", "ca", "au", "in", "it", "gm", "fr", "sp", "al", "ag", "ar", "am", "as", "aj", "bg", "bo", "be", "bh", "bk", "br", "bu", "ci", "ch", "co", "cs", "hr", "cu", "ez", "dk", "ec", "eg", "en", "fi", "gg", "gr", "hk", "hu", "ic", "id", "ir", "iz", "ei", "is", "jm", "ja", "ke", "kn", "ks", "ku", "lg", "ly", "ls", "lh", "lu", "mc", "mk", "my", "mt", "mx", "md", "mn", "mj", "mo", "np", "nl", "nz", "ni", "no", "pk", "we", "pm", "pa", "pe", "rp", "pl", "po", "rq", "qa", "ro", "rs", "sm", "sa", "sg", "ri", "sn", "lo", "si", "sf", "sw", "sz", "sy", "tw", "th", "ts", "tu", "ua", "ae", "uy", "uz", "ve" ], "type": "string", "description": "Geo-target the search to a specific country (FIPS 10-4 code, mapped to Google's country restriction). 🌍", "default": "us" }, "limit": { "title": "πŸ”’ Max Results", "minimum": 1, "type": "integer", "description": "Maximum number of WhatsApp link records to collect (across all keywords). Leave empty for no limit. πŸ“Š", "default": 10 }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy Configuration", "type": "object", "description": "Proxy used to reach the search engine. The Actor starts direct (no proxy), and if the search engine blocks the request it automatically escalates: 🟒 direct β†’ 🟑 datacenter β†’ πŸ”΄ residential (sticky). For best Google results, keep the GOOGLE_SERP group enabled. πŸ”", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```