x-api

Retrieve Twitter/X user profiles and search tweets via twitterapi.io.

Updated Oct 24, 2025
One-click install
npx skills add https://github.com/shalomma/social-media-research --skill x-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-api
Source: https://github.com/shalomma/social-media-research/tree/main/.claude/skills/x-api
Command: npx skills add https://github.com/shalomma/social-media-research --skill x-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, typer, pydantic, and includes scripts (resource) components.

What problem does it solve?

Manually gathering Twitter/X data for research or monitoring is slow and complex. This Skill simplifies access to user profiles, tweets, and search results, automating data collection for analysis and saving you valuable time.

Core Features & Use Cases

  • User Info Retrieval: Instantly fetch detailed user profiles by screen name, including follower counts, recent activity, and language.
  • Tweet Search: Find tweets matching specific queries, with advanced filters for precise results (e.g., by date, user, content type).
  • Use Case: Quickly validate a list of potential influencers by checking their follower count and recent activity, or monitor specific keywords related to your brand or industry.

Quick Start

Get user information for 'elonmusk'

python3 .claude/skills/x-api/src/client.py userinfo elonmusk

Search for latest tweets about "artificial intelligence"

python3 .claude/skills/x-api/src/client.py search "artificial intelligence" --type Latest

Frequently Asked Questions about x-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I collect Twitter/X data programmatically without manual scraping?

Twitter/X data collection is automated through this Skill by querying user profiles and tweets via twitterapi.io. You retrieve typed user information by screen name and search tweets with filters—date, content type, user—returning structured results instantly without manual work.

Can I search tweets by specific keywords and filter results by type?

Tweet search supports filtered timeline queries across Top, Latest, Media, People, and Lists categories. Filter by keyword, date range, and user to narrow results, then export structured data for analysis or monitoring.

What's the fastest way to validate influencers by follower count and recent activity?

User info retrieval fetches detailed profiles including follower counts and recent activity by screen name. Query multiple users programmatically to validate influencer lists and compare metrics without visiting Twitter/X directly.

Does this work with Python CLI workflows or require custom code?

The Skill exposes both CLI and agent-friendly interfaces via Python. Use command-line arguments for direct queries or integrate typed responses into automation workflows with built-in mock mode for restricted environments.

Can I monitor brand keywords across Twitter/X at scale?

Advanced tweet search enables keyword monitoring with precise filters and pagination. Return typed results across multiple search types to track brand mentions, competitor activity, or industry trends programmatically.

What happens if the API is blocked or rate-limited in my environment?

Mock mode allows testing and development when twitterapi.io access is blocked. Run queries against simulated data to validate logic before deploying to environments with full API access.