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

[Landscaping](/topic/landscaping)

### Top News

*Showing a maximum of X news posts for non-authenticated requests. Use your API key in requests for full results.*  

"A sublimely crafted modernist masterwork in King City - The Globe and Mail"  
[@globeandmail](/creator/x/globeandmail) on [X](/post/news/theglobeandmail.com-1038852035) 2025-07-16 13:06:34 UTC 2M followers, 3670 engagements

### Topic News

https://lunarcrush.com/api4/public/topic/:topic/news/v1

Get the top news posts for a social topic. Top news is determined by the metrics related to the social posts that mention the news posts.

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/news/v1
```



Example response:

```json
{
  "config": {
    "topic": "bitcoin",
    "type": "topic",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "generated": 1751552696
  },
  "data": [
    {
      "id": "news.bitcoin.com-1834060068",
      "post_type": "news",
      "post_title": "South Africa’s First NFT Marketplace, Momint, Shuts Down Amid Market Pressures – News Bytes Bitcoin News",
      "post_link": "https://news.bitcoin.com/south-africas-first-nft-marketplace-momint-shuts-down-amid-market-pressures/",
      "post_image": "https://static.news.bitcoin.com/wp-content/uploads/2025/07/mominyyyttt.png",
      "post_created": 1751550334,
      "post_sentiment": 2.95,
      "creator_id": "twitter::3367334171",
      "creator_name": "BTCTN",
      "creator_display_name": "Bitcoin.com News",
      "creator_followers": 3174857,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1917825669825966080/2bAp4kVv_200x200.jpg",
      "interactions_24h": 56,
      "interactions_total": XX
    }
  ]
}
```

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**: LunarCrush internal ID for the asset
+ **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




---

### Topic Whatsup

https://lunarcrush.com/api4/public/topic/:topic/whatsup/v1

Generate an AI summary of the hottest news and social posts for a specific topic

input parameters:

+ **topic**: _Provide the topic to get a summary 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/whatsup/v1
```



Example response:

```json
{
  "config": {
    "topic": "bitcoin",
    "generated": 1751552662
  },
  "summary": "Several major financial institutions and companies, such as BlackRock, Fidelity, and Microcloud Hologram Inc., are making significant moves in the Bitcoin space, including investing heavily in Bitcoin and launching new Bitcoin-related products. Additionally, regulatory developments, such as the SEC approving Grayscale's proposal to convert its fund into a spot ETF, are also having an impact. Meanwhile, some countries, like Pakistan, are exploring Bitcoin mining plans, while others, like South Africa, are seeing NFT marketplaces shut down due to market pressures."
}
```

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 $
+ **generated**: A unix timestamp (in seconds) when the data was generated to understand possibly stale data




---

### Category News

https://lunarcrush.com/api4/public/category/:category/news/v1

Get the top news posts for a category. Top news is determined by the metrics related to the social posts that mention the news posts.

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/cryptocurrencies/news/v1
```



Example response:

```json
{
  "config": {
    "category": "cryptocurrencies",
    "type": "topic",
    "id": "_cryptocurrencies",
    "topic": "_cryptocurrencies",
    "generated": 1751552698
  },
  "data": [
    {
      "id": "news.bitcoin.com-1834060068",
      "post_type": "news",
      "post_title": "South Africa’s First NFT Marketplace, Momint, Shuts Down Amid Market Pressures – News Bytes Bitcoin News",
      "post_link": "https://news.bitcoin.com/south-africas-first-nft-marketplace-momint-shuts-down-amid-market-pressures/",
      "post_image": "https://static.news.bitcoin.com/wp-content/uploads/2025/07/mominyyyttt.png",
      "post_created": 1751550334,
      "post_sentiment": 2.95,
      "creator_id": "twitter::3367334171",
      "creator_name": "BTCTN",
      "creator_display_name": "Bitcoin.com News",
      "creator_followers": 3174857,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1917825669825966080/2bAp4kVv_200x200.jpg",
      "interactions_24h": 56,
      "interactions_total": XX
    }
  ]
}
```

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**: LunarCrush internal ID for the asset
+ **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




---

### Topics List

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

Get a list of trending social topics.

Example request:

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



Example response:

```json
{
  "data": [
    {
      "topic": "youtube",
      "title": "YouTube",
      "topic_rank": 1,
      "topic_rank_1h_previous": 1,
      "topic_rank_24h_previous": 1,
      "num_contributors": 412953,
      "num_posts": 836638,
      "interactions_24h": 3573313797
    }
  ]
}
```

Schema:

+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **title**: The case sensitive title of the topic or category
+ **topic_rank**: LunarCrush metric for ranking a social topic relative to all other social topics
+ **topic_rank_1h_previous**: The topic rank from X hour ago
+ **topic_rank_24h_previous**: The topic rank from XX hours ago
+ **num_contributors**: The number of unique social contributors to the topic
+ **num_posts**: Total number of posts with interactions on this topic in the last XX hours
+ **interactions_24h**: Number of interactions in the last XX hours




---