CrewAI

The crewai-xpoz Python package provides 44 CrewAI tools for social media intelligence. Add them to any agent in your crew to give it access to Twitter/X, Instagram, Reddit, and TikTok data.

Setup

Get your access key

Install the package

pip install crewai-xpoz

You also need an LLM provider for your agents. For example, with Anthropic:

pip install "crewai[anthropic]"

Set your access key

export XPOZ_API_KEY=your-access-key

Use in a crew

from crewai import Agent, Crew, Task
from crewai_xpoz import XpozTwitterSearch, XpozRedditSearch

researcher = Agent(
    role="Social media researcher",
    goal="Answer questions using real social media data",
    backstory="You research social media using the tools provided.",
    tools=[XpozTwitterSearch(), XpozRedditSearch()],
    llm="anthropic/claude-sonnet-4-6",
)

task = Task(
    description="Find recent posts about 'AI agents' on Twitter and summarize the main themes.",
    expected_output="A short summary grounded in real posts.",
    agent=researcher,
)

crew = Crew(agents=[researcher], tasks=[task])
result = crew.kickoff()
print(result)

Using Individual Tools

You can also call tools directly without a crew:

from crewai_xpoz import XpozTwitterSearch

tool = XpozTwitterSearch()
result = tool.run(query="AI agents", limit=5)
print(result)

When a task needs the most recent posts, tell the agent to omit date filters. Tools accept optional date-range parameters, and models sometimes fill them speculatively, which skews results older.

Available Tools

Twitter/X

Tool	Description
`XpozTwitterSearch`	Search posts by keywords, hashtags, or phrases
`XpozTwitterUser`	Get a user profile by username or ID
`XpozTwitterUserPosts`	Get posts by a specific user
`XpozTwitterPostComments`	Get replies on a post
`XpozTwitterSearchUsers`	Search users by name
`XpozTwitterUserConnections`	Get a user’s followers or following
`XpozTwitterUsersByKeywords`	Find users who posted about a topic
`XpozTwitterCountPosts`	Count posts matching a phrase
`XpozTwitterPostsByIds`	Get specific posts by their IDs
`XpozTwitterPostRetweets`	Get retweets of a post
`XpozTwitterPostQuotes`	Get quote tweets of a post
`XpozTwitterPostInteractingUsers`	Get users who retweeted, quoted, or commented on a post
`XpozTwitterUsers`	Get multiple user profiles by usernames or IDs

Instagram

Tool	Description
`XpozInstagramSearch`	Search posts by keywords
`XpozInstagramUser`	Get a user profile by username or ID
`XpozInstagramUserPosts`	Get posts by a specific user
`XpozInstagramPostComments`	Get comments on a post
`XpozInstagramSearchUsers`	Search users by name
`XpozInstagramUsersByKeywords`	Find users who posted about a topic
`XpozInstagramPostsByIds`	Get specific posts by their IDs
`XpozInstagramUserConnections`	Get a user’s followers or following
`XpozInstagramPostInteractingUsers`	Get users who liked or commented on a post

Tool	Description
`XpozRedditSearch`	Search posts by keywords
`XpozRedditUser`	Get a user profile
`XpozRedditPostWithComments`	Get a post with its comment thread
`XpozRedditSearchComments`	Search comments by keywords
`XpozRedditSearchSubreddits`	Search subreddits by name or topic
`XpozRedditSubreddit`	Get a subreddit’s info and recent posts
`XpozRedditUsersByKeywords`	Find users who posted about a topic
`XpozRedditSearchUsers`	Search users by name
`XpozRedditSubredditsByKeywords`	Find subreddits related to a topic

TikTok

Tool	Description
`XpozTiktokSearch`	Search videos by keywords
`XpozTiktokUser`	Get a creator profile by username or ID
`XpozTiktokUserPosts`	Get videos by a specific creator
`XpozTiktokPostComments`	Get comments on a video
`XpozTiktokSearchUsers`	Search creators by name
`XpozTiktokPostsByHashtags`	Search videos by hashtags
`XpozTiktokUsersByKeywords`	Find creators who posted about a topic
`XpozTiktokPostsByIds`	Get specific videos by their IDs
`XpozTiktokUsersByHashtags`	Find creators who posted with specific hashtags

Tracking & Account

Tool	Description
`XpozGetTrackedItems`	List all tracked keywords, users, and hashtags
`XpozAddTrackedItems`	Add items to track across platforms
`XpozRemoveTrackedItems`	Stop tracking items
`XpozAccountDetails`	Get account plan, usage, and billing info

Configuration

All tools accept an optional api_key parameter. If not provided, the XPOZ_API_KEY environment variable is used:

from crewai_xpoz import XpozTwitterSearch

# Using environment variable (recommended)
tool = XpozTwitterSearch()

# Passing API key explicitly
tool = XpozTwitterSearch(api_key="your-access-key")

What You Can Do

Give research agents in a crew live access to posts across Twitter, Instagram, Reddit, and TikTok
Look up user profiles, followers, and engagement metrics mid-task
Split platforms across specialist agents and combine their findings
Track keywords and users for continuous monitoring
Build crews that autonomously research brands, competitors, and trends

Integrations

Setup

Using Individual Tools

Available Tools

Twitter/X

Instagram

Reddit

TikTok

Tracking & Account

Configuration

What You Can Do

Next Steps

MCP Tools

PyPI Package

​Setup

​Using Individual Tools

​Available Tools

​Twitter/X

​Instagram

​Reddit

​TikTok

​Tracking & Account

​Configuration

​What You Can Do

​Next Steps

MCP Tools

PyPI Package

Setup

Using Individual Tools

Available Tools

Twitter/X

Instagram

Reddit

TikTok

Tracking & Account

Configuration

What You Can Do

Next Steps