# Telegram Group Inviter (`agentx/telegram-group-inviter`) Actor Authenticated Telegram group invite automation. Sign in with QR or a reusable session, select a group you administer, and invite up to 10 users by username or numeric ID with per-target statuses such as success, already\_member, privacy\_restricted, and peer\_flood. - **URL**: https://apify.com/agentx/telegram-group-inviter.md - **Developed by:** [AgentX](https://apify.com/agentx) (community) - **Categories:** Social media, Automation, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $0.05 / actor start This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Telegram Group Inviter - Telegram Group Invitation Automation API **Telegram Group Inviter is a Telegram group invitation automation API that performs structured member invitations by username or user ID, returning per-target invite status, failure reason, and reusable session management in a single target-list-driven run.** Telegram Group Inviter returns structured records per invitation operation, including target username or ID, resolved Telegram user ID, resolved username, first name, last name, invite status (success / already_member / privacy_restricted / flood_wait / failed and 8 additional codes), error message, processor, and processed timestamp. Coverage spans Telegram groups and supergroups where the operating account has invite permissions, with QR-login session reuse and 2FA password support. Built for community administration, group migration workflows, audited member onboarding, CRM-driven invite pipelines, regulated-community compliance, automated cohort enrollment, and rate-limit-aware invite operations. Pay-per-result pricing with no monthly minimum. [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi) [![Group Automation](https://img.shields.io/badge/Group_Automation-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi) [![Member Operations](https://img.shields.io/badge/Member_Operations-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi) --- ### Why Choose This API #### Structured Telegram Invitation Operations for B2B Community Pipelines **📊 Per-Target Invite Status Tracking** The `status` field returns a granular result code per invitation — `success`, `already_member`, `admin_required`, `permission_denied`, `privacy_restricted`, `flood_wait`, `peer_flood`, `resolve_failed`, `unavailable`, `bot_blocked`, `user_limit_reached`, `blocked`, or `failed` — enabling precise operation audit logs, retry queue construction, and success rate analysis. **🔐 Reusable Session Management** The `session` field accepts a saved Telegram session string — enabling QR-login-once, session reuse across multiple runs, and automated headless invitation operations without repeated authentication. **👤 Username & User ID Support** The `usernames` array accepts both `@username` handles and numeric Telegram user IDs — enabling integration with member lists extracted via [Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper?fpr=aiagentapi) or [Subreddit Member Scraper](https://apify.com/agentx/subreddit-member-scraper?fpr=aiagentapi). **🛡️ Error Attribution** The `error` field captures the exact Telegram error message per failed invite — enabling error categorization, root cause analysis, and targeted remediation without manual log inspection. --- ### Quick Start Guide #### How to Invite Members to a Telegram Group in 3 Steps ##### Step 1: Prepare Your Member List Compile up to 10 Telegram usernames (`@handle`) or numeric user IDs. You must be an **admin** of the target group. ##### Step 2: Configure Session and Group [Open Actor Input](https://console.apify.com/actors/XI6EIILM3IjhI2X0W/input?fpr=aiagentapi) On first run, leave `session` empty — scan the QR code in the run log to authenticate. Save the printed session string for future runs. Enter a substring matching your group name, `@username`, or numeric group ID in `group_match`. ##### Step 3: Review Invitation Status Logs Each target returns a structured status record — download as JSON for audit logging or pipeline integration. --- ### Input Parameters #### Configuration Fields | Parameter | Type | Required | Description | Example Values | | ------------- | --------------- | -------- | -------------------------------------------------------------- | -------------------------- | | `session` | string (secret) | ❌ | Saved Telegram session string (QR login on first run) | `"1BQAAUM4..."` | | `password` | string (secret) | ❌ | Telegram 2FA password (if enabled) | `"mypassword"` | | `group_match` | string | ✅ | Substring to match target group (title, @username, or ID) | `"my_group"`, `"@mygroup"` | | `usernames` | array | ✅ | List of @username handles or numeric user IDs to invite (1–10) | `["@user1", "123456789"]` | #### Example Input Configuration ```json { "group_match": "my_community_group", "usernames": ["@alice", "@bob", "987654321"] } ```` *** ### Output Data Schema #### Complete Invitation Result Record Structure Each processed invitation target returns the following fields: [Open Actor Output](https://console.apify.com/actors/XI6EIILM3IjhI2X0W/output?fpr=aiagentapi) #### Core Invitation Fields | Field | Type | Description | | -------------- | ------- | ------------------------------------------ | | `processor` | string | Apify actor URL that processed this record | | `processed_at` | string | ISO 8601 timestamp (UTC) when processed | | `target` | string | Input username or user ID as provided | | `user_id` | integer | Resolved Telegram user ID | | `username` | string | Resolved Telegram @username | | `first_name` | string | User's first name | | `last_name` | string | User's last name | | `status` | string | Invitation result code | | `error` | string | Error detail if invite failed | #### Invite Status Codes | Status | Meaning | | -------------------- | ----------------------------------------- | | `success` | User successfully invited | | `already_member` | User is already in the group | | `admin_required` | Operator account lacks admin permissions | | `permission_denied` | Group restricts invitations | | `privacy_restricted` | User's privacy settings block invitations | | `flood_wait` | Telegram rate limit triggered | | `peer_flood` | Peer-level flood protection triggered | | `resolve_failed` | Username/ID could not be resolved | | `unavailable` | User account unavailable | | `bot_blocked` | Bot blocked by user | | `user_limit_reached` | Group member limit reached | | `blocked` | User blocked | | `failed` | Generic failure | #### Example JSON Output ```json { "processor": "https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi", "processed_at": "2026-05-01T10:30:00.000Z", "target": "@alice", "user_id": 123456789, "username": "alice", "first_name": "Alice", "last_name": "Smith", "status": "success", "error": null } ``` #### Export Formats - **JSON** - Complete audit log with per-target status records - **CSV** - Spreadsheet-compatible for operation tracking - **API Access** - Programmatic access via Apify Client SDK - **Cloud Storage** - Automatic upload to Apify Dataset *** ### Integration Examples #### Actor ID for Platform Integration ```text XI6EIILM3IjhI2X0W ``` #### Ⓜ️ [Make.com Setup:](https://www.make.com/en/register?pc=marketingme) 1. Login to **[Make.com (Get 1000 Free Credits)](https://www.make.com/en/register?pc=marketingme)** 2. Add module **"Run an Actor"** 3. Turn **'Map'** on - right side of the 'Actor\*' 4. Paste **Actor ID** - from above 5. Click the **'⟳ Refresh'** - left side of Map 6. **Input JSON\*** - Modify the parameters as needed 7. Set **"Run synchronously"** to **YES** 8. Add module **"Get Dataset Items"** - receive the result 9. In **Dataset ID\*** select **defaultDatasetId** #### 🎱 [N8N.io Setup:](https://n8n.io/) 1. Add **'Run an Actor and get dataset'** - from the apify node 2. **Actor** → **By ID** → **Paste Actor ID** - from above 3. **Input JSON** - Modify the parameters as needed #### Python Integration Example ```python from apify_client import ApifyClient client = ApifyClient('YOUR_API_TOKEN') run_input = { "group_match": "my_community_group", "usernames": ["@alice", "@bob", "987654321"] } run = client.actor("XI6EIILM3IjhI2X0W").call(run_input=run_input) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` #### JavaScript/Node.js Integration ```javascript import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: "YOUR_API_TOKEN" }); const input = { group_match: "my_group", usernames: ["@member1", "@member2"], }; const run = await client.actor("XI6EIILM3IjhI2X0W").call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => console.log(item)); ``` #### JSON-LD Metadata ```json { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi#software", "name": "Telegram Group Inviter", "description": "Telegram Group Inviter is a Telegram group invitation automation API with per-target status tracking, reusable session management, and structured status records for community administration and audited member onboarding pipelines.", "applicationCategory": "BusinessApplication", "applicationSubCategory": "Automation API", "operatingSystem": "Web, Cloud", "url": "https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi", "softwareVersion": "1.0.0", "datePublished": "2024-08-01", "dateModified": "2026-05-01", "featureList": [ "Invite by username or user ID", "13 granular per-target status codes", "Flood_wait detection with per-target status reporting", "Reusable QR-login session string", "Encrypted Telegram 2FA password field", "Structured per-target status records", "Pay-per-use pricing with no monthly minimum", "Native integrations with Make.com, n8n, LangChain, and CrewAI" ], "offers": { "@type": "Offer", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "author": { "@id": "https://apify.com/agentx?fpr=aiagentapi#person" }, "publisher": { "@id": "https://apify.com#organization" } }, { "@type": "Person", "@id": "https://apify.com/agentx?fpr=aiagentapi#person", "name": "AgentX", "url": "https://apify.com/agentx?fpr=aiagentapi", "sameAs": [ "https://apify.com/agentx?fpr=aiagentapi", "https://t.me/AiAgentApi", "https://t.me/Apify_Actor" ], "knowsAbout": [ "automation", "Telegram", "group invitation", "member operations", "community management" ] }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Do I need to be an admin to use this actor?", "acceptedAnswer": { "@type": "Answer", "text": "Yes — you must be an admin of the target group. The actor returns admin_required status if the authenticated account lacks admin permissions." } }, { "@type": "Question", "name": "How do I authenticate without a saved session?", "acceptedAnswer": { "@type": "Answer", "text": "Leave the session field empty on your first run. The actor will print a QR code in the run log — scan it with Telegram to authenticate. Copy the printed session string and save it for future runs." } }, { "@type": "Question", "name": "What is the maximum number of invitations per run?", "acceptedAnswer": { "@type": "Answer", "text": "The usernames array accepts up to 10 targets per run. For larger batches, run the actor multiple times or schedule sequential runs." } }, { "@type": "Question", "name": "Why did I get flood_wait or peer_flood?", "acceptedAnswer": { "@type": "Answer", "text": "Telegram applies rate limits on invitation operations. Wait the specified duration before retrying. Avoid sending too many invitations in a short window." } } ] }, { "@type": "HowTo", "name": "How to invite members to a Telegram group with Telegram Group Inviter", "step": [ { "@type": "HowToStep", "position": 1, "name": "Prepare Your Member List", "text": "Compile up to 10 Telegram usernames (@handle) or numeric user IDs. Ensure you are an admin of the target group." }, { "@type": "HowToStep", "position": 2, "name": "Configure Session and Group", "text": "Open the Actor input page. On first run, leave session empty and scan the QR code in the run log to authenticate. Save the session string for future runs. Enter a substring matching your group name, @username, or numeric group ID in group_match." }, { "@type": "HowToStep", "position": 3, "name": "Review Invitation Status Logs", "text": "Each target returns a structured status record with one of 13 result codes. Download results as JSON for audit logging or pipeline integration." } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Apify", "item": "https://apify.com?fpr=aiagentapi" }, { "@type": "ListItem", "position": 2, "name": "AgentX", "item": "https://apify.com/agentx?fpr=aiagentapi" }, { "@type": "ListItem", "position": 3, "name": "Telegram Group Inviter", "item": "https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi" } ] } ] } ``` *** ### Pricing & Cost Calculator #### Transparent Pay-Per-Use Model | Event Type | Price | Description | | --------------- | ----- | ----------------------------- | | **Actor Start** | $0.05 | One-time charge per Actor run | #### Cost Examples **Single Operation** (1 invite target): - Actor Start: $0.05 - **Total**: ~$0.05 **Standard Run** (5 invite targets): - Actor Start: $0.05 - **Total**: ~$0.05 **Full Run** (10 invite targets, maximum per run): - Actor Start: $0.05 - **Total**: ~$0.05 #### Competitive Pricing Comparison | Feature | Telegram Group Inviter | Manual Operations | Generic Automation | Custom Development | | ----------------------- | ---------------------- | ----------------- | ------------------ | ------------------ | | **Run Pricing** | **$0.05/run** ⭐ | Free | Variable | Dev hours | | **Status Tracking** | **13 codes** ⭐ | None | Basic | Custom | | **Session Management** | **Reusable QR** ⭐ | Manual | Manual | Custom | | **Rate Limit Status** | **Detected** ⭐ | Manual | Basic | Custom | | **API Integration** | **Enterprise** ⭐ | None | Webhook only | Custom | | **Time to Deploy** | **Minutes** ⭐ | Immediate | Hours | Days / Weeks | *** ### Use Cases & Applications #### Community Administration & Migration **Group Member Onboarding** Automate invitations for approved member lists — building structured onboarding pipelines for community launches, group migrations, and controlled member additions with per-target audit trails. **Migration from Another Platform** Collect member usernames from competitor communities via [Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper?fpr=aiagentapi), then batch-invite identified users — enabling structured community migration workflows. **Invitation Audit Logging** The structured `status` and `error` fields per target enable complete invitation audit logs — tracking success rates, failure patterns, and privacy-restricted user ratios for community operations reporting. #### Integration with Member Intelligence **Pipeline Integration with Member Scrapers** Combine with [Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper?fpr=aiagentapi) or [Subreddit Member Scraper](https://apify.com/agentx/subreddit-member-scraper?fpr=aiagentapi) — extract member lists upstream, then pass usernames into this actor for automated invitation operations. *** ### FAQ #### Do I need to be an admin to use this actor? Yes — you must be an admin of the target group. The actor returns `admin_required` status if the authenticated account lacks admin permissions. #### How do I authenticate without a saved session? Leave the `session` field empty on your first run. The actor will print a QR code in the run log — scan it with Telegram to authenticate. Copy the printed session string and save it for future runs. #### What is the maximum number of invitations per run? The `usernames` array accepts up to 10 targets per run. For larger batches, run the actor multiple times or schedule sequential runs. #### Why did I get `flood_wait` or `peer_flood`? Telegram applies rate limits on invitation operations. Wait the specified duration before retrying. Avoid sending too many invitations in a short window. *** ### SEO Keywords & Search Terms #### Primary Keywords Telegram group inviter API, Telegram invitation automation, Telegram member invite API, Telegram group member automation, Telegram group admin API, Telegram bulk invite API, Telegram invitation pipeline, Telegram group onboarding API, Telegram member management API, Telegram community administration API #### Long-Tail Keywords how to automate Telegram group invitations programmatically, Telegram group invite status tracking API, Telegram member onboarding automation, Telegram group migration tool API, Telegram invitation audit log, Telegram group admin automation API, Telegram invite rate limit handling, Telegram session management API, Telegram bulk member invitation, Telegram group member management pipeline #### Industry Terms Telegram invitation automation API, community administration pipeline, group migration workflow, member onboarding automation, invitation audit logging, session reuse management, rate-limited invitation control, community operations API, structured invite status tracking, Telegram member operations *** ### Trust & Certifications - ✅ **Production-Grade Infrastructure** — runs on the Apify cloud platform with structured per-target invite records - ✅ **Privacy-Aligned Operations** — invitations only target user-supplied usernames or IDs; session credentials encrypted in Apify secret store and never persisted beyond the run - ✅ **Transparent Run Pricing** — clear pay-per-use pricing with no monthly minimum or seat fees - ✅ **Continuously Maintained** — schema and selector updates released as Telegram evolves *** ### Legal & Compliance #### Data Rights & Usage This actor performs invitation operations using authenticated Telegram sessions. Users are responsible for ensuring all invitation activities comply with Telegram's terms of service and applicable regulations. Only invite users who have consented to being added to groups. #### Privacy Compliance - **GDPR**: Compliant with EU GDPR for data processing workflows. - **CCPA**: Compliant with California Consumer Privacy Act requirements. #### Platform Terms of Service Users must review and comply with Telegram's terms of service. Misuse of invitation features may result in account restrictions. #### Enterprise Support For enterprise licensing, custom integrations, or compliance inquiries: - **Telegram**: [@AiAgentApi](https://t.me/AiAgentApi) *** ### Related Tools #### Jobs & Hiring - **[All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper?fpr=aiagentapi)** - Multi-Platform Job Listings Intelligence API - **[Glassdoor Hiring Scraper](https://apify.com/agentx/glassdoor-hiring-scraper?fpr=aiagentapi)** - Glassdoor Job Listings Intelligence API - **[Glints Employer Data Extractor](https://apify.com/agentx/glints-employer-data-extractor?fpr=aiagentapi)** - Glints Employer Intelligence API - **[Glints Jobs Data Extractor](https://apify.com/agentx/glints-jobs-data-extractor?fpr=aiagentapi)** - Glints Job Listings Intelligence API - **[Indeed Hiring Scraper](https://apify.com/agentx/indeed-hiring-scraper?fpr=aiagentapi)** - Indeed Job Listings Intelligence API - **[JobStreet Employer Data Extractor](https://apify.com/agentx/jobstreet-employer-data-extractor?fpr=aiagentapi)** - JobStreet Employer Intelligence API - **[JobStreet Jobs Data Extractor](https://apify.com/agentx/jobstreet-jobs-data-extractor?fpr=aiagentapi)** - JobStreet Job Listings Intelligence API - **[LinkedIn Hiring Scraper](https://apify.com/agentx/linkedin-hiring-scraper?fpr=aiagentapi)** - LinkedIn Job Listings Intelligence API - **[StepStone Employer Data Extractor](https://apify.com/agentx/stepstone-employer-data-extractor?fpr=aiagentapi)** - StepStone Employer Intelligence API - **[StepStone Jobs Data Extractor](https://apify.com/agentx/stepstone-jobs-data-extractor?fpr=aiagentapi)** - StepStone Job Listings Intelligence API #### Social Media - **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper?fpr=aiagentapi)** - Instagram Creator Intelligence API - **[Instagram Post Reel Scraper](https://apify.com/agentx/instagram-post-reel-scraper?fpr=aiagentapi)** - Instagram Post & Reel Intelligence API - **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper?fpr=aiagentapi)** - Instagram Trending Content Intelligence API - **[LinkedIn Company Scraper](https://apify.com/agentx/linkedin-company-scraper?fpr=aiagentapi)** - LinkedIn Company Intelligence API - **[LinkedIn Profile Scraper](https://apify.com/agentx/linkedin-profile-scraper?fpr=aiagentapi)** - LinkedIn Profile Intelligence API - **[Medium Author Data Extractor](https://apify.com/agentx/medium-author-data-extractor?fpr=aiagentapi)** - Medium Author Intelligence API - **[Medium Content Data Extractor](https://apify.com/agentx/medium-content-data-extractor?fpr=aiagentapi)** - Medium Content Intelligence API - **[Reddit Author Scraper](https://apify.com/agentx/reddit-author-scraper?fpr=aiagentapi)** - Reddit Author Intelligence API - **[Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi)** - Reddit Viral Content Intelligence API - **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper?fpr=aiagentapi)** - Subreddit Intelligence API - **[Subreddit Member Scraper](https://apify.com/agentx/subreddit-member-scraper?fpr=aiagentapi)** - Subreddit Member Intelligence API - **[SubReddit Post Scraper](https://apify.com/agentx/subreddit-post-scraper?fpr=aiagentapi)** - Subreddit Post Intelligence API - **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi)** - Telegram Chat Intelligence API - **[Telegram Group Inviter](https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi)** - Telegram Group Invitation API - **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi)** - Telegram Channel Intelligence API - **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper?fpr=aiagentapi)** - Telegram Member Intelligence API - **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi)** - Telegram Private Group Intelligence API - **[TikTok Creator Scraper](https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi)** - TikTok Creator Intelligence API - **[Twitter Community Scraper](https://apify.com/agentx/twitter-community-scraper?fpr=aiagentapi)** - Twitter Community Intelligence API - **[Twitter Info Scraper](https://apify.com/agentx/twitter-info-scraper?fpr=aiagentapi)** - Twitter Account Intelligence API - **[YouTube Market Intelligence](https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi)** - YouTube Channel Intelligence API #### Video & Transcript - **[All Video Scraper](https://apify.com/agentx/all-video-scraper?fpr=aiagentapi)** - Multi-Platform Video Intelligence API - **[Live Stream Transcript](https://apify.com/agentx/live-stream-transcript?fpr=aiagentapi)** - Live Stream Transcript Intelligence API - **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader?fpr=aiagentapi)** - TikTok Live Stream Download API - **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript?fpr=aiagentapi)** - TikTok Video Transcript Intelligence API - **[Video Caption Scraper](https://apify.com/agentx/video-caption-scraper?fpr=aiagentapi)** - Multi-Platform Video Caption Extraction API - **[Video to Social Post](https://apify.com/agentx/video-to-social-post?fpr=aiagentapi)** - Video to Social Post Generation API - **[Video Transcript](https://apify.com/agentx/video-transcript?fpr=aiagentapi)** - Multi-Platform Video Transcript Intelligence API - **[YouTube Transcript](https://apify.com/agentx/youtube-transcript?fpr=aiagentapi)** - YouTube Video Transcript Intelligence API #### E-Commerce & Retail - **[Amazon Product Data Extractor](https://apify.com/agentx/amazon-product-data-extractor?fpr=aiagentapi)** - Amazon Product Intelligence API - **[Amazon Storefront Data Extractor](https://apify.com/agentx/amazon-storefront-data-extractor?fpr=aiagentapi)** - Amazon Storefront Intelligence API - **[Argos Retail Data Extractor](https://apify.com/agentx/argos-retail-data-extractor?fpr=aiagentapi)** - Argos Product Intelligence API - **[ASOS Product Catalog Extractor](https://apify.com/agentx/asos-product-catalog-extractor?fpr=aiagentapi)** - ASOS Product Catalog Intelligence API - **[eBay Marketplace Data Extractor](https://apify.com/agentx/ebay-marketplace-data-extractor?fpr=aiagentapi)** - eBay Marketplace Intelligence API - **[eBay Seller Leads API](https://apify.com/agentx/ebay-seller-leads-api?fpr=aiagentapi)** - eBay Seller Lead Intelligence API - **[Flipkart Product Data Extractor](https://apify.com/agentx/flipkart-product-data-extractor?fpr=aiagentapi)** - Flipkart Product Intelligence API - **[John Lewis Retail Data Extractor](https://apify.com/agentx/john-lewis-retail-data-extractor?fpr=aiagentapi)** - John Lewis Product Intelligence API - **[Lidl Offers Data Extractor](https://apify.com/agentx/lidl-offers-data-extractor?fpr=aiagentapi)** - Lidl Offers Intelligence API - **[Magalu Product Data Extractor](https://apify.com/agentx/magalu-product-data-extractor?fpr=aiagentapi)** - Magalu Product Intelligence API - **[MediaMarkt Product Data Extractor](https://apify.com/agentx/mediamarkt-product-data-extractor?fpr=aiagentapi)** - MediaMarkt Product Intelligence API - **[Mercado Livre Marketplace Data Extractor](https://apify.com/agentx/mercado-livre-marketplace-data-extractor?fpr=aiagentapi)** - Mercado Livre Marketplace Intelligence API - **[Nykaa Product Data Extractor](https://apify.com/agentx/nykaa-product-data-extractor?fpr=aiagentapi)** - Nykaa Product Intelligence API - **[OTTO Product Data Extractor](https://apify.com/agentx/otto-product-data-extractor?fpr=aiagentapi)** - OTTO Product Intelligence API - **[Target Product Data Extractor](https://apify.com/agentx/target-product-data-extractor?fpr=aiagentapi)** - Target Product Intelligence API - **[Walmart Product Data Extractor](https://apify.com/agentx/walmart-product-data-extractor?fpr=aiagentapi)** - Walmart Product Intelligence API #### Classifieds & Automotive - **[AutoTrader Dealer Leads API](https://apify.com/agentx/autotrader-dealer-leads-api?fpr=aiagentapi)** - AutoTrader Dealer Lead Intelligence API - **[AutoTrader Vehicle Listings API](https://apify.com/agentx/autotrader-vehicle-listings-api?fpr=aiagentapi)** - AutoTrader Vehicle Listings Intelligence API - **[Cars.com Dealer Leads API](https://apify.com/agentx/cars-com-dealer-leads-api?fpr=aiagentapi)** - Cars.com Dealer Lead Intelligence API - **[Cars.com Vehicle Listings API](https://apify.com/agentx/cars-com-vehicle-listings-api?fpr=aiagentapi)** - Cars.com Vehicle Listings Intelligence API - **[Kleinanzeigen Classifieds Data Extractor](https://apify.com/agentx/kleinanzeigen-classifieds-data-extractor?fpr=aiagentapi)** - Kleinanzeigen Classifieds Intelligence API - **[Kleinanzeigen Seller Leads API](https://apify.com/agentx/kleinanzeigen-seller-leads-api?fpr=aiagentapi)** - Kleinanzeigen Seller Lead Intelligence API - **[OLX Classifieds Data Extractor](https://apify.com/agentx/olx-classifieds-data-extractor?fpr=aiagentapi)** - OLX Classifieds Intelligence API - **[OLX Seller Leads API](https://apify.com/agentx/olx-seller-leads-api?fpr=aiagentapi)** - OLX Seller Lead Intelligence API - **[Webmotors Vehicle Listings API](https://apify.com/agentx/webmotors-vehicle-listings-api?fpr=aiagentapi)** - Webmotors Vehicle Listings Intelligence API #### Real Estate - **[MagicBricks Builder Leads API](https://apify.com/agentx/magicbricks-builder-leads-api?fpr=aiagentapi)** - MagicBricks Builder Lead Intelligence API - **[MagicBricks Property Data Extractor](https://apify.com/agentx/magicbricks-property-data-extractor?fpr=aiagentapi)** - MagicBricks Real Estate Data API - **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper?fpr=aiagentapi)** - Realtor.com Property Listings Intelligence API - **[Zillow For Sale Scraper](https://apify.com/agentx/zillow-for-sale-scraper?fpr=aiagentapi)** - Zillow Property Listings Intelligence API #### Business Intelligence & Reviews - **[BBB Business Data Extractor](https://apify.com/agentx/bbb-business-data-extractor?fpr=aiagentapi)** - BBB Business Intelligence API - **[BBB Reputation Data Extractor](https://apify.com/agentx/bbb-reputation-data-extractor?fpr=aiagentapi)** - BBB Reputation Intelligence API - **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper?fpr=aiagentapi)** - Google Maps Business Intelligence API - **[Reclame Aqui Company Data Extractor](https://apify.com/agentx/reclame-aqui-company-data-extractor?fpr=aiagentapi)** - Reclame Aqui Company Intelligence API - **[TradeIndia Product Data Extractor](https://apify.com/agentx/tradeindia-product-data-extractor?fpr=aiagentapi)** - TradeIndia Product Intelligence API - **[TradeIndia Supplier Leads API](https://apify.com/agentx/tradeindia-supplier-leads-api?fpr=aiagentapi)** - TradeIndia Supplier Lead Intelligence API - **[Zomato Menu Data Extractor](https://apify.com/agentx/zomato-menu-data-extractor?fpr=aiagentapi)** - Zomato Restaurant Menu Intelligence API - **[Zomato Restaurant Data Extractor](https://apify.com/agentx/zomato-restaurant-data-extractor?fpr=aiagentapi)** - Zomato Restaurant Search Intelligence API #### Other - **[Global Weather Scraper](https://apify.com/agentx/global-weather-scraper?fpr=aiagentapi)** - Global Weather Intelligence API *** ### Support & Community - **👥 Community**: [@Apify\_Actor](https://t.me/Apify_Actor) - **👤 Contact Team**: [@AiAgentApi](https://t.me/AiAgentApi) *** **Last Updated:** May 01, 2026 # Actor input Schema ## `session` (type: `string`): Telegram Session string. Leave empty on first use: complete login with the QR code in the run log. After login, paste it here on later runs to skip QR login. ## `password` (type: `string`): Telegram 2FA password (if enabled on the account). Stored encrypted. Leave empty if not used. ## `group_match` (type: `string`): Substring to match your target group in dialogs (title, @username, or numeric ID). You must be an admin of this group to invite members. ## `usernames` (type: `array`): List of Telegram usernames (with or without @) or numeric user IDs to invite into the group. ## Actor input object example ```json { "group_match": "my_group", "usernames": [ "@username1", "123456789" ] } ``` # Actor output Schema ## `results` (type: `string`): Invite operation results for each targeted user with success or failure status # 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 = { "group_match": "my_group", "usernames": [ "@username1", "123456789" ] }; // Run the Actor and wait for it to finish const run = await client.actor("agentx/telegram-group-inviter").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 = { "group_match": "my_group", "usernames": [ "@username1", "123456789", ], } # Run the Actor and wait for it to finish run = client.actor("agentx/telegram-group-inviter").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 '{ "group_match": "my_group", "usernames": [ "@username1", "123456789" ] }' | apify call agentx/telegram-group-inviter --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=agentx/telegram-group-inviter", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Telegram Group Inviter", "description": "Authenticated Telegram group invite automation. Sign in with QR or a reusable session, select a group you administer, and invite up to 10 users by username or numeric ID with per-target statuses such as success, already_member, privacy_restricted, and peer_flood.", "version": "1.0", "x-build-id": "KvA37BD14B2ICdyTL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agentx~telegram-group-inviter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agentx-telegram-group-inviter", "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/agentx~telegram-group-inviter/runs": { "post": { "operationId": "runs-sync-agentx-telegram-group-inviter", "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/agentx~telegram-group-inviter/run-sync": { "post": { "operationId": "run-sync-agentx-telegram-group-inviter", "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": [ "group_match", "usernames" ], "properties": { "session": { "title": "🔐 Session", "type": "string", "description": "Telegram Session string. Leave empty on first use: complete login with the QR code in the run log. After login, paste it here on later runs to skip QR login." }, "password": { "title": "🔑 Password", "type": "string", "description": "Telegram 2FA password (if enabled on the account). Stored encrypted. Leave empty if not used." }, "group_match": { "title": "👥 Group Match", "type": "string", "description": "Substring to match your target group in dialogs (title, @username, or numeric ID). You must be an admin of this group to invite members." }, "usernames": { "title": "👤 Usernames", "minItems": 1, "maxItems": 10, "type": "array", "description": "List of Telegram usernames (with or without @) or numeric user IDs to invite into the group.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```