Twitter / X Data
Real-time Twitter data with engagement metrics and AI-powered insights for tracking narratives, sentiment, and trends. The Twitter data share provides comprehensive access to tweets, engagement data, and AI-generated insights. Perfect for crypto sentiment tracking, influencer monitoring, and trend detection.
Update Frequency: On-demand
What's Included
This data is collected by Heisenberg nodes running the data agent and organized into the following structure.
Raw Tweet Data
Complete tweet information with full context:
| Field Name | Type | Nullable | Description |
|---|---|---|---|
| username | string | No | Twitter handle of the author |
| user_id | string | No | Unique user identifier |
| created_on | timestamp | No | Tweet timestamp |
| content | text | No | Full tweet text |
| url | string | No | Direct link to the tweet |
| hashtags | array | Yes | Extracted hashtags |
| lang | string | Yes | Tweet language code |
| links | array | Yes | URLs included in the tweet |
| videos | array | Yes | Video attachments |
| photos | array | Yes | Image attachments |
| animated | array | Yes | Animated GIF attachments |
| retweet_count | integer | No | Number of retweets |
| like_count | integer | No | Number of likes |
| reply_count | integer | No | Number of replies |
| quote_count | integer | No | Number of quote tweets |
| conversation_id | string | Yes | Thread identifier |
| content_length | integer | No | Character count |
| is_own_retweet | boolean | No | Whether it's a self-retweet |
AI-Powered Insights
Trend analysis and sentiment detection powered by AI:
| Field Name | Type | Nullable | Description |
|---|---|---|---|
| timestamp | timestamp | No | Analysis timestamp |
| run_number | integer | No | Analysis batch identifier |
| trend | string | Yes | Identified trend or topic |
| trend_description | text | Yes | Detailed trend explanation |
| url | string | No | Source tweet URL |
| content | text | No | Tweet content being analyzed |
| duration | integer | Yes | Analysis time window in seconds |
| vertical | string | Yes | Industry or category (e.g., crypto, DeFi, NFTs) |
Additional Features
| Feature | Benefit |
|---|---|
| Real-time Updates | Data refreshes multiple times per day, ensuring you always have the latest tweets and insights |
| Thread Detection | Automatically identifies conversation threads and reply chains for context analysis |
| Media Extraction | Separate fields for videos, photos, and animated GIFs for rich media analysis |
| Engagement Metrics | Comprehensive engagement data including retweets, likes, replies, and quote tweets |
| Language Detection | Built-in language identification for multi-lingual analysis |
| Hashtag Extraction | Automatically parsed hashtags for trend tracking and topic analysis |
| Vertical Classification | AI-powered categorization into industry verticals (crypto, DeFi, NFTs, etc.) |
| Trend Identification | Automated detection of emerging trends with detailed descriptions |
| Sentiment Analysis | Built-in sentiment scoring for positive, negative, and neutral content |
| Influencer Tracking | User-level data for tracking key voices and their impact |
| Historical Context | Full conversation IDs and timestamps for temporal analysis |
| Structured Format | Clean, normalized data ready for immediate use in AI applications |
On-Demand Context Generation
Want to create custom context pipelines from this Twitter data? You can generate on-demand context tailored to your specific needs using our COOK platform. COOK allows you to build personalized Data Agents that process, filter, and transform this Twitter data into custom insights perfect for your AI applications. Create context pipelines that combine Twitter data with other sources, apply custom filters, and generate structured outputs that match your exact requirements.
Integration
Access Methods
REST API - Query tweets programmatically with filtering and sorting
MCP Integration - Plug directly into AI agents and multi-cloud workflows
Direct Database Access - PostgreSQL connection for custom analytics
Example Queries
Filter tweets by:
- Time range - Last hour, day, week
- Engagement threshold - Minimum likes, retweets
- Keywords or hashtags - Specific terms or tags
- Vertical - Crypto, DeFi, NFTs, etc.
- Trend - Specific trending topics
- User - Specific accounts
Analyze insights by:
- Trending topics - What's hot right now
- Vertical breakdown - Which sectors are active
- Sentiment over time - How sentiment shifts
- Viral content - Highest engagement tweets
Next Steps
Ready to integrate Twitter data into your application?