Weir API
One API for public conversations on Reddit and X, each returned in that platform's own field names. A Reddit post carries subreddit, selftext, score,…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
One API for public conversations on Reddit and X, each returned in that platform's own
field names.
A Reddit post carries subreddit, selftext, score, upvoteRatio, and numComments.
An X post carries text, likeCount, retweetCount, and an embedded author object.
Nothing is renamed into a shared vocabulary and nothing is dropped to make the shapes
match: the only fields both carry are id, url, and createdAt.
Billing. Prepaid: calls spend a balance of credits, 5,000 free each month plus any
bought, and stop when it runs out. Priced per returned result, not per request. A call
that fails or is refused costs nothing. A call that succeeds is charged for what it
returned, plus a one-credit minimum that covers reaching the source even when nothing
matched. Every operation publishes its price in an x-weir-billing extension, and every
response reports what it charged in x-credits-charged and what is left inx-credits-remaining.
Limits. Running out of credit returns 402 and is not retryable: only a person can
clear it, by adding credits in the dashboard, and retrying never will. Rate limiting returns429 and is retryable, as is a 429 with details.reason credits_held, returned when
the account's remaining credits are held by its own calls still in flight. They are
separate codes because they need opposite responses.
Endpoints 58
- POSTSearch public Reddit posts
/v1/reddit/searchPosts matching a query across Reddit, or within the communities named in subreddit or subreddits. Reddit's search covers post titles and bodies only — it does… - GETGet one public Reddit post
/v1/reddit/posts/:idThe post's current state: score, comment count, flair, and whether it was locked, archived, or removed (removedByCategory). To refresh many posts at once, use… - GETGet information about a public subreddit
/v1/reddit/subreddits/:nameA community's description, member count, type, language, and whether it is NSFW or quarantined. A community that does not exist is a 404; one that is private,… - POSTSearch posts within one subreddit
/v1/reddit/subreddits/:name/searchPosts matching a query inside the community in the path. The body cannot widen the search beyond it. To find communities rather than posts, use POST… - GETGet a Reddit comment tree as a flat list, page by page
/v1/reddit/posts/:id/commentsA post's comments, flattened depth-first: each carries depth (0 is top-level) and parentId, so the tree can be rebuilt. The first page is the thread as Reddit… - GETList a community's posts: hot, new, rising, top, or controversial
/v1/reddit/subreddits/:name/postsA community's own listing, with no keyword: everything new in r/saas, or this week's top posts in r/startups. Use this rather than search when the community… - GETRead a community's newest comments, across every post
/v1/reddit/subreddits/:name/commentsEvery new comment in a community, newest first, each with the post it belongs to (linkTitle, linkPermalink). This is the way to find mentions inside comments:… - POSTFind communities by name or topic
/v1/reddit/search/subredditsCommunities whose name or description matches the query, with member counts. Use it to find where a topic is discussed before reading or watching those… - GETGet a Reddit account's public profile
/v1/reddit/users/:usernameKarma, account age, moderator and Premium status, and the profile's bio and follower count — the facts that tell a real, established account from a throwaway.… - GETList the posts an account has submitted
/v1/reddit/users/:username/postsPosts the account submitted, across every community, newest first by default. To be told when it posts, create a reddit_user monitor instead of polling.… - GETList the comments an account has made
/v1/reddit/users/:username/commentsComments the account made, across every community, each with the post it belongs to (linkTitle, linkPermalink). Newest first by default. Reddit lets people… - POSTFetch up to 100 posts and comments, and 100 communities, in one call
/v1/reddit/lookupCurrent state of items you already know about: fresh scores and comment counts, whether a post was removed (removedByCategory) or a comment deleted ([deleted]…
X
- POSTSearch public X posts with composable filters
/v1/x/searchSearches public X (Twitter) posts by keyword, phrase, account, hashtag, language, date and engagement. Every filter narrows the result, and at least one of… - GETGet up to 100 public X posts by id
/v1/x/posts?ids=1878432157392445440,1878432157392445441Looks up many posts in one request, for hydrating ids you already hold (from a webhook, a dataset, or another response). Posts come back in the order… - GETGet one public X post
/v1/x/posts/:idReturns one post with its author, counters, media, and any post it quotes or reposts. 404 when the post does not exist, was deleted, or is not public. - GETGet replies to an X post
/v1/x/posts/:id/repliesReturns the replies under a post, including replies to replies. The post itself, the posts above it, and promoted posts are left out. For the author's own… - GETGet the author's thread containing a post
/v1/x/posts/:id/threadReturns the thread a post belongs to, in reading order: the author's earlier posts it continues from, the post, and the author's continuation below it. Pass… - GETGet posts quoting an X post
/v1/x/posts/:id/quotesReturns public posts that quote the given post, each with the quoted post embedded as quotedPost. Useful for tracking how a post is being discussed beyond its… - GETGet accounts that reposted an X post
/v1/x/posts/:id/retweetersReturns the accounts that reposted a post, as X lists them; X may cap the list for very widely reposted posts. Who liked a post is not available: X made likes… - GETGet the edit history of an X post
/v1/x/posts/:id/editsReturns every version of an edited post, newest first, including the current one. An empty list means the post exists and was never edited. X allows edits… - GETRead an X Article
/v1/x/posts/:id/articleReturns the X Article a post carries: title, cover image, and the full body as plain text, Markdown, and X's own blocks (headings, lists, quotes, code, links,… - GETGet up to 100 public X profiles by id
/v1/x/users?ids=1593274519387648000,783214Looks up many accounts in one request, for hydrating ids you already hold, such as post authors or followers. Profiles come back in the order requested. An id… - POSTSearch X accounts
/v1/x/users/searchFinds accounts by name, username, or bio, ranked by X's people search. Use it to turn a person or brand name into a username before calling the other account… - GETGet a public X profile
/v1/x/users/:userReturns one account's profile: name, bio, counters, pinned posts, and whether it is protected. A protected account's profile is public on X, so it is… - GETGet an X account's "About this account" details
/v1/x/users/:user/aboutReturns what X shows under "About this account": the country X attributes the account to, how it connects to X, how many times its username has changed, and… - GETGet a public X user timeline
/v1/x/users/:user/postsReturns an account's own posts and reposts, newest first, with any pinned post first. X keeps only the newest 800 or so posts on this tab: where they end,… - GETGet an X account's posts and replies
/v1/x/users/:user/repliesReturns the profile's Replies tab: the account's posts together with its replies to others, newest first, with any pinned post first. X keeps the newest 3,200… - GETGet an X account's posts with media
/v1/x/users/:user/mediaReturns the profile's Media tab: the account's own posts that carry photos, videos, or GIFs, newest first. Media URLs are in each post's media. 404 when the… - GETGet the posts an X account highlights
/v1/x/users/:user/highlightsReturns the profile's Highlights tab: posts the account chose to feature. Only accounts with X Premium can highlight, so for others the list is empty. 404… - GETGet an X account's followers
/v1/x/users/:user/followersReturns accounts that follow the account in the order X lists them: mostly most recent first, though X can place some accounts out of that order. X chooses… - GETGet the accounts an X account follows
/v1/x/users/:user/followingReturns accounts the account follows in the order X lists them: mostly most recent first, though X can place some accounts out of that order. X chooses the… - GETGet an organisation's affiliated X accounts
/v1/x/users/:user/affiliatesReturns the accounts a Verified Organization lists as affiliated with it, such as its employees, products, or regional accounts. Empty for accounts that are… - GETGet the creators an X account subscribes to
/v1/x/users/:user/subscriptionsReturns the creators the account pays to subscribe to, where it has not hidden them. Often empty. 404 when the account does not exist, or is protected: a… - GETGet a public X List
/v1/x/lists/:idReturns a List's name, description, owner, and member and follower counts. Read its members with getXListMembers and its timeline with getXListPosts. 404 when… - GETGet the members of a public X List
/v1/x/lists/:id/membersReturns the accounts in a List, as X orders them. Lists are curated, so this is a quick way to find the accounts that matter on a topic. Paginate with… - GETGet the timeline of a public X List
/v1/x/lists/:id/postsReturns recent posts from the List's members, newest first: the same feed the List shows on X. X chooses the page size (up to about 100 posts), so there is no… - GETGet an X Space
/v1/x/spaces/:idReturns a Space (a live audio room): its title, state (NotStarted, Running, or Ended), schedule, host, speakers, and audience counts, and whether a replay is…
Monitors
- GETList monitors
/v1/monitors - POSTCreate a monitor
/v1/monitors - GETGet one monitor
/v1/monitors/:id - DELETEDelete a monitor
/v1/monitors/:id - PATCHUpdate a monitor
/v1/monitors/:id - GETList deduplicated results a monitor has found
/v1/monitors/:id/results - GETList a monitor's execution history
/v1/monitors/:id/runs - GETGet one monitor run
/v1/monitors/:id/runs/:runIdOne run from the monitor's history: its status, timing, how many results it found and how many were new, and what it cost. Poll it after runMonitor to see… - POSTQueue a monitor run immediately
/v1/monitors/:id/runQueues the run and returns straight away. The run itself consumes credits when it executes, priced by what it finds, not by this call.
Webhooks
- GETList webhooks
/v1/webhooks - POSTCreate a webhook
/v1/webhooksThe signing secret is returned exactly once, in this response. It is stored encrypted and cannot be retrieved again. To replace it, create a new webhook and… - DELETEDelete a webhook
/v1/webhooks/:id - PATCHUpdate a webhook
/v1/webhooks/:id - POSTQueue a test delivery
/v1/webhooks/:id/test - GETList recent delivery attempts
/v1/webhook-deliveries - GETGet one delivery, with its body
/v1/webhook-deliveries/:idOne delivery with the exact JSON body Weir sends (and signs), how many attempts it has taken, the last response status and error, and when the next attempt is…
Account
- GETCredit balance, holds, and this month's free grant
/v1/usageReturns the caller's own credit state. Requires authentication but no additional scope, because a key that cannot discover why it is being refused cannot… - GETCeilings imposed by the account's tier
/v1/limits - GETIdentify the account and scopes behind this key
/v1/whoami
System
- GETLiveness check
/health - GETReadiness check
/ready
API details
- Base URL
https://api.weirapp.io- Authentication
- A bearer token in the Authorization header
- Operations
- 58 operations on 53 pathsGET 44POST 10PATCH 2DELETE 2
- Main resources
- X 25Reddit 12Monitors 9Webhooks 7Account 3System 2
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
ca29f52bb5e7-20261117T121817Z - Links
- OpenAPI document · Terms of service · Support
- Listed from
- Weirapp's published OpenAPI description
How to test the Weir API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Weir API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Search public Reddit posts” (POST /v1/reddit/search), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Weir API?
One API for public conversations on Reddit and X, each returned in that platform's own field names. A Reddit post carries subreddit, selftext, score,… It is listed under Social and has 58 endpoints.
Who publishes the Weir API?
It is listed from Weirapp's public API description (an OpenAPI document), not published by Weirapp on Swastik Codes. Anyone who controls weirapp.io can claim the profile by adding a DNS TXT record.
What is the base URL of the Weir API?
Requests go to https://api.weirapp.io. Endpoint paths are added to this base URL.
How do I authenticate with the Weir API?
With A bearer token in the Authorization header.
How many endpoints does the Weir API have?
58 operations on 53 paths (44 GET, 10 POST, 2 PATCH, 2 DELETE). The largest groups are X, Reddit, Monitors, Webhooks.
Is forking the Weir API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.