Moni Discover API

https://moni-discover-api.readme.io/reference
Admin
Moni Discover API is a social intelligence layer for web3 data that provides structured access to...
Tokens:31,154
Snippets:136
Trust Score:9.9
Update:1 year ago
Show doc for...
Tokens:
Raw
### Indexing List Response Example

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-tracker-tweet

Example JSON response body for the Indexing List API, showing the structure of active indexing accounts including creation date, start date, and Twitter user ID.

```json
{
  "items": [
    {
      "createdAt": 1742283266,
      "startDate": 1742265254,
      "twitterUserId": "1026753750038470658"
    }
  ]
}
```

--------------------------------

### Get Full Account Info Response (JSON Example)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-info-full

Example JSON response for the 'Full Account Info' endpoint, showcasing detailed account data including user ID, URL, smart engagement metrics (smarts count, Moni score, mentions count), smart profile information (tier, tags, categories), project tags, and associated blockchains.

```json
{
  "meta": {
    "userId": "1026753750038470658",
    "userUrl": "https://x.com/elonmusk"
  },
  "smartEngagement": {
    "smartsCount": 494,
    "moniScore": 3718,
    "mentionsCount": 2779,
    "smartMentionsCount": 1761
  },
  "smartProfile": {
    "smartTier": {
      "tier": 1,
      "logoUrl": "https://storage.googleapis.com/moni-twitter-bot/statics/images/score_1.png"
    },
    "smartTags": [
      {
        "slug": "alpha-hunter",
        "name": "Alpha Hunter",
        "totalCount": 3
      }
    ],
    "smartTagCategories": [
      {
        "slug": "vc/fund-team",
        "name": "VC/Fund team"
      }
    ],
    "projectTags": [
      {
        "slug": "other",
        "name": "Other"
      }
    ],
    "chains": [
      {
        "slug": "ethereum"
      }
    ]
  }
}
```

--------------------------------

### Get Project Chains Response (JSON)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-basics-project-chains

Example JSON response for the Get Project Chains endpoint, showing a list of chains with their slugs and names. The response is an object containing an 'items' array.

```json
{
  "items": [
    {
      "slug": "ethereum",
      "name": "Ethereum"
    }
  ]
}
```

--------------------------------

### Get Smarts Full Info Response - JSON

Source: https://moni-discover-api.readme.io/reference/smarts

Example JSON response for the 'Smarts Full Info' API endpoint, showing the structure of the returned data. It includes a list of 'items', each containing 'meta', 'smartEngagement', and 'smartProfile' objects with detailed analytics and tagging information.

```JSON
{
  "items": [
    {
      "meta": {
        "userId": "14379660",
        "userUrl": "https://x.com/elonmusk"
      },
      "smartEngagement": {
        "interactedAt": 1708135452,
        "moniScore": 25147,
        "mentionsCount": 6313,
        "smartMentionsCount": 4744,
        "smartsCount": 2396
      },
      "smartProfile": {
        "smartTier": {
          "tier": 1,
          "logoUrl": "https://storage.googleapis.com/moni-twitter-bot/statics/images/score_1.png"
        },
        "smartTags": [
          {
            "slug": "influencer",
            "name": "Influencer"
          }
        ],
        "smartTagCategories": [
          {
            "slug": "vc/fund-team",
            "name": "VC/Fund team"
          }
        ],
        "projectTags": [
          {
            "slug": "other",
            "name": "Other"
          }
        ],
        "chains": [
        ]
      }
    }
  ]
}
```

--------------------------------

### Get Smarts Full Info (cURL)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-full

Example of how to retrieve the full list of smarts for a specific account using cURL. This request includes parameters for pagination, sorting, and filtering.

```Shell
curl --request GET \
     --url 'https://api.discover.getmoni.io/api/v3/accounts/username/smarts/full/?limit=100&offset=0&orderBy=CREATED_AT&orderByDirection=DESC' \
     --header 'accept: application/json'
```

--------------------------------

### GET /api/v3/basics/project_chains/

Source: https://moni-discover-api.readme.io/reference/get_api-v3-basics-project-chains

Provides all available project chains. Use this endpoint to get the full list of chains.

```APIDOC
## GET /api/v3/basics/project_chains/

### Description
Provides all available project chains. Use this endpoint to get the full list of chains.

### Method
GET

### Endpoint
https://api.discover.getmoni.io/api/v3/basics/project_chains/

### Parameters
#### Query Parameters
- **Api-Key** (string) - required - API Key for authentication.

### Request Example
```bash
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/basics/project_chains/ \
     --header 'accept: application/json'
