{ "openapi": "3.0.1", "info": { "title": "X Twitter Latest Tweets Scraper - Tweet View Count, Bookmarks", "description": "One account with its 10 latest tweets costs $0.0031 here against $0.038 and $0.070 at the niche leader's profile scrapers: no per-request fee, no start fee, no minimum charge. Profile card plus latest tweets of any public X account, with likes, retweets, replies, quotes, bookmarks and views.", "version": "0.1", "x-build-id": "4tJeAd1uxq4hzvVS2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/snow_leo_data~twitter-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-snow_leo_data-twitter-profile-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/snow_leo_data~twitter-profile-scraper/runs": { "post": { "operationId": "runs-sync-snow_leo_data-twitter-profile-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/snow_leo_data~twitter-profile-scraper/run-sync": { "post": { "operationId": "run-sync-snow_leo_data-twitter-profile-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", "properties": { "handles": { "title": "Accounts", "type": "array", "description": "X accounts to read: a handle (nasa), an @handle (@nasa) or a profile link (https://x.com/nasa). Each account returns its profile card and its latest tweets.", "items": { "type": "string" } }, "tweetUrls": { "title": "Tweet URLs", "type": "array", "description": "Links to single tweets, for example https://x.com/nasa/status/2100294890068271339. Charged as one row each, with no extra per-request fee.", "items": { "type": "string" } }, "includeProfile": { "title": "Include profile", "type": "boolean", "description": "Return one profile row per account: name, bio, followers, following, tweet count, location, avatar, banner, verification.", "default": true }, "includeTweets": { "title": "Include tweets", "type": "boolean", "description": "Return the latest tweets of each account with the full engagement set: likes, retweets, replies, quotes, bookmarks and views.", "default": true }, "maxTweetsPerAccount": { "title": "Max tweets per account", "minimum": 0, "maximum": 100, "type": "integer", "description": "Upper bound per account. X serves 5 to 10 latest tweets on a public profile page (measured on 10 accounts: 56 tweets, median 5.5), so a higher number cannot add more.", "default": 20 }, "maxItems": { "title": "Max rows", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Hard stop on billed rows. 0 means no limit.", "default": 100 }, "minFavorites": { "title": "Min likes", "minimum": 0, "type": "integer", "description": "Keep tweets with at least this many likes.", "default": 0 }, "minRetweets": { "title": "Min retweets", "minimum": 0, "type": "integer", "description": "Keep tweets with at least this many retweets.", "default": 0 }, "minViews": { "title": "Min views", "minimum": 0, "type": "integer", "description": "Keep tweets with at least this many views.", "default": 0 }, "languages": { "title": "Languages", "type": "array", "description": "Keep tweets in these language codes only, for example en, es, ru.", "items": { "type": "string" } }, "textContains": { "title": "Text contains", "type": "string", "description": "Keep tweets whose text contains this, case-insensitive." }, "onlyChanged": { "title": "Only changed", "type": "boolean", "description": "For watch runs: return only what is new or changed since the previous run of this Actor. Likes and views are deliberately not watched, otherwise every tweet would count as changed every hour.", "default": false }, "compact": { "title": "Compact rows", "type": "boolean", "description": "Keep only the core columns, so the CSV has no empty ones.", "default": false }, "inputDatasetId": { "title": "Input dataset ID", "type": "string", "description": "Read the accounts from another Actor's dataset instead of typing them." }, "urlField": { "title": "Field with the account", "type": "string", "description": "Which field of that dataset holds the handle or profile link.", "default": "handle" }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many accounts are read at once.", "default": 4 }, "timeoutSeconds": { "title": "Request timeout, seconds", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long one request to X may take before it is retried.", "default": 30 } } }, "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 } } } } } } } } } }