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

### 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::1353384573435056128",
      "creator_name": "rovercrc",
      "creator_avatar": "https://pbs.twimg.com/profile_images/1891433835675475969/J-TloTb6_200x200.png",
      "creator_followers": 1267738,
      "creator_rank": 1,
      "interactions_24h": 1686455
    }
  ]
}
```

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:

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



Example response:

```json
{
  "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




---

### 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": "FoxNews",
      "creator_display_name": "Fox News",
      "creator_id": "1367531",
      "creator_network": "twitter",
      "creator_avatar": "https://pbs.twimg.com/profile_images/1591278197844414464/O6Fp0hFB_200x200.jpg",
      "creator_followers": 26725655,
      "creator_posts": 2639,
      "creator_rank": 1,
      "interactions_24h": 378298216
    }
  ]
}
```

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 XX hours
+ **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:

```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/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 $




---