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.
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:youraccountto 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:
- Go to Settings > Integrations > X
- Click Disable
This stops all search query polling. Historical data remains in Modem after disconnecting.