```

### Response
#### Success Response (200)
- **items** (array of objects) - required
  - **slug** (string) - required - The unique slug for the chain.
  - **name** (string) - required - The display name of the chain.

#### Response Example
```json
{
  "items": [
    {
      "slug": "ethereum",
      "name": "Ethereum"
    }
  ]
}
```
```

--------------------------------

### GET /api/v3/basics/project_categories/

Source: https://moni-discover-api.readme.io/reference/mindshare-essentials

Provides all available project categories. Use this endpoint to get the full list of project categories.

```APIDOC
## GET /api/v3/basics/project_categories/

### Description
Provides all available project categories. Use this endpoint to get the full list of project categories.

### Method
GET

### Endpoint
https://api.discover.getmoni.io/api/v3/basics/project_categories/

### Parameters
#### Headers
- **Api-Key** (string) - Required - API key for authentication.

### Request Example
```curl
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/basics/project_categories/ \
     --header 'accept: application/json'
```

### Response
#### Success Response (200)
- **items** (array of objects) - Required. An array containing project category objects.
  - **slug** (string) - Required - The unique identifier for the category.
  - **name** (string) - Required - The display name of the category.

#### Response Example
```json
{
  "items": [
    {
      "slug": "ai",
      "name": "AI"
    }
  ]
}
```
```

--------------------------------

### Get Smarts Full Info Response (JSON)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-full

Example JSON response for the 'Smarts Full Info' API endpoint, showcasing the structure of smarts data including meta information, engagement metrics, and profile details.

```JSON
{
  "items": [
    {
      "meta": {
        "userId": "14379660",
        "userUrl": "https://x.com/elonmusk"
      },
      "smartEngagement": {
        "interactedAt": 1708135452,
        "moniScore": 25147,
        "mentionsCount": 6313,
        "smartMentionsCount": 4744,
        "smartsCount": 2396
      },
      "smartProfile": {
        "smartTier": {
          "tier": 1,
          "logoUrl": "https://storage.googleapis.com/moni-twitter-bot/statics/images/score_1.png"
        },
        "smartTags": [
          {
            "slug": "influencer",
            "name": "Influencer"
          }
        ],
        "smartTagCategories": [
          {
            "slug": "vc/fund-team",
            "name": "VC/Fund team"
          }
        ],
        "projectTags": [
          {
            "slug": "other",
            "name": "Other"
          }
        ],
        "chains": [
          // ... chain details
        ]
      }
    }
    // ... more smart items
  ]
}
```

--------------------------------

### API Key Status Response Example

Source: https://moni-discover-api.readme.io/reference/get_api-v3-status-api-key

Provides an example of the JSON response body when retrieving API key status. It includes the activation status, monthly point limits and usage, and the expiration timestamp.

```json
{
  "isActive": true,
  "monthPointsLimit": 0,
  "monthPointsUsage": 0,
  "expiresAt": 0
}
```

--------------------------------

### Start Indexing Tweets

Source: https://moni-discover-api.readme.io/reference/feed-indexing

Initiates the indexing of posts from a specified X (formerly Twitter) account. Once indexing is complete, the posts can be retrieved using GET method with feed & tweets category endpoints. This operation incurs a usage cost of 10 credits.

```APIDOC
## PUT /api/v3/accounts/{username}/tracker/tweet/

### Description
Initiates the indexing of posts from a user's X account. After indexing, posts can be retrieved via GET requests to feed and tweets endpoints. This operation costs 10 credits.

### Method
PUT

### Endpoint
https://api.discover.getmoni.io/api/v3/accounts/{username}/tracker/tweet/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username (handle) of the user in x.com

#### Query Parameters
None

#### Request Body
- **startDate** (int32 | null) - Optional - Defaults to null. If provided, credits are deducted only for tweets created after this date.

### Request Example
```json
{
  "startDate": null
}
```

### Response
#### Success Response (200)
- Response body is an empty object `{}`.

#### Response Example
```json
{}
```
```

--------------------------------

### Get All Project Categories Response (JSON)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-basics-project-categories

Example JSON response for the project categories endpoint, showing a 200 status code and an 'items' array containing category objects with 'slug' and 'name'.

```json
{
  "items": [
    {
      "slug": "ai",
      "name": "AI"
    }
  ]
}
```

--------------------------------

### Start Indexing Tweets

Source: https://moni-discover-api.readme.io/reference/put_api-v3-accounts-username-tracker-tweet

Initiates the indexing of posts from a Twitter account. Once indexing is complete, the posts can be retrieved using GET method with feed & tweets category endpoints.

