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.]

Topic Posts

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

Get the top posts for a social topic. If start time is provided the result will be the top posts by interactions for the time range. If start is not provided it will be the most recent top posts by interactions from the last XX hours.

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
start: The start time (unix timestamp) to start at. Will be rounded to the beginning of the day. If the end parameter is not provided it will just be the top posts for this day.
end: (Optional) The end time (unix timestamp) to stop at. Will be rounded to the end of the day.

Example request:

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

Example response:

{
  "config": {
    "topic": "bitcoin",
    "type": "topic",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "generated": 1751552696
  },
  "data": [
    {
      "id": "1940767467934294480",
      "post_type": "tweet",
      "post_title": "NEW: 🇺🇸 Bitcoin & crypto market cap will \"probably go to $15-$20 TRILLION” once the Genius stablecoin legislation passes, says Trump's Digital Asset Director",
      "post_link": "https://x.com/BTC_Archive/status/1940767467934294480",
      "post_image": "https://pbs.twimg.com/media/Gu79uZ4WwAELycU.jpg",
      "post_created": 1751549996,
      "post_sentiment": 3.13,
      "creator_id": "twitter::970994516357472257",
      "creator_name": "BTC_Archive",
      "creator_display_name": "Bitcoin Archive",
      "creator_followers": 1726739,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1938906052956700672/7aV7c-nF_200x200.jpg",
      "interactions_24h": 30978,
      "interactions_total": 31161
    }
  ]
}

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: Unique id of the social post
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

Category Posts

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

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
start: The start time (unix timestamp) to start at. Will be rounded to the beginning of the day. If the end parameter is not provided it will just be the top posts for this day.
end: (Optional) The end time (unix timestamp) to stop at. Will be rounded to the end of the day.

Example request:

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

Example response:

{
  "config": {
    "category": "cryptocurrencies",
    "type": "topic",
    "id": "_cryptocurrencies",
    "topic": "_cryptocurrencies",
    "generated": 1751552697
  },
  "data": [
    {
      "id": "1940767467934294480",
      "post_type": "tweet",
      "post_title": "NEW: 🇺🇸 Bitcoin & crypto market cap will \"probably go to $15-$20 TRILLION” once the Genius stablecoin legislation passes, says Trump's Digital Asset Director",
      "post_link": "https://x.com/BTC_Archive/status/1940767467934294480",
      "post_image": "https://pbs.twimg.com/media/Gu79uZ4WwAELycU.jpg",
      "post_created": 1751549996,
      "post_sentiment": 3.13,
      "creator_id": "twitter::970994516357472257",
      "creator_name": "BTC_Archive",
      "creator_display_name": "Bitcoin Archive",
      "creator_followers": 1726739,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1938906052956700672/7aV7c-nF_200x200.jpg",
      "interactions_24h": 30978,
      "interactions_total": 31161
    }
  ]
}

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: Unique id of the social post
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

Posts

https://lunarcrush.com/api4/public/posts/:post_type/:post_id/v1

Get details of a post

input parameters:

post_type: The post type e.g. tweet, youtube-video, tiktok-video, reddit-post, instagram-post required
post_id: The unique id of a post, for twitter it is a number, youtube it is the id in the url after watch?v=, look in the url for the unique id required

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/posts/tweet/1756378079893782591/v1

Example response:

{
  "type": "tweet",
  "id": "1756378079893782591",
  "title": "Social activity is 👆 across the board today. \n\n🤔 What are y'all talking about? \n🫡 We've got you covered.\n\n👩‍💻 Technology\n💬 Social Networks\n👨‍🎤 Musicians\n🕺 Celebrities\n🌏 Countries\n🎮 Gaming\n🏖️ Travel\n🚗 Automotive\n🥷 Cryptocurrencies\n🇺🇸 US Election\n\n🚀 https://t.co/AI5yuZEyi7 https://t.co/T0mqJBiyx0",
  "description": null,
  "extraText": "https://lunarcrush.com/categories?rpp=300&page=1&cols=topic_rank%2Ccontributors_active%2Cposts_active%2Caverage_sentiment%2Cinteractions_24h%2Cinteractions_trend",
  "metrics": {
    "bookmarks": 2,
    "favorites": 20,
    "retweets": 3,
    "replies": 13,
    "views": 13004
  },
  "image": {
    "src": "https://pbs.twimg.com/media/GF_n3GQaoAA23sT.jpg",
    "width": 2048,
    "height": XXX
  },
  "video": null,
  "images": null,
  "creator_id": "twitter::988992203568562176",
  "creator_name": "LunarCrush",
  "creator_display_name": "LunarCrush Analytics",
  "creator_avatar": "https://pbs.twimg.com/profile_images/1863747720827244545/xoSWaM53_200x200.png",
  "topics": [
    "analytics"
  ],
  "categories": []
}

Schema:

type: Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
id: Unique id of the social post
title: Title of the social post
description: Explanation of the change and the potential impact
extraText: Extra text for the post for search matching like the retweet text or text included in the video
metrics: Comma separated list of metrics to include or that are included
image: Provides the url/src width and height of a the image in the post if available
video: Provides the url/src width and height of a the video in the post if available
images: Provides the url/src width and height of a the images in the post if available
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_avatar: The URL to the avatar for the creator
categories: an array of categories this topic aggregates into

Posts Time Series

https://lunarcrush.com/api4/public/posts/:post_type/:post_id/time-series/v1

Get interactions over time for a post. If a post is older than XXX days the time series will be returned as daily interactions, otherwise it hourly interactions

input parameters:

post_type: The post type e.g. tweet, youtube-video, tiktok-video, reddit-post, instagram-post required
post_id: The unique id of a post, for twitter it is a number, youtube it is the id in the url after watch?v=, look in the url for the unique id required

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/posts/tweet/1756378079893782591/time-series/v1

Example response:

{
  "data": [
    {
      "time": "1707523200",
      "interactions": XX
    }
  ]
}

Schema:

time: A unix timestamp (in seconds)
interactions: number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)