📢 Datura AI Twitter Search Actor - Apify

Effortlessly search X (Twitter) for tweets matching your query!

🚀 Overview

This Apify actor allows users to search tweets using the Basic X (Twitter) Search API from Datura.ai. With this tool, you can extract tweets based on various filters such as keywords, engagement metrics, dates, and media types.

🛠 Features

✅ Search tweets using advanced query operators
✅ Filter results by language, engagement, date, and media type
✅ Retrieve tweet details, including user info, retweets, and likes
✅ Exclude images, videos, or quotes
✅ Fetch up to 100 tweets per query

📌 How to Use

1️⃣ Open the Apify Actor UI
2️⃣ Configure search parameters (e.g., query, date range, filters)
3️⃣ Run the actor and retrieve tweets
4️⃣ Download results in JSON format

📌 Input Parameters

Parameter	Type	Required	Description
query	String	✅ Yes	Search term (e.g., "Bittensor"). Use Twitter Search Operators for advanced queries.
sort	String	❌ No	Sort by "Top" or "Latest" (default: "Top").
start_date	String	❌ No	Start date (YYYY-MM-DD).
end_date	String	❌ No	End date (YYYY-MM-DD).
lang	String	❌ No	Language filter (en, fr, es, etc.).
min_likes	Number	❌ No	Minimum number of likes.
min_retweets	Number	❌ No	Minimum number of retweets.
min_replies	Number	❌ No	Minimum number of replies.
blue_verified	Boolean	❌ No	Filter for Twitter Blue users (default: false).
is_image	Boolean	❌ No	Include tweets with images (true/false).
is_video	Boolean	❌ No	Include tweets with videos (true/false).
count	Number	❌ No	Number of tweets to retrieve (default: 10, max: 100).

📥 Expected Output

The actor outputs a JSON file containing the retrieved tweets. Example format:

[
  {
    "user": {
      "id": "1453417787746029577",
      "url": "https://x.com/firsttensor",
      "name": "Firsττensor - Biττensor Validator",
      "username": "firsttensor",
      "created_at": "2021-10-27",
      "followers_count": 4669,
      "profile_image_url": "https://pbs.twimg.com/profile_images/1890150870563614720/L3PGGoUs_normal.jpg"
    },
    "id": "1891203972003684353",
    "text": "How to Stake/Unstake $TAO to the FirstTensor Validator...",
    "retweet_count": 2,
    "like_count": 7,
    "created_at": "2025-02-16",
    "url": "https://x.com/firsttensor/status/1891203972003684353",
    "hashtags": ["bittensor", "delegate", "root"]
  }
]

📌 Twitter Search Operators

This actor supports Twitter's advanced search operators to refine results.
🔍 Examples:

• #hashtag → Tweets with a specific hashtag
• from:user → Tweets from a specific user
• min_retweets:10 → Tweets with at least 10 retweets
• filter:videos → Tweets with videos
• since:YYYY-MM-DD → Tweets from a certain date

For a complete list, check Twitter Advanced Search.

📈 Use Cases

💡 Market Research: Find trending tweets on a topic.
💡 Brand Monitoring: Track mentions of your brand.
💡 Crypto & Finance Analysis: Follow discussions on tokens.
💡 News Scraping: Collect tweets from verified sources.

🚀 Get Started

1️⃣ Open the Apify Actor UI
2️⃣ Enter your search parameters
3️⃣ Run the actor and collect tweets effortlessly!

🛠 Support

For questions or issues, check Datura Docs.