Posts mentioning an account

Who is talking about this account, newest first. X publishes no mentions timeline on this path, so it is a search for the handle with the account's own posts excluded - which is the right definition anyway: a mention report that counts your own posts inflates every reach number in it.

This is a live read: it goes to the platform at request time, returns cache_age_s = 0, and is metered against a separate live-per-minute bucket on top of your tier. It needs the scrape:live scope (Live scrape): Read from the platform itself rather than from the catalog: a profile or channel on any of the seven platforms, and on X the whole content layer - timelines, posts, replies, quotes, threads, followers, search, lists and communities.

curl "https://crmsolid.com/data-api/v2/x/users/elonmusk/mentions" \
  -H "Authorization: Bearer psk_live_..."

const res = await fetch("https://crmsolid.com/data-api/v2/x/users/elonmusk/mentions", {
  headers: {
    Authorization: `Bearer ${process.env.CRM_SOLID_DATA_API_KEY}`,
  },
});

if (!res.ok) {
  const { error } = await res.json();
  throw new Error(`${error.code}: ${error.message} (${error.request_id})`);
}

const { data, meta } = await res.json();

import os

import requests

res = requests.get(
    "https://crmsolid.com/data-api/v2/x/users/elonmusk/mentions",
    headers={"Authorization": f"Bearer {os.environ['CRM_SOLID_DATA_API_KEY']}"},
    timeout=30,
)
res.raise_for_status()

payload = res.json()
data, meta = payload["data"], payload["meta"]

Keys look like psk_live_... for production keys, psk_test_... for test keys and are minted in the panel.

Tweets

1 items

{
  "data": {
    "tweets": [
      {
        "tweet_id": "1908244251923312641",
        "url": "https://x.com/elonmusk/status/1908244251923312641",
        "text": "Starship is stacked",
        "created_at": "2026-08-30T16:02:11+00:00",
        "lang": "en",
        "source": "Twitter for iPhone",
        "likes": 184221,
        "retweets": 21004,
        "replies": 9118,
        "quotes": 1402,
        "bookmarks": 3889,
        "views": 41882337,
        "is_reply": false,
        "is_retweet": false,
        "is_quote": false,
        "conversation_id": "1908244251923312641",
        "in_reply_to_tweet_id": null,
        "quoted_tweet_id": null,
        "retweeted_tweet_id": null,
        "hashtags": [],
        "mentions": [],
        "links": [],
        "media": [
          "photo"
        ],
        "author": {
          "user_id": "44196397",
          "handle": "elonmusk",
          "display_name": "Elon Musk",
          "bio": "",
          "followers": 221400112,
          "following": 1104,
          "tweets": 78412,
          "media_count": 9233,
          "likes_given": 148902,
          "is_verified": false,
          "is_blue_verified": true,
          "is_protected": false,
          "location": null,
          "avatar_url": "https://pbs.twimg.com/profile_images/1234567890/abc_400x400.jpg",
          "header_url": null,
          "created_at": "2009-06-02T20:12:29+00:00",
          "profile_url": "https://x.com/elonmusk"
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_9f2c41a8b3d5",
    "generated_at": "2026-08-23T09:14:02.317Z",
    "took_ms": 42,
    "page": {
      "limit": 50,
      "next_cursor": "eyJrIjoiMTczNDU2IiwiZCI6ImEifQ",
      "count": 50
    },
    "cache_age_s": 0
  }
}

• 401Unauthorizedunauthorized | invalid_key

  No key was presented, or the key is unknown, revoked or expired.

• 402PaymentRequiredpayment_required | subscription_inactive

  The key is valid but the plan behind it cannot serve the call: the included requests are spent and overage is switched off, capped or unfunded (payment_required), or the billing period lapsed and was not renewed (subscription_inactive). Retrying does not help; paying does. The X-Plan-* headers on this response say how far past the line you are.

  Carries X-Plan, X-Plan-Limit, X-Plan-Overage, X-Plan-Period-End, X-Plan-Remaining.

• 403Forbiddenforbidden_scope | forbidden_ip

  The key is valid but not allowed to make this call: it lacks the scope, or the request came from an address outside the key's allowlist.

• 404NotFoundnot_found

  The addressed resource does not exist.

• 422InvalidRequestinvalid_request

  A parameter is malformed, out of range or mutually exclusive with another. `details` names the offending fields.

• 429RateLimitedrate_limited | quota_exceeded

  Either the burst ceiling for the current minute or the daily quota is spent. Distinguish with the code: rate_limited clears within the minute, quota_exceeded does not clear until 00:00 UTC.

  Carries Retry-After, X-Quota-Limit, X-Quota-Remaining, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-Request-Id.

• 500InternalErrorinternal_error

  Something failed on our side. Internals are never leaked; quote the request id.

• 503Unavailableupstream_timeout | upstream_error | not_configured

  The request could not be served right now. BRANCH ON error.code, not on the status: 'upstream_timeout' means a source was too slow (this is what a catalog query hitting its 15-second statement timeout returns, so it is reachable from any endpoint that reads the corpus, not only the live-scrape ones) and the same call is worth retrying with backoff - narrowing it with a smaller limit, a filtered scope or a less popular account makes it far less likely; 'upstream_error' means a source was unreachable, so back off further; 'not_configured' means the capability has no backing service in this deployment, and retrying will never help.

Every response carries X-Request-Id and meta.request_id. Quote it in support requests.

Live reads count against the live column as well as the ordinary one, so a burst of them runs out of the live bucket first. Every response reports where you stand in X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and the X-Plan headers.

• GET/x/users/{handle}One X profile, live
• GET/x/users/{handle}/aboutX's About this account panel
• GET/x/users/{handle}/tweetsAn account's timeline
• GET/x/users/{handle}/mediaAn account's media timeline
• GET/x/users/{handle}/followersFollowers, newest first
• GET/x/users/{handle}/verified-followersVerified followers only
• GET/x/users/{handle}/followers/idsFollower ids in bulk
• GET/x/users/{handle}/followingWho an account follows
• GET/x/users/{handle}/relationshipDoes one account follow another
• GET/x/tweets/{id}One post
• GET/x/tweetsPosts by id, batched
• GET/x/tweets/{id}/repliesDirect replies to a post
• GET/x/tweets/{id}/threadThe whole conversation
• GET/x/tweets/{id}/quotesQuote posts of a post
• GET/x/tweets/{id}/retweetersWho reposted a post
• GET/x/search/tweetsAdvanced post search
• GET/x/search/usersPeople search
• GET/x/lists/{id}/tweetsA list's timeline
• GET/x/lists/{id}/membersWho is on a list
• GET/x/communities/{id}One X community
• GET/x/communities/{id}/membersA community's members
• GET/x/communities/{id}/moderatorsA community's moderators
• GET/x/communities/{id}/tweetsA community's posts
• GET/x/trendsWhat is trending, by location

Reference path: /data-api/reference/x-users-mentions