```APIDOC
## PUT /api/v3/accounts/{username}/tracker/tweet/

### Description
Initiates the indexing of posts from a Twitter account. Once indexing is complete, the posts can be retrieved using GET method with feed & tweets category endpoints.

### Method
PUT

### Endpoint
https://api.discover.getmoni.io/api/v3/accounts/{username}/tracker/tweet/

### Parameters
#### Path Parameters
- **username** (string) - required - The username (handle) of the user in x.com

#### Query Parameters
None

#### Request Body
- **startDate** (int32 | null) - optional - Defaults to null. If this parameter is sent, credits will only be deducted for tweets created after this date.

### Request Example
```json
{
  "startDate": null
}
```

### Response
#### Success Response (200)
- **object** - An empty object indicating success.

#### Response Example
```json
{}
```
```

--------------------------------

### Account Smart Profile Response Example

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-info-smart-profile

This is an example JSON response for the Account Smart Profile API. It details the smart profile analysis, including the smart tier, manually assigned tags and categories, associated blockchain networks, and the count of bio changes.

```json
{
  "smartProfile": {
    "smartTier": {
      "tier": 1,
      "logoUrl": "https://storage.googleapis.com/moni-twitter-bot/statics/images/score_1.png"
    },
    "smartTags": [
      {
        "slug": "alpha-hunter",
        "name": "Alpha Hunter",
        "totalCount": 3
      }
    ],
    "smartTagCategories": [
      {
        "slug": "vc/fund-team",
        "name": "VC/Fund team"
      }
    ],
    "projectTags": [
      {
        "slug": "other",
        "name": "Other"
      }
    ],
    "chains": [
      {
        "slug": "ethereum",
        "name": "Ethereum"
      }
    ],
    "bioChangesCount": 0
  }
}
```

--------------------------------

### Retrieve Account Events Response Example

Source: https://moni-discover-api.readme.io/reference/feed-events

Example JSON response for the account events API, containing an array of event items, each with creation timestamp, type, and data.

```json
{
  "items": [
    {
      "createdAt": 1742128258,
      "type": "NEW_BIO",
      "data": {}
    }
  ]
}
```

--------------------------------

### Smarts Tiers Response Example

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-distribution-level

An example of a successful response from the Smarts Tiers API, showing the structure of the returned data, including the 'items' array with 'name', 'level', and 'itemsCount' for each smart follower tier.

```JSON
{
  "items": [
    {
      "name": "string",
      "level": 0,
      "itemsCount": 0
    }
  ]
}
```

--------------------------------

### Get All Smart Tag Categories Response (JSON)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-basics-smart-tag-categories

This is an example JSON response for the smart tag categories endpoint, showing a list of items, each with a 'slug' and 'name'.

```JSON
{
  "items": [
    {
      "slug": "influencers",
      "name": "Influencers"
    }
  ]
}
```

--------------------------------

### GET /api/v3/basics/project_categories/

Source: https://moni-discover-api.readme.io/reference/get_api-v3-basics-project-categories

Provides all available project categories. Use this endpoint to get the full list of project categories.

```APIDOC
## GET /api/v3/basics/project_categories/

### Description
Provides all available project categories. Use this endpoint to get the full list of project categories.

### Method
GET

### Endpoint
https://api.discover.getmoni.io/api/v3/basics/project_categories/

### Parameters
#### Headers
- **Api-Key** (string) - required - API key for authentication.

### Request Example
```curl
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/basics/project_categories/ \
     --header 'accept: application/json'
```

### Response
#### Success Response (200)
- **items** (array of objects) - required
  - **slug** (string) - required
  - **name** (string) - required

#### Response Example
```json
{
  "items": [
    {
      "slug": "ai",
      "name": "AI"
    }
  ]
}
```
```

--------------------------------

### Smarts Engagement Response Example

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-smart-engagement

An example of the JSON response from the Smarts Engagement API. It includes an array of 'items', where each item contains 'smartEngagement' details like interaction time, Moni score, and mention counts. Also includes the total count of Smarts.

```json
{
  "items": [
    {
      "smartEngagement": {
        "interactedAt": 1708135452,
        "moniScore": 25147,
        "mentionsCount": 6313,
        "smartMentionsCount": 4744,
        "smartsCount": 2396
      }
    }
  ],
  "totalCount": 0
}
```

--------------------------------

### Get All Project Categories (cURL)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-basics-project-categories

Fetches all available project categories from the API. This is a GET request to the specified endpoint with an accept header for JSON.

```shell
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/basics/project_categories/ \
     --header 'accept: application/json'
```

--------------------------------

### Get Smart Mentions Count (Python)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-history-smart-mentions-count

Provides a Python example for accessing the smart mentions history API. It utilizes the 'requests' library to perform a GET request and parse the JSON response.

```python
# Python example would go here, likely using the requests library
```

--------------------------------

### Get Project Mindshare Response (JSON)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-projects

