{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Tweet Scraper | $0.12/1K | No Login", "description": "Scrape tweets from X by search term, profile, tweet URL, conversation or community. No login, no cookies. Full engagement metrics and author data, exported to JSON, CSV or Excel. Flat $0.12 per 1,000 tweets with no start or query fees. By FeedMiner.", "version": "1.0", "x-build-id": "0k5Mhgrp8NGJJX8OC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/feedminer~x-tweet-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-feedminer-x-tweet-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/feedminer~x-tweet-scraper/runs": { "post": { "operationId": "runs-sync-feedminer-x-tweet-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/feedminer~x-tweet-scraper/run-sync": { "post": { "operationId": "run-sync-feedminer-x-tweet-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search for on X. Supports the full advanced syntax, for example scraping from:apify min_faves:10 lang:en.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Profile, tweet, search, list, community, /media or /highlights URLs. Paste them and get results.", "items": { "type": "string" } }, "twitterHandles": { "title": "X handles", "type": "array", "description": "Accounts to scrape, with or without the @.", "items": { "type": "string" } }, "conversationIds": { "title": "Conversation IDs", "type": "array", "description": "Tweet IDs whose replies you want.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum tweets", "type": "integer", "description": "Caps how many tweets end up in your dataset.", "default": 1000 }, "sort": { "title": "Sort by", "enum": [ "Latest", "Top", "Latest + Top" ], "type": "string", "description": "How search results are ranked. Latest gives you the newest, Top the most engaging. Latest + Top runs both and merges them.", "default": "Latest" }, "tweetLanguage": { "title": "Language", "enum": [ "ab", "aa", "af", "ak", "sq", "am", "ar", "an", "hy", "as", "av", "ae", "ay", "az", "bm", "ba", "eu", "be", "bn", "bi", "bs", "br", "bg", "my", "ca", "ch", "ce", "ny", "zh", "cu", "cv", "kw", "co", "cr", "hr", "cs", "da", "dv", "nl", "dz", "en", "eo", "et", "ee", "fo", "fj", "fi", "fr", "fy", "ff", "gd", "gl", "lg", "ka", "de", "el", "kl", "gn", "gu", "ht", "ha", "he", "hz", "hi", "ho", "hu", "is", "io", "ig", "id", "ia", "ie", "iu", "ik", "ga", "it", "ja", "jv", "kn", "kr", "ks", "kk", "km", "ki", "rw", "ky", "kv", "kg", "ko", "kj", "ku", "lo", "la", "lv", "li", "ln", "lt", "lu", "lb", "mk", "mg", "ms", "ml", "mt", "gv", "mi", "mr", "mh", "mn", "na", "nv", "nd", "nr", "ng", "ne", "no", "nb", "nn", "ii", "oc", "oj", "or", "om", "os", "pi", "ps", "fa", "pl", "pt", "pa", "qu", "ro", "rm", "rn", "ru", "se", "sm", "sg", "sa", "sc", "sr", "sn", "sd", "si", "sk", "sl", "so", "st", "es", "su", "sw", "ss", "sv", "tl", "ty", "tg", "ta", "tt", "te", "th", "bo", "ti", "to", "ts", "tn", "tr", "tk", "tw", "ug", "uk", "ur", "uz", "ve", "vi", "vo", "wa", "cy", "wo", "xh", "yi", "yo", "za", "zu" ], "type": "string", "description": "Keeps only tweets X detected in this language." }, "onlyVerifiedUsers": { "title": "Only verified authors", "type": "boolean", "description": "Restricts searches to verified authors.", "default": false }, "onlyTwitterBlue": { "title": "Only Premium authors", "type": "boolean", "description": "Restricts searches to authors on X Premium.", "default": false }, "onlyImage": { "title": "Only tweets with images", "type": "boolean", "description": "Restricts searches to tweets carrying an image.", "default": false }, "onlyVideo": { "title": "Only tweets with videos", "type": "boolean", "description": "Restricts searches to tweets carrying a video.", "default": false }, "onlyQuote": { "title": "Only quote tweets", "type": "boolean", "description": "Restricts searches to quote tweets.", "default": false }, "includeReplies": { "title": "Include replies in timelines", "type": "boolean", "description": "Adds each account's replies to its posts.", "default": false }, "author": { "title": "From this account", "type": "string", "description": "Restricts searches to tweets from this account, with or without the @." }, "inReplyTo": { "title": "Replying to this account", "type": "string", "description": "Restricts searches to replies addressed to this account, with or without the @." }, "mentioning": { "title": "Mentioning this account", "type": "string", "description": "Restricts searches to tweets that mention this account, with or without the @." }, "minimumFavorites": { "title": "Minimum likes", "type": "integer", "description": "Drops search results with fewer likes than this." }, "minimumRetweets": { "title": "Minimum reposts", "type": "integer", "description": "Drops search results with fewer reposts than this." }, "minimumReplies": { "title": "Minimum replies", "type": "integer", "description": "Drops search results with fewer replies than this." }, "start": { "title": "From date", "type": "string", "description": "YYYY-MM-DD" }, "end": { "title": "To date", "type": "string", "description": "YYYY-MM-DD" }, "geotaggedNear": { "title": "Geotagged near", "type": "string", "description": "A place name, for example San Francisco." }, "withinRadius": { "title": "Within radius", "type": "string", "description": "For example 15km, used together with Geotagged near." }, "geocode": { "title": "Geocode", "type": "string", "description": "latitude,longitude,radius, for example 37.7,-122.4,10km." }, "placeObjectId": { "title": "Place object ID", "type": "string", "description": "X place id." }, "includeSearchTerms": { "title": "Include search terms", "type": "boolean", "description": "Adds the term that found each tweet to its record.", "default": false }, "sessions": { "title": "X accounts", "type": "array", "description": "Optional, and normally left empty. X accounts of your own, for anyone who would rather the run used accounts they control." }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Writes the actor's internal steps to the log. Turn it on when a run returns less than you expected.", "default": false } } }, "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 } } } } } } } } } }