​
πŸš€ 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

ParameterTypeRequiredDescription
queryStringβœ… YesSearch term (e.g., "Bittensor"). Use Twitter Search Operators for advanced queries.
sortString❌ NoSort by "Top" or "Latest" (default: "Top").
start_dateString❌ NoStart date in format YYYY-MM-DD.
end_dateString❌ NoEnd date in format YYYY-MM-DD.
langString❌ NoLanguage filter (en, fr, es, etc.).
min_likesNumber❌ NoMinimum number of likes.
min_retweetsNumber❌ NoMinimum number of retweets.
min_repliesNumber❌ NoMinimum number of replies.
blue_verifiedBoolean❌ NoFilter for Twitter Blue users (default: false).
is_imageBoolean❌ NoInclude tweets with images (true/false).
is_videoBoolean❌ NoInclude tweets with videos (true/false).
countNumber❌ NoNumber 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 X Advance Query 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!