Example JSON response for the project mindshare analytics endpoint. It includes an array of items, each detailing a user's project mentions, associated tags, mindshare value, and change percentage.

```JSON
{
  "items": [
    {
      "userId": "1026753750038470658",
      "projectTags": [
        {
          "slug": "other",
          "name": "Other"
        }
      ],
      "value": 50.4,
      "change": -12.5
    }
  ]
}
```

--------------------------------

### Get Chains Mindshare Analytics (Node.js)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-chains

Example of how to fetch chain mindshare analytics using Node.js with the 'axios' library. It makes a GET request to the API endpoint, specifying the 'accept' header.

```JavaScript
const axios = require('axios');

axios
  .get('https://api.discover.getmoni.io/api/v3/analytics/charts/mindshare/chains/?forAccountProjectTags=null&timeframe=H24&fromSmartAccountsTagCategories=null', {
    headers: {
      accept: 'application/json'
    }
  })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });
```

--------------------------------

### Smarts Smart Profile Response Example

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-smart-profile

This is an example JSON response for the Smarts Smart Profile endpoint. It includes a list of 'items', where each item contains a 'smartProfile' object detailing the 'smartTier', 'smartTags', 'smartTagCategories', 'projectTags', 'chains', and 'bioChangesCount'. The 'totalCount' indicates the total number of Smarts available.

```json
{
  "items": [
    {
      "smartProfile": {
        "smartTier": {
          "tier": 1,
          "logoUrl": "https://storage.googleapis.com/moni-twitter-bot/statics/images/score_1.png"
        },
        "smartTags": [
          {
            "slug": "influencer",
            "name": "Influencer"
          }
        ],
        "smartTagCategories": [
          {
            "slug": "vc/fund-team",
            "name": "VC/Fund team"
          }
        ],
        "projectTags": [
          {
            "slug": "other",
            "name": "Other"
          }
        ],
        "chains": [
          {
            "slug": "ethereum",
            "name": "Ethereum"
          }
        ],
        "bioChangesCount": 0
      }
    }
  ],
  "totalCount": 0
}
```

--------------------------------

### Start Indexing Tweets (cURL)

Source: https://moni-discover-api.readme.io/reference/feed-indexing

Initiates the indexing of posts from a specified X.com account. The request includes the account's username and an optional start date for filtering tweets. The API key is required for authentication.

```shell
curl --request PUT \
     --url https://api.discover.getmoni.io/api/v3/accounts/username/tracker/tweet/ \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"startDate":null}'
```

--------------------------------

### GET /basics/project_chains/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves chains for mindshare, with a usage cost of 0 points.

```APIDOC
## GET /basics/project_chains/

### Description
Retrieves chains associated with mindshare. This endpoint incurs a usage cost of 0 points.

### Method
GET

### Endpoint
/basics/project_chains/

### Response
#### Success Response (200)
- **chains** (array) - An array of strings representing project chains.

#### Response Example
```json
{
  "chains": ["chainA", "chainB", "chainC"]
}
```
```

--------------------------------

### GET /api/v3/basics/smart_tag_categories/

Source: https://moni-discover-api.readme.io/reference/get_api-v3-basics-smart-tag-categories

Provides all available smart tag categories. Use this endpoint to get the full list of smart categories.

```APIDOC
## GET /api/v3/basics/smart_tag_categories/

### Description
Provides all available smart tag categories. Use this endpoint to get the full list of smart categories.

### Method
GET

### Endpoint
https://api.discover.getmoni.io/api/v3/basics/smart_tag_categories/

### Parameters
#### Headers
- **Api-Key** (string) - required - The API key for authentication.

### Request Example
```curl
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/basics/smart_tag_categories/ \
     --header 'accept: application/json'
```

### Response
#### Success Response (200)
- **items** (array of objects) - required
  - **slug** (string) - required - The unique identifier for the smart tag category.
  - **name** (string) - required - The display name of the smart tag category.

#### Response Example
```json
{
  "items": [
    {
      "slug": "influencers",
      "name": "Influencers"
    }
  ]
}
```
```

--------------------------------

### Get Server Status (cURL)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-status-server

This snippet shows how to make a GET request to the server status endpoint using cURL. It includes the URL and the necessary Accept header.

```shell
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/status/server/ \
     --header 'accept: application/json'
```

--------------------------------

### cURL GET Request for Smarts Categories

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-categories

This snippet shows how to make a GET request to the Smarts Categories endpoint using cURL. It specifies the URL and required headers.

```Shell
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/accounts/username/smarts/categories/ \
     --header 'accept: application/json'
```

--------------------------------

### API Response Example

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-chains

