A TypeScript SDK for the Threads API, making it easy to interact with Threads in your TypeScript/JavaScript projects.
https://developers.facebook.com/docs/threads
Install the package using npm:
npm install threads-tsOr using yarn:
yarn add threads-tsFirst, import and initialize the ThreadsAPI class:
import { ThreadsAPI, ThreadsAPIConfig } from 'threads-ts';
const config: ThreadsAPIConfig = {
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET',
redirectUri: 'YOUR_REDIRECT_URI',
scope: ['threads_basic', 'threads_content_publish']
};
const threadsAPI = new ThreadsAPI(config);Generate an authorization URL:
const authUrl = threadsAPI.getAuthorizationUrl();
console.log('Authorize your app:', authUrl);Exchange the authorization code for an access token:
const code = 'AUTHORIZATION_CODE';
const tokenResponse = await threadsAPI.getAccessToken(code);
console.log('Access Token:', tokenResponse.access_token);
// Set the access token for future requests
threadsAPI.setAccessToken(tokenResponse.access_token);const userId = 'USER_ID';
// Create a media container
const creationId = await threadsAPI.createMediaContainer({
userId,
mediaType: 'TEXT',
text: 'Hello, Threads!'
});
// Publish the media container
const threadId = await threadsAPI.publishMediaContainer({
userId,
creationId
});
console.log('Published Thread ID:', threadId);const userId = 'USER_ID';
const fields = ['id', 'text', 'username', 'timestamp'];
const userThreads = await threadsAPI.getUserThreads({
userId,
fields,
options: { limit: 10 }
});
console.log('User Threads:', userThreads);const userId = 'USER_ID';
const fields = ['id', 'username', 'name', 'threads_profile_picture_url'];
const userProfile = await threadsAPI.getUserProfile({
userId,
fields
});
console.log('User Profile:', userProfile);const mediaId = 'THREAD_ID';
const fields = ['id', 'text', 'username', 'timestamp'];
const replies = await threadsAPI.getReplies({
mediaId,
fields
});
console.log('Replies:', replies);const userId = 'USER_ID';
const replyToId = 'THREAD_ID_TO_REPLY_TO';
const replyId = await threadsAPI.respondToReply({
userId,
mediaType: 'TEXT',
text: 'This is my response!',
replyToId
});
console.log('Reply ID:', replyId);const mediaId = 'THREAD_ID';
const metrics = ['engagement', 'impressions', 'reach'];
const insights = await threadsAPI.getMediaInsights({
mediaId,
metrics
});
console.log('Media Insights:', insights);For a complete list of available methods and their parameters, please refer to the API documentation.
We welcome contributions to the threads-ts SDK! Here's how you can help:
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Please make sure to update tests as appropriate and adhere to the existing coding style.
This project is licensed under the MIT License - see the LICENSE file for details.
If you encounter any issues or have questions, please open an issue on GitHub.
- Thanks to the Threads team for providing the API
- All the contributors who have helped improve this SDK
Made with ❤️ by solojungle