[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.]
Mentions: undefined
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": "youtube::UC0C-w0YjGpqDXGB8IHb662A",
"creator_name": "edsheeran",
"creator_avatar": "https://yt3.ggpht.com/pZQ5JMD4EOI8TcNYAPTzMexe_fC0CKnb_hYlV4rPfIzmDidF239fH1XKmzkeT30XSg7fxNwc_w=s88-c-k-c0x00ffffff-no-rj",
"creator_followers": 57700000,
"creator_rank": 1,
"interactions_24h": 39981772
}
]
}
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
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": 221643469,
"creator_rank": "9",
"interactions_24h": 137219778,
"topic_influence": [
{
"topic": "elon musk",
"count": 282,
"percent": 4.45,
"rank": X
}
]
}
}
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 $
Creator Time Series
https://lunarcrush.com/api4/public/creator/:network/:id/time-series/v1
Get time series data on a creator.
input parameters:
- network: Influencer social network required
- id: The unique id or screen name of the creator required
- bucket: bucket time series data into hours or days. default is hours.
- interval: Use interval to specify the start and end time automatically for convenience. If "start" or "end" parameters are provided this parameter is ignored.
- start: The start time (unix timestamp) to go back to.
- end: The end time (unix timestamp) to stop at.
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creator/twitter/lunarcrush/time-series/v1
Example response:
{
"config": {
"network": "twitter",
"influencer_id": "twitter::988992203568562176",
"interval": "1w",
"start": 1750896000,
"end": 1751587200,
"bucket": "hour",
"name": "lunarcrush",
"remote_api": "danode1-13",
"generated": 1751552702
},
"data": [
{
"time": 1750896000,
"followers": 310261,
"interactions": 5925,
"posts_active": 40,
"creator_rank": 121192
}
]
}
Schema:
- config: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
- network: The social network for the post or influencer. We still refer to x as twitter out of developer preference.
- interval: Typically used for specifying time intervals like 1w = X week, 1m = X month etc
- start: Start/from unix timestamp (in seconds)
- end: End/to unix timestamp (in seconds)
- bucket: Data is generally bucketed into hours or days
- name: The full name of the asset
- generated: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
- time: A unix timestamp (in seconds)
- followers: The number of publicly displayed followers the creator has
- interactions: number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
- posts_active: number of unique social posts with interactions
- creator_rank: ranking based on all posts in the last XX hours that have interactions
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": "1822352993422901402",
"post_type": "tweet",
"post_title": "",
"post_created": 1723317785,
"post_sentiment": 3,
"post_link": "https://x.com/elonmusk/status/1822352993422901402",
"post_image": "https://pbs.twimg.com/media/GUpMY1xX0AA9VV1.jpg",
"creator_id": "twitter::44196397",
"creator_name": "elonmusk",
"creator_display_name": "Elon Musk",
"creator_followers": 221635586,
"creator_avatar": "https://pbs.twimg.com/profile_images/1936002956333080576/kqqe2iWO_200x200.jpg",
"interactions_24h": 0,
"interactions_total": 75476945
}
]
}
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