An example of a successful JSON response from the Chains Mindshare API. It contains an 'items' array, where each object represents a category with its name, logo URL, mindshare value, and change percentage compared to the previous timeframe.

```JSON
{
  "items": [
    {
      "name": "AI",
      "logoUrl": "https://storage.googleapis.com/moni-twitter-bot/statics/images/project_tag_logo/ai.png",
      "value": 50.4,
      "change": -12.5
    }
  ]
}
```

--------------------------------

### Smart Mentions Feed Response Example (JSON)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-feed-smart-mentions

This JSON response provides an example of the data structure returned by the Smart Mentions Feed endpoint. It includes an 'items' array, where each item represents a mention with details such as creation date, type, and associated data like the mentioner's information and the post URL.

```json
{
  "items": [
    {
      "createdAt": 1737729427,
      "type": "NEW_MENTION",
      "data": {
        "mentionBy": {
          "userId": "string",
          "userUrl": "string",
          "moniScore": 0,
          "smartsCount": 0,
          "tags": [
            {
              "slug": "influencer",
              "name": "Influencer"
            }
          ]
        },
        "postUrl": "https://x.com/elonmusk/status/1900638690252136809",
        "postId": "1900638690252136809"
      }
    }
  ]
}
```

--------------------------------

### GET /basics/project_tags/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves tags for mindshare, with a usage cost of 0 points.

```APIDOC
## GET /basics/project_tags/

### Description
Retrieves tags associated with mindshare. This endpoint incurs a usage cost of 0 points.

### Method
GET

### Endpoint
/basics/project_tags/

### Response
#### Success Response (200)
- **tags** (array) - An array of strings representing project tags.

#### Response Example
```json
{
  "tags": ["tag1", "tag2", "tag3"]
}
```
```

--------------------------------

### GET /accounts/{username}/info/meta/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves metadata for a given username, with a usage cost of 1 point.

```APIDOC
## GET /accounts/{username}/info/meta/

### Description
Retrieves metadata for a specified username. This endpoint incurs a usage cost of 1 point.

### Method
GET

### Endpoint
/accounts/{username}/info/meta/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve metadata for.

### Response
#### Success Response (200)
- **metadata** (object) - Contains the account metadata.

#### Response Example
```json
{
  "metadata": {
    "last_login": "2023-10-26T14:30:00Z",
    "status": "active"
  }
}
```
```

--------------------------------

### Get Project Mindshare (cURL)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-projects

Fetches project mindshare analytics using a GET request. It supports filtering by project chains, tags, smart tag categories, and accounts, with a specified timeframe.

```Shell
curl --request GET \
     --url 'https://api.discover.getmoni.io/api/v3/analytics/charts/mindshare/projects/?forAccountProjectChains=null&forAccountProjectTags=null&timeframe=H24&fromSmartAccountsTagCategories=null&forAccounts=null' \
     --header 'accept: application/json'
```

--------------------------------

### GET /accounts/{username}/info/full/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves the full account information for a given username, with a usage cost of 8 points.

```APIDOC
## GET /accounts/{username}/info/full/

### Description
Retrieves the full account information for a specified username. This endpoint incurs a usage cost of 8 points.

### Method
GET

### Endpoint
/accounts/{username}/info/full/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve information for.

### Response
#### Success Response (200)
- **account_info** (object) - Contains the full account details.

#### Response Example
```json
{
  "account_info": {
    "username": "example_user",
    "email": "user@example.com",
    "creation_date": "2023-01-01T10:00:00Z"
  }
}
```
```

--------------------------------

### GET /accounts/{username}/info/smart_profile/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves the smart profile for a given username, with a usage cost of 2 points.

```APIDOC
## GET /accounts/{username}/info/smart_profile/

### Description
Retrieves the smart profile for a specified username. This endpoint incurs a usage cost of 2 points.

### Method
GET

### Endpoint
/accounts/{username}/info/smart_profile/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve the smart profile for.

### Response
#### Success Response (200)
- **smart_profile** (object) - Contains the account's smart profile information.

#### Response Example
```json
{
  "smart_profile": {
    "interests": ["technology", "finance"],
    "preferred_language": "en"
  }
}
```
```

--------------------------------

### Account Metadata (ID) GET Request (cURL)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-info-meta

This snippet demonstrates how to retrieve account metadata, including the user ID and URL, using a cURL GET request. It specifies the endpoint URL and the necessary 'accept' header.

```Shell
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/accounts/username/info/meta/ \
     --header 'accept: application/json'
```

--------------------------------

### GET /accounts/{username}/smarts/distribution/level/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves the distribution of smarts by level for a given username, with a usage cost of 1 point.

