### 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:

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



Example response:

```json
{
  "data": [
    {
      "creator_id": "twitter::1605310254085980161",
      "creator_name": "Bitcoin_Teddy",
      "creator_avatar": "https://pbs.twimg.com/profile_images/1739753415134138368/FrWHMAnb_200x200.jpg",
      "creator_followers": 74293,
      "creator_rank": 1,
      "interactions_24h": [-------]
    }
  ]
}
```

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 [--] hours that have interactions
+ **interactions_24h**: Number of interactions in the last [--] 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:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/category/musicians/creators/v1
```



Example response:

```json
{
  "data": [
    {
      "creator_id": "youtube::undefined",
      "creator_name": "airshowfansh",
      "creator_avatar": "https://yt3.ggpht.com/cUuwxYNRoYoO_rnBAgPbze39nOMI_rUq0pVmHiM-Fz40TsRDmv8gZcUxvqxLF_bsGzhdVu4u9A=s88-c-k-c0x00ffffff-no-rj",
      "creator_followers": 79600000,
      "creator_rank": 1,
      "interactions_24h": [---------]
    }
  ]
}
```

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 [--] hours that have interactions
+ **interactions_24h**: Number of interactions in the last [--] hours




---

### Creators List

https://lunarcrush.com/api4/public/creators/list/v1

Get a list of trending social creators over all of social based on interactions. To get lists of creators by category or topic see the topics and categories endpoints.

Example request:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creators/list/v1
```



Example response:

```json
{
  "data": [
    {
      "creator_name": "elonmusk",
      "creator_display_name": "Elon Musk",
      "creator_id": "44196397",
      "creator_network": "twitter",
      "creator_avatar": "https://pbs.twimg.com/profile_images/2008546467615580160/57KcqsTA_200x200.jpg",
      "creator_followers": 234295750,
      "creator_posts": 3649,
      "creator_rank": 1,
      "interactions_24h": [---------]
    }
  ]
}
```

Schema:

+ **creator_name**: The unique screen name for the influencer
+ **creator_display_name**: The chosen display name for the influencer if available
+ **creator_id**: The [network]::[unique_id] for the influencer
+ **creator_network**: The social network for the post or influencer. We still refer to x as twitter out of developer preference.
+ **creator_avatar**: The URL to the avatar for the creator
+ **creator_followers**: number of followers the account has
+ **creator_posts**: total number of posts with interactions in the last [--] hours
+ **creator_rank**: ranking based on all posts in the last [--] hours that have interactions
+ **interactions_24h**: Number of interactions in the last [--] 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:

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



Example response:

```json
{
  "data": {
    "creator_id": "twitter::44196397",
    "creator_name": "elonmusk",
    "creator_display_name": "Elon Musk",
    "creator_avatar": "https://pbs.twimg.com/profile_images/2008546467615580160/57KcqsTA_200x200.jpg",
    "creator_followers": 234296337,
    "creator_rank": 2,
    "interactions_24h": 318539577,
    "topic_influence": [
      {
        "topic": "in the",
        "count": 294,
        "percent": 5.88,
        "rank": [--]
      }
    ],
    "top_community": [
      {
        "creator_name": "grok",
        "creator_display_name": "Grok",
        "creator_avatar": "https://pbs.twimg.com/profile_images/1893219113717342208/Vgg2hEPa_200x200.jpg",
        "count": [---]
      }
    ]
  }
}
```

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 [--] hours that have interactions
+ **interactions_24h**: Number of interactions in the last [--] 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




---

Limited data mode. Full metrics available with subscription: lunarcrush.com/pricing