{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Tweet Engagers & Audience Leads", "description": "Turn public X/Twitter Retweets, Quote Tweets, and replies into one deduplicated audience list. Compare repeat engagers across Tweets and export profiles, engagement evidence, follower counts, and verification—no login or API key required.", "version": "0.2", "x-build-id": "FgLLOJzzF4fkHrrv0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arjun_code~x-twitter-tweet-engagers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arjun_code-x-twitter-tweet-engagers", "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/arjun_code~x-twitter-tweet-engagers/runs": { "post": { "operationId": "runs-sync-arjun_code-x-twitter-tweet-engagers", "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/arjun_code~x-twitter-tweet-engagers/run-sync": { "post": { "operationId": "run-sync-arjun_code-x-twitter-tweet-engagers", "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": [ "tweets" ], "properties": { "tweets": { "title": "Tweets to analyze", "minItems": 1, "maxItems": 25, "type": "array", "description": "Enter up to 25 Tweet URLs or numeric Tweet IDs, one per line. Repeated Tweets are processed once. Example: https://x.com/elonmusk/status/2108952286030356925", "items": { "type": "string", "minLength": 1 } }, "collectRetweets": { "title": "Include people who Retweeted", "type": "boolean", "description": "Collect the public users who Retweeted each input Tweet.", "default": true }, "collectQuoteTweets": { "title": "Include people who posted a Quote Tweet", "type": "boolean", "description": "Collect Quote Tweet authors and include their public Quote Tweet text, URL, time, and available metrics.", "default": true }, "collectReplies": { "title": "Include people who replied", "type": "boolean", "description": "Collect the public users who replied to each input Tweet.", "default": true }, "includeThreadReplies": { "title": "Include replies inside the conversation", "type": "boolean", "description": "Keep this off to collect only direct replies to the input Tweet. Turn it on to also collect visible replies to other replies. This setting is ignored when reply collection is off.", "default": false }, "maxUsersPerTypePerTweet": { "title": "Users per engagement type, per Tweet (0 = all)", "minimum": 0, "type": "integer", "description": "The limit applies separately to every selected type and every input Tweet. For example, 100 can collect up to 100 Retweet users, 100 Quote Tweet authors, and 100 Reply authors from each Tweet. Set 0 to collect all records currently exposed by X; large Tweets can take much longer.", "default": 100 }, "engagerMatch": { "title": "How each user must engage", "enum": [ "any", "multiple_types", "all_selected", "all_selected_same_tweet" ], "type": "string", "description": "Choose how a user must have engaged. Matching across input Tweets allows different actions on different Tweets; matching on one Tweet requires all selected actions on the same Tweet. At least 2 engagement types requires two or more collection switches above to be enabled.", "default": "any" }, "minimumTweetsEngaged": { "title": "Minimum different input Tweets per user", "minimum": 1, "type": "integer", "description": "Only save users who engaged with at least this many different input Tweets. Multiple actions on the same Tweet count as one Tweet. Use 1 for all engagers or 2+ to find repeat engagers across your content. This value cannot be greater than the number of valid unique Tweets entered above.", "default": 1 }, "minimumFollowers": { "title": "Minimum account followers", "minimum": 0, "type": "integer", "description": "Only save accounts with at least this many followers. Keep 0 to include accounts of every audience size.", "default": 0 }, "verification": { "title": "Verification status", "enum": [ "any", "any_verified", "blue_verified", "official_verified", "unverified" ], "type": "string", "description": "Choose which account verification group to save. Any verified includes blue, business, government, and legacy verified accounts. Official / legacy verified uses X's native verification type or verified flag.", "default": "any" } } }, "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 } } } } } } } } } }