```APIDOC
## GET /accounts/{username}/smarts/distribution/level/

### Description
Retrieves the distribution of smarts by level for a specified username. This endpoint incurs a usage cost of 1 point.

### Method
GET

### Endpoint
/accounts/{username}/smarts/distribution/level/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve smarts distribution by level for.

### Response
#### Success Response (200)
- **smarts_distribution** (object) - Contains the distribution of smarts across different levels.

#### Response Example
```json
{
  "smarts_distribution": {
    "level_1": 20,
    "level_2": 30,
    "level_3": 15
  }
}
```
```

--------------------------------

### GET /basics/smart_tag_categories/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves categories for smarts, with a usage cost of 0 points.

```APIDOC
## GET /basics/smart_tag_categories/

### Description
Retrieves categories associated with smarts. This endpoint incurs a usage cost of 0 points.

### Method
GET

### Endpoint
/basics/smart_tag_categories/

### Response
#### Success Response (200)
- **categories** (array) - An array of strings representing smart tag categories.

#### Response Example
```json
{
  "categories": ["Smart Category 1", "Smart Category 2"]
}
```
```

--------------------------------

### GET /accounts/{username}/smarts/meta/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves metadata for smarts of a given username, with a usage cost of 1 point.

```APIDOC
## GET /accounts/{username}/smarts/meta/

### Description
Retrieves metadata for the smarts associated with a specified username. This endpoint incurs a usage cost of 1 point.

### Method
GET

### Endpoint
/accounts/{username}/smarts/meta/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve smarts metadata for.

### Response
#### Success Response (200)
- **smarts_metadata** (object) - Contains metadata related to the account's smarts.

#### Response Example
```json
{
  "smarts_metadata": {
    "total_smarts": 50,
    "last_smart_update": "2023-10-25T09:00:00Z"
  }
}
```
```

--------------------------------

### GET /accounts/{username}/info/smart_engagement/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves smart engagement data for a given username, with a usage cost of 5 points.

```APIDOC
## GET /accounts/{username}/info/smart_engagement/

### Description
Retrieves smart engagement data for a specified username. This endpoint incurs a usage cost of 5 points.

### Method
GET

### Endpoint
/accounts/{username}/info/smart_engagement/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve smart engagement data for.

### Response
#### Success Response (200)
- **smart_engagement** (object) - Contains the account's smart engagement metrics.

#### Response Example
```json
{
  "smart_engagement": {
    "likes": 150,
    "comments": 25
  }
}
```
```

--------------------------------

### GET /accounts/{username}/smarts/full/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves full smarts information for a given username, with a usage cost of 5 points.

```APIDOC
## GET /accounts/{username}/smarts/full/

### Description
Retrieves the full smarts information for a specified username. This endpoint incurs a usage cost of 5 points.

### Method
GET

### Endpoint
/accounts/{username}/smarts/full/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve full smarts information for.

### Response
#### Success Response (200)
- **smarts_data** (object) - Contains the full smarts data for the account.

#### Response Example
```json
{
  "smarts_data": {
    "smart_id_1": {"name": "Smart A", "value": 100},
    "smart_id_2": {"name": "Smart B", "value": 150}
  }
}
```
```

--------------------------------

### GET /api/v3/status/server/

Source: https://moni-discover-api.readme.io/reference/get_api-v3-status-server

Returns the current status of the API server. Use this endpoint to check if the API server is operational and running.

```APIDOC
## GET /api/v3/status/server/

### Description
Returns the current status of the API server. Use this endpoint to check if the API server is operational and running.

### Method
GET

### Endpoint
https://api.discover.getmoni.io/api/v3/status/server/

### Parameters

#### Query Parameters
None

#### Request Body
None

### Request Example
```curl
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/status/server/ \
     --header 'accept: application/json'
```

### Response
#### Success Response (200)
An empty JSON object indicates a successful response, meaning the server is up and running.

#### Response Example
```json
{}
```
```

--------------------------------

### GET /analytics/charts/mindshare/chains/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves the mindshare for chains, with a usage cost of 1 point.

```APIDOC
## GET /analytics/charts/mindshare/chains/

### Description
Retrieves the mindshare for chains. This endpoint incurs a usage cost of 1 point.

### Method
GET

### Endpoint
/analytics/charts/mindshare/chains/

### Response
#### Success Response (200)
- **mindshare_data** (object) - Contains the mindshare data for chains.

#### Response Example
```json
{
  "mindshare_data": {
    "chain_1": 50,
    "chain_2": 90
  }
}
```
```

--------------------------------

### GET /accounts/{username}/smarts/smart_profile/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves the smart profile of smarts for a given username, with a usage cost of 1 point.

