--- name: twit-api-production-de12.up.railway.app description: This host provides read-only access to Twitter/X public data via three skills: searching tweets by keyword and filter criteria, fetching a specific user's recent tweet timeline, and searching for user accounts by keyword. It does not support write operations, streaming, or direct lookup by ID. host: twit-api-production-de12.up.railway.app --- # twit-api-production-de12.up.railway.app twit-api-production-de12.up.railway.app is a Twitter/X data retrieval host serving agents that need to query public tweet content or discover user accounts. It covers two distinct data types — tweets and users — through search and timeline access. It is a read-only integration with no support for posting, direct messages, or real-time streaming. ## When to use this host Use this host when an agent needs to search public Twitter/X tweets by keyword, hashtag, date range, or engagement threshold, retrieve a specific user's recent tweets by screen name, or discover user accounts by topic. Do not use this host for fetching a single tweet or user by exact ID, posting or replying to tweets, streaming real-time data, or accessing private or protected account content. For real-time tweet streams or write operations, a dedicated Twitter/X streaming or OAuth-enabled write API should be used instead. ## Capabilities ### Tweet Retrieval Retrieves public tweet content either by searching with keyword and filter criteria or by fetching the recent timeline of a known user account. - **`search-tweets`** — Searches public Twitter/X tweets using advanced filters including keywords, phrases, hashtags, usernames, engagement thresholds, and date ranges, returning full tweet objects with author metadata and public metrics. - **`fetch-user-tweet-timeline`** — Fetches up to 20 most-recent tweets from a specified Twitter user's timeline, including tweet text, public metrics, and pagination cursor. ### User Discovery Finds Twitter/X user accounts matching a keyword or phrase, returning profile metadata including follower counts, verification status, and bios. - **`search-twitter-users`** — Searches Twitter/X for user accounts matching a keyword or phrase and returns up to 20 users per page with profile details and public metrics. ## Workflows ### Discover Users Then Audit Their Tweets *Use when an agent needs to find accounts relevant to a topic and then inspect the recent tweet output of those accounts.* 1. **`search-twitter-users`** — Search for user accounts matching a topic keyword to identify relevant handles. 2. **`fetch-user-tweet-timeline`** — Fetch the recent tweet timeline for each identified username to review their actual content. ### Topic Search Then Author Profile Lookup *Use when an agent needs to find tweets on a topic and then understand who the authors are by examining their profiles.* 1. **`search-tweets`** — Search for tweets matching keywords, hashtags, or engagement thresholds to surface relevant content and author usernames. 2. **`search-twitter-users`** — Search for the author usernames surfaced in the tweet results to retrieve their profile details, follower counts, and verification status. ## Skill reference ### `search-tweets` **Twit Premium Tweet Search** — Searches public Twitter/X tweets using advanced filters including keywords, phrases, hashtags, usernames, engagement thresholds, and date ranges, returning full tweet objects with author metadata and public metrics. *Use when:* Use when an agent needs to retrieve public tweets matching specific keywords, hashtags, usernames, date windows, or minimum engagement counts (likes, replies, reposts) from Twitter/X. *Not for:* Do not use for fetching a single tweet by ID, retrieving a user's full timeline without filters, or streaming real-time tweets; use a dedicated timeline or streaming API instead. **Inputs:** - `words` (string) — All these words must appear in the tweet. - `phrase` (string) — Exact phrase that must appear in the tweet. - `anyWords` (string) — Any of these words must appear in the tweet. - `noneWords` (string) — Exclude tweets containing these words. - `hashtags` (string) — Filter by hashtag (without the # symbol). - `from` (string) — Return tweets authored by this username. - `to` (string) — Return tweets that are replies to this username. - `mentioning` (string) — Return tweets that mention this username. - `minReplies` (string) — Minimum reply count a tweet must have. - `minLikes` (string) — Minimum like count a tweet must have. - `minReposts` (string) — Minimum retweet count a tweet must have. - `since` (string) — Start date for tweet search in YYYY-MM-DD format. - `until` (string) — End date for tweet search in YYYY-MM-DD format. - `next_token` (string) — Pagination cursor returned from a previous response to fetch the next page of results. **Returns:** Returns a data array of tweet objects each containing tweet text, creation timestamp, language, public engagement metrics, and a nested author object with profile and follower counts. **Example:** `GET https://twit-api-production-de12.up.railway.app/tweets/search?words=AI&hashtags=web3&minLikes=10&since=2026-01-01&until=2026-05-15` --- ### `fetch-user-tweet-timeline` **Tweet User Feed** — Fetches up to 20 most-recent tweets from a specified Twitter user's timeline, including tweet text, public metrics, and pagination cursor. *Use when:* Use when an agent needs to retrieve recent tweets from a specific Twitter account by screen name, optionally paginating through results using a cursor token. *Not for:* Do not use for keyword or hashtag search; use a tweet search endpoint instead. Not suitable for streaming or real-time tweet monitoring. **Inputs:** - `username` (string, required) — Twitter screen name of the target user, without the @ symbol. - `next_token` (string) — Pagination cursor returned by a previous response to fetch the next page of tweets. **Returns:** Returns a data array of up to 20 tweet objects with id, text, public_metrics, and optional note_tweet, plus a meta.next_token cursor for pagination. **Example:** `GET https://twit-api-production-de12.up.railway.app/tweets/user?username=vitalikbuterin` --- ### `search-twitter-users` **Twit User Search** — Searches Twitter/X for user accounts matching a keyword or phrase and returns up to 20 users per page with profile details and public metrics. *Use when:* Use when an agent needs to find Twitter/X user accounts by username, name, or topic keyword, including follower counts, verification status, and bio descriptions. *Not for:* Do not use for searching tweets or posts; use a tweet search endpoint instead. Not suitable for looking up a single known user by exact ID. **Inputs:** - `query` (string, required) — Search keyword or phrase to match against Twitter/X user accounts. - `next_token` (string) — Pagination cursor returned by a previous response to retrieve the next page of results. **Returns:** Returns a data array of up to 20 user objects each with id, username, name, description, verified status, profile_banner_url, optional pinned_tweet_id, and public_metrics (followers, following, tweets, likes, media counts). **Example:** `GET https://twit-api-production-de12.up.railway.app/users/search?query=bitcoin` ---