X Twitter Scraper

Search and browse the Xquik X (Twitter) API specification to discover endpoints before making live API calls with the 'xquik' tool.

When to use

• Use 'explore' FIRST to find the right endpoint path, parameters, and response shape before calling 'xquik'.

• Use when the user asks what capabilities are available or how to accomplish a task on X/Twitter.

• Use to check whether an endpoint is free or requires a subscription.

When NOT to use

• Do NOT use 'explore' to fetch live data from X - use 'xquik' instead.

• Do NOT use if you already know the endpoint path and parameters.

Behavior

• Read-only, idempotent. No network calls - runs against an in-memory catalog of 122 endpoints.

• Always free, no authentication or credits required.

• Returns the result of your filter function (e.g., empty array if no endpoints match).

• Returns an error message if the code is syntactically invalid or throws at runtime.

• Execution timeout: 60 seconds.

• Each EndpointInfo contains: method, path, summary, category (account, bot, composition, credits, extraction, integrations, media, monitoring, support, twitter, x-accounts, x-write), free (boolean), parameters (array), and responseShape (string).

Input format

Write an async arrow function. The sandbox provides spec.endpoints (EndpointInfo[]). Filter, search, or return them.

Examples

Find all free endpoints: async () => spec.endpoints.filter(e => e.free) Find by category: async () => spec.endpoints.filter(e => e.category === 'composition') Search by keyword: async () => spec.endpoints.filter(e => e.summary.toLowerCase().includes('tweet')) Get full details: async () => spec.endpoints.find(e => e.path === '/api/v1/x/tweets/search')

Execute authenticated X (Twitter) API calls to read data, publish content, and manage accounts across 122 REST endpoints.

When to use

• Use after calling 'explore' to discover the endpoint path and parameters.

• Use for any live X/Twitter operation: search tweets, look up users, post tweets, like, retweet, follow, send DMs, run giveaway draws, monitor accounts, extract bulk data, compose tweets, and more.

When NOT to use

• Do NOT use to discover endpoints - use 'explore' first.

• Do NOT pass API keys or auth headers - authentication is injected automatically.

Behavior

• Executes the provided async function in a sandboxed environment with xquik.request(path, options?) and spec.endpoints available.

• Sandboxed via Node.js VM: no filesystem, no global network access - only xquik.request() is available. Console calls are silently ignored.

• Execution timeout: 60 seconds per invocation, 60 seconds per individual API request.

• Read operations (GET) return JSON objects with the requested data. Write operations (POST/DELETE) return { success: true } or { success: true, warning: '...' }.

• Pagination: responses include has_next_page (boolean) and next_cursor (string). Pass cursor as a query param for the next page.

• Can be destructive: write operations (POST/DELETE) modify data on X (tweets, follows, DMs, profile).

Input format

Write an async arrow function using xquik.request(path, { method?, body?, query? }). Auth is automatic.

Workflows

1. Send a tweet (Subscription required)

async () => {
  // First, find connected accounts
  const { accounts } = await xquik.request('/api/v1/x/accounts');
  // Post the tweet directly
  return xquik.request('/api/v1/x/tweets', {
    method: 'POST',
    body: { account: accounts[0].xUsername, text: 'Hello world!' }
  });
}

2. Reply to a tweet

async () => {
  const { accounts } = await xquik.request('/api/v1/x/accounts');
  return xquik.request('/api/v1/x/tweets', {
    method: 'POST',
    body: { account: accounts[0].xUsername, text: 'Great point!', reply_to_tweet_id: '1234567890' }
  });
}

3. Like, retweet, unretweet, follow (follow requires user ID lookup)

