# Moni Discover API Documentation > Documentation for Moni Discover API ## API Reference - [🧿 Overview](https://moni-discover-api.readme.io/reference/overview.md): Welcome to Moni API – a powerful Social Intelligence Layer for web3 data and narrative signals — built for developers who need seamless integration and advanced analysis capabilities. Our API provides structured access to key social metrics, enabling businesses, analysts, and developers to enhance their products with data-driven insights. - [💵 API Costs](https://moni-discover-api.readme.io/reference/api-costs.md): The Moni API is designed to flexibly support your data needs – whether you’re a solo developer or an enterprise handling large-scale requests. Each plan includes a set of API endpoints, monthly point limits, rate limits, and access to historical data. Get in touch with our sales team, and we’ll help you find the right plan to match your workflow and grow with confidence. - [💳 Usage Costs](https://moni-discover-api.readme.io/reference/usage-costs.md) - [Indexing List](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-tracker-tweet.md): **Description**: Returns the list of accounts where tweets indexing is active **Usage Cost**: free of charge - [Stop Indexing](https://moni-discover-api.readme.io/reference/delete_api-v3-accounts-username-tracker-tweet.md): **Description**: Stops the indexing of posts from an account. **Usage Cost**: free of charge - [Start Indexing](https://moni-discover-api.readme.io/reference/put_api-v3-accounts-username-tracker-tweet.md): **Description**: Initiates the indexing of posts from a account. Once indexing is complete, the posts can be retrieved using GET method with feed & tweets category endpoints. **Usage Cost**: 10 - [Event List](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-feed-events.md): **Description**: Retrieves **a list of major events** related to a specific account, tracking key changes in its activity such as: - **Bio updates** – name, description, or handle changes (`NEW_BIO`). - **Major events** – significant activities detected by Moni Discover (`NEW_MAJOR_EVENT`) You can **filter events by type and date range**, as well as **sort them by time or event category**. The endpoint has **limits** – up to **100 events in the list per request**. **Usage**: This endpoint provides a timeline of key account updates, useful for tracking activity trends and engagement shifts. Monitor profile updates & major activity changes in real-time. Analyze historical events to detect good or bad behavioral patterns. **Usage Cost**: 3 points per request - [Smart Mentions Feed](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-feed-smart-mentions.md): **Description**: Retrieves **a list of tweets mentioning a given account**, but **only from smarts**.This endpoint helps analyze how high-quality Web3 participants interact with an account and track narrative shifts among smart audiences. Filter tweets by date range. The endpoint has **limits** – up to **100 tweets in the list per request**. **Usage**: Use to Monitor how smarts mention your account, Identify key influencers talking about a project. **Usage Cost**: 4 points per request - [Full Feed Info](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-feed-tweets-full.md): **Description**: Retrieves **a complete list of indexed tweets** from a given specific account feed. - **Tweet metadata** – ID. This endpoint provides full access to an account's historical tweets. You Filter tweets by post IDs range. The endpoint has **limits** – up to **100 tweets in the list per request.** ⚡ **Important**: To enable tweet indexing for an account, you must first send a **PUT request** to `/api/v3/accounts/{username}/tracker/tweet/`. **Usage**: Use to Retrieve all indexed tweets from an account with engagement stats. Analyze post performance based on likes, retweets, and views. Monitor historical tweet activity for trend analysis. Extract useful tweet info to make better decisions. **Usage Cost**: 5 points per request - [Mentions History](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-history-mentions-count.md): **Description**: Provides **historical data** on the **total number of mentions** for a specific account. - **Graph-ready data** – structured for **date vs. mention count** visualization. - **Change tracking** – see how mention frequency evolves over time. - **Custom timeframes** – query by last **1H, 24H, 7D, 30D, 90D, 180D, or 1Y**. **Usage**: Use this endpoint to analyze audience engagement trends and detect spikes in attention. Build historical mention charts for tracking engagement. Identify sudden spikes in visibility (viral moments, controversy, promotions). Compare mentions of trends across different timeframes. **Usage Cost**: 2 points per request **Timeframe**: The time range for the returned data. Possible values: - `H1` - Last 1 hour - `H24` - Last 24 hours - `D7` - Last 7 days - `D30` - Last 30 days - `D90` - Last 90 days - `D180` - Last 180 days - `Y1` - Last 1 year - [Smart Mentions History](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-history-smart-mentions-count.md): **Description**: Provides **historical data** on the number of **Smart Mentions** for a specific account. These mentions come from **"smart" accounts**, manually curated by moderators. - **Graph-ready data** – structured for **date vs. mention** count visualization. - **Smart mentions tracking** – see how often key accounts reference this profile. - **Custom timeframes** – query by last **1H, 24H, 7D, 30D, 90D, 180D, or 1Y**. **Usage**: Use this endpoint to analyze engagement from influential users and track shifts in relevance within the smart audience. Monitor mentions from high-value, curated accounts. Identify spikes in attention from smart users. Compare smart mentions across different timeframes. **Usage Cost**: 4 points per request **Timeframe**: The time range for the returned data. Possible values: - `H1` - Last 1 hour - `H24` - Last 24 hours - `D7` - Last 7 days - `D30` - Last 30 days - `D90` - Last 90 days - `D180` - Last 180 days - `Y1` - Last 1 year - [Smarts History](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-history-smarts-count.md): **Description**: Provides **historical data** on the number of **smarts** (manually curated by moderators) associated/interacted with a specific account. - **Graph-ready data** – structured for **date vs. smarts count** visualization. - **Smart change tracking** – see new additions & removals over time. - **Custom timeframes** – query by last **1H, 24H, 7D, 30D, 90D, 180D, or 1Y**. **Usage**: Use this endpoint to analyze long or short-term smarts attention growth trends & dynamics. Build historical charts of smarts. Identify growth spikes & declines over time. Compare smart trends across different timeframes. **Usage Cost**: 4 points per request **Timeframe**: The time range for the returned data. Possible values: - `H1` - Last 1 hour - `H24` - Last 24 hours - `D7` - Last 7 days - `D30` - Last 30 days - `D90` - Last 90 days - `D180` - Last 180 days - `Y1` - Last 1 year - [Full Account Info](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-info-full.md): **Description**: Retrieves **detailed insights** about a specific account using its username. The response includes: - **Profile metadata** – ID. - **Engagement metrics** – smarts count, tweet count, mentions. - **Advanced analytics** – number of Smarts, Smart Mentions and **Moni score**. - **Blockchain & category tagging** – identifies the account’s connection to specific blockchains and assigns tags from algorithm or manual classification by moderators & tiers **(tier from 1 to 3)** smart is tagged and assigned by algorithm & moderators Use this endpoint to analyze **influencers, projects, and community engagement** in Web3. **Usage**: Use to extract full information of any specific account including Moni Score & Social Analytics. Get deep insights into any specific account. **Usage Cost**: 8 points per request - [Account Metadata (ID)](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-info-meta.md): **Description**: Retrieves **basic profile data** of a specific account using its username. The response includes: - **Profile details** – ID. This endpoint provides **only account ID** without advanced social analytics. **Usage**: Use to fetch account ID. **Usage Cost**: 1 points per request - [Account Smart Engagement](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-info-smart-engagement.md): **Description**: Retrieves **only advanced engagement analytics** for a specific account, including: - **Smarts count** – how many smarts interacted with this account. - **Moni score** – our internal account score calculated based on smarts. - **Total mentions** – number of times the account was mentioned. - **Smart mentions** – how often it's mentioned by "smart" accounts. **Usage**: Use this endpoint to analyze an account’s impact, influence, and reach within the smart Web3 community. Identify influential Web3 accounts based on smart audience, measure real engagement vs. bot activity. **Usage Cost**: 5 points per request - [Account Smart Profile](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-info-smart-profile.md): **Description**: Retrieves only **advanced insights** about a specific account, including: - **Smart profile analysis** – internal ranking called **Smart Tier** of account influence. - **Categorization & tags** – labels assigned algorithmically or manually from our moderators. - **Blockchain affiliation** – blockchains associated with the account. - **Profile history** – number of bio updates as a signal of behavioral patterns. **Smart Tier** - is a rank assigned by Moni internal algorithm. There are three tiers based on the "smart" account's rating tiers: 1 - 🧠 2 - 🧠🧠 3 - 🧠🧠🧠 The higher the tier, the greater the account's influence on its audience. **Usage**: Use to access an account’s influence & smart audience presence, detect blockchain-linked accounts in the crypto space, categorize profiles based on moderator-assigned tags & tiers. **Usage Cost**: 2 points per request - [Top Interacted Users](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-interactions-top.md): **Description**: Retrieves top accounts a specific account interacted with through retweets, quote retweets, and comments. The response includes: - **Account metadata** – user ID, URL, username, name, profile image. - **Interaction counters** – retweets, quote retweets, comments and total interactions count. - **Engagement context** – Moni score and smarts count for each interacted account when available. **Usage**: Use this endpoint to understand which accounts a user amplifies, replies to, or references most often. **Usage Cost**: 3 points per request - [Smarts Categories](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-categories.md): **Description**: Retrieves a list of categories associated with the smarts of a given specific account, including the smarts count for each category. **Usage**: Use this endpoint to see which categories dominate an account’s smarts, Identify if an account has more smarts in some specific category, benchmark category distribution across multiple accounts. **Usage Cost**: 1 point per request - [Smarts Tiers](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-distribution-level.md): **Description**: Returns information about the tier distribution of Smarts for a specific account. A "smart" account tier represents its level of influence on generating attention toward a project, as determined by Moni's internal algorithm. There are three tiers based on the "smart" account's rating: 1 - 🧠 2 - 🧠🧠 3 - 🧠🧠🧠 The higher the tier, the greater the account's influence on its audience. **Usage**: Use it to analyze the distribution of Tier 1, 2, and 3 smarts. Compare tier distribution across multiple accounts. Observe changes in high-tier smarts over time. Identify accounts with a strong base of high-tier smarts. **Usage Cost**: 1 point per request - [Smarts Full Info](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-full.md): **Description**: Retrieves the complete list of smarts for a given specific account, providing detailed information about each smart. - **Advanced analytics** – number of Smarts, Smart Mentions and **Moni score**. - **Blockchain & category tagging** – identifies the account’s connection to specific blockchains and assigns tags from algorithm or manual classification by moderators & tiers **(tier from 1 to 3)** smart is tagged and assigned by algorithm & moderators. Order results by **interaction date, moni score or smarts count, category**. The endpoint has **limits** – up to **100 Smarts in the list per request**. **Usage**: Use endpoint to retrieve detailed analytics on an account’s smarts. Filter & sort smarts based on influence and engagement. Build custom leaderboards & audience segmentation. **Usage Cost**: 5 points per request - [Smarts Metadata (ID)](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-meta.md): **Description**: Retrieves **a list of all smarts** for a given specific account, providing only basic profile data: - **Profile details** – ID. Order results by **interaction date, moni score or smarts count, category**. The endpoint has **limits** – up to **100 Smarts in the list per request**. **Usage**: Use to fetch a simple list of smarts with key profile details. Filter & sort smarts by relevance, growth, or influence. Use for quick lookups and bulk audience processing. **Usage Cost**: 1 point per request - [Smarts Engagement](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-smart-engagement.md): **Description**: Retrieves **a list of all Smarts** for a given specific account, focusing on **engagement and influence metrics of Smarts such as**: - **Smarts count** – how many "smart" users interacted with this account. - **Moni score** – our internal account score calculated based on smarts. - **Total mentions** – number of times the account was mentioned. - **Smart mentions** – how often it's mentioned by "smart" accounts. Order results by **interaction date, moni score, or category**. The endpoint has **limits** – up to **100 Smarts in the list per request**. This endpoint is useful for **analyzing the activity, relevance, and network strength of an account**. **Usage**: This endpoint is useful for analyzing the activity, relevance, and network strength of an account. Use it to Identify highly engaged accounts based on their own smart mentions & smarts network. Use for targeted influencer analysis & outreach. **Usage Cost**: 3 points per request - [Smarts Smart Profile](https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-smart-profile.md): **Description**: Retrieves **a list of all Smarts** for a given specific account, focusing on **tier classification and tagging**. - **Smart profile analysis** – internal ranking called **Smart Tier** of account influence. - **Categorization & tags** – labels assigned algorithmically or manually from our moderators. - **Blockchain affiliation** – blockchains associated with the account. - **Profile history** – number of bio updates as a signal of behavioral patterns. **Smart Tier** - is a rank assigned by Moni internal algorithm. There are three tiers based on the "smart" account's rating tiers: 1 - 🧠 2 - 🧠🧠 3 - 🧠🧠🧠 The higher the tier, the greater the account's influence on its audience. Order results by **interaction date, moni score or smarts count, category**. The endpoint has **limits** – up to **100 Smarts in the list per request**. **Usage**: This endpoint is ideal for segmenting smarts based on influence and niche. Retrieve tiered lists of smarts for influence analysis. Filter & sort smart by tags, score, and engagement level. Use for audience segmentation and targeted outreach. **Usage Cost**: 1 point per request - [Category Mindshare](https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-categories.md): **Description**: Provides category mindshare analytics. **Usage**: Use this endpoint to understand which narratives are most discussed by smart money within the selected timeframe. Use `api/v3/basics/project_categories/` to get all available project categories Use `api/v3/basics/project_chains/` to get all available project chains. Use `api/v3/basics/smart_tag_categories/` to get all available smart tag categories. **Usage Cost**: 1 points per category **Timeframe**: The time range for the returned data. Possible values: - `H1` - Last 1 hour - `H24` - Last 24 hours - `D7` - Last 7 days - `D30` - Last 30 days - `D90` - Last 90 days - `D180` - Last 180 days - `Y1` - Last 1 year - [Chains Mindshare](https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-chains.md): **Description**: Provides chain mindshare analytics. **Usage**: Use this endpoint to understand which chains are most discussed by smart money within the selected timeframe. Use `api/v3/basics/project_categories/` to get all available project categories Use `api/v3/basics/project_chains/` to get all available project chains. Use `api/v3/basics/smart_tag_categories/` to get all available smart tag categories. **Usage Cost**: 1 points per chain **Timeframe**: The time range for the returned data. Possible values: - `H1` - Last 1 hour - `H24` - Last 24 hours - `D7` - Last 7 days - `D30` - Last 30 days - `D90` - Last 90 days - `D180` - Last 180 days - `Y1` - Last 1 year - [Projects Mindshare](https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-projects.md): **Description**: Provides project mindshare analytics. **Usage**: Use this endpoint to understand which projects are most discussed by smarts within the selected timeframe. Use `api/v3/basics/project_categories/` to get all available project categories Use `api/v3/basics/project_chains/` to get all available project chains. Use `api/v3/basics/smart_tag_categories/` to get all available smart tag categories. **Usage Cost**: 1 point per project + 50 points per project in the forAccounts parameter **Timeframe**: The time range for the returned data. Possible values: - `H1` - Last 1 hour - `H24` - Last 24 hours - `D7` - Last 7 days - `D30` - Last 30 days - `D90` - Last 90 days - `D180` - Last 180 days - `Y1` - Last 1 year - [Categories for Mindshare](https://moni-discover-api.readme.io/reference/get_api-v3-basics-project-categories.md): **Description**: Provides all available project categories **Usage**: Use this endpoint to get the full list of project categories. **Usage Cost**: 0 point - [Chains for Mindshare](https://moni-discover-api.readme.io/reference/get_api-v3-basics-project-chains.md): **Description**: Provides all available project chains **Usage**: Use this endpoint to get the full list of chains. **Usage Cost**: 0 point - [Smarts for Mindshare](https://moni-discover-api.readme.io/reference/get_api-v3-basics-smart-tag-categories.md): **Description**: Provides all available smart tag categories **Usage**: Use this endpoint to get the full list of smart categories. **Usage Cost**: 0 point - [Chat Conversations List](https://moni-discover-api.readme.io/reference/get_api-v3-chat-conversations.md): **Description**: Returns AI chat conversations available to the current API key. **Usage Cost**: free of charge - [Create Chat Conversation](https://moni-discover-api.readme.io/reference/post_api-v3-chat-conversations.md): **Description**: Creates an empty AI chat conversation for the current API key. **Usage Cost**: free of charge - [Delete Chat Conversation](https://moni-discover-api.readme.io/reference/delete_api-v3-chat-conversations-conversation-id.md): **Description**: Deletes an AI chat conversation for the current API key. **Usage Cost**: free of charge - [Chat Conversation Details](https://moni-discover-api.readme.io/reference/get_api-v3-chat-conversations-conversation-id.md): **Description**: Returns one AI chat conversation, its sanitized messages and saved message reactions. **Usage Cost**: free of charge - [Rename Chat Conversation](https://moni-discover-api.readme.io/reference/patch_api-v3-chat-conversations-conversation-id.md): **Description**: Updates the title of an AI chat conversation. **Usage Cost**: free of charge - [Set Chat Message Reaction](https://moni-discover-api.readme.io/reference/put_api-v3-chat-conversations-conversation-id-messages-message-id-reaction.md): **Description**: Saves, updates or removes a reaction for an assistant message in an AI chat conversation. **Usage Cost**: free of charge - [Stop Chat Conversation Stream](https://moni-discover-api.readme.io/reference/post_api-v3-chat-conversations-conversation-id-stop.md): **Description**: Requests the upstream chat service to stop an active conversation stream. The current upstream returns 409 while resumable streams are enabled. **Usage Cost**: free of charge - [Resume Chat Conversation Stream](https://moni-discover-api.readme.io/reference/get_api-v3-chat-conversations-conversation-id-stream.md): **Description**: Reconnects to an active AI chat stream for a conversation. Returns HTTP 204 when no active stream is available. **Usage Cost**: free of charge - [Send Chat Message](https://moni-discover-api.readme.io/reference/post_api-v3-chat-messages.md): **Description**: Sends a user message to the AI chat and streams the assistant response as an AI SDK UI message stream. **Usage**: If `conversationId` is omitted, a new conversation is created. The created conversation id is returned in the `X-Chat-Conversation-Id` response header. **Usage Cost**: 1 point per submitted message - [Project Events Feed](https://moni-discover-api.readme.io/reference/get_api-v3-events-list.md): **Description**: Returns AI-detected events across discovered projects, with filters by time window, upcoming/past timing, event category, project, impact and smart author top tags. **Usage**: Use this endpoint to monitor launches, announcements, incidents and other high-signal project events discussed by smart accounts. **Usage Cost**: 1 point per returned event - [Smart Mentions Feed](https://moni-discover-api.readme.io/reference/get_api-v3-smart-mentions-feed.md): **Description**: Returns a global discovery feed of profiles mentioned by smart accounts, with filters for smart author categories, mentioned profile chains, social metrics and activity windows. **Usage**: Use this endpoint to monitor which profiles smart accounts are mentioning and where those mentions happened. **Usage Cost**: 1 point per returned feed item - [Smart Tweets Feed](https://moni-discover-api.readme.io/reference/get_api-v3-smart-tweets-feed.md): **Description**: Returns a global feed of posts from smart accounts with event links, author metadata, engagement metrics, replies and retweet context. **Usage**: Use this endpoint to track what smart accounts are posting, which narratives they discuss, and which events those posts are attached to. **Usage Cost**: 1 point per returned post - [Projects Feed](https://moni-discover-api.readme.io/reference/get_api-v3-projects.md): **Description**: Returns a ranked list of discovered Web3 projects with profile metadata, social metrics, smart audience metrics and filters by category, chain, audience size and activity window. **Usage**: Use this endpoint to discover projects, rank them by smart activity, and build project discovery dashboards. **Usage Cost**: 1 point per returned project - [Raw Projects Feed](https://moni-discover-api.readme.io/reference/get_api-v3-projects-raw.md): **Description**: Returns raw project candidates detected by Moni before stricter public project filters are applied. Supports ML project prediction filters and the same activity/sorting controls as the projects feed. **Usage**: Use this endpoint for broader project discovery and candidate research. **Usage Cost**: 1 point per returned project - [Api Key Status](https://moni-discover-api.readme.io/reference/get_api-v3-status-api-key.md): **Description**: Returns the current status of your API key, including **usage limits, computational points used, activity status, and expiration date** **Usage**: Use to monitor your API key’s status and limits. **Usage Cost**: free of charge - [Server Status](https://moni-discover-api.readme.io/reference/get_api-v3-status-server.md): **Description**: Returns the current status of API Server. **Usage**: Use to check if the API server is up and running. **Usage Cost**: free of charge