The End 👋

Today, I received a cease and desist letter from Meta, asking me to take this project down.
Consequently, I decided to stop future development of this project and related ones:

Warning
As of September 8, 2023, the development of the "threads-api" project have been halted and discontinued due to communication received from Meta Platforms, Inc. (“Meta,” previously known as Facebook, Inc.). This repository, along with related projects threads-py and react-threads, has been archived and will no longer receive updates or maintenance. The previous documentation related to this project has been moved to PRESERVED.md as requested.

The "threads-api" was developed for educational and research purposes only. Based on the notification from Meta, it's clear that using or distributing the code might violate the terms of service of Meta Platforms, Inc. and its associated services, including but not limited to Instagram and Threads. Any actions or activities related to the material contained within this repository are solely the user's responsibility. The author and contributors of this repository do not support or condone any unethical or illegal activities.

It was a wonderful journey, and thank you to everyone for being a part of it.
Look forward to seeing you in future projects!

🥹♥️

These are the final release notes I forgot to update:

What's Changed

• add MediaThreads.net to app registry by @farizrifqi in #313
• Added InstaThreadsDown to apps list by @iRajatDas in #315
• Submit rethreads.pro to apps list by @Newt0n in #319
• Add my bot to app registry by @steveyout in #321
• feat: add my app to app registry by @Dun-sin in #326
• Add 2FA support by @firtoz in #322
• Bye 👋 by @junhoyeo in #327

New Contributors

• @iRajatDas made their first contribution in #315
• @Newt0n made their first contribution in #319
• @steveyout made their first contribution in #321
• @Dun-sin made their first contribution in #326
• @firtoz made their first contribution in #322

Full Changelog: v1.6.3...the-end

v1.6.3 (🛠️ Fix bugs, Made Improvements)

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

What's Changed

• fix: ensure this.device is defined by @aleclarson in #281
• fix: align the publish result with its return type by @aleclarson in #284

Full Changelog: v1.6.2...v1.6.3

v1.6.2 (✨ Full User/Post Details, 🔇 Mute/Block, 🔔 Notif., 🔍 Search Users, 💎 Rec.)

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

Summary

• Thanks to @stevenlafl, we got a bunch of methods added in this release 🚀
• ✨ Full User Profile & Thread(Post) Details with Authorization — getUserProfileLoggedIn and getThreadsLoggedIn.
• 🔇 Mute/Unmute a user or a user's post — mute and unmute with userID (required, thanks to @aleclarson) and postID (optional)
• 🔇 Block/Unblock a user — block and unblock
• 🔔 Notifications — (fetch) getNotifications, (update view state) setNotificationsSeen

  let data = await threadsAPI.getNotifications(
    ThreadsAPI.NotificationFilter.MENTIONS, // {MENTIONS, REPLIES, VERIFIED}
  );
  
  if (!data.is_last_page) {
    const cursor = data.next_max_id;
    data = await threadsAPI.getNotifications(ThreadsAPI.NotificationFilter.MENTIONS, cursor);
  }

• 🔍 Search Users — searchUsers
• 💎 Fetch Recommended Users — getRecommendedUsers

What's Changed

• Add an app to the registry by @swarajbachu in #243
• Add App by @Digital39999 in #242
• Add a slew of authenticated features by @stevenlafl in #189
• [ImgBot] Optimize images by @imgbot in #263
• api, docs: Refactor API, Update README.md with new methods by @junhoyeo in #277
• api: Fix verbose logs and ThreadsAPIError messages by @junhoyeo in #279
• api, docs: rename getRecommended -> getRecommendedUsers by @junhoyeo in #280

New Contributors

• @swarajbachu made their first contribution in #243
• @stevenlafl made their first contribution in #189

Full Changelog: v1.5.4...v1.6.2

v1.5.4 (🛠️ Bug Fixes)

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

What's Changed

• Add my app 😃 by @sooluh in #228
• api: Remove unused logs by @junhoyeo in #239
• fix(api): dotenv config was invoked explicitly by @suvam0451 in #235
• api: Move dotenv to devDependencies by @junhoyeo in #241

New Contributors

• @suvam0451 made their first contribution in #235

Full Changelog: v1.5.3...v1.5.4

v1.5.3 (🛠️ Fix method getToken to properly return User ID)

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

