# X (twitter) Community Info Scraper (`datamagnet/x-twitter-community-info-scraper`) Actor Fetch and save the details of a community from a single community ID. - **URL**: https://apify.com/datamagnet/x-twitter-community-info-scraper.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Community Info Fetcher — Community Info Scraper Community Info Fetcher is a simple community info scraper for looking up one community at a time by its unique ID. It helps you quickly collect community details such as the community name, description, member count, rules, banner images, and status in a clean, ready-to-use format. This is ideal for marketers, researchers, analysts, and social media teams who need reliable community data without manual searching. The actor saves the source response exactly as received, so you get the original community information with no changes. ### Key Features - **Extract** detailed community information from a single community ID in one run. - **Collect** important community fields like name, description, member count, rules, and banner images. - **Preserve** the original response exactly as received for accurate downstream use. - **Simplify** one-at-a-time community lookups for focused research and verification. - **Support** social media analysis, audience research, and community monitoring workflows. - **Save** time by avoiding manual copying and repeated searches. - **Deliver** clean output that is easy to review, export, and share with your team. ### Use Cases #### Community Research Researchers and analysts use this actor to review a specific community’s profile before making decisions about outreach, partnerships, or content strategy. Fields like `name`, `description`, `member_count`, and `primary_topic` help them understand what the community is about and how large it is. #### Brand Safety Review Marketing teams can check whether a community is suitable for brand placement or engagement. The `is_nsfw` flag, `rules`, and `status` help them quickly assess whether the community aligns with brand guidelines and content standards. #### Audience Analysis Social media managers and growth teams can study community size and tone before launching campaigns. `member_count`, `description`, and `rules` reveal how active or focused the community may be, helping teams decide where to invest attention. #### Competitive Intelligence Businesses tracking competitors can look up communities tied to competitor brands, products, or fan groups. By reviewing `name`, `description`, and `created_at`, they can understand when a community was established and how it is positioned. #### Content Moderation Review Moderation teams can inspect community rules and status to understand how a community is managed. The `rules` array and `status` field provide a quick snapshot of the community’s governance and whether it appears to be functioning normally. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | community_id | string | Yes | Enter the unique ID of the community you want to look up. | 1493290339532222469 | ### Output | Field | Type | Description | |---|---|---| | id | string | The unique community ID you searched for, so you can match the result to the right community. | | created_at | integer | The time the community was created, shown as a timestamp. Useful for understanding how established the community is. | | name | string | The community’s display name. This is the main label people recognize. | | description | string | A short summary of what the community is about. Helpful for quick evaluation. | | default_banner_media | string | The default banner image link for the community. Useful for visual review and branding checks. | | custom_banner_media | string | The custom banner image link, if one is set. Helpful for comparing the community’s current look. | | is_nsfw | boolean | Shows whether the community is marked as adult or sensitive content. Important for safety and brand suitability checks. | | primary_topic | null or string | The main topic associated with the community, if available. Helps with categorization and discovery. | | member_count | integer | The number of members in the community. Useful for measuring size and reach. | | rules | array | The community’s posted rules, including rule names and descriptions. Helpful for moderation and compliance review. | | status | string | The current status of the community record. Useful for checking whether the lookup completed as expected. | | last_cursor | string | A cursor value returned with the record, if present. Usually used for tracking or continuation purposes. | ### Sample Output ```json [ { "id": "1493290339532222469", "created_at": 1644863135598, "name": "XRP", "description": "XRP community", "default_banner_media": "https://pbs.twimg.com/media/FECS7TfVcAcCrj2.jpg", "custom_banner_media": "https://pbs.twimg.com/media/FECS7TfVcAcCrj2.jpg", "is_nsfw": false, "primary_topic": null, "member_count": 122509, "rules": [ { "description": "You should be respectful towards others.", "name": "Be Respectful" }, { "description": "To make sure everybody has a good time, keep the tweets about topics within the community.", "name": "Make sure the tweets are on subject" }, { "description": "Don’t post a BOOOOM announcement with fake news", "name": "Don’t spread fake news" } ], "status": "failed", "last_cursor": "" } ] ```` ### How It Works 1. You enter the community ID you want to look up. 2. The actor finds the matching community and gathers its details. 3. It saves the returned information exactly as received. 4. You review the community name, description, member count, rules, and other fields in the output. 5. You export or reuse the results in your reporting, research, or workflow. ### Getting Started Getting started is easy and does not require coding knowledge. Click **Try for free**, enter the community ID you want to check, and click **Run**. The actor will fetch the community details automatically and return the results in a format you can review right away. You can then download the output as JSON, CSV, or Excel depending on how you want to use the data. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is designed for non-technical users who simply want to look up a community by ID. You only need to paste the community ID into the input field and run it. #### How fast does it run? It usually runs quickly because it looks up just one community at a time. The exact time depends on the size of the response and current system load, but most lookups are completed in a short time. #### What format is the output? The output is available in easy-to-use formats such as JSON, CSV, and Excel. This makes it simple to review the data yourself or share it with teammates. #### Is this legal to use? This actor is intended for lawful research, analysis, and business workflows. You should always make sure your use complies with the platform’s rules and any applicable laws or internal policies. #### Can I schedule it to run automatically? Yes, you can set it up to run on a schedule if you want regular lookups. That can be useful for recurring checks, monitoring, or reporting workflows where you need updated community information over time. # Actor input Schema ## `community_id` (type: `array`): Enter the community ID to fetch its details. ## Actor input object example ```json { "community_id": [ "1493290339532222469" ] } ``` # 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 = { "community_id": [ "1493290339532222469" ] }; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/x-twitter-community-info-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 = { "community_id": ["1493290339532222469"] } # Run the Actor and wait for it to finish run = client.actor("datamagnet/x-twitter-community-info-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 '{ "community_id": [ "1493290339532222469" ] }' | apify call datamagnet/x-twitter-community-info-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/x-twitter-community-info-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "X (twitter) Community Info Scraper", "description": "Fetch and save the details of a community from a single community ID.", "version": "0.0", "x-build-id": "Accerxbf1pdky2u22" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~x-twitter-community-info-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-x-twitter-community-info-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/datamagnet~x-twitter-community-info-scraper/runs": { "post": { "operationId": "runs-sync-datamagnet-x-twitter-community-info-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/datamagnet~x-twitter-community-info-scraper/run-sync": { "post": { "operationId": "run-sync-datamagnet-x-twitter-community-info-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": [ "community_id" ], "properties": { "community_id": { "title": "Community ID", "type": "array", "description": "Enter the community ID to fetch its details.", "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 } } } } } } } } } } ```