X (Twitter) Listening Reports¶
With the Tweet Binder API, you can create reports to analyze content from X (formerly Twitter). This content primarily consists of posts (tweets). It's important to distinguish between counts and reports, as they serve different purposes:
Counts vs. Reports¶
- Counts return only the number of tweets matching a specific query.
- Fast and lightweight
-
Useful when you just need the volume of activity
-
Reports provide complete analytics, including user stats, hashtags, devices, timelines, and more.
- More detailed, but slower to generate
- Ideal for deeper analysis
Types of Reports and Counts¶
There are two main categories of tweet analysis: historical and live.
Historical Reports¶
Used to analyze tweets from the past. These can be counts or full reports:
| Type | Description |
|---|---|
7-day count |
Total number of tweets from the past 7 days |
Historical count |
Total number of tweets from any custom date range |
7-day report |
Full statistics report from the last 7 days |
Historical report |
Full statistics report from a custom historical period |
Live Reports¶
Used to analyze tweets in real time, from the moment the report is activated.
- No counts are available in live tracking.
- Engagement data (likes, reposts, impressions, etc.) is not included initially, because tweets are collected too quickly.
- Engagement stats can be updated later if needed.
Search Operators¶
When building your queries, you can use advanced search operators to refine results. Here are some of the most commonly used:
| Operator | Example |
|---|---|
keyword |
Paris |
OR |
Paris OR Pamplona OR "New York" |
emoji |
(😃 OR 😡) 😬 |
"exact phrase" |
"Tweet Binder is great" |
# |
#Osasuna |
@ |
@ElonMusk |
$ |
$BTC |
from: |
from:tweetbinder |
to: |
to:tweetbinder |
url: |
url:https://www.tweetbinder.com |
list: |
list:1492601169428025349 |
has:media |
"Tweet Binder" has:media |
lang: |
"Tweet Binder" lang:en |
retweets_of: |
retweets_of:tweetbinder |
in_reply_to_tweet_id: |
in_reply_to_tweet_id:1518703397020577793 |
retweets_of_tweet_id: |
retweets_of_tweet_id:1518703397020577793 |
quotes_of_tweet_id: |
quotes_of_tweet_id:1518703397020577793 |
place: |
place:chicago |
place_country: |
place_country:US |
is:retweet |
"Tweet Binder" is:retweet |
is:reply |
"Tweet Binder" is:reply |
is:quote |
"Tweet Binder" is:quote |
is:verified |
"Tweet Binder" is:verified |
has:images |
"Tweet Binder" has:images |
has:video_link |
"Tweet Binder" has:video_link |
has:geo |
"Tweet Binder" has:geo |
has:hashtags |
"Tweet Binder" has:hashtags |
has:cashtags |
"Tweet Binder" has:cashtags |
has:links |
"Tweet Binder" has:links |
has:mentions |
"Tweet Binder" has:mentions |
You can combine multiple operators to refine your search even further.
Summary¶
- Use counts to quickly check how many tweets match a query.
- Use reports when you need full analytics.
- Choose between historical or live depending on the data timeframe.
- Apply advanced search operators to fine-tune your queries and get precise insights.
These tools give you the flexibility to analyze X (Twitter) content effectively for any topic, campaign, or account.