Aident logoAident logo centerAident Loadout
Use CasesPricingDocs
ENStart Now
AppsTwitter ToolsTwitter Recent Search
Twitter Tools

Twitter Recent Search

Searches Tweets from the last 7 days matching a query (using X's search syntax), ideal for real-time analysis, trend monitoring, or retrieving posts from specific users (e.g., `from:username`) DEFAULT FIELDS: Tweet objects always return 'id' and 'text' by default. User objects a…

Write actionRisk level 2 of 5OAuth connection
Use Twitter Recent Search

Pricing and limits

Aident logo

Product

Aident LoadoutAident Playbook EditorOpen-CUAK

About

AppsSkillsUse CasesDocsBlogPricingDownloadsPrivacy PolicyTerms of Service

Alternatives

vs Composiovs Zapier
llms.txtGet an AI summary of Aident LoadoutSummarize with ChatGPTSummarize with ClaudeSummarize with GeminiSummarize with Perplexity

© Aident Labs, 2024-2026

Pricing
Free
Unified payment
Not currently supported

Inputs

  • querystring
    Required
    REQUIRED. Search query for matching Tweets. Recent Search limited to last 7 days; for older tweets use Full Archive Search. IMPORTANT QUERY REQUIREMENTS: • Each OR-separated clause must independently contain at least one positive term (keyword, hashtag, from:user, etc.) • Each O…
  • end_timestring
    Newest UTC timestamp (YYYY-MM-DDTHH:mm:ssZ) for results; exclusive. IMPORTANT: Cannot be used with `since_id` or `until_id` - these are mutually exclusive time range filters.
  • since_idstring
    Returns Tweets more recent than this ID. IMPORTANT: Cannot be used with `start_time` or `end_time` - these are mutually exclusive time range filters.
  • until_idstring
    Returns Tweets older than this ID. IMPORTANT: Cannot be used with `start_time` or `end_time` - these are mutually exclusive time range filters.
  • expansionsarray
    Expansions to include additional objects like users, media, polls, etc.
  • next_tokenstring
    Token from `meta.next_token` of a previous response for pagination; do not modify.
  • sort_orderstring
    Order of results: 'recency' (most recent first) or 'relevancy'.
  • start_timestring
    Oldest UTC timestamp (YYYY-MM-DDTHH:mm:ssZ) for results. Must be within last 7 days. For last N hours, calculate from current time (e.g., now-12h = 2025-10-06T03:00:00Z if now is 15:00). IMPORTANT: Cannot be used with `since_id` or `until_id` - these are mutually exclusive time…
  • max_resultsinteger
    Number of results to return. Twitter API enforces minimum of 10 (values below 10 are auto-adjusted to 10). Maximum 100 per call (automatically paginates internally for higher values up to 2000). If more results exist beyond 2000, check `meta.has_more` from the response and pass…
  • poll_fieldsarray
    Poll fields to include when poll IDs are expanded.
  • user_fieldsarray
    Additional user object fields to include when user IDs are expanded via expansions. Note: 'id', 'name', and 'username' are always returned by default and should not be requested.
  • media_fieldsarray
    Media fields to include when media keys are expanded.

Observable output

  • data
    Required
    Data from the action execution
  • errorstring
    Error if any occurred during the execution of the action
  • successfulboolean
    Required
    Whether or not the action execution was successful or not

Skills that use this Action

Related use cases

  • Monitor brand conversations on XSearch recent public posts for brand, product, and problem language, then turn the results into a deduplicated listening brief.
  • Find X creators for a focused campaignDiscover creators already discussing a specific problem, then compare recent public posts and available performance evidence before outreach.
  • Prepare an open-source launch on XResearch the live conversation, draft one evidence-grounded launch post, and preserve a review checkpoint before publication.
  • Detect and triage a social crisis on XSeparate a fast-moving complaint cluster from routine mentions, preserve source evidence, and prepare a bounded response brief.

Official source

Provider source

Skills that use this Action

  • @Aident9,093277
    Community Ambassador Program PlaybookDesign an ambassador program and operate its X listening and recognition loop.
    Sep 10, 2026
  • @Aident1,278386
    Developer Community ListeningResearch current public developer conversations across X, GitHub issues, and the open web and produce an evidence-linked listening brief.
    Aug 18, 2026
  • @Aident1,303332
    Marketing Skills Community MarketingBuild and operate community programs using authorized public and connected-community evidence.
    Sep 10, 2026
  • @Aident6,468217
    Social ContentResearch, create, review, publish, and measure social content and listening workflows across selected platforms.
    Sep 10, 2026
  • @Aident2,122151
    Social Crisis ResponseUse when the user faces a PR crisis or reputational threat and needs rapid severity assessment, stakeholder messaging, and a communication timeline.
    Aug 18, 2026
  • @Aident5,402193
    X Community Listening PlanResearch recent X conversations and turn them into a focused community engagement plan.
    Aug 12, 2026
  • @Aident6,285202
    X Creator Campaign BriefUse current public X posts to inform a reviewed creator-campaign brief, selection criteria, compliance rules, and measurement plan.
    Aug 12, 2026
  • @Aident5,478372
    X Influencer DiscoveryFind and evaluate active X accounts relevant to a reviewed campaign brief.
    Aug 18, 2026