Twitter Mentions
Tracking public mentions reveals brand perception, customer inquiries, and conversational inbound chatter across X. Normalized mention records capture post text, author handles, timestamps, media attachments, and public engagement counters without platform authentication.
Features
- Public mention trackingRetrieve public tweets mentioning any target username without requiring the target account's login credentials.
- Date window boundingConstrain mention feeds using start_date and end_date filters formatted as ISO dates or Unix seconds.
- Author and tweet detailReceive normalized post records containing full tweet text, author profiles, media attachments, and permalinks.
- Engagement metricsExtract like, comment, repost, quote, bookmark, and view counts for each discovered mention.
Parameters
| Parameters | Required | Description |
|---|---|---|
usernames | Required | Array of target public X usernames to retrieve mentions for, with or without leading @. |
results_limit | Optional | Maximum number of mentions to return per username; must be a multiple of 20 between 20 and 2,000. |
start_date | Optional | Optional start timestamp in ISO format (YYYY-MM-DD) or Unix seconds to filter mentions on or after this time. |
end_date | Optional | Optional end timestamp in ISO format (YYYY-MM-DD) or Unix seconds to filter mentions before this time. |
How to Use
Submit a target username and optional date range as an asynchronous task, then poll for mention records.
- Specify one or more usernames in usernames and set results_limit to a multiple of 20 (up to 2,000).
- Optionally provide start_date and end_date to restrict the mention collection period.
- Send a POST request to /v1/x/mentions with your SocQ API key.
- Poll /v1/tasks/{task_id} and paginate through data.results.items using next_cursor.
curl -X POST "https://api.socq.ai/v1/x/mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@OpenAI"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.Best Use Cases
- Brand reputation monitoring: Track inbound mentions, reviews, and sentiment around your company handle in near real time.
- Customer support triage: Identify unaddressed customer complaints, product bugs, or feedback directed at your support accounts.
- Executive presence listening: Monitor mentions and replies directed at leadership accounts to assess industry response to announcements.
Pro Tips
- results_limit must be a multiple of 20 (e.g. 20, 40, 100) to match upstream page sizes.
- ISO date strings like 2026-09-01 are automatically converted to UTC Unix timestamps by the backend.
- This endpoint returns tweets mentioning the account; to get the account's own outbound posts, use X User Posts.
- Pair with X Post Replies to track granular conversation threads stemming from significant mention tweets.
Related APIs
Use these APIs when you need a different type of public X data.
- Twitter Tweet Scraper API — Retrieve public post text, authors, engagement, media, hashtags, mentions, and conversation relationships from x.com or twitter.com status URLs.
- Twitter Profile Scraper API — Retrieve public account identity, biographies, avatars, cover images, account status, and visible audience statistics by username.
- Twitter User Tweets Scraper API — Collect recent public posts, authors, media, hashtags, mentions, and engagement by username with replies excluded.
- Twitter Search API — Find public posts by search expression with latest or top ordering and a configurable result limit.
- X Followers List API — Collect public follower account identities and visible profile metrics for one or more X usernames.
- X Following List API — Collect profiles followed by public X accounts, including identity, biographies, account signals, visible counters, and source usernames.
- X Post Quotes API — Collect public quote posts for known status URLs with commentary, authors, engagement, media, timestamps, and source-post context.
- X Post Replies API — Collect public replies from X post URLs with selectable ordering, reply text, authors, visible engagement, media, and parent-post context.
- X Post Retweeters API — Collect a task-level unique set of normalized public profiles for accounts that reposted known X or Twitter status URLs.
- X Trends API — Collect current public X trend snapshots for known numeric WOEIDs with source rank, query, description, and location context.
- Twitter User Search API