Operating Modes

The SDK supports three operating modes for different use cases.

Hybrid Mode (Default)

Automatically switches between scraping and API:

const client = new XTwitterClient({
  mode: 'hybrid',
  preferredMode: 'crawler' // Try scraping first
});

Best for: Flexibility and reliability

API Mode

Uses only the official Twitter API:

const client = new XTwitterClient({
  mode: 'api'
});

Best for: Guaranteed compatibility, write operations

Crawler Mode

Uses only web scraping:

const client = new XTwitterClient({
  mode: 'crawler'
});

Best for: Read-only operations, higher volume

Choosing a Mode

Mode	Read Operations	Write Operations	Fallback
Hybrid	Scraping → API	API	Yes
API	API	API	No
Crawler	Scraping	Not supported	No

Next Steps

• Configuration - Configure each mode
• Error Handling - Handle mode-specific errors