twitter_skill

Overview

This skill connects to Twitter/X via twitterapi.io to search and retrieve profiles, tweets, replies, followers, communities, Spaces, and trends. It is built for quick access to public Twitter data and supports targeted searches, user lookups, and conversation threading. Use it whenever a user mentions Twitter, X, tweets, or requests social listening or profile data.

How this skill works

The skill calls twitterapi.io endpoints with an API key supplied in the environment to fetch user objects, timelines, tweet conversation trees, media, community and Space details, and trending topics. It supports search query modifiers (date ranges, media filters, min engagement, exclude retweets) and paginated results for large lists like followers or retweeters. Responses are returned as structured JSON that can be filtered, summarized, or used to build insights.

When to use it

• Identify a user’s recent tweets, replies, and public profile data.
• Search for tweets matching a keyword, date range, or engagement threshold.
• Map conversations: get replies, quotes, and full tweet threads.
• Compile followers, following, or verified follower lists for research.
• Retrieve community posts, moderators, or Space details for moderation or engagement analysis.

Best practices

• Set the twitterapi.io API key in your environment before using the skill.
• Use query filters (from:, since:, until:, -filter:retweets, filter:media) to limit noise and reduce API usage.
• Paginate results and set sensible limits to control cost; twitterapi.io charges per request volume.
• Handle rate limits and errors gracefully, and cache frequently requested user or trend data.
• Respect privacy and Twitter’s terms: avoid collecting or exposing private data and rate-limit scraping behavior.

Example use cases

• Fetch a public user’s recent tweets and summarize their topical focus for outreach.
• Track a brand campaign by searching tweets with campaign hashtags and min_faves to find high-engagement posts.
• Reconstruct a tweet thread and collect replies and quotes for sentiment analysis or moderation.
• List verified followers of a high-profile account to identify potential influencers or partners.
• Pull worldwide or region-specific trends to inform content planning and SEO topics.