desearch-x-searchSearch X (Twitter) in real time. Find posts by keyword, user, or hashtag. Get a user's timeline, replies, retweeters, or fetch specific posts by ID or URL. S...
Install via ClawdBot CLI:
clawdbot install okradze/desearch-x-searchReal-time X/Twitter search and monitoring. Search posts, track users, get timelines, replies, and retweeters with powerful filtering.
export DESEARCH_API_KEY='your-key-here'All tweet-returning endpoints share these shapes. Fields marked * are always present.
| Field | Type | Description |
|-------|------|-------------|
| id* | string | Post ID |
| text* | string | Post content |
| created_at* | string | ISO 8601 timestamp |
| url | string\|null | Direct link: https://x.com/{username}/status/{id} |
| like_count* | int | Likes |
| retweet_count* | int | Retweets |
| reply_count* | int | Replies |
| quote_count* | int | Quotes |
| bookmark_count* | int | Bookmarks |
| view_count | int\|null | Views |
| lang | string\|null | Language code (e.g. en) |
| is_retweet | bool\|null | Is a retweet |
| is_quote_tweet | bool\|null | Is a quote tweet |
| conversation_id | string\|null | Thread ID |
| in_reply_to_screen_name | string\|null | Username of post being replied to |
| in_reply_to_status_id | string\|null | ID of post being replied to |
| media | array\|null | [{media_url, type}] — type: photo, video, animated_gif |
| entities | object\|null | {hashtags, symbols, urls, user_mentions} |
| quote | Tweet\|null | Nested quoted tweet |
| retweet | Tweet\|null | Original tweet _(timeline endpoint only)_ |
| user | User\|null | Post author — see User below |
| Field | Type | Description |
|-------|------|-------------|
| id* | string | User ID |
| username* | string | @handle (without @) |
| name | string\|null | Display name |
| url | string\|null | Profile URL |
| description | string\|null | Bio |
| followers_count | int\|null | Followers |
| followings_count | int\|null | Following |
| statuses_count | int\|null | Total tweets posted |
| verified | bool\|null | Legacy verified badge |
| is_blue_verified | bool\|null | Twitter Blue subscriber |
| location | string\|null | Self-reported location |
| created_at | string\|null | Account creation date |
| profile_image_url | string\|null | Avatar URL |
x — Search PostsSearch X posts by keyword, hashtag, or user with engagement filters.
scripts/desearch.py x "Bittensor TAO" --sort Latest --count 10
scripts/desearch.py x "AI news" --user elonmusk --start-date 2025-01-01
scripts/desearch.py x "crypto" --min-likes 100 --verified --lang enOptions:
| Option | Description |
|--------|-------------|
| --sort | Top (default) or Latest |
| --user, -u | Filter to posts by username |
| --start-date | Start date UTC (YYYY-MM-DD) |
| --end-date | End date UTC (YYYY-MM-DD) |
| --lang | Language code (e.g. en, es) |
| --verified | Only verified users |
| --blue-verified | Only Twitter Blue users |
| --is-quote | Only quote tweets |
| --is-video | Only posts with video |
| --is-image | Only posts with images |
| --min-retweets | Minimum retweet count |
| --min-replies | Minimum reply count |
| --min-likes | Minimum like count |
| --count, -n | Results count (default: 20, max: 100) |
Response: Tweet[]
x_post — Retrieve Post by IDFetch a single post by its numeric ID.
scripts/desearch.py x_post 1892527552029499853Response: Tweet
x_urls — Fetch Posts by URLsRetrieve one or more posts by their X URLs.
scripts/desearch.py x_urls "https://x.com/user/status/123" "https://x.com/user/status/456"Response: Tweet[]
x_user — Search Posts by UserSearch within a specific user's posts for a keyword.
scripts/desearch.py x_user elonmusk --query "AI" --count 10Options:
| Option | Description |
|--------|-------------|
| --query, -q | Keyword to filter the user's posts |
| --count, -n | Results count (default: 10, max: 100) |
Response: Tweet[]
x_timeline — Get User TimelineFetch the most recent posts from a user's timeline. Retweets include a retweet field with the original post.
scripts/desearch.py x_timeline elonmusk --count 20Options:
| Option | Description |
|--------|-------------|
| --count, -n | Number of posts (default: 20, max: 100) |
Response: { user: User, tweets: Tweet[] }
x_retweeters — Get Retweeters of a PostList users who retweeted a specific post. Supports cursor-based pagination.
scripts/desearch.py x_retweeters 1982770537081532854
scripts/desearch.py x_retweeters 1982770537081532854 --cursor "AAAAANextCursorValue=="Options:
| Option | Description |
|--------|-------------|
| --cursor | Pagination cursor from a previous response |
Response: { users: User[], next_cursor: string|null } — next_cursor is null when no more pages remain.
x_replies — Get User's RepliesFetch a user's tweets-and-replies timeline. Replies have in_reply_to_screen_name and in_reply_to_status_id set.
scripts/desearch.py x_replies elonmusk --count 10
scripts/desearch.py x_replies elonmusk --query "AI" --count 10Options:
| Option | Description |
|--------|-------------|
| --count, -n | Results count (default: 10, max: 100) |
| --query, -q | Filter keyword |
Response: Tweet[]
x_post_replies — Get Replies to a PostFetch replies to a specific post by ID.
scripts/desearch.py x_post_replies 1234567890 --count 10
scripts/desearch.py x_post_replies 1234567890 --query "thanks" --count 5Options:
| Option | Description |
|--------|-------------|
| --count, -n | Results count (default: 10, max: 100) |
| --query, -q | Filter keyword within replies |
Response: Tweet[]
Status 401, Unauthorized (e.g., missing/invalid API key)
{
"detail": "Invalid or missing API key"
}Status 402, Payment Required (e.g., balance depleted)
{
"detail": "Insufficient balance, please add funds to your account to continue using the service."
}Generated Mar 1, 2026
Companies can track mentions of their brand, products, or campaigns on X in real time to gauge public sentiment and engagement. This helps in identifying trends, responding to customer feedback promptly, and monitoring competitor activities with filters like language and engagement thresholds.
Financial analysts and traders can search for posts related to specific stocks, cryptocurrencies, or economic events to gather market sentiment and breaking news. Using advanced filters like date range and verified users ensures high-quality data for investment decisions and risk assessment.
Researchers can collect data on public discourse around topics like AI, climate change, or political movements by searching keywords and hashtags. The ability to filter by language and media type supports qualitative analysis and trend tracking over time for academic papers or reports.
Content creators and journalists can use this skill to find trending posts, user timelines, or replies for inspiration, fact-checking, or sourcing quotes. Features like fetching posts by URL and filtering by engagement help in curating high-impact content for articles, videos, or social media updates.
Businesses can monitor customer inquiries, complaints, or praise on X by tracking specific users or keywords. This enables proactive support, identifying common issues, and engaging with users through replies or retweets to improve customer satisfaction and brand loyalty.
Offer a subscription-based service that provides real-time X data analytics dashboards for businesses. Integrate this skill to deliver insights on brand mentions, competitor tracking, and sentiment analysis, with tiered pricing based on data volume and advanced features like engagement filters.
Resell access to this skill's capabilities through a custom API wrapper, targeting developers and enterprises needing X data for their applications. Provide additional services like data normalization, historical archiving, or integration with other platforms to add value and charge per API call or data package.
Use this skill to gather X data for clients in industries like marketing or finance, offering tailored reports and insights. Charge for one-time projects or ongoing monitoring services, leveraging advanced filters to deliver actionable intelligence on trends, user behavior, or campaign performance.
💬 Integration Tip
Ensure the DESEARCH_API_KEY is securely stored in environment variables and test endpoints with sample queries to validate data formats before full integration.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.