Xpoz - Social Media Intelligence

Access data from Twitter/X, Instagram, Reddit, and TikTok through the Xpoz platform. Search for users, posts, comments, followers, and more — all from a single Apify Actor.

What is Xpoz?

Xpoz is a social media intelligence platform that provides structured access to data across major social networks. This Actor wraps the Xpoz TypeScript SDK to make all capabilities available directly from Apify.

Getting Started

1. Try it now — run the Actor without an API key to get a preview with limited results (max 5) and narrower data coverage
2. Get an API key at xpoz.ai/get-token for full access with unlimited results and optimal data coverage
3. Run this Actor with your API key, platform, and action
4. Download results from the Apify dataset as JSON, CSV, or Excel

Supported Platforms & Actions

Twitter / X

Action	Description
getUser	Get a single user profile by username or ID
getUsers	Get multiple user profiles at once
searchUsers	Search users by name
getUserConnections	Get a user's followers or following list
getUsersByKeywords	Find users by keyword search
getPostsByIds	Get specific tweets by their IDs
getPostsByAuthor	Get all tweets by a specific user
searchPosts	Search tweets by keywords
getRetweets	Get retweets of a specific tweet
getQuotes	Get quote tweets of a specific tweet
getComments	Get replies to a specific tweet
getPostInteractingUsers	Get users who liked, retweeted, or replied to a tweet
countPosts	Count tweets matching a search query

Instagram

Action	Description
getUser	Get a user profile by username or ID
searchUsers	Search users by name
getUserConnections	Get a user's followers or following list
getPostInteractingUsers	Get users who interacted with a post
getUsersByKeywords	Find users by keyword search
getPostsByIds	Get specific posts by their IDs
getPostsByUser	Get all posts by a specific user
searchPosts	Search posts by keywords
getComments	Get comments on a specific post

Reddit

Action	Description
getUser	Get a user profile
searchUsers	Search users by name
getUsersByKeywords	Find users by keyword search
searchSubreddits	Search subreddits by name
getSubredditsByKeywords	Find subreddits by keyword search
getSubredditWithPosts	Get a subreddit's info and recent posts
searchPosts	Search posts by keywords
getPostWithComments	Get a post and its comments
searchComments	Search comments by keywords

TikTok

Action	Description
getUser	Get a user profile by username or ID
searchUsers	Search users by name
getUsersByKeywords	Find users by keyword search
getUsersByHashtags	Find users posting with specific hashtags
getPostsByIds	Get specific posts by their IDs
getPostsByUser	Get all posts by a specific user
searchPosts	Search posts by keywords
getPostsByHashtags	Get posts with specific hashtags
getComments	Get comments on a specific post

Tracking

Action	Description
getTrackedItems	List all your tracked keywords, users, and hashtags
addTrackedItems	Add items to your tracking list
removeTrackedItems	Remove items from your tracking list

Input Parameters

Parameter	Type	Required	Description
apiKey	string	Yes	Your Xpoz API key
platform	string	Yes	Platform: twitter, instagram, reddit, tiktok, or tracking
action	string	Yes	Action to perform (see tables above)
identifier	string	Depends	Username, post ID, search query, or subreddit name
identifiers	string[]	Depends	Multiple IDs (for getUsers, getPostsByIds)
identifierType	string	No	username (default) or id
connectionType	string	Depends	followers or following (for getUserConnections)
interactionType	string	Depends	likes, retweets, replies, or comments
hashtags	string[]	Depends	Hashtags without # (for TikTok hashtag actions)
subreddit	string	No	Filter Reddit results to a specific subreddit
startDate	string	No	Start date filter (YYYY-MM-DD)
endDate	string	No	End date filter (YYYY-MM-DD)
limit	integer	No	Maximum number of results
fields	string[]	No	Specific fields to include (empty = all)
forceLatest	boolean	No	Force fresh data instead of cached
fetchAllPages	boolean	No	Fetch all pages of results (default: first page only)
sort	string	No	Reddit sort order: new, hot, top, controversial, rising
time	string	No	Reddit time range: hour, day, week, month, year, all
language	string	No	Language code filter (e.g., en, es)
filterOutRetweets	boolean	No	Exclude retweets from Twitter search

Example Use Cases

Find influencers talking about AI on Twitter:

• Platform: twitter | Action: getUsersByKeywords | Identifier: artificial intelligence | Start Date: 2025-01-01

Export all posts from an Instagram account:

• Platform: instagram | Action: getPostsByUser | Identifier: natgeo | Fetch All Pages: true

Monitor Reddit discussions about your brand:

• Platform: reddit | Action: searchPosts | Identifier: your brand name | Sort: new

Get trending TikTok content by hashtag:

• Platform: tiktok | Action: getPostsByHashtags | Hashtags: trending, viral

Output

Results are pushed to the default Apify dataset. Each item in the dataset corresponds to a user, post, comment, or other entity depending on the action. Download results as JSON, CSV, or Excel from the Apify console.

For paginated results, pagination metadata (total rows, total pages) is stored in the key-value store under the key PAGINATION_INFO.

Pricing

This Actor is free. You only pay for Apify platform usage (compute time) and your Xpoz API plan. The Actor is usable without an API key, but results will be very limited (max 5 items per request) with narrower data coverage. Get your API key at xpoz.ai/get-token for unlimited results and optimal data coverage.

Support

• Xpoz documentation: docs.xpoz.ai
• Email: support@xpoz.ai