```APIDOC
## GET /accounts/{username}/smarts/smart_profile/

### Description
Retrieves the smart profile of smarts for a specified username. This endpoint incurs a usage cost of 1 point.

### Method
GET

### Endpoint
/accounts/{username}/smarts/smart_profile/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve the smarts smart profile for.

### Response
#### Success Response (200)
- **smarts_smart_profile** (object) - Contains the smart profile information related to the account's smarts.

#### Response Example
```json
{
  "smarts_smart_profile": {
    "dominant_smart": "Smart A",
    "trending_smarts": ["Smart C", "Smart D"]
  }
}
```
```

--------------------------------

### GET /accounts/{username}/smarts/categories/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves the categories of smarts for a given username, with a usage cost of 1 point.

```APIDOC
## GET /accounts/{username}/smarts/categories/

### Description
Retrieves the categories associated with smarts for a specified username. This endpoint incurs a usage cost of 1 point.

### Method
GET

### Endpoint
/accounts/{username}/smarts/categories/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve smarts categories for.

### Response
#### Success Response (200)
- **smarts_categories** (array) - An array of strings, where each string is a category of smarts.

#### Response Example
```json
{
  "smarts_categories": ["Category X", "Category Y"]
}
```
```

--------------------------------

### GET /accounts/{username}/feed/events/

Source: https://moni-discover-api.readme.io/reference/usage-costs

Retrieves a list of events from the feed for a given username, with a usage cost of 3 points.

```APIDOC
## GET /accounts/{username}/feed/events/

### Description
Retrieves a list of events from the feed for a specified username. This endpoint incurs a usage cost of 3 points.

### Method
GET

### Endpoint
/accounts/{username}/feed/events/

### Parameters
#### Path Parameters
- **username** (string) - Required - The username of the account to retrieve feed events for.

### Response
#### Success Response (200)
- **events** (array) - An array of event objects from the account's feed.

#### Response Example
```json
{
  "events": [
    {"event_id": "evt_1", "timestamp": "2023-10-26T10:00:00Z", "type": "like"},
    {"event_id": "evt_2", "timestamp": "2023-10-26T10:05:00Z", "type": "comment"}
  ]
}
```
```

--------------------------------

### Get Category Mindshare Analytics (Node.js)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-categories

Retrieves category mindshare analytics using Node.js. This example demonstrates making a GET request to the API endpoint with specified query parameters and headers.

```Node.js
const fetch = require('node-fetch');

const url = 'https://api.discover.getmoni.io/api/v3/analytics/charts/mindshare/categories/?forAccountProjectChains=null&timeframe=H24&fromSmartAccountsTagCategories=null';

fetch(url, {
  method: 'GET',
  headers: {
    'accept': 'application/json'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
```

--------------------------------

### Get Category Mindshare Analytics (PHP)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-categories

Retrieves category mindshare analytics using PHP's cURL functions. This example demonstrates making a GET request with query parameters and setting the accept header.

```PHP
<?php

$url = 'https://api.discover.getmoni.io/api/v3/analytics/charts/mindshare/categories/?forAccountProjectChains=null&timeframe=H24&fromSmartAccountsTagCategories=null';

$headers = [
    'accept: application/json'
];

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>
```

--------------------------------

### Get Chains Mindshare Analytics (PHP)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-chains

An example of retrieving chain mindshare analytics in PHP using cURL. It sets the request method to GET and includes the 'accept' header for JSON response.

```PHP
<?php

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, 'https://api.discover.getmoni.io/api/v3/analytics/charts/mindshare/chains/?forAccountProjectTags=null&timeframe=H24&fromSmartAccountsTagCategories=null');
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'accept: application/json',
]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo $response;
}

curl_close($curl);
?>
```

--------------------------------

### Get Mentions History Response (JSON)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-history-mentions-count

Example JSON response for the Mentions History API endpoint. It includes an array of historical mention counts ('chart') with timestamps, and metrics for timeframe and 'since found' changes.

```json
{
  "chart": [
    [
      1594713600,
      9219
    ],
    [
      1594713900,
      9218
    ]
  ],
  "timeframeChange": 0,
  "sinceFoundChange": 0,
  "sinceFound": 0
}
```

--------------------------------

### Get Project Chains (cURL)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-basics-project-chains

Retrieves a list of all available project chains from the Moni Discover API. This endpoint requires an 'accept' header set to 'application/json'.

```shell
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/basics/project_chains/ \
     --header 'accept: application/json'
```

--------------------------------

### Account Smart Engagement Response Example

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-info-smart-engagement

This JSON response provides the smart engagement analytics for an account, including the number of smarts, Moni score, total mentions, and smart mentions.

