{"id":"ai.xpoz/social-insights","slug":"ai-xpoz-social-insights","title":"Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)","description":"Twitter/X, Instagram, Reddit & TikTok data for AI agents. Billions of posts. No API keys.","version":"1.4.1","publisher":{"kind":"domain","id":"xpoz.ai","label":"xpoz.ai","url":"https://xpoz.ai"},"website":"https://www.xpoz.ai","repository":"https://github.com/xpozpublic/xpoz-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.xpoz.ai/mcp"}],"packages":[],"published":"2026-07-14","updated":"2026-07-14","status":"online","auth":"","latency_ms":1485,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"getTwitterUsers","title":"Twitter: Get Users","description":"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 ","read_only":true},{"name":"getTwitterUser","title":"Twitter: Get User","description":"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","read_only":true},{"name":"searchTwitterUsers","title":"Twitter: Search Users","description":"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","read_only":true},{"name":"getTwitterUserConnections","title":"Twitter: Get User Connections","description":"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 ","read_only":true},{"name":"getTwitterUsersByKeywords","title":"Twitter: Get Users by Keywords","description":"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","read_only":true},{"name":"getTwitterPostsByIds","title":"Twitter: Get Posts by IDs","description":"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","read_only":true},{"name":"getTwitterPostsByAuthor","title":"Twitter: Get Posts by Author","description":"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. ","read_only":true},{"name":"getTwitterPostsByKeywords","title":"Twitter: Search Posts","description":"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","read_only":true},{"name":"getTwitterPostRetweets","title":"Twitter: Get Retweets","description":"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. ","read_only":true},{"name":"getTwitterPostQuotes","title":"Twitter: Get Quote Posts","description":"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 ","read_only":true},{"name":"getTwitterPostComments","title":"Twitter: Get Post Comments","description":"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","read_only":true},{"name":"countTweets","title":"Twitter: Count Tweets","description":"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 ","read_only":true},{"name":"getTwitterPostInteractingUsers","title":"Twitter: Get Post Interacting Users","description":"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 ","read_only":true},{"name":"checkOperationStatus","title":"Operations: Check Status","description":"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","read_only":true},{"name":"cancelOperation","title":"Operations: Cancel","description":"Cancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. Use checkOperationStatus to verify cancellation completed.","read_only":false},{"name":"getInstagramPostsByIds","title":"Instagram: Get Posts by IDs","description":"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","read_only":true},{"name":"getInstagramPostsByUser","title":"Instagram: Get Posts by User","description":"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\"): ","read_only":true},{"name":"getInstagramPostsByKeywords","title":"Instagram: Get Posts by Keywords","description":"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","read_only":true},{"name":"getInstagramUser","title":"Instagram: Get User","description":"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","read_only":true},{"name":"searchInstagramUsers","title":"Instagram: Search Users","description":"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","read_only":true},{"name":"getInstagramUserConnections","title":"Instagram: Get User Connections","description":"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","read_only":true},{"name":"getInstagramPostInteractingUsers","title":"Instagram: Get Post Interacting Users","description":"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","read_only":true},{"name":"getInstagramUsersByKeywords","title":"Instagram: Get Users by Keywords","description":"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","read_only":true},{"name":"getInstagramCommentsByPostId","title":"Instagram: Get Post Comments","description":"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=","read_only":true},{"name":"getRedditUser","title":"Reddit: Get User","description":"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, ","read_only":true},{"name":"searchRedditUsers","title":"Reddit: Search Users","description":"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","read_only":true},{"name":"getRedditUsersByKeywords","title":"Reddit: Get Users by Keywords","description":"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 -","read_only":true},{"name":"getRedditPostsByKeywords","title":"Reddit: Get Posts by Keywords","description":"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","read_only":true},{"name":"getRedditPostWithCommentsById","title":"Reddit: Get Post with Comments by ID","description":"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), ","read_only":true},{"name":"getRedditCommentsByKeywords","title":"Reddit: Get Comments by Keywords","description":"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","read_only":true},{"name":"getRedditCommentById","title":"Reddit: Get Comment by ID","description":"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","read_only":true},{"name":"searchRedditSubreddits","title":"Reddit: Search Subreddits","description":"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","read_only":true},{"name":"getRedditSubredditWithPostsByName","title":"Reddit: Get Subreddit with Posts by Name","description":"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 ","read_only":true},{"name":"getRedditSubredditsByKeywords","title":"Reddit: Get Subreddits by Keywords","description":"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","read_only":true},{"name":"getTiktokUser","title":"Tiktok: Get User","description":"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,","read_only":true},{"name":"searchTiktokUsers","title":"Tiktok: Search Users","description":"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","read_only":true},{"name":"getTiktokUsersByKeywords","title":"Tiktok: Get Users by Keywords","description":"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 -","read_only":true},{"name":"getTiktokUsersByHashtags","title":"Tiktok: Get Users by Hashtags","description":"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","read_only":true},{"name":"getTiktokPostsByIds","title":"Tiktok: Get Posts by IDs","description":"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. ","read_only":true},{"name":"getTiktokPostsByUser","title":"Tiktok: Get Posts by User","description":"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","read_only":true},{"name":"getTiktokPostsByKeywords","title":"Tiktok: Get Posts by Keywords","description":"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","read_only":true},{"name":"getTiktokPostsByHashtags","title":"Tiktok: Get Posts by Hashtags","description":"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. ","read_only":true},{"name":"searchTiktokSounds","title":"Tiktok: Search Sounds","description":"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","read_only":true},{"name":"getTiktokPostsBySound","title":"Tiktok: Get Posts by Sound","description":"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","read_only":true},{"name":"getTiktokCommentsByPostId","title":"Tiktok: Get Post Comments","description":"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","read_only":true},{"name":"getUserAccessKey","title":"Auth: Get User Access Key","description":"Retrieve authenticated user access key. Required: authentication, confirmation. Returns: access key, metadata.","read_only":true},{"name":"checkAccessKeyStatus","title":"Auth: Check Access Key Status","description":"Check access key status without revealing key. Required: authentication. Returns: status, metadata.","read_only":true},{"name":"getTrackedItems","title":"Tracking: Get Tracked Items","description":"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.","read_only":true},{"name":"addTrackedItems","title":"Tracking: Add Tracked Items","description":"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.","read_only":false},{"name":"removeTrackedItems","title":"Tracking: Remove Tracked Items","description":"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.","read_only":false},{"name":"getAccountDetails","title":"Account: Get Account Details","description":"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.","read_only":true},{"name":"getCreditsUsageHistory","title":"Account: Get Credits Usage History","description":"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","read_only":true}],"server_info":{"name":"xpoz-mcp","version":"3.0.0","instructions":"Xpoz MCP provides read-only access to Twitter/X, Instagram, and Reddit social media data. Use it for user lookups, post searches, engagement analysis, and trend discovery. All tools are safe and read-only. For post searches, use the fields parameter to select only needed fields for better performance. Paginated results return a tableName for fetching subsequent pages.","capabilities":{"tools":{},"prompts":{},"resources":{}}},"category":"social","tags":["web-search","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-14","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/ai-xpoz-social-insights/"}