{ "openapi": "3.0.1", "info": { "title": "Twitter (X) Community Search, Members & Tweets Scraper", "description": "Search X (Twitter) communities by keyword or get them by link or ID. Get community details and rules, feed posts with engagement counts, or member lists with roles. No X login needed.", "version": "0.0", "x-build-id": "oCCLYdfd8W5oiDE4X" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~x-communities/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-x-communities", "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/maximedupre~x-communities/runs": { "post": { "operationId": "runs-sync-maximedupre-x-communities", "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/maximedupre~x-communities/run-sync": { "post": { "operationId": "run-sync-maximedupre-x-communities", "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": [ "resultType" ], "properties": { "maxItems": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Stop after this many results in total, for all communities. Leave empty or set 0 to get all available results." }, "resultType": { "title": "Result type", "enum": [ "communities", "posts", "members" ], "type": "string", "description": "Choose what each result is: one community, one post from a community feed, or one community member." }, "findCommunitiesBy": { "title": "Find communities by", "enum": [ "keywords", "links" ], "type": "string", "description": "Search X communities by keyword, or get the communities you list in Community links or IDs. If omitted, keyword search is used.", "default": "keywords" }, "keywords": { "title": "Keywords: Search keywords", "type": "array", "description": "Enter one or more words or phrases. Each entry is a separate search.", "items": { "type": "string", "minLength": 1 } }, "postFeed": { "title": "Feed", "enum": [ "top", "latest", "media" ], "type": "string", "description": "Get posts from the community's Top, Latest, or Media feed. If omitted, the Latest feed is used. Post keywords work only with Top or Latest. Media with Post keywords is an invalid choice. It is not replaced by another feed.", "default": "latest" }, "postKeywords": { "title": "Post keywords", "type": "array", "description": "Only get posts that match these words or phrases. Each entry is a separate search in each community. Keyword search uses the Top or Latest order from Feed. It does not work with the Media feed. Leave empty to get all posts in the feed.", "items": { "type": "string", "minLength": 1 } }, "memberRole": { "title": "Members to get", "enum": [ "all", "moderators" ], "type": "string", "description": "Get all members, or only the admins and moderators. If omitted, all members are returned.", "default": "all" }, "communityList": { "title": "Community links or IDs", "type": "array", "description": "Enter X community links, such as https://x.com/i/communities/1234567890, or community IDs (the digits after /i/communities/). Used by Community posts, Community members, and Communities when you find communities by links or IDs.", "items": { "type": "string", "minLength": 1 } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }