Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
Twitter/X, Instagram, Reddit & TikTok data for AI agents. Billions of posts. No API keys.
| Endpoint | https://mcp.xpoz.ai/mcp (streamable-http) |
|---|---|
| Registry version | 1.4.1 |
| Now | 52 tools · grade F (24) · pin ts_fde274efc27dee521a711f7f5ed603e0 · protocol 2025-06-18 |
| First / last listed | 2026-11-02 02:44 UTC / 2026-11-02 02:44 UTC |
| Grade over time | 2026-11-02: F (24), 52 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: getTwitterUsers getTwitterUser searchTwitterUsers getTwitterUserConnections getTwitterUsersByKeywords getTwitterPostsByIds getTwitterPostsByAuthor getTwitterPostsByKeywords getTwitterPostRetweets getTwitterPostQuotes getTwitterPostComments countTweets getTwitterPostInteractingUsers checkOperationStatus cancelOperation getInstagramPostsByIds getInstagramPostsByUser getInstagramPostsByKeywords getInstagramUser searchInstagramUsers getInstagramUserConnections getInstagramPostInteractingUsers getInstagramUsersByKeywords getInstagramCommentsByPostId getRedditUser searchRedditUsers getRedditUsersByKeywords getRedditPostsByKeywords getRedditPostWithCommentsById getRedditCommentsByKeywords getRedditCommentById searchRedditSubreddits getRedditSubredditWithPostsByName getRedditSubredditsByKeywords getTiktokUser searchTiktokUsers getTiktokUsersByKeywords getTiktokUsersByHashtags getTiktokPostsByIds getTiktokPostsByUser getTiktokPostsByKeywords getTiktokPostsByHashtags searchTiktokSounds getTiktokPostsBySound getTiktokCommentsByPostId getUserAccessKey checkAccessKeyStatus getTrackedItems addTrackedItems removeTrackedItems getAccountDetails getCreditsUsageHistory
getTwitterUsers | Get one or more Twitter user profiles by IDs or usernames (1-100 per request). Use identifierType="id" for numeric user IDs, identifierType="username" for usernames. All identifiers must be the same type. For single user: pass array of 1, e.g. identifiers=["elonmusk"]. For person names or fuzzy search, use searchTwitterUsers instead. PERFORMANCE: More efficient than multiple single calls, but can params: identifiers*, identifierType*, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterUser | Get Twitter user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username (e.g., "elonmusk"). For person names or fuzzy search, use searchTwitterUsers instead. Optional fields parameter for performance (default: ["id", "username", "name"]). Available fields: id, profileImageUrl, profile params: identifier*, identifierType*, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
searchTwitterUsers | Search users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., "Elon Musk", "Sam Altman"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getTwitterUser when username is certain). Optional fields parameter fo params: name*, limit, fields, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterUserConnections | Get Twitter user connections (followers or following). Use connectionType="followers" for users who follow them, connectionType="following" for users they follow. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. PAGING (responseType="paging"): Async paginated results (1000/page params: username*, connectionType*, pageNumber, pageNumberEnd, tableName, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterUsersByKeywords | Search for USERS who authored tweets/comments/quotes/retweets matching keywords. USE CASE: Find users who have posted content about specific topics, keywords, or phrases. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. "paging": Async paginated r params: query*, responseType, limit, pageNumber, pageNumberEnd, tableName, startDate, endDate, language, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterPostsByIds | Get multiple Twitter posts by numeric IDs (1-100 IDs per request). Returns results directly. Returns only found tweets, omitting not-found IDs for flexibility. First searches database, then external API for missing/stale data in parallel. Use when you have multiple exact post IDs. NOT for search - use getTwitterPostsByKeywords. PERFORMANCE: Much more efficient than multiple single-ID calls. Batche params: postIds*, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterPostsByAuthor | Get posts from author by username with multiple response modes. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. params: username*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterPostsByKeywords | Search posts by keywords. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subs params: query*, pageNumber, pageNumberEnd, tableName, startDate, endDate, authorUsername, authorId, language, sortBy, countryCode, filterOutRetweets, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterPostRetweets | Get retweets of specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Database-only. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent pages. params: postId*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterPostQuotes | Get quote posts of specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName params: postId*, pageNumber, pageNumberEnd, tableName, startDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterPostComments | Get comments (replies) to specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tab params: postId*, pageNumber, pageNumberEnd, tableName, startDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
countTweets | Count tweets containing a specific phrase within a date range. Returns the total count of matching tweets (int) directly, or zero if none found. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases ("deep learning"), boolean expressions (AI AND crypto, bitcoin OR ethereum, politics NOT sports), or parenthesized groups ((startup OR entrepreneur) NOT "venture capital"). AND/OR/NOT params: phrase*, startDate, endDate, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTwitterPostInteractingUsers | Get users who interacted with a specific Twitter post (commenters, quoters, or retweeters). INTERACTION TYPES: "commenters" (users who replied to the post), "quoters" (users who quoted the post), "retweeters" (users who retweeted the post). FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback when params: postId*, interactionType*, responseType, limit, startDate, endDate, pageNumber, pageNumberEnd, tableName, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
checkOperationStatus | checkOperationStatus: poll an async operation and retrieve its results or CSV download URL. Use this after any tool call made with responseType="paging" or responseType="csv" — those return an operationId that must be polled via checkOperationStatus to get the actual data. Also handles background job status checks, presigned S3 link retrieval for data dumps, and completion polling for long-running params: operationId*, feedback, _requestId |
cancelOperation | Cancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. Use checkOperationStatus to verify cancellation completed. params: operationId*, feedback, _requestId |
getInstagramPostsByIds | Get multiple Instagram posts by IDs (1-50 IDs per request). Returns results directly. Returns only found posts, omitting not-found IDs for flexibility. First searches database, then external API for missing/stale data in parallel. Use when you have multiple exact post IDs. NOT for search - use getInstagramPostsByKeywords. PERFORMANCE: Much more efficient than multiple single-ID calls. Batches data params: postIds*, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getInstagramPostsByUser | Get posts from Instagram user by ID or username with two response modes. Use identifierType="id" for numeric user ID, identifierType="username" for username. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): params: identifier*, identifierType*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getInstagramPostsByKeywords | Search Instagram posts by keywords with two response modes. Searches in both post captions and video subtitles. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100/page), returns op params: query*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getInstagramUser | Get Instagram user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username (e.g., "cristiano"). For person names or fuzzy search, use searchInstagramUsers instead. Optional fields parameter for performance (default: ["id", "username", "fullName"]). Available fields: id, username, fullN params: identifier*, identifierType*, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
searchInstagramUsers | Search users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., "Cristiano Ronaldo", "Kim Kardashian"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getInstagramUser when username is certain). Optional field params: name*, limit, fields, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getInstagramUserConnections | Get Instagram user connections (followers or following). Use connectionType="followers" for users who follow them, connectionType="following" for users they follow. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. PAGING (responseType="paging"): Async paginated results (100 user params: username*, connectionType*, pageNumber, pageNumberEnd, tableName, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getInstagramPostInteractingUsers | Get USER PROFILES of people who interacted with an Instagram post. Returns full user data (bio, followerCount, followingCount, etc.). RETURNS USER PROFILES: id, username, fullName, biography, followerCount, followingCount, isVerified, profilePicUrl. Use for analyzing WHO engaged with a post. NOT FOR COMMENT TEXT: To read the actual comment content (what people wrote), use getInstagramCommentsByPos params: postId*, interactionType*, responseType, limit, pageNumber, pageNumberEnd, tableName, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getInstagramUsersByKeywords | Search for USERS who authored Instagram posts matching keywords. USE CASE: Find users who have posted content about specific topics, keywords, or phrases. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. "paging": Async paginated results (100/page params: query*, responseType, limit, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getInstagramCommentsByPostId | Get COMMENT CONTENT (text, likes) for an Instagram post. Returns the actual comment objects with text and metadata. RETURNS COMMENT DATA: id, text, username, createdAtDate, likeCount, childCommentCount. Use for reading what people said. NOT FOR USER PROFILES: To get detailed user profiles (bio, followerCount, followingCount) of commenters, use getInstagramPostInteractingUsers with interactionType= params: postId*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getRedditUser | Get Reddit user profile by username. Returns user profile including karma breakdown (link, comment, total), account status (gold, mod, employee), and profile info. Use without u/ prefix (e.g., "spez" not "u/spez"). Optional fields parameter for performance (default: ["id", "username", "totalKarma"]). Available fields: id, username, profileUrl, profilePicUrl, snoovatarImg, linkKarma, commentKarma, params: username*, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
searchRedditUsers | Search Reddit users by name, username, or profile description using real-time external API. PRIMARY USE: When given a person's name (e.g., "spez", "GallowBoob"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getRedditUser when username is certain). Optional fields parameter for pe params: name*, limit, fields, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getRedditUsersByKeywords | Search for USERS who authored Reddit posts matching keywords. USE CASE: Find users who have posted content about specific topics. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. "paging": Async paginated results (100/page). Returns operation ID - params: query*, responseType, limit, pageNumber, pageNumberEnd, tableName, startDate, endDate, subreddit, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getRedditPostsByKeywords | Search Reddit posts by keywords with two response modes. Searches in post titles and selftext. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for pol params: query*, pageNumber, pageNumberEnd, tableName, startDate, endDate, sort, time, subreddit, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getRedditPostWithCommentsById | Get Reddit post by ID with its comments. Returns both the post data and comments in a single response. FAST (default, omit responseType or responseType="fast"): Returns post and up to 300 comments directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100 comments/page), params: postId*, postFields, commentFields, pageNumber, pageNumberEnd, tableName, forceLatest, responseType, limit, feedback, _requestId, _isTrial, _trialToken |
getRedditCommentsByKeywords | Search Reddit comments by keywords. Searches in comment body text. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName f params: query*, pageNumber, pageNumberEnd, tableName, startDate, endDate, subreddit, fields, responseType, limit, feedback, _requestId, _isTrial, _trialToken |
getRedditCommentById | Get a single Reddit comment by its ID. Accepts the bare base36 comment id or the t1_-prefixed form (e.g. "laz1ytq" or "t1_laz1ytq"), as returned by getRedditPostWithCommentsById and getRedditCommentsByKeywords. First searches database, then fetches from the external API if the comment is missing or stale (>1 week). NOT for searching - use getRedditCommentsByKeywords for keyword search. Optional fi params: commentId*, fields, forceLatest, feedback, _requestId, _isTrial, _trialToken |
searchRedditSubreddits | Search Reddit subreddits by keywords using real-time external API. Searches subreddit names and descriptions to find communities. Use for: Discovering communities about topics, finding niche subreddits, exploring Reddit communities. Optional fields parameter for performance (default: ["id", "displayName", "title", "subscribersCount"]). Available fields: id, displayName, title, publicDescription, d params: query*, limit, fields, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getRedditSubredditWithPostsByName | Get Reddit subreddit by name with its posts. FAST (default, omit responseType or responseType="fast"): Returns subreddit data with up to 300 posts directly (use limit param to reduce). Auto API fallback for fresh data. PAGING (responseType="paging"): Async paginated results (100 posts per page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName for subsequent params: subredditName*, subredditFields, postFields, pageNumber, pageNumberEnd, tableName, forceLatest, responseType, limit, feedback, _requestId, _isTrial, _trialToken |
getRedditSubredditsByKeywords | Search for SUBREDDITS where Reddit posts match keywords. Returns unique, deduplicated subreddit profiles. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce). Auto API fallback for fresh data. PAGING (responseType="paging"): Async paginated results (100 per page), returns operationId for polling via checkOperationStatus. Supports params: query*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokUser | Get Tiktok user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username. For person names or fuzzy search, use searchTiktokUsers instead. Optional fields parameter for performance (default: ["id", "username", "nickname"]). Available fields: id, username, nickname, signature, isPrivate, params: identifier*, identifierType*, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
searchTiktokUsers | Search Tiktok users by name or username via external API. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getTiktokUser when username is certain). Optional fields parameter for performance (default: ["id", "username", "nickname"]). Returns: array of matching users (default 10, max 10). This is a safe, read-only tool fo params: name*, limit, fields, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokUsersByKeywords | Search for USERS who authored Tiktok posts matching keywords. USE CASE: Find users who have posted content about specific topics. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 results directly in one call. Use limit param to reduce. Best for quick lookups. "paging": Async paginated results (100/page). Returns operation ID - params: query*, responseType, limit, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokUsersByHashtags | Search for USERS who authored Tiktok posts tagged with specific hashtags. USE CASE: Find users who have posted content tagged with one or more hashtags. Returns unique, deduplicated user profiles. Pass hashtags as an array of bare alphanumeric strings - do NOT include leading "#". OR semantics: matches users who posted content tagged with ANY of the listed hashtags. RESPONSE MODES (responseType pa params: hashtags*, responseType, limit, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokPostsByIds | Get multiple Tiktok posts by IDs (1-100 IDs per request). Returns results directly. First searches database, then external API for missing/stale data. Optional fields parameter for performance: ["id", "description", "likeCount"]. Returns: results array with id, description, userId, username, createdAtDate, engagement metrics. This is a safe, read-only tool for analyzing searchable information. params: postIds*, fields, forceLatest, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokPostsByUser | Get posts from Tiktok user by ID or username with three response modes. Use identifierType="id" for numeric user ID, identifierType="username" for username. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): A params: identifier*, identifierType*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokPostsByKeywords | Search Tiktok posts by keywords with three response modes. Searches post descriptions and video transcripts. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Supports pageNumber/tableName params: query*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokPostsByHashtags | Search Tiktok posts by hashtags with three response modes. Searches the hashtags column directly (NOT post descriptions). Pass hashtags as an array of bare alphanumeric strings - do NOT include leading "#". OR semantics: matches posts containing ANY of the listed hashtags. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. params: hashtags*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
searchTiktokSounds | Search Tiktok sounds/music by keyword. Use to discover sound/music objects (by title, artist, or album), then pass the returned id to getTiktokPostsBySound to find posts using that sound. Optional fields parameter (default: ["id", "title", "author", "userCount"]). Returns: array of sounds (up to 300) with id, title, author, userCount. This is a safe, read-only tool for analyzing searchable informa params: keyword*, limit, fields, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokPostsBySound | Get Tiktok posts that use a specific sound/music with three response modes. Required: soundId (numeric ID from searchTiktokSounds). FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (responseType="paging"): Async paginated results (100/page), returns operationId for polling via checkOperationStatus. Suppor params: soundId*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getTiktokCommentsByPostId | Get COMMENT CONTENT (text, likes) for a Tiktok post. Returns the actual comment objects with text and metadata. RETURNS COMMENT DATA: id, text, username, createdAtDate, likeCount. Use for reading what people said. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. PAGING (response params: postId*, pageNumber, pageNumberEnd, tableName, startDate, endDate, fields, forceLatest, responseType, limit, userPrompt, feedback, _requestId, _isTrial, _trialToken |
getUserAccessKey | Retrieve authenticated user access key. Required: authentication, confirmation. Returns: access key, metadata. params: confirmRetrieval*, feedback, _requestId |
checkAccessKeyStatus | Check access key status without revealing key. Required: authentication. Returns: status, metadata. params: feedback, _requestId |
getTrackedItems | Get tracked keywords and users. Returns: phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. params: feedback, _requestId, _isTrial, _trialToken |
addTrackedItems | Add keywords/users to track. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Returns error if plan limit exceeded. params: items*, feedback, _requestId, _isTrial, _trialToken |
removeTrackedItems | Remove tracked keywords/users. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Use getTrackedItems first to see current items. params: items*, feedback, _requestId, _isTrial, _trialToken |
getAccountDetails | Get authenticated user's account details: plan (name, features), billing (period, next renewal date; null for Free plan), and usage (subscription credits remaining, extra credits remaining, extra tracked items). Required: authentication. Returns: nested plan/billing/usage object. params: feedback, _requestId |
getCreditsUsageHistory | Get authenticated user's credits and export-rows usage over time, for analyzing usage patterns. Params: range ("today" | "7d" | "current_month" | "lifetime", default current_month), granularity ("hour" | "day", default day). Returns time-series buckets for both credits and exportRows, each with subscriptionUsed, extraUsed, totalUsed, extraPurchased. Use for trend analysis and spotting usage spikes params: range, granularity, feedback, _requestId |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.