find_influential_users
Read-only
Search recent posts on a topic to discover influential accounts ranked by followers, engagement, or relevance. Ideal for topic-driven discovery of high-reach users.
Instructions
Find influential users in a topic or network by searching recent posts and ranking their authors. Works without authentication; richer with auth. Read-only — produces no side effects. Use this instead of find_similar_users when you want topic-driven discovery of high-reach accounts rather than a specific user's social graph. Subject to per-tool rate limiting.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | No | Topic keyword(s) to search for (e.g. "climate change"). Used as the search query when searchQuery is not provided. | |
| searchQuery | No | Explicit search query string. When provided, takes precedence over topic. At least one of topic or searchQuery must be supplied. | |
| minFollowers | No | Minimum follower count a user must have to be included in results (default 100). | |
| maxResults | No | Maximum number of users to return (1–50, default 20). | |
| sortBy | No | Sort order for results: "followers" (by follower count), "engagement" (by computed influence score), or "relevance" (by how many matched posts are from that user). Default "followers". | followers |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | Yes | Whether the operation completed successfully. | |
| query | Yes | The search query that was used. | |
| users | Yes | List of influential users found, sorted per the sortBy parameter. | |
| insights | Yes | Human-readable insight strings summarising the results. |