Skip to main content

X and Twitter API for AI Agents: How to Track Social Signals Programmatically

· 5 min read
Felo Search Tips Buddy
Committed to answers at your fingertips

Learn how AI agents can use the X Search API to track social signals, monitor brand sentiment, and pull tweet data for research and analysis.

Social media is where conversations happen in real time. But AI agents can't access it without the right API. The X Search API changes that, giving agents programmatic access to user data, tweets, and social signals.

Why Social Data Matters for AI Agents

Training data has a cutoff date. Social media doesn't. When agents can access X (Twitter) data, they gain:

  • Real-time sentiment — what people are saying right now, not what they said six months ago
  • Expert opinions — industry leaders sharing insights before they hit mainstream media
  • Trend detection — emerging topics before they become obvious
  • Brand monitoring — direct mentions, indirect references, and competitive intelligence
  • Source material — tweets as primary sources for research and analysis

An agent that can search X is working with current reality, not cached knowledge.

What the X Search API Provides

Felo OpenAPI's X Search API gives agents access to:

User search — find X users by name, handle, or topic area. Useful for identifying industry experts, competitors, and influencers.

User tweets — pull recent tweets from a specific user. Track what a competitor is announcing, what an expert is recommending, or what your brand is being mentioned for.

Tweet search — search across all tweets for keywords, hashtags, or phrases. Find conversations about your product, your industry, or any topic of interest.

User profiles — get profile information including follower counts, bio, and activity patterns.

Setup

  1. Create a Felo OpenAPI key
  2. Open your agent's setup guide — works with Claude Code, Codex, OpenClaw, Hermes, or custom agents
  3. Configure the X Search API through the same base URL and key as all other Felo tools

No separate X API application, no separate authentication flow. One key, all tools.

Use Cases

Brand Monitoring

Set up an agent to track mentions of your brand, product, or campaign on X:

  1. Agent searches for brand keywords and hashtags
  2. Pulls relevant tweets with context
  3. Analyzes sentiment patterns
  4. Saves findings to LiveDocs for ongoing tracking
  5. Generates a summary report

Run this daily, and you have a brand monitoring workflow that costs pennies and runs while you sleep.

Competitive Intelligence

Track what competitors are announcing and how the market is responding:

  1. Agent searches for competitor brand names and product launches
  2. Pulls tweets and engagement metrics
  3. Identifies key themes in public reaction
  4. Produces a competitive analysis brief

Market Research

Social data reveals what people actually care about, not what surveys say they care about:

  1. Agent searches for industry keywords and pain points
  2. Analyzes conversation volume and sentiment over time
  3. Identifies emerging topics and declining interests
  4. Generates a market sentiment report with supporting tweets

Expert Source Gathering

For research-heavy workflows, X is a goldmine of expert opinions:

  1. Agent searches for recognized experts in a domain
  2. Pulls their recent tweets on relevant topics
  3. Extracts key insights and data points
  4. Includes expert quotes as sourced evidence in presentations and reports

Crisis Detection

Catch negative sentiment spikes before they become full-blown issues:

  1. Agent monitors brand mentions with sentiment analysis
  2. Flags sudden increases in negative mentions
  3. Pulls the tweets driving the spike
  4. Alerts with context and recommended response

Combining X Data With Other Tools

The X Search API is most powerful when combined with other Felo tools:

X + Web Search + PPT

Agent searches X for industry sentiment, cross-references with web search for data validation, then generates a presentation combining both sources.

X + LiveDocs + Report

Agent pulls tweets about a topic, saves them to LiveDocs with source attribution, and produces a research report with direct quotes and engagement metrics.

X + Web Fetch + Landing Page

Agent searches X for customer pain points, reads related web pages for solutions, and drafts a landing page that addresses the issues people are actually talking about.

API Endpoints

The X Search API includes:

  • User search — find users by query
  • User tweets — get tweets from a specific user
  • Tweet search — search all tweets by keyword or phrase
  • User profiles — retrieve user profile data

All accessible through the same Felo OpenAPI base URL and key.

Rate Limits and Best Practices

Search frequency: Don't hammer the API. Set reasonable intervals for monitoring tasks — hourly for active campaigns, daily for ongoing brand tracking.

Data freshness: X data moves fast. Tweets from last week may already be outdated. Focus on recent data for time-sensitive analysis.

Source attribution: When using tweets as evidence in reports or presentations, preserve the tweet text, author handle, and timestamp for credibility.

Privacy: Respect user privacy and platform terms. Use X data for analysis and research, not for building user profiles or harassment.

Getting Started

  1. Create your free API key
  2. Explore the X Search API docs
  3. Connect your agent and run your first social search

Stop working with stale data. Give your agent access to the conversation happening right now.

Try X Search API Free →


This post is also available in 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español, বাংলা and Português.