Xpoz - TikTok Scraper

Access TikTok data through the Xpoz platform. Search for users, posts, comments, hashtags, and more — all from a single Apify Actor.

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 and action
4. Download results from the Apify dataset as JSON, CSV, or Excel

Actions

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

Input Parameters

Parameter	Type	Required	Description
apiKey	string	Yes	Your Xpoz API key
action	string	Yes	Action to perform (see table above)
identifier	string	Depends	Username, post ID, or search query depending on the action
identifiers	string[]	Depends	Multiple post IDs (for getPostsByIds)
identifierType	string	No	username (default) or id
hashtags	string[]	Depends	Hashtags without # (for getUsersByHashtags, getPostsByHashtags)
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)

Example Use Cases

Find trending creators by hashtag:

• Action: getUsersByHashtags | Hashtags: trending, viral | Limit: 50

Search TikTok posts by hashtag:

• Action: getPostsByHashtags | Hashtags: fitness, workout | Start Date: 2025-01-01

Analyze content from a specific creator:

• Action: getPostsByUser | Identifier: charlidamelio | Fetch All Pages: true

Monitor competitor activity:

• Action: getPostsByUser | Identifier: competitor_username | Force Latest: true

Search for niche creators:

• Action: getUsersByKeywords | Identifier: plant based recipes | Limit: 100

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