Desearch X Scrapper Search

🚀 Overview

This Apify actor allows users to search tweets using the Basic X (Twitter) Search API from Desearch.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 in format `YYYY-MM-DD`.
`end_date`	String	❌ No	End date in format `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 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!