# X (Twitter) Posts Search (`scraper_one/x-posts-search`) Actor ✨ Search for X (formerly Twitter) posts using keywords or hashtags. Retrieve post URLs, content, publication dates, author details, and engagement metrics. Ideal for monitoring brand mentions on X over time. - **URL**: https://apify.com/scraper\_one/x-posts-search.md - **Developed by:** [Scraper One](https://apify.com/scraper_one) (community) - **Categories:** Social media, Lead generation, Other - **Stats:** 1,659 total users, 286 monthly users, 100.0% runs succeeded, 19 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.20 / 1,000 result items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## X (Twitter) Posts Search ![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue) This **Apify Actor** searches for posts on **X (formerly Twitter)** based on keywords or hashtags. The results include post URL, content, publication date, author information, and engagement metrics. It's a powerful tool for **monitoring** public conversations on X, tracking **brand mentions**, staying updated on **trending topics**, and discovering **high-engagement** posts in real time. **Stay ahead** of potential reputation risks, detect viral content, and join relevant discussions 🚀 ### Features - 🔍 Search by **keywords or hashtags** - 🕐 Filter by **time window** (e.g. posts from the last 7 days) - 🧵 Choose between **top** or **latest** results - 🎥 Retrieve **media** (images, videos, gifs) from posts - 📊 Extract **engagement metrics** (likes, reposts, replies, quotes) ### Input Parameters | Parameter | Type | Required | Description | |-------------------|----------|----------|---------------------------------------------------------------------------------------------------------------------------| | `query` | `string` | ✅ | Keyword or hashtag to search posts for. | | `resultsCount` | `number` | ❌ | Maximum number of posts to extract. If not set, only a few of the first posts will be returned. | | `timeWindowHours` | `number` | ❌ | Time window in **hours**, counting back from current time. E.g. `5` = last 5 hours. Works only with 'Latest' Search Type. | | `timeWindow` | `number` | ❌ | Time window in **days**, counting back from today. E.g. `7` = last 7 days. Works only with 'Latest' Search Type. | | `searchType` | `string` | ❌ | Type of search results: `"top"` or `"latest"`. Defaults to platform’s default if not specified. | #### Example Input ```json { "query": "SpaceX", "resultsCount": 30, "timeWindow": 7, "searchType": "latest" } ``` ```json { "query": "NASA", "resultsCount": 30, "timeWindowHours": 4, "searchType": "latest" } ``` ### Output Data The actor returns an array of JSON objects representing individual X posts. #### Example Output ```json [ { "postText": "#Iceland hospital\nAnd\nPolice hell !! See you soon on court 😉 https://t.co/axWj1bexPl", "postUrl": "https://x.com/Maj33Majewska/status/1905313916126736649", "timestamp": 1743097211000, "conversationId": "1905313916126736649", "postId": "1905313916126736649", "media": [ { "mediaUrlHttps": "https://pbs.twimg.com/amplify_video_thumb/1905313794902966272/img/0HvmBic_wjBJQa3b.jpg", "type": "video", "id": "1905313794902966272" } ], "author": { "name": "Natalie", "screenName": "Maj33Majewska", "followersCount": 142, "favouritesCount": 300, "friendsCount": 171, "description": "Strict and intelligent person is curious about @SpaceX" }, "replyCount": 0, "quoteCount": 0, "repostCount": 0, "favouriteCount": 0 } ] ``` ✅ Let us know if you'd like to include additional data fields or filters. ### Usage 1. **Create an Apify account** and open the actor page. 2. **Configure input parameters** in the Apify UI or via API. 3. **Run the actor** and monitor logs for progress. 4. **Download extracted posts** in JSON, CSV, or Excel format. ### Limitations & Notes - Ensure your usage of X's data complies with their [Terms of Service](https://twitter.com/en/tos). - Avoid excessive scraping to reduce the risk of IP blocking or rate limiting. - Media content is linked directly from X and may expire or be removed. - Rate-limited – Free users can make only a few requests per day. **Contact us if you need higher or custom limits!** ### Works Best With For best results, use this actor together with [X Post Replies Scraper](https://apify.com/scraper_one/x-post-replies-scraper). First, search for tweets matching your criteria using **X Posts Search**, then pass those tweet URLs into this **X Post Replies Scraper** to extract replies and enrich your dataset. ✅ #### Best Use Case Flow - 🔎 Run X Posts Search → Find relevant tweets based on keywords or hashtags - 📥 Feed tweet URLs into X Post Replies Scraper → Get replies for each tweet - 📊 Gain insights → Analyze engagement, sentiment, and conversation threads This combination provides a powerful workflow for understanding discussions around specific topics on X. 🚀 ### Other Recommended Scrapers If you're working with multiple platforms or want additional data sources, check out these scrapers: - 🐦 [X (Twitter) Posts Search](https://apify.com/scraper_one/x-posts-search) — Find posts/tweets based on keywords, hashtags, and more - 🐦 [X Post Replies Scraper](https://apify.com/scraper_one/x-post-replies-scraper) — Scrap replies of multiple X ( Twitter) posts - 🐦 [X Profile Posts Scraper](https://apify.com/scraper_one/x-profile-posts-scraper) — Scrap posts of specific X ( Twitter) profile - 📘 [Facebook Posts Search](https://apify.com/scraper_one/facebook-posts-search) — Discover Facebook posts for a given topic or page - 📘 [Facebook Comments Scraper](https://apify.com/scraper_one/facebook-comments-scraper) — Extract comments from public Facebook posts - 📘 [Facebook Reactions Scraper](https://apify.com/scraper_one/facebook-reactions-scraper) — Scrap reactions from Facebook posts (like, sad, haha, angry etc.) - 📘 [Facebook Posts Scraper](https://apify.com/scraper_one/facebook-posts-scraper) — Scrap posts from Facebook pages, groups etc. - 🎬 [YouTube Search Scraper](https://apify.com/scraper_one/youtube-search-scraper) — Extract videos from search queries - 🎬 [YouTube Comments Scraper](https://apify.com/scraper_one/youtube-comments-scraper) — Extract comments from posted videos - 🎬 [YouTube Downloader](https://apify.com/scraper_one/yt-downloader) — Download youtube videos ### Support & Contact 📬 Need help or found a bug? Open an issue or contact us at **scraper1one@gmail.com** # Actor input Schema ## `query` (type: `string`): The search term to look for. ## `resultsCount` (type: `integer`): Number of search results to retrieve (between 1 and 500). If not set, only a few of the first posts will be returned. ## `timeWindow` (type: `integer`): Get posts from last n day(s). Works only when the Search Type is set to 'Latest' ## `timeWindowHours` (type: `integer`): Get posts from last n hours. Works only when the Search Type is set to 'Latest' ## `searchType` (type: `string`): What kind of posts you'd like to search for. ## Actor input object example ```json { "query": "Iceland", "resultsCount": 30, "searchType": "top" } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "Iceland", "resultsCount": 30, "searchType": "top" }; // Run the Actor and wait for it to finish const run = await client.actor("scraper_one/x-posts-search").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "Iceland", "resultsCount": 30, "searchType": "top", } # Run the Actor and wait for it to finish run = client.actor("scraper_one/x-posts-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "Iceland", "resultsCount": 30, "searchType": "top" }' | apify call scraper_one/x-posts-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraper_one/x-posts-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/acts/rBaTEHzveTxZPraGv/builds/qUyvJISvqOno1OfnH/openapi.json