{ "openapi": "3.0.1", "info": { "title": "X / Twitter Account Monitor - Track Accounts", "description": "Latest posts with full engagement counts from a list of X accounts, plus the part nobody else sells: what is new since your last run and which older posts are still gaining. Schedule it for a feed instead of a snapshot. The spend cap stops the run, it does not trim after.", "version": "0.1", "x-build-id": "qc04VSaxVTOWEFPwL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalayer~twitter-account-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalayer-twitter-account-monitor", "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/datalayer~twitter-account-monitor/runs": { "post": { "operationId": "runs-sync-datalayer-twitter-account-monitor", "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/datalayer~twitter-account-monitor/run-sync": { "post": { "operationId": "run-sync-datalayer-twitter-account-monitor", "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": [ "accounts" ], "properties": { "accounts": { "title": "X / Twitter accounts", "type": "array", "description": "Handles, @handles or profile URLs. X publishes the 20 most recent posts per account, which is what this returns.", "default": [ "nasa" ], "items": { "type": "string" } }, "trackChanges": { "title": "Track what changed since last run", "type": "boolean", "description": "Compares against the previous run and flags posts that are new, or older ones still gaining engagement. Run it on a schedule to get a feed instead of a snapshot.", "default": true }, "maxTweets": { "title": "Maximum posts", "minimum": 1, "type": "integer", "description": "Hard stop on TOTAL rows, counting both posts and change rows. The run stops collecting at this number rather than gathering everything and trimming afterwards. If you want the change feed as well, set this comfortably above the number of posts you expect (about 20 per account).", "default": 1000 }, "maxCostUsd": { "title": "Maximum spend (USD)", "minimum": 1, "type": "integer", "description": "Hard ceiling on what this run may cost. Leave empty for no cost ceiling." }, "postedFrom": { "title": "Posted after", "type": "string", "description": "Only keep posts on or after this date. Posts outside the range are never charged for. An unreadable date stops the run instead of being ignored.", "default": "" }, "postedTo": { "title": "Posted before", "type": "string", "description": "Only keep posts on or before this date.", "default": "" }, "minEngagement": { "title": "Minimum engagement", "minimum": 0, "type": "integer", "description": "Skip posts below this combined total of likes, retweets, replies and quotes. Skipped posts are not charged for.", "default": 0 }, "excludeReplies": { "title": "Exclude replies", "type": "boolean", "description": "Keep only the account's own posts, not its replies to other people.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "X only answers residential addresses reliably, so this defaults to Apify Proxy residential.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }