Tools Reference
Social Sentiment Tools
Social Sentiment Tools
17 tools for social media analytics, creator tracking, and trending topic data.
MCP Endpoint: POST /hive_social_sentiment/mcp
Data Source: LunarCrush
Topic Analytics
get_topic_creators
Get the top creators for a social topic.
| Parameter | Type | Required | Description |
|---|---|---|---|
| topic | string | Yes | Cryptocurrency symbol or topic (e.g., "BTC", "ETH") |
Example:
curl -X POST https://api.hiveintelligence.xyz/api/execute \
-H "Content-Type: application/json" \
-d '{
"toolName": "get_topic_creators",
"arguments": {
"topic": "BTC"
}
}'
get_topic_news
Get the top news posts for a social topic. Top news is determined by metrics related to social posts that mention the news.
| Parameter | Type | Required | Description |
|---|---|---|---|
| topic | string | Yes | Cryptocurrency symbol or topic (e.g., "BTC", "ETH") |
get_topic_posts
Get the top posts for a social topic. Returns top posts by interactions from the last 24 hours, or for a specified time range.
| Parameter | Type | Required | Description |
|---|---|---|---|
| topic | string | Yes | Cryptocurrency symbol or topic |
| start | string | No | Start timestamp (Unix seconds) |
| end | string | No | End timestamp (Unix seconds) |
Example:
curl -X POST https://api.hiveintelligence.xyz/api/execute \
-H "Content-Type: application/json" \
-d '{
"toolName": "get_topic_posts",
"arguments": {
"topic": "ETH"
}
}'
get_topic_metrics
Get summary information for a social topic. Returns 24-hour aggregated social activity with metrics comparing to the previous 24 hours.
| Parameter | Type | Required | Description |
|---|---|---|---|
| topic | string | Yes | Cryptocurrency symbol or topic |
Response includes:
- Social mentions and interactions
- Contributor counts
- Sentiment indicators
- 24h change comparisons
get_trending_topics
Get a list of trending social topics across all of crypto.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
Category Analytics
get_category_info
Get summary information for a social category.
| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | Yes | Category name (e.g., "DeFi", "NFT", "Layer1") |
Example:
curl -X POST https://api.hiveintelligence.xyz/api/execute \
-H "Content-Type: application/json" \
-d '{
"toolName": "get_category_info",
"arguments": {
"category": "DeFi"
}
}'
get_category_topics
Get the top topics for a social category.
| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | Yes | Category name |
get_category_posts
Get the top posts for a social category. Returns top posts by interactions from the last 24 hours, or for a specified time range.
| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | Yes | Category name |
| start | string | No | Start timestamp (Unix seconds) |
| end | string | No | End timestamp (Unix seconds) |
get_category_news
Get the top news posts for a category. Top news is determined by metrics related to social posts that mention the news.
| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | Yes | Category name |
get_category_creators
Get the top creators for a social category.
| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | Yes | Category name |
get_categories_list
Get a list of trending social categories.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
Creator Analytics
get_creators_list
Get a list of trending social creators based on interactions across all of social.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
get_creator_profile
Get detailed information on a specific creator.
| Parameter | Type | Required | Description |
|---|---|---|---|
| network | string | Yes | Social network (e.g., "twitter", "youtube") |
| id | string | Yes | Creator ID on the network |
Example:
curl -X POST https://api.hiveintelligence.xyz/api/execute \
-H "Content-Type: application/json" \
-d '{
"toolName": "get_creator_profile",
"arguments": {
"network": "twitter",
"id": "VitalikButerin"
}
}'
get_creator_metrics
Get time series data on a creator's social metrics.
| Parameter | Type | Required | Description |
|---|---|---|---|
| network | string | Yes | Social network |
| id | string | Yes | Creator ID |
| bucket | string | No | Time bucket for aggregation |
| interval | string | No | Time interval |
| start | string | No | Start timestamp (Unix seconds) |
| end | string | No | End timestamp (Unix seconds) |
get_creator_posts
Get the top posts for a specific creator.
| Parameter | Type | Required | Description |
|---|---|---|---|
| network | string | Yes | Social network |
| id | string | Yes | Creator ID |
| start | string | No | Start timestamp (Unix seconds) |
| end | string | No | End timestamp (Unix seconds) |
Post Analytics
get_post_details
Get details of a specific social post.
| Parameter | Type | Required | Description |
|---|---|---|---|
| post_type | string | Yes | Post type (e.g., "twitter", "youtube") |
| post_id | string | Yes | Post ID |
Example:
curl -X POST https://api.hiveintelligence.xyz/api/execute \
-H "Content-Type: application/json" \
-d '{
"toolName": "get_post_details",
"arguments": {
"post_type": "twitter",
"post_id": "1234567890"
}
}'
get_post_metrics
Get interactions over time for a post. Returns hourly interactions for posts less than 365 days old, otherwise daily.
| Parameter | Type | Required | Description |
|---|---|---|---|
| post_type | string | Yes | Post type |
| post_id | string | Yes | Post ID |
Quick Reference
| Tool | Description |
|---|---|
| get_topic_creators | Top creators for a topic |
| get_topic_news | Top news for a topic |
| get_topic_posts | Top posts for a topic |
| get_topic_metrics | Topic summary metrics |
| get_trending_topics | Trending topics list |
| get_category_info | Category summary info |
| get_category_topics | Top topics in category |
| get_category_posts | Top posts in category |
| get_category_news | Top news in category |
| get_category_creators | Top creators in category |
| get_categories_list | Trending categories list |
| get_creators_list | Trending creators list |
| get_creator_profile | Creator details |
| get_creator_metrics | Creator time series |
| get_creator_posts | Creator's top posts |
| get_post_details | Post details |
| get_post_metrics | Post interaction metrics |