Cheap & Simple Twitter / X.com API – Apify Actor A robust, dirt-cheap, affordable, pay-per-use Apify actor that wraps the raw Twitter API endpoints, providing simplified, noise-free tweet and user objects. Designed for easy integration, strict field filtering, and reliable automation. --- ## 🚀 Features - Pay-per-event monetization: Only pay for successful, non-empty results. As low as $0.00046 per tweet. - Comprehensive endpoint support (see below) - Unified Twitter API access via Apify - Strict field filtering for tweet and user objects (no noise) - Production-ready error handling - Pagination support via cursor parameter for all list endpoints - Advanced search supports queryType (Latest/Top) --- ## Getting Started Guide I've created a detailed Getting Started Guide, available in Markdown or a PDF file ## Complex Advanced Search Query Builder This little tool will help you create complex API search queries: 👉 Twitter search builder ## 💸 Pricing - $0.009375 per API response event (up to 20 results per response) - You are only charged if: - The API call is successful and - The response contains at least one tweet or user object --- ## 🛠️ How to Use ### 1. Via Apify UI - Go to the actor page and click "Run". - Fill in the input fields: - endpoint: (string) The endpoint to call (see list below) - parameters: (object) Parameters for the endpoint (see below) ### 2. Via Apify API Send a POST request to the actor with a JSON body: json { "endpoint": "user/info", "parameters": { "userName": "NASA" } } --- ## 📥 Input Schema json { "endpoint": "string (required)", "parameters": "object (required)" } --- ## 📤 Output Schema - User object: json { "type": "user", "userName": "string", "url": "string", "id": "string", "name": "string", "isBlueVerified": true, "profilePicture": "string", "coverPicture": "string", "description": "string", "location": "string", "followers": 123, "following": 123 } - Tweet object: json { "type": "tweet", "id": "string", "url": "string", "text": "string", "source": "string", "retweetCount": 123, "replyCount": 123, "likeCount": 123, "quoteCount": 123, "viewCount": 123, "createdAt": "string", "lang": "string", "bookmarkCount": 123, "isReply": true, "media": "string", "video": { "duration_millis": 123, "variants": [ { "bitrate": 123, "content_type": "string", "url": "string" } ] }, "author": { ...user object... } } - Array: Most endpoints return an array of user or tweet objects. --- ## 📚 Supported Endpoints & Usage | Endpoint | Description | Parameters (required) | Example Input | |-------------------------|---------------------------------------------|-------------------------------|--------------| | user/info | Get user info by username | userName (string) | { "endpoint": "user/info", "parameters": { "userName": "NASA" } } | | user/last_tweets | Get latest tweets by user | userName (string), cursor (optional) | { "endpoint": "user/last_tweets", "parameters": { "userName": "NASA", "cursor": "NEXT_CURSOR" } } | | user/followers | Get followers of a user | userName (string), cursor (optional) | { "endpoint": "user/followers", "parameters": { "userName": "NASA", "cursor": "NEXT_CURSOR" } } | | user/followings | Get users followed by a user | userName (string), cursor (optional) | { "endpoint": "user/followings", "parameters": { "userName": "NASA", "cursor": "NEXT_CURSOR" } } | | user/mentions | Get tweets mentioning a user | userName (string), cursor (optional) | { "endpoint": "user/mentions", "parameters": { "userName": "NASA", "cursor": "NEXT_CURSOR" } } | | tweet/by_ids | Get tweets by IDs | tweet_ids (string, comma-separated) | { "endpoint": "tweet/by_ids", "parameters": { "tweet_ids": "1920130001699062027" } } | | tweet/replies | Get replies to a tweet | tweet_id (string), cursor (optional) | { "endpoint": "tweet/replies", "parameters": { "tweet_id": "1920130001699062027", "cursor": "NEXT_CURSOR" } } | | tweet/quotes | Get quotes of a tweet | tweet_id (string), cursor (optional) | { "endpoint": "tweet/quotes", "parameters": { "tweet_id": "1920130001699062027", "cursor": "NEXT_CURSOR" } } | | tweet/retweeters | Get users who retweeted a tweet | tweetId (string), cursor (optional) | { "endpoint": "tweet/retweeters", "parameters": { "tweetId": "1920130001699062027", "cursor": "NEXT_CURSOR" } } | | tweet/advanced_search | Advanced tweet search | query (string, required), queryType (enum: Latest, Top, required, default: Latest), cursor (optional) | { "endpoint": "tweet/advanced_search", "parameters": { "query": "from:NASA", "queryType": "Latest", "cursor": "NEXT_CURSOR" } } | | list/tweets | Get tweets from a list | listId (string), cursor (optional) | { "endpoint": "list/tweets", "parameters": { "listId": "YOUR_LIST_ID", "cursor": "NEXT_CURSOR" } } | --- ## 🧑‍💻 Example Usage Input JSON (Apify UI or API): json { "endpoint": "tweet/advanced_search", "parameters": { "query": "from:NASA", "queryType": "Latest", "cursor": "NEXT_CURSOR" } } Sample Output: json { "type": "user", "userName": "NASA", "url": "https://twitter.com/NASA", "id": "123456789", "name": "Muzli", "isBlueVerified": true, "profilePicture": "https://...", "coverPicture": "https://...", "description": "Curated design inspiration", "location": "Internet", "followers": 100000, "following": 1 } --- ## ⚠️ Error Handling - If the API call fails or returns no results, you will receive an error object: json { "error": true, "message": "Error message", "stack": "Stack trace" } --- ## 🙋 Support - For questions or issues, use the Apify actor page "Issues" tab or contact the maintainer. --- Actor ID: gdN28kzr6QsU4nVh8 Pricing: $0.009375 per successful, non-empty API response ---