```json
{
  "smartEngagement": {
    "smartsCount": 494,
    "moniScore": 3718,
    "mentionsCount": 2779,
    "smartMentionsCount": 1761
  }
}
```

--------------------------------

### Smarts Categories API Response (200 OK)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-smarts-categories

This is an example JSON response for a successful request to the Smarts Categories endpoint. It includes a list of categories, the count of smarts within each category, and the total count of categories.

```JSON
{
  "items": [
    {
      "slug": "string",
      "name": "string",
      "itemsCount": 0
    }
  ],
  "totalCount": 0
}
```

--------------------------------

### Get Indexing List (cURL)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-tracker-tweet

Retrieves the list of accounts where tweets indexing is active using a GET request. Requires an accept header for JSON.

```shell
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/accounts/tracker/tweet/ \
     --header 'accept: application/json'
```

--------------------------------

### API Endpoints and Usage Costs

Source: https://moni-discover-api.readme.io/reference/usage-costs

Lists various API endpoints for different functionalities like analytics, account information, and history tracking, along with their respective usage costs in points. Some endpoints might have additional charges for custom projects.

```markdown
Endpoint| Name| Usage Cost (Points)  
---|---|---
GET /analytics/charts/mindshare/projects/| Projects Mindshare| 1 + 50*  
GET /analytics/charts/mindshare/categories/| Narrative Mindshare| 1  
GET /analytics/charts/mindshare/chains/| Chains Mindshare| 1  
GET /accounts/{username}/info/full/| Full Account Info| 8  
GET /accounts/{username}/info/meta/| Account Metadata| 1  
GET /accounts/{username}/info/smart_profile/| Account Smart Profile| 2  
GET /accounts/{username}/info/smart_engagement/| Account Smart Engagement| 5  
GET /accounts/{username}/history/smarts_count/| Smarts History| 4  
GET /accounts/{username}/history/mentions_count/| Mentions History| 2  
GET /accounts/{username}/history/smart_mentions_count/| Smart Mentions History| 4  
GET /accounts/{username}/smarts/full/| Smart Full Info| 5  
GET /accounts/{username}/smarts/meta/| Smarts Metadata| 1  
GET /accounts/{username}/smarts/smart_profile/| Smarts Smart Profile| 1  
GET /accounts/{username}/smarts/smart_engagement/| Smarts Engagement| 3  
GET /accounts/{username}/smarts/distribution/level/| Smarts Tiers| 1  
GET /accounts/{username}/smarts/categories/| Smarts Categories| 1  
GET /accounts/{username}/feed/events/| Event List| 3  
GET /accounts/{username}/feed/smart_mentions/| Smart Mentions Feed| 4  
GET /basics/project_tags/| Tags for Mindshare| 0  
GET /basics/project_chains/| Chains for Mindshare| 0  
GET /basics/smart_tag_categories/| Smarts for Mindshare| 0  
*For custom project
```

--------------------------------

### Get Category Mindshare Analytics (Python)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-categories

Retrieves category mindshare analytics using Python's requests library. This code snippet shows how to send a GET request with appropriate headers and parameters.

```Python
import requests

url = "https://api.discover.getmoni.io/api/v3/analytics/charts/mindshare/categories/"
params = {
    "forAccountProjectChains": "null",
    "timeframe": "H24",
    "fromSmartAccountsTagCategories": "null"
}
headers = {
    "accept": "application/json"
}

response = requests.get(url, params=params, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")
```

--------------------------------

### Get API Key Status (cURL)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-status-api-key

Retrieves the current status of the API key, including usage limits and expiration. This cURL command sends a GET request to the status endpoint.

```shell
curl --request GET \
     --url https://api.discover.getmoni.io/api/v3/status/api_key/ \
     --header 'accept: application/json'
```

--------------------------------

### Get Smart Mentions Count (Node.js)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-accounts-username-history-smart-mentions-count

Demonstrates how to fetch smart mentions history using Node.js. It makes a GET request to the API endpoint with a specified timeframe and handles the JSON response.

```javascript
// Node.js example would go here, likely using fetch or a similar library
```

--------------------------------

### Get Chains Mindshare Analytics (Ruby)

Source: https://moni-discover-api.readme.io/reference/get_api-v3-analytics-charts-mindshare-chains

Demonstrates fetching chain mindshare analytics using Ruby with the 'httparty' gem. It sends a GET request to the API endpoint with the appropriate 'Accept' header.

```Ruby
require 'httparty'

response = HTTParty.get('https://api.discover.getmoni.io/api/v3/analytics/charts/mindshare/chains/?forAccountProjectTags=null&timeframe=H24&fromSmartAccountsTagCategories=null', headers: { 'Accept' => 'application/json' })

puts response.body
```
Tokens:
Raw