What is tweet-api?

@macarie/tweet-api lets you fetch Twitter/X posts and display them inside your own web application. Instead of relying on Twitter's official embed widgets, which come with their own styling and limitations, you pull the raw tweet data and format it however you like. The package gives you two main tools. You call getTweet with a tweet ID, and it fetches the post's content from Twitter's API. Then you pass that data through enrichTweet, which cleans it up and organizes details like author info, text, and media into a structure that's easy to render in your own UI. From there, you decide how it looks. The package itself doesn't include visual components, it just handles the data fetching and formatting layer. This is useful for developers building React apps who want full control over how tweets appear on their site or in their product. For example, if you're building a blog and want to embed tweets with your own custom styling, or creating a dashboard that surfaces social media content alongside other data, this gives you the building blocks without the visual constraints of Twitter's embed iframes. It's worth noting that this project is a stripped-down fork of Vercel's react-tweet library. The original includes ready-made React components for displaying tweets, but this package intentionally excludes those and exports only the data-fetching and utility functions. That makes it lighter and more flexible if you want to build your own presentation layer. However, the package doesn't follow standard versioning conventions, the author deliberately keeps the version number below 1.0 so package managers won't auto-update it, since breaking changes can arrive in minor updates. You'll need to update it manually and carefully.