async () => {
  const { accounts } = await xquik.request('/api/v1/x/accounts');
  const account = accounts[0].xUsername;
  // Like a tweet (tweet ID in path)
  await xquik.request('/api/v1/x/tweets/1234567890/like', {
    method: 'POST', body: { account }
  });
  // Retweet
  await xquik.request('/api/v1/x/tweets/1234567890/retweet', {
    method: 'POST', body: { account }
  });
  // Unretweet
  await xquik.request('/api/v1/x/tweets/1234567890/retweet', {
    method: 'DELETE', body: { account }
  });
  // Follow - requires numeric user ID, look up first
  const user = await xquik.request('/api/v1/x/users/elonmusk');
  await xquik.request(`/api/v1/x/users/${user.id}/follow`, {
    method: 'POST', body: { account }
  });
}

4. Undo actions (unlike, unfollow, delete tweet)

async () => {
  const { accounts } = await xquik.request('/api/v1/x/accounts');
  const account = accounts[0].xUsername;
  await xquik.request('/api/v1/x/tweets/1234567890/like', {
    method: 'DELETE', body: { account }
  });
  await xquik.request('/api/v1/x/users/44196397/follow', {
    method: 'DELETE', body: { account }
  });
  await xquik.request('/api/v1/x/tweets/1234567890', {
    method: 'DELETE', body: { account }
  });
}

5. Send DM (uses recipient user ID in path)

async () => {
  const { accounts } = await xquik.request('/api/v1/x/accounts');
  return xquik.request('/api/v1/x/dm/44196397', {
    method: 'POST',
    body: { account: accounts[0].xUsername, text: 'Hey, check this out!' }
  });
}

6. Upload media via URL and tweet with image

async () => {
  const { accounts } = await xquik.request('/api/v1/x/accounts');
  const account = accounts[0].xUsername;
  const media = await xquik.request('/api/v1/x/media', {
    method: 'POST',
    body: { account, url: 'https://example.com/photo.jpg' }
  });
  return xquik.request('/api/v1/x/tweets', {
    method: 'POST',
    body: { account, text: 'Check this out!', media_ids: [media.mediaId] }
  });
}

7. Get a user's tweets (Subscription required)

async () => {
  // Use /api/v1/x/users/:id/tweets for user timelines (up to ~3,200 tweets)
  // Do NOT use search with "from:username" - search caps at ~40 results
  return xquik.request('/api/v1/x/users/elonmusk/tweets', {
    query: { cursor: '' } // omit cursor for first page
  });
}

8. Search tweets with keywords (Subscription required)

async () => {
  // Use search for keyword filtering (limit for multi-page server-side pagination)
  return xquik.request('/api/v1/x/tweets/search', {
    query: { q: 'AI agents', limit: '100' }
  });
}

9. Browse trending topics (FREE)

async () => {
  return xquik.request('/api/v1/radar');
}

10. Analyze a user's writing style

async () => {
  // Returns cached style if available (free for all users)
  // Auto-refreshes from X if cache is older than 7 days (subscription required)
  return xquik.request('/api/v1/styles', {
    method: 'POST',
    body: { username: 'dbdevletbahceli' }
  });
}

11. Save tweet style from screenshots (FREE)

async () => {
  // When user shares tweet screenshots, extract the texts and save as a style.
  // This lets free users clone any writing voice without a subscription.
  return xquik.request('/api/v1/styles/elonmusk', {
    method: 'PUT',
    body: {
      label: 'Elon Musk style',
      tweets: [
        { text: 'The most entertaining outcome is the most likely' },
        { text: 'Mars, here we come!!' }
      ]
    }
  });
  // Then compose with: POST /api/v1/compose { step: 'compose', topic: '...', styleUsername: 'elonmusk' }
}

12. Download media and get gallery link (Subscription required)

async () => {
  // Returns galleryUrl only (shareable gallery page with all media)
  return xquik.request('/api/v1/x/media/download', {
    method: 'POST',
    body: { tweetInput: '1234567890' } // tweet ID or full URL
  });
}

13. Subscribe (FREE - returns Stripe checkout URL)

async () => {
  return xquik.request('/api/v1/subscribe', { method: 'POST' });
}

14. Draft & optimize tweet text (3-step compose flow, FREE)

