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.
timeWindow	number	❌	Time window in days, counting back from today. E.g. 7 = last 7 days.
searchType	string	✅	Type of search results: "top" or "latest". Defaults to platform’s default if not specified.

Example Input

1{
2  "query": "SpaceX",
3  "resultsCount": 30,
4  "timeWindow": 7,
5  "searchType": "latest"
6}

Output Data

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

Example Output

1[
2  {
3    "postText": "#Iceland hospital\nAnd\nPolice hell !! See you soon on court 😉 https://t.co/axWj1bexPl",
4    "postUrl": "https://x.com/Maj33Majewska/status/1905313916126736649",
5    "timestamp": 1743097211000,
6    "conversationId": "1905313916126736649",
7    "postId": "1905313916126736649",
8    "media": [
9      {
10        "mediaUrlHttps": "https://pbs.twimg.com/amplify_video_thumb/1905313794902966272/img/0HvmBic_wjBJQa3b.jpg",
11        "type": "video",
12        "id": "1905313794902966272"
13      }
14    ],
15    "author": {
16      "name": "Natalie",
17      "screenName": "Maj33Majewska",
18      "followersCount": 142,
19      "favouritesCount": 300,
20      "friendsCount": 171,
21      "description": "Strict and intelligent person is curious about @SpaceX"
22    },
23    "replyCount": 0,
24    "quoteCount": 0,
25    "repostCount": 0,
26    "favouriteCount": 0
27  }
28]

✅ 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.

---

Support & Contact

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