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

@yumtopia "140-Year-Old Traditional Iranian RESTAURANT with the Best KEBAB ABGOOSHT and Traditional Teahouse"
YouTube Link @yumtopia 2024-06-14T14:35Z 35.5K followers, 771.1K engagements

"140 Years Old Iranian RESTAURANT with the Best KABAB in Tehran's Grand Bazaar"
YouTube Link @yumtopia 2024-11-07T15:30Z 35.5K followers, 479.4K engagements

"100 Years of Authentic Persian DIZY in Tehran's Grand Bazaar ABGOOSHT Tehran Best FOOD Bazaar"
YouTube Link @yumtopia 2024-06-05T22:18Z 35.5K followers, 3.7M engagements

Creator Posts

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

Get the top posts for a specific creator.

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": 226632002,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1936002956333080576/kqqe2iWO_200x200.jpg",
      "interactions_24h": 0,
      "interactions_total": 18440141
    }
  ]
}

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": 1758826387
  },
  "data": [
    {
      "id": "1971274382795510165",
      "post_type": "tweet",
      "post_title": "Bitcoin LOD\nGold HOD",
      "post_link": "https://x.com/zerohedge/status/1971274382795510165",
      "post_image": null,
      "post_created": 1758823412,
      "post_sentiment": 3.5,
      "creator_id": "twitter::18856867",
      "creator_name": "zerohedge",
      "creator_display_name": "zerohedge",
      "creator_followers": 2237609,
      "creator_avatar": "https://pbs.twimg.com/profile_images/72647502/tyler_200x200.jpg",
      "interactions_24h": 77999,
      "interactions_total": 77999
    }
  ]
}

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": 1758826395
  },
  "data": [
    {
      "id": "1971261889687478688",
      "post_type": "tweet",
      "post_title": "Of course. But meanwhile, @Microsoft gave the CCP access to top secret Department of Defense Cyber systems via their government contract for the Microsoft Government Azure platform. \n\nThey had no problem allowing for the Chinese to surveil classified US government materials. \n\nAcross all Federal agencies too by the way. \n\nMicrosoft is a very bad company. They protect the CCP and now they are protecting HAMAS. And, they love the H1B visa scam. \n\nThe US should cancel all of their contracts with Microsoft.",
      "post_link": "https://x.com/LauraLoomer/status/1971261889687478688",
      "post_image": null,
      "post_created": 1758820433,
      "post_sentiment": 3.07,
      "creator_id": "twitter::537709549",
      "creator_name": "LauraLoomer",
      "creator_display_name": "Laura Loomer",
      "creator_followers": 1817370,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1874663547445116928/MsW2vCgM_200x200.jpg",
      "interactions_24h": 63908,
      "interactions_total": 64013
    }
  ]
}

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

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": 226637736,
    "creator_rank": 26,
    "interactions_24h": 53318135,
    "topic_influence": [
      {
        "topic": "elon musk",
        "count": 180,
        "percent": 2.81,
        "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