User Search Details
Retrieve full metadata and analytics for a user-based social media search.
GET /api/iq/user_search/{id}
Parameters
| Field | Description |
|---|
| id | User search ID |
Request Example
curl -X GET "https://rolli.ai/api/iq/user_search/9876" \
-H "X-ROLLI-TOKEN: your_token" \
-H "X-ROLLI-USER-ID: your_user_id" \
-H "Content-Type: application/json"
fetch("https://rolli.ai/api/iq/user_search/9876", {
method: "GET",
headers: {
"X-ROLLI-TOKEN": "your_token",
"X-ROLLI-USER-ID": "your_user_id",
"Content-Type": "application/json"
},
})
.then(res => res.json())
.then(console.log);
require "net/http"
require "uri"
require "json"
uri = URI("https://rolli.ai/api/iq/user_search/9876")
req = Net::HTTP::Get.new(uri)
req["X-ROLLI-TOKEN"] = "your_token"
req["X-ROLLI-USER-ID"] = "your_user_id"
req["Content-Type"] = "application/json"
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(req)
end
puts res.body
import requests
import json
url = "https://rolli.ai/api/iq/user_search/9876"
headers = {
"X-ROLLI-TOKEN": "your_token",
"X-ROLLI-USER-ID": "your_user_id",
"Content-Type": "application/json"
}response = requests.get(url, headers=headers)
print(response.json())
Response Fields
| Field Name | Description |
|---|
| id | The search ID |
| query | The search query (username) |
| created_at | The search creation time |
| updated_at | The last time the search was updated |
| status | The search execution status |
| status_text | Status summary text |
| status_percentage | Status progress percentage |
| results | The full analysis results (only when status is “completed” — not available for Facebook or Instagram) |
results Fields
| Field Name | Description |
|---|
| account_age_in_days | Number of days since the X account was created |
| account_creation_time | Date the account was created |
| account_type | Type of account (Individual, Organization, etc.) |
| ai_summary | AI-generated summary describing user interests and activity |
| avg_tweets_per_day | Average number of tweets per day during the collection period |
| avg_tweets_per_month | Average number of tweets per month during the collection period |
| collection_start_date | Start of the tweet collection period |
| collection_end_date | End of the tweet collection period |
| country_code | Two-letter country code (“us”, “br”, etc.) |
| country_name | Country name inferred from user data |
| duplicate_count | Object of duplicated expressions and counts |
| duplicate_index | List of tweet indexes considered duplicates |
| engagement_rate | Engagement normalized by tweet count |
| freq_quote_who | Map of usernames the user quotes most frequently |
| freq_reply_who | Map of usernames the user replies to most |
| freq_retweet_who | Map of usernames the user retweets most |
| hashtag_only_* | Objects with hashtags used in each tweet type (originals, quotes, replies, retweets) |
| hashtag_only_*_num | Count of hashtag-only tweets per type |
| hashtag_only_*_pct | Percentage of hashtag-only tweets per type |
| id_hash256 | Internal analysis hash ID |
| lang | Language frequency map for tweets |
| largest_time_gap | List of inactive periods between tweets |
| name | User’s display name |
| num_followers | Total followers |
| num_following | Total accounts followed |
| num_originals | Total original tweets |
| num_quotes | Total quote tweets |
| num_replies | Total replies |
| num_retweets | Total retweets |
| outlier_like | Boolean indicating whether like outliers were detected |
| outlier_like_index | Indexes of tweets with abnormal like count |
| outlier_rt | Boolean for retweet outliers |
| outlier_rt_index | Indexes of tweets with abnormal retweet count |
| pct_originals | Percentage of original tweets |
| pct_quotes | Percentage of quote tweets |
| pct_replies | Percentage of replies |
| pct_retweets | Percentage of retweets |
| profile_image_url_https | Profile image URL |
| top_5_domains | Top 5 domains appearing in user tweets |
| top_5_hashtags | Top 5 hashtags used |
| top_5_urls | Top 5 URLs shared |
| total_num_tweets_collected | Total tweets collected |
| url_only_* | Objects of URLs used in each tweet type |
| url_only_*_num | Count of URL-only tweets per type |
| url_only_*_pct | Percentage of URL-only tweets per type |
| url_only_*_url | Actual URLs by tweet type |
| user_description | User bio/about text (optional) |
| user_id_str | X user ID string |
| username | X username (without @) |
| verified | Boolean indicating verification status |
Example Response
{
"id": 1241,
"query": "an_username",
"created_at": "2023-10-01T12:00:00Z",
"updated_at": "2023-10-01T12:00:00Z",
"status": "finished",
"status_percentage": "100",
"status_text": "Finished data collection.",
"tweet_preview": [
{
"d": "How can people be expected to have faith in Trump if he won’t release the Epstein files?",
"i": 623174,
"l": "https://twitter.com/elonmusk/status/1942653394168246464",
"n": "elonmusk",
"p": "https://pbs.twimg.com/profile_images/1936002956333080576/kqqe2iWO_normal.jpg",
"t": "2025-07-08T18:33:56",
"u_d": "",
"u_id": "44196397",
"u_t": "2009-06-02T20:12:29"
}
],
"results": {
"account_age_in_days": 5875,
"account_creation_time": "2009-06-02",
"account_type": "Individual",
"ai_summary": "The user appears to be a politically conservative individual who is a fan of Elon Musk, Tesla, and SpaceX. They are critical of government spending, particularly in relation to the budget deficit and debt ceiling. They are supportive of Rand Paul and critical of certain bills being passed. They are also a fan of Starlink and are excited about its availability in different countries. They are knowledgeable about technology and space exploration, as evidenced by their tweets about Starship and the Space Station. They are also active in retweeting and engaging with other users who share similar views. The user seems to be well-informed about current events and technology trends.",
"avg_tweets_per_day": 33.333333333333336,
"avg_tweets_per_month": 1000.0000000000001,
"collection_end_date": "2025-07-03",
"collection_start_date": "2025-07-01",
"country_code": "us",
"country_name": "United States",
"duplicate_count": {
"true": 2,
"yes": 3,
"yup": 2
},
"duplicate_index": [
9,
25,
29,
31,
68,
73,
95
],
"engagement_rate": 26229.19,
"freq_quote_who": {
"ADFIntl": 1,
"CollinRugg": 1,
"Starlink": 2,
"cb_doge": 1,
"teslaownersSV": 1
},
"freq_reply_who": {
"BasedBeffJezos": 3,
"JessePeltan": 3,
"ResethO": 2,
"Thiss_Youu": 4,
"ns123abc": 2
},
"freq_retweet_who": {
"MarioNawfal": 5,
"SawyerMerritt": 2,
"Starlink": 2,
"johnkrausphotos": 2,
"teslaownersSV": 4
},
"hashtag_only_originals": {},
"hashtag_only_originals_num": 0,
"hashtag_only_originals_pct": 0.0,
"hashtag_only_quote_tweets": {},
"hashtag_only_quote_tweets_num": 0,
"hashtag_only_quote_tweets_pct": 0.0,
"hashtag_only_replies": {},
"hashtag_only_replies_num": 0,
"hashtag_only_replies_pct": 0.0,
"hashtag_only_retweets": {},
"hashtag_only_retweets_num": 0,
"hashtag_only_retweets_pct": 0.0,
"id_hash256": "9cf0ab8c50c002f695a958fe7a95050b70545860447a8a91191da74c2887d411",
"lang": {
"art": 2,
"en": 67,
"ko": 1,
"pt": 1,
"qme": 19,
"qst": 1,
"und": 5,
"zxx": 4
},
"largest_time_gap": [],
"name": "Elon Musk",
"num_followers": 221669997,
"num_following": 1149,
"num_originals": 4,
"num_quotes": 10,
"num_replies": 52,
"num_retweets": 34,
"outlier_like": true,
"outlier_like_index": [
40,
74
],
"outlier_rt": true,
"outlier_rt_index": [
40,
91
],
"pct_originals": 0.04,
"pct_quotes": 0.1,
"pct_replies": 0.52,
"pct_retweets": 0.34,
"profile_image_url_https": "https://pbs.twimg.com/profile_images/1936002956333080576/kqqe2iWO_normal.jpg",
"recent_tweet_result_url": "https://informationtracer.com/result/9cf0ab8c50c002f695a958fe7a95050b70545860447a8a91191da74c2887d411",
"top_5_domains": {
"x.com": 1
},
"top_5_hashtags": {},
"top_5_urls": {
"https://x.com/i/grok/share/xZziDEaFEY4tjN0XEph5qLHAA": 1
},
"total_num_tweets_collected": 100,
"url_only_originals_domain": {},
"url_only_originals_num": 0,
"url_only_originals_pct": 0.0,
"url_only_originals_url": {},
"url_only_quote_tweets_domain": {},
"url_only_quote_tweets_num": 0,
"url_only_quote_tweets_pct": 0.0,
"url_only_quote_tweets_url": {},
"url_only_replies_domain": {},
"url_only_replies_num": 0,
"url_only_replies_pct": 0.0,
"url_only_replies_url": {},
"url_only_retweets_domain": {},
"url_only_retweets_num": 0,
"url_only_retweets_pct": 0.0,
"url_only_retweets_url": {},
"user_description": "",
"user_id_str": "44196397",
"username": "elonmusk",
"verified": false
}
}
