[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.]
Engagements: XXX
- X Week XXXXX -XX%
- X Month XXXXXX -XX%
- X Months XXXXXXX +239%
- X Year XXXXXXX +142%
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
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 Creators
https://lunarcrush.com/api4/public/topic/:topic/creators/v1
Get the top creators for a social topic
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/creators/v1
Example response:
{
"data": [
{
"creator_id": "tiktok::7509870025967207447",
"creator_name": "yeti.solana",
"creator_avatar": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/93e1598920b075388436ef3aa00fb2b9~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=7404bb29&x-expires=1760720400&x-signature=zGB30r6Ns86%2FC7fxbCIOGusQlnA%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=sg1",
"creator_followers": 353382,
"creator_rank": 1,
"interactions_24h": 3074146
}
]
}
Schema:
- creator_id: The [network]::[unique_id] for the influencer
- creator_name: The unique screen name for the influencer
- 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
Category Creators
https://lunarcrush.com/api4/public/category/:category/creators/v1
Get the top creators for a social category
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/musicians/creators/v1
Example response:
{
"data": [
{
"creator_id": "twitter::79293791",
"creator_name": "rihanna",
"creator_avatar": "https://pbs.twimg.com/profile_images/1960786225423659008/GhLekHuP_200x200.jpg",
"creator_followers": 106933122,
"creator_rank": 1,
"interactions_24h": 21430912
}
]
}
Schema:
- creator_id: The [network]::[unique_id] for the influencer
- creator_name: The unique screen name for the influencer
- 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