Skip to main content
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.
The X integration is capture-only. Unlike Slack, you can’t interact with the Modem Agent from X. Posts are polled periodically rather than streamed in real time.

​
Prerequisites

  • Owner or admin role in your Modem organization
  • At least one project to assign posts to

​
Setup

1

Enable the integration

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

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.
3

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: You can combine operators to build precise queries. Queries that are too broad will capture noise, so start specific and widen if needed.
A good starting point is @yourcompany OR "your product name" -is:retweet. This captures mentions and product references while filtering out retweets.

​
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)
Only public posts are captured. Modem cannot access direct messages, posts from protected accounts, or posts older than approximately 7 days.

​
Querying X Data

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

​
Troubleshooting

  • 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
Your search query may be too broad. Try narrowing it:
  • Add -is:retweet to exclude retweets
  • Use quoted phrases ("exact phrase") instead of individual words
  • Add -from:youraccount to exclude your own 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.

Topics

How Modem groups and classifies the posts it captures.

The Modem Agent

Ask questions and take action on your X data.