LunarCrush LLM | LunarCrush AI Interface

[GUEST ACCESS MODE: Data is scrambled or limited to provide examples. Make requests using your API key to unlock full data. Check https://lunarcrush.ai/auth for authentication information.]

Landscaping

Topic News

https://lunarcrush.com/api4/public/topic/:topic/news/v1

Get the top news posts for a social topic. Top news is determined by the metrics related to the social posts that mention the news posts.

input parameters:

topic: Provide the topic to get details for. A topic must be all lower case and can only include letters, numbers, spaces, # and $. required

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/news/v1

Example response:

{
  "config": {
    "topic": "bitcoin",
    "type": "topic",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "generated": 1758826391
  },
  "data": [
    {
      "id": "news.bitcoin.com-2003821389",
      "post_type": "news",
      "post_title": "Gate Launches Layer X Network for Web3 Expansion – Crypto News Bitcoin News",
      "post_link": "https://news.bitcoin.com/gate-launches-layer-2-network-for-web3-expansion/",
      "post_image": "https://static.news.bitcoin.com/wp-content/uploads/2025/09/gate-launches-layer-2-network-for-web3-expansion.jpg",
      "post_created": 1758822757,
      "post_sentiment": 3.21,
      "creator_id": "twitter::3367334171",
      "creator_name": "BTCTN",
      "creator_display_name": "Bitcoin.com News",
      "creator_followers": 3224282,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1917825669825966080/2bAp4kVv_200x200.jpg",
      "interactions_24h": 96,
      "interactions_total": XX
    }
  ]
}

Schema:

config: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
topic: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
type: Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
id: LunarCrush internal ID for the asset
name: The full name of the asset
symbol: The symbol for the asset
generated: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
post_type: The type of social post
post_title: The title text of the social post
post_link: The URL to view the social post on the social network
post_image: The URL to the primary image for the post if available
post_created: The unix timestamp of our best indication of when the post was created
post_sentiment: The sentiment of the post is a score between X and X with X being very negative, X being neutral, and X being very positive. A score of XXX is considered slightly positive.
creator_id: The [network]::[unique_id] for the influencer
creator_name: The unique screen name for the influencer
creator_display_name: The chosen display name for the influencer if available
creator_followers: number of followers the account has
creator_avatar: The URL to the avatar for the creator
interactions_24h: Number of interactions in the last XX hours
interactions_total: Number of total interactions

Topic Whatsup

https://lunarcrush.com/api4/public/topic/:topic/whatsup/v1

Generate an AI summary of the hottest news and social posts for a specific topic

input parameters:

topic: Provide the topic to get a summary for. A topic must be all lower case and can only include letters, numbers, spaces, # and $. required

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/whatsup/v1

Example response:

{
  "config": {
    "topic": "bitcoin",
    "generated": 1758826249
  },
  "summary": "Several major companies, including Google and Capital Group, are investing in Bitcoin and related technologies, indicating growing institutional interest. Additionally, various firms, such as Melanion Capital and Oranjebtc, are developing new Bitcoin treasury models and expanding their Bitcoin holdings. Meanwhile, regulatory developments, like the SEC's approval of a new crypto ETF, are also shaping the market."
}

Schema:

config: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
topic: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
generated: A unix timestamp (in seconds) when the data was generated to understand possibly stale data

Category News

https://lunarcrush.com/api4/public/category/:category/news/v1

Get the top news posts for a category. Top news is determined by the metrics related to the social posts that mention the news posts.

input parameters:

category: Provide the category to get details for. A category must be all lower case and can only include letters, numbers, and spaces. required

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/category/cryptocurrencies/news/v1

Example response:

{
  "config": {
    "category": "cryptocurrencies",
    "type": "topic",
    "id": "_cryptocurrencies",
    "topic": "_cryptocurrencies",
    "generated": 1758826396
  },
  "data": [
    {
      "id": "news.bitcoin.com-2003821389",
      "post_type": "news",
      "post_title": "Gate Launches Layer X Network for Web3 Expansion – Crypto News Bitcoin News",
      "post_link": "https://news.bitcoin.com/gate-launches-layer-2-network-for-web3-expansion/",
      "post_image": "https://static.news.bitcoin.com/wp-content/uploads/2025/09/gate-launches-layer-2-network-for-web3-expansion.jpg",
      "post_created": 1758822757,
      "post_sentiment": 3.21,
      "creator_id": "twitter::3367334171",
      "creator_name": "BTCTN",
      "creator_display_name": "Bitcoin.com News",
      "creator_followers": 3224282,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1917825669825966080/2bAp4kVv_200x200.jpg",
      "interactions_24h": 96,
      "interactions_total": XX
    }
  ]
}

Schema:

config: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
category: LunarCrush social category. Can only includes letters, numbers and spaces
type: Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
id: LunarCrush internal ID for the asset
topic: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
generated: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
post_type: The type of social post
post_title: The title text of the social post
post_link: The URL to view the social post on the social network
post_image: The URL to the primary image for the post if available
post_created: The unix timestamp of our best indication of when the post was created
post_sentiment: The sentiment of the post is a score between X and X with X being very negative, X being neutral, and X being very positive. A score of XXX is considered slightly positive.
creator_id: The [network]::[unique_id] for the influencer
creator_name: The unique screen name for the influencer
creator_display_name: The chosen display name for the influencer if available
creator_followers: number of followers the account has
creator_avatar: The URL to the avatar for the creator
interactions_24h: Number of interactions in the last XX hours
interactions_total: Number of total interactions

Topics List

https://lunarcrush.com/api4/public/topics/list/v1

Get a list of trending social topics.

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topics/list/v1

Example response:

{
  "data": [
    {
      "topic": "youtube",
      "title": "YouTube",
      "topic_rank": 1,
      "topic_rank_1h_previous": 1,
      "topic_rank_24h_previous": 1,
      "num_contributors": 420430,
      "num_posts": 912873,
      "interactions_24h": 2912785759
    }
  ]
}

Schema:

topic: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
title: The case sensitive title of the topic or category
topic_rank: LunarCrush metric for ranking a social topic relative to all other social topics
topic_rank_1h_previous: The topic rank from X hour ago
topic_rank_24h_previous: The topic rank from XX hours ago
num_contributors: The number of unique social contributors to the topic
num_posts: Total number of posts with interactions on this topic in the last XX hours
interactions_24h: Number of interactions in the last XX hours