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

@hachasell9104 "i didn't shine #teamfortress2 #tf2 #shorts"
YouTube Link @hachasell9104 2025-10-16T19:45Z XXX followers, 1148 engagements

"we do a little trolling #teamfortress2 #tf2 #shorts"
YouTube Link @hachasell9104 2025-10-16T19:47Z XXX followers, 1534 engagements

Creator Posts

https://lunarcrush.com/api4/public/creator/:network/:id/posts/v1

Get the top posts for a specific creator. 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:

network: Network for the creator. One of twitter, youtube, instagram, reddit, or tiktok required
id: Unique ID or screen name of the creator 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/creator/twitter/elonmusk/posts/v1

Example response:

{
  "data": [
    {
      "id": "1953886838445552084",
      "post_type": "tweet",
      "post_title": "Good idea. \n\nAlso, we will be putting the most liked images on 𝕏 in the Grok Imagine default feed.",
      "post_created": 1754677898,
      "post_sentiment": 3.48,
      "post_link": "https://x.com/elonmusk/status/1953886838445552084",
      "post_image": null,
      "creator_id": "twitter::44196397",
      "creator_name": "elonmusk",
      "creator_display_name": "Elon Musk",
      "creator_followers": 227846462,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1936002956333080576/kqqe2iWO_200x200.jpg",
      "interactions_24h": 0,
      "interactions_total": 18444057
    }
  ]
}

Schema:

id: Unique id of the social post
post_type: The type of social post
post_title: The title text of the social post
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.
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
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 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": 1760647718
  },
  "data": [
    {
      "id": "t3_1o7u058",
      "post_type": "reddit-post",
      "post_title": "Made this bitcoin shadow box. Not sure if I'm crazy about this design but it's something",
      "post_link": "https://redd.it/1o7u058",
      "post_image": null,
      "post_created": 1760646307,
      "post_sentiment": 3.2,
      "creator_id": "reddit::t2_kszqkqvk",
      "creator_name": "Outrageous-Garage179",
      "creator_display_name": "Outrageous-Garage179",
      "creator_avatar": "https://styles.redditmedia.com/t5_60m8fu/styles/profileIcon_63j7drb563fa1.png?width=256&height=256&crop=256:256,smart&s=9b79b5074a344e0e8cf39a127dcfa5c2f4b5ecf3",
      "interactions_24h": 1683,
      "interactions_total": 1683
    }
  ]
}

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_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": 1760647720
  },
  "data": [
    {
      "id": "t3_1o8b66k",
      "post_type": "reddit-post",
      "post_title": "Uptober",
      "post_link": "https://redd.it/1o8b66k",
      "post_image": null,
      "post_created": 1760645040,
      "post_sentiment": 3,
      "creator_id": "reddit::t2_123yyn",
      "creator_name": "skuntils",
      "creator_display_name": "skuntils",
      "creator_avatar": "https://styles.redditmedia.com/t5_ekeht/styles/profileIcon_snoof92c973c-0c87-4da9-a1cb-ee3475c3d920-headshot.png?width=256&height=256&crop=256:256,smart&s=33fc1ad631533a5b6ca1dc8ccff10621a3c3d103",
      "interactions_24h": 14135,
      "interactions_total": 14135
    }
  ]
}

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_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

Creator

https://lunarcrush.com/api4/public/creator/:network/:id/v1

Get detail information on a specific creator

input parameters:

network: Provide the network for the creator. One of twitter, youtube, instagram, reddit, or tiktok required
id: Provide the unique ID or screen name of the creator required

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creator/twitter/elonmusk/v1

Example response:

{
  "data": {
    "creator_id": "twitter::44196397",
    "creator_name": "elonmusk",
    "creator_display_name": "Elon Musk",
    "creator_avatar": "https://pbs.twimg.com/profile_images/1936002956333080576/kqqe2iWO_200x200.jpg",
    "creator_followers": 227854844,
    "creator_rank": 4,
    "interactions_24h": 120031096,
    "topic_influence": [
      {
        "topic": "elon musk",
        "count": 189,
        "percent": 1.71,
        "rank": X
      }
    ],
    "top_community": [
      {
        "creator_name": "grok",
        "creator_display_name": "Grok",
        "creator_avatar": "https://pbs.twimg.com/profile_images/1893219113717342208/Vgg2hEPa_200x200.jpg",
        "count": XXX
      }
    ]
  }
}

Schema:

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
creator_followers: number of followers the account has
creator_rank: ranking based on all posts in the last XX hours that have interactions
interactions_24h: Number of interactions in the last XX hours
topic_influence: an array of social topics and the creators ranking on each topic
topic: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
top_community: an array of the top accounts that have recently mentioned this creator or that this creator has mentioned