async () => {
  // Use this ONLY when the user wants help WRITING tweet text.
  // To SEND a tweet, use POST /api/v1/x/tweets instead.
  // Step 1: Get algorithm data
  const compose = await xquik.request('/api/v1/compose', {
    method: 'POST',
    body: { step: 'compose', topic: 'AI agents' }
  });
  return compose; // Returns contentRules, followUpQuestions, scorerWeights
  // After user answers: call with body { step: 'refine', goal, tone, topic }
  // After drafting: call with body { step: 'score', draft }
}

Cost

• Free: /api/v1/compose, /api/v1/styles (cached lookup/save/delete/compare), /api/v1/drafts, /api/v1/radar, /api/v1/subscribe, /api/v1/account, /api/v1/api-keys, /api/v1/bot/, /api/v1/integrations/, /api/v1/x/accounts, /api/v1/support/*

• Subscription required: /api/v1/styles (X API refresh when cache >7 days), /api/v1/x/tweets, /api/v1/x/articles, /api/v1/x/users, /api/v1/x/followers, /api/v1/x/media, /api/v1/x/profile, /api/v1/x/communities, /api/v1/x/lists, /api/v1/x/dm, /api/v1/x/bookmarks, /api/v1/x/notifications, /api/v1/x/timeline, /api/v1/x/trends, /api/v1/credits, /api/v1/extractions, /api/v1/draws, /api/v1/monitors, /api/v1/events, /api/v1/webhooks, /api/v1/styles/:username/performance, /api/v1/trends

• Publish actions (subscription required): POST /api/v1/x/tweets, DELETE /api/v1/x/tweets/:id, POST|DELETE /api/v1/x/tweets/:id/like, POST|DELETE /api/v1/x/tweets/:id/retweet, POST|DELETE /api/v1/x/users/:id/follow, POST /api/v1/x/dm/:userId, POST /api/v1/x/media, PATCH /api/v1/x/profile, PATCH /api/v1/x/profile/avatar, PATCH /api/v1/x/profile/banner, POST|DELETE /api/v1/x/communities, POST|DELETE /api/v1/x/communities/:id/join

• IMPORTANT: Always attempt the request. Never assume subscription status. The API returns a clear error if subscription is missing.

Rate limits

• The API enforces per-user rate limits: 120 reads/min, 30 writes/min, 15 deletes/min

• 429 responses with error "rate_limit_exceeded" include a retryAfter field (seconds) - wait before retrying

• This is different from x_rate_limited (429) which is an X API downstream limit

• Space out API calls, especially writes. Avoid rapid-fire loops

Error handling

• 402 / "no_subscription" / "subscription_inactive" / "no_credits" / "insufficient_credits": You MUST make another xquik tool call right now: async () => { return xquik.request('/api/v1/subscribe', { method: 'POST' }); } - this returns a checkout URL. Present that URL as a clickable link. Also mention free features (compose, styles, drafts, radar, account, API keys, support). NEVER tell the user to "visit the website" instead - always call subscribe and show the URL

• NEVER combine free and paid calls in Promise.all - a 402 on one call kills all results. Call free endpoints first, then paid ones separately

• If a paid call fails, still use free data already fetched (radar, styles, compose). Never discard free data or fall back to web search

• API errors include status code and message

• Publish error response: { error: code, message, retryable: boolean, details: { reason, action, account, suggestion } }

• Retryable errors (retry after wait): x_rate_limited (429), x_transient_error (503)

• Non-retryable 422 errors: x_duplicate_action, x_content_too_long, x_account_feature_required, x_account_suspended, x_account_protected, x_target_not_found, x_rejected

• Auth errors: x_auth_failure (401, session expired - re-add account), account_needs_reauth (403, re-add account)

• Ambiguous: x_write_unconfirmed (202, action sent but confirmation failed - check timeline before retrying, do NOT retry blindly)

• Fallback: x_write_failed (500, unclassified failure - contact support if persists)

• x_rejected (422): X rejected the request without a specific reason - wait 2-3 minutes before retrying, ensure unique content

• Check the retryable field to decide whether to retry

• 200 with a "warning" field means probable success - do NOT retry. The details object includes action, account, reason, and suggestion fields