Skip to content

A Node.js and TypeScript library for interacting with Twitter API v2

License

Notifications You must be signed in to change notification settings

twitterjs/twitter.js

Repository files navigation

twitter.js github

twitter.js official discord server NPM version NPM downloads Twitter API v2

Twitter.js

A Node.js and TypeScript library for interacting with Twitter API v2

Installation

npm i twitter.js

Usage

🚀 Fetch details about a twitter user in no time:

import { Client } from 'twitter.js';
import { bearerToken } from './secrets.js';

const client = new Client();
await client.loginWithBearerToken(bearerToken);

const user = await client.users.fetchByUsername('iShiibi');
console.log(user.description); // Contributing to open-source 🌐

🔒 Make user-context authorized requests without any hassle:

import { Client } from 'twitter.js';
import { credentials } from './secrets.js';

const client = new Client();
await client.login(credentials);

const tweet = await client.tweets.fetch('1336749579228745728');
await tweet.like();

📈 Want real-time events listening? We got you covered:

import { Client } from 'twitter.js';
import { credentials } from './secrets.js';

const client = new Client({ events: ['FILTERED_TWEET_CREATE'] });
await client.login(credentials);

await client.filteredStreamRules.create({ value: '@tjs_test' });

client.on('filteredTweetCreate', async tweet => {
	console.log(tweet.text); // hey @tjs_test, like this tweet if you're listening!
	await tweet.like();
});

Future

The twitter.js library is not ready for production use yet. You can expect breaking changes without any major version bump until we release v1.0.0 of the library.