X (Twitter) Posts Search

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

{
    "query": "SpaceX",
    "resultsCount": 30,
    "timeWindow": 7,
    "searchType": "latest"
}

{
    "query": "NASA",
    "resultsCount": 30,
    "timeWindowHours": 4,
    "searchType": "latest"
}

Output Data

The actor returns an array of JSON objects representing individual X posts.

Example Output

[
    {
        "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.
• 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.

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 — Find posts/tweets based on keywords, hashtags, and more
• 🐦 X Post Replies Scraper — Scrap replies of multiple X ( Twitter) posts
• 🐦 X Profile Posts Scraper — Scrap posts of specific X ( Twitter) profile
• 📘 Facebook Posts Search — Discover Facebook posts for a given topic or page
• 📘 Facebook Comments Scraper — Extract comments from public Facebook posts
• 📘 Facebook Reactions Scraper — Scrap reactions from Facebook posts (like, sad, haha, angry etc.)
• 📘 Facebook Posts Scraper — Scrap posts from Facebook pages, groups etc.
• 🎬 YouTube Search Scraper — Extract videos from search queries
• 🎬 YouTube Comments Scraper — Extract comments from posted videos
• 🎬 YouTube Downloader — Download youtube videos

Support & Contact

📬 Need help or found a bug? Open an issue or contact us at scraper1one@gmail.com