Twitter/X Scraper & API Client for JavaScript / TypeScript

The official JavaScript & TypeScript SDK for the FetchLayer Twitter/X API.

Search tweets. Get profiles. Pull followers and following lists. Fetch replies. All as clean JSON from a single API — no scraping infrastructure, no proxies, no X developer account.

Open-source SDK, hosted API. This package is MIT-licensed. The API requires a free FetchLayer API key — no subscriptions, no contracts, no lock-in. Pay only for what you use.

Install

npm install @fetchlayer/twitter

pnpm add @fetchlayer/twitter

yarn add @fetchlayer/twitter

Get your API key

1. Go to fetchlayer.dev
2. Sign in with your email
3. Copy your API key from the dashboard

That's it. No credit card. No trial expiration. You get free requests to start, then pay-as-you-go when you need more.

Quick start

import { FetchLayerTwitter } from "@fetchlayer/twitter";

const twitter = new FetchLayerTwitter({
  apiKey: process.env.FETCHLAYER_API_KEY!,
});

// Search Twitter/X for tweets about any topic
const results = await twitter.search({
  query: "best CRM tools",
  product: "Top",
  count: 10,
});

console.log(results);

That's 4 lines to get structured Twitter/X data. No OAuth, no rate-limit wrestling, no $100/month X API bill.

Why use this instead of X's official API

| Problem | FetchLayer | | --- | --- | | X API costs $100/mo (Basic) or $5K/mo (Pro) | Free tier + pay-per-use | | Complex OAuth setup (4 keys to manage) | Single API key | | Aggressive rate limits (1 req/15s on some endpoints) | No rate limits | | Follower graph requires Pro tier ($5K/mo) | Followers, following, verified followers included | | Maintaining scraping infra is a full-time job | npm install and done | | You need tweets, profiles, AND followers | 10 endpoints, one SDK |

All methods

const twitter = new FetchLayerTwitter({ apiKey });

| Method | What it does | | --- | --- | | twitter.search(params) | Search tweets by keyword (Top, Latest, People, Media, Lists) | | twitter.getTweetDetail(params) | Get a specific tweet by ID | | twitter.getTweetReplies(params) | Fetch replies to a tweet | | twitter.getUserProfile(params) | Get user profile, bio, follower count | | twitter.getAboutProfile(params) | Get extended profile metadata (category, business type) | | twitter.getUserTweets(params) | Get recent tweets from a user | | twitter.getUserReplies(params) | Get recent replies from a user | | twitter.getFollowers(params) | Get accounts following a user | | twitter.getFollowing(params) | Get accounts a user follows | | twitter.getVerifiedFollowers(params) | Get verified accounts following a user |

Examples

Search tweets

const results = await twitter.search({
  query: "react server components",
  product: "Latest",
  count: 25,
});

for (const tweet of results.results ?? []) {
  console.log(`@${tweet.author?.handle}: ${tweet.text?.slice(0, 100)}`);
  console.log(`  ${tweet.likeCount} likes · ${tweet.retweetCount} retweets`);
}

Get a user profile

const profile = await twitter.getUserProfile({ handle: "openai" });

console.log(`${profile.displayName} (@${profile.handle})`);
console.log(`Followers: ${profile.followersCount?.toLocaleString()}`);
console.log(`Bio: ${profile.description}`);

Get followers

const followers = await twitter.getFollowers({
  handle: "openai",
  count: 50,
});

for (const account of followers.accounts ?? []) {
  console.log(`@${account.handle} — ${account.followersCount?.toLocaleString()} followers`);
}

Get verified followers

const verified = await twitter.getVerifiedFollowers({
  handle: "levelsio",
  count: 100,
});

console.log(`${verified.accounts?.length ?? 0} verified followers`);

Paginate through results

// Search with pagination
const page1 = await twitter.search({ query: "AI", product: "Latest", count: 50 });

if (page1.cursor) {
  const page2 = await twitter.search({
    query: "AI",
    product: "Latest",
    count: 50,
    cursor: page1.cursor,
  });
}

// Followers pagination works the same way
let cursor: string | undefined;
do {
  const page = await twitter.getFollowers({
    handle: "openai",
    count: 100,
    ...(cursor ? { cursor } : {}),
  });
  cursor = page.cursor;
  // Process page.accounts...
} while (cursor);

TypeScript

All response types are exported. Import them for full type safety:

import type { SearchResponse, Tweet, UserProfile, FollowersResponse } from "@fetchlayer/twitter";

const data: SearchResponse = await twitter.search({ query: "typescript" });

// Fully typed — no `any` anywhere
for (const tweet of data.results ?? []) {
  console.log(tweet.author?.handle); // string | undefined
  console.log(tweet.likeCount);      // number | undefined
}

API Reference

See the FetchLayer Twitter/X API docs for full endpoint reference, parameter details, and response schemas.

License

MIT © 2026 HootCodes LTD