Products / X API

x-api

X API

X API v2 uses pay-per-usage credits rather than subscriptions. The X Activity API (XAA) delivers realtime user activity; inbound webhook events are billed per delivery with 24-hour UTC dedup. Recent additions include mute/block events (Jul 21, 2026) and post create/delete (Jun 4, 2026). Media upload remains on the v1.1 media endpoints. Owned reads are priced separately from public lookup.
id
x-api
current_version
v2
last_updated
generated_at
published_at (this UI deploy)
XGAX Stack
ProductDocsUpstream changelog

Features

  • X Activity API

    Realtime user-activity webhooks. Successor path from legacy Account Activity API. Subscribe by user id; optional direction filter.

    apiactivity

  • Pay-per-usage credits

    No subscription SKUs. Buy credits, set spending limits, earn up to 20% back in xAI API credits. Owned reads vs public lookup priced separately.

    apipricing

  • Webhook event billing

    Activity API events billed per delivery, same 24h UTC dedup window. Inbound events cost; many outbound actions do not.

    apipricingactivity

  • Media upload

    Media upload remains on the v1.1 media endpoints after other v1.1 SKUs were retired.

    mediaapi

  • Mute and block events

    mute.mute / mute.unmute / block.block / block.unblock. Private events; OAuth 2.0 user-context with mute.read or block.read.

    activityapi

Changelog

  • Fix

    Updated video_total_views definition

    can · Ads video_total_views now 100% in-view for 3s

    X Ads API Analytics VIDEO metric video_total_views now counts views that are 100% in-view for at least 3 seconds, plus any view where a user clicks play. The prior MRC 50%-in-view-for-2s definition no longer applies; video_3s100pct_views and VIEW_3S_100PCT bidding remain.

  • Feature

    Mute and block events for X Activity API

    can · Activity API has mute/block events

    Subscribe by user id for mute/unmute and block/unblock. Private events requiring user-context OAuth 2.0.

  • Feature

    Post create and delete events

    can · Activity API has post.create and post.delete

    post.create and post.delete on the Activity API. For keyword filtering, continue to use Filtered Stream.

  • Feature

    Direction filter and event-type rename

    can · Activity API subscriptions take a direction filter

    Optional direction filter on Activity API subscriptions. Event type naming moved off PascalCase.