Summary

• 🛠️ Fix getToken to properly return userID
• 🛠️ Rename Internal Method: _getProfilePage -> _getCleanedProfileHTML

What's Changed

• web-ui: Add mobile responsiveness by @junhoyeo in #221
• [ImgBot] Optimize images by @imgbot in #222
• api(test): fix test for getToken to function correctly by @junhoyeo in #225
• Fix: getToken not returning userID by @Aerglonus in #223
• changed the name of _getProfilePage to _getCleanedProfileHTML by @Aerglonus in #227

Full Changelog: v1.5.2...v1.5.3

v1.5.2 (🛠️ Bug Fixes)

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

What's Changed

• add httpAgent/httpsAgent at syncLoginExperiments for proxy auth by @enggaraziz in #210
• Update and rename getToken.test.ts to getTokenWithProxy.test.ts by @enggaraziz in #203
• fix: methods failing because of token or headers by @Aerglonus in #216
• api(package): Update repository, Move @swc/cli and @swc/core to devDependencies by @junhoyeo in #219

New Contributors

• @Aerglonus made their first contribution in #216

Full Changelog: v1.5.1...v1.5.2

v1.5.1 (🛠️ Bug Fixes)

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

Summary

• 🛠️ Fix broken type import (TypeScript)
• 🛠️ Use this.httpAgent/this.httpsAgent in login

What's Changed

• fix: broken type import by @aleclarson in #205
• add httpAgent/httpsAgent at login for proxy by @enggaraziz in #204

New Contributors

• @enggaraziz made their first contribution in #204

Full Changelog: v1.5.0...v1.5.1

v1.5.0 (✨ Threads with Sidecar (Multiple Images))

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

Summary

await threadsAPI.publish({
  text: '🤖 Threads with Sidecar',
  attachment: {
    sidecar: [
      'https://raw.githubusercontent.com/junhoyeo/threads-api/main/threads-web-ui/app/opengraph-image.jpg?v=2',
      'https://github.com/junhoyeo/threads-api/raw/main/.github/cover.jpg',
    ],
  },
});

• ✨ We now support Sidecar Attachments! This means you can now upload multiple images, which is shown as a carousel in your threads.
• ✨ The publish method's interface has been changed once again! url and image options have been deprecated and replaced with a single attachment option which can be { url }, { image }, or { sidecar }. This is more restrictive as Threads only permit a single rich attachment in the first place.
  • 🛠️ Also, upload IDs will never collide in uploadImage. 🎉
• ✨ ThreadAPI related types had been refactored into namespace ThreadsAPI. (See #198)
• 📌 Note: we still have full backward compatibility with the previous version!

What's Changed

• [web-ui] Workaround for overflow: hidden + border-radius bug in Safari by @junhoyeo in #193
• [root] Fix .prettierrc to work inside VSCode by @junhoyeo in #194
• web-ui(landing): Revalidate stargazers count every 60 seconds, Add missing link by @junhoyeo in #195
• web-ui(apps): Initialize App Registry by @junhoyeo in #196
• [web-ui] Add favicons by @junhoyeo in #197
• web-ui(apps): Show community-made apps in App Registry by @junhoyeo in #199
• web-ui(landing): Add opengraph image by @junhoyeo in #200
• feat: add attachment.sidecar publish option by @aleclarson in #198
• docs: Update README.md by @junhoyeo in #202

Full Changelog: v1.4.7...v1.5.0

v1.4.7 (🛠️ Bug Fixes)

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

What's Changed

• postId from publish by @cedriking in #192

Full Changelog: v1.4.6...v1.4.7

v1.4.6 (✨ Reply Control, 🛠️ Bug Fixes)

Threads API - Unofficial, Reverse-Engineered Node.js/TypeScript client for Meta's Threads.

What's Changed

• [web-ui] Implement thread detail page by @junhoyeo in #180
• feat: add replyControl option by @aleclarson in #184
• Fix mimeTypes import (related to #177) by @sooluh in #187
• fix: strip user ID from parentPostID and quotedPostID by @aleclarson in #185
• [web-ui] Show stargazers count from the GitHub API in landing by @junhoyeo in #190

New Contributors

• @sooluh made their first contribution in #187

Full Changelog: v1.4.5...v1.4.6