Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Standard v1.1 timelines to X API v2 timelines

If you have been working with the v1.1 timelines endpoints (statuses/user_timeline and statuses/mentions_timeline), the goal of this guide is to help you understand the similarities and differences between the standard and X API v2 timelines endpoints so that you can migrate your current integration to the new version.
  • Similarities:
    • Authentication:
      • OAuth 1.0a User Context (reverse chronological home timeline, user Post timeline and user mentions timeline)
      • OAuth 2.0 App-Only (user Post timeline)
    • Historical Access limit: User timeline (user Post timeline) provides access to most recent 3200 Posts; mentions timeline (user mention timeline) provides access to most recent 800 mentions.
    • Support for Post edit history and metadata
    • Rate limits (user Post timeline)
    • Refresh polling: Ability to retrieve new results since the since_id
    • Traversing timelines by Post IDs
    • Results specifications:
      • Results order: Results returned in reverse chronological order
      • Ability to exclude replies (user Post timeline only)
      • Ability to exclude Retweets (user Post timeline only)
  • Differences
    • New Authentication capability:
      • OAuth 2.0 App-Only (user mention timeline)
      • OAuth 2.0 Authorization Code Flow with PKCE (reverse chronological home timeline, user Post timeline and user mentions timeline)
    • Access requirements: X API v2 App and Project requirements
    • Rate limits (user mention timeline and reverse chronological home timeline)
    • Additional pagination method
      • Different max_results (count) per response
    • Response data format
    • Request parameters
      • Custom