Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

X

Monitor public posts matching your search queries

The X integration monitors public posts that match search queries you define. Matched posts are ingested into Modem, grouped into topics, and linked to people and companies like any other data source.

Prerequisites

  • Owner or admin role in your Modem organization
  • At least one project to assign posts to
  • A Modem organization on the Startup plan or above, or an active trial

Setup

Enable the integration

Go to Settings > Integrations > X in your Modem dashboard and click Enable X.

Add a search query

Click Add Query to define what posts to monitor. Each query has three fields:

  • Search Query: The X search syntax to match against (e.g. @yourcompany OR "your product")
  • Display Name: A label shown in Modem to identify this query (e.g. “Company Mentions”)
  • Project: Which project the matched posts should be assigned to

See Writing Search Queries below for syntax help.

Wait for results

Modem polls X periodically for new results. Matched posts will begin appearing in your project shortly after the first poll runs.

Writing Search Queries

Search queries use the X API v2 search syntax. A few common patterns:

Goal Query
Posts mentioning your handle @yourcompany
Posts containing a phrase "your product name"
Multiple terms (any match) @yourcompany OR "your product"
From a specific account from:yourcompany

You can combine operators to build precise queries. Queries that are too broad will capture noise, so start specific and widen if needed.

Managing Queries

You can add multiple search queries, each targeting a different keyword, handle, or project. Manage them from Settings > Integrations > X.

  • Pause/Resume: Temporarily stop polling a query without deleting it
  • Delete: Permanently remove a query

Each query shows its display name, the raw search syntax, and when it was last polled.

What Gets Captured

For each matched post, Modem captures:

  • Post text and metadata (timestamps, conversation threading)
  • Author name, username, and avatar
  • Engagement metrics (likes, reposts, replies, quotes)
  • Entities (mentions, hashtags, URLs)
  • Reply relationships (which post a reply is responding to)

Querying X Data

Once posts are flowing in, you can ask the Modem Agent about them from the dashboard or Slack.

PromptWhat are people saying about us on X this week?
PromptSummarize the top complaints from X mentions
PromptCreate a Linear ticket for the bug reports coming in from X

Troubleshooting

No posts are appearing
  • Verify the integration is enabled in Settings > Integrations > X
  • Check that your search query matches real posts (test it on X’s search page first)
  • Make sure the query is not paused
  • Allow a few minutes for the first poll to run
Too many irrelevant posts

Plain retweets are never captured; Modem counts them as reposts on the original post. If the query is still too broad, try narrowing it:

  • Use quoted phrases ("exact phrase") instead of individual words
  • Add -from:youraccount to exclude your own posts
  • Add negative keywords (-giveaway) to drop unrelated matches
Missing recent posts

Modem polls periodically, so there can be a short delay. If posts are consistently missing, check that your query syntax is correct. The X API recent search endpoint only returns posts from the last 7 days.

Disconnecting

To disable the X integration:

  1. Go to Settings > Integrations > X
  2. Click Disable

This stops all search query polling. Historical data remains in Modem after disconnecting.

Was this page helpful?