Execute searches and retrieve real-time social context from Membit: search trending clusters, fetch cluster details, and find relevant posts via simple HTTP endpoints.

​
Authentication

All API endpoints require authentication using an API key. Send your API key in the header: 
X-Membit-Api-Key: <your-api-key>
Get your API key at get your API key.

​
Endpoints

​
GET /clusters/search

Search for trending discussion clusters using semantic and keyword matching.
​
q
string
required
Search query (minimum 3 characters)
​
limit
integer
default:"10"
Maximum number of clusters to return (1-50)
​
format
string
default:"json"
Response format: “json” or “llm”
curl GET
curl -X GET "https://api-app.membit.ai/clusters/search?q=artificial%20intelligence&limit=1" \
  -H "X-Membit-Api-Key: <your-api-key>"
Success
{
  "clusters": [
    {
      "label": "Machine Learning Study Resources",
      "summary": "Several academic resources related to mathematics, computer science, and machine learning are shared, including books and lecture notes from MIT and Princeton.",
      "category": "Artificial Intelligence",
      "engagement_score": 4010.119762872029,
      "search_score": 0.9719360841066075
    }
  ]
}
When format=llm, returns a formatted text response optimized for language models: 
Here are clusters of trending discussions related to your query "artificial intelligence":

---

**Cluster**: label="Machine Learning Study Resources"
**Summary**: Several academic resources related to mathematics, computer science, and machine learning are shared, including books and lecture notes from MIT and Princeton.
**Category**: Artificial Intelligence
**Search Score**: 0.9719360841066075
**Engagement Score**: 4010.119762872029

---

Next, you may call `cluster_info` tool with the label you're interested in to dive deeper into each conversation. Make sure to use the exact label.
​
clusters
array
Array of cluster objects

​
GET /clusters/info

Get detailed information about a specific cluster, including individual posts.
​
label
string
required
Exact cluster label from search results
​
limit
integer
default:"10"
Maximum number of posts to return (1-50)
​
format
string
default:"json"
Response format: “json” or “llm”
curl GET
curl -X GET "https://api-app.membit.ai/clusters/info?label=Machine%20Learning%20Study%20Resources&limit=1" \
  -H "X-Membit-Api-Key: <your-api-key>"
Success
{
  "category": "Artificial Intelligence",
  "summary": "Several academic resources related to mathematics, computer science, and machine learning are shared, including books and lecture notes from MIT and Princeton.",
  "engagement_score": 4010.119762872029,
  "posts": [
    {
      "id": 237064,
      "uuid": "2b13144b-d8d1-76fd-dd9a-a2020c9ad227",
      "author": {
        "handle": "@PhilosophyOfPhy",
        "name": "Philosophy Of Physics",
        "profile_image": "https://img.membit.ai/v2/ae606b4a-cd1f-4ec2-fa1d-b549ce56371e.jpeg"
      },
      "content": "The World as a Mathematical Game;\n\n\" John von Neumann and Twentieth Century Science\"\n\n- by Giorgio Israel and Ana Millán Gasca.\n\n![image](https://img.membit.ai/v2/b7d2051d-6369-e400-78cc-f3b31ccfda59.jpeg)",
      "url": "https://x.com/PhilosophyOfPhy/status/1955303556321525765",
      "mentioned": null,
      "timestamp": "2025-08-12T16:21:10Z",
      "is_substantive": true,
      "engagement": { "likes": 552, "replies": 1, "retweets": 68 },
      "engagement_score": 525.4269464440242
    }
  ]
}
When format=llm, returns a formatted text response optimized for language models: 
Here's social dicussions around the cluster "Machine Learning Study Resources" (Artificial Intelligence):

---

## Summary:
Several academic resources related to mathematics, computer science, and machine learning are shared, including books and lecture notes from MIT and Princeton.

---

## Posts:

---

**URL**: https://x.com/PhilosophyOfPhy/status/1955303556321525765
**Post Time**: 2025-08-12 16:21:10+00:00
**Author**: Philosophy Of Physics (@PhilosophyOfPhy)
**Engagement**: Likes=552, Replies=1, Retweets=68
**Engagement Score**: 525.4269464440242
**Content**: The World as a Mathematical Game;

" John von Neumann and Twentieth Century Science"

- by Giorgio Israel and Ana Millán Gasca.

![image](https://img.membit.ai/v2/b7d2051d-6369-e400-78cc-f3b31ccfda59.jpeg)
​
category
string
Cluster topic category
​
summary
string
Detailed cluster description
​
engagement_score
float
Overall cluster engagement (0-1)
​
posts
array
Array of post objects

​
GET /posts/search

Search for individual social media posts using semantic similarity.
​
q
string
required
Search query (minimum 3 characters)
​
limit
integer
default:"10"
Maximum number of posts to return (1-50)
​
format
string
default:"json"
Response format: “json” or “llm”
curl GET
curl -X GET "https://api-app.membit.ai/posts/search?q=blockchain&limit=1" \
  -H "X-Membit-Api-Key: <your-api-key>"
Success
{
  "posts": [
    {
      "id": 239012,
      "uuid": "0ca539f8-45d0-0e63-981e-3852bce72379",
      "author": {
        "handle": "@TrustlessState",
        "name": "David Hoffman",
        "profile_image": "https://img.membit.ai/v2/6912825a-d421-2b4a-2f45-ad3eaadbd97c.jpeg"
      },
      "content": "Every few years we try out the public vs private chain thesis \n\nEvery time we learn the same lesson\n\nEthereum",
      "url": "https://x.com/TrustlessState/status/1955462168352297121",
      "mentioned": {
        "id": 29481,
        "uuid": "a024f4de-498a-8ddb-dbae-c0514428f991",
        "author": {
          "handle": "@CamiRusso",
          "name": "Camila Russo",
          "profile_image": "https://img.membit.ai/v2/a3fd6747-e064-e204-89eb-a3b94c546fa4.jpeg"
        },
        "content": "SO, what happens with Stripe and Circle chains? \n\nDo they end up becoming the world's payments rails, or do they fade into irrelevance and capitulate to issuing their stablecoins in established networks?",
        "timestamp": "2025-08-12T15:40:15Z"
      },
      "timestamp": "2025-08-13T02:51:26Z",
      "is_substantive": true,
      "engagement": { "likes": 389, "replies": 29, "retweets": 25 },
      "search_score": 0.3715041809563351,
      "cluster_label": "Circle Arc Blockchain Launch"
    }
  ]
}
When format=llm, returns a formatted text response optimized for language models: 
Here are raw social posts for your query "blockchain":

---

**URL**: https://x.com/TrustlessState/status/1955462168352297121
**Post Time**: 2025-08-13 02:51:26+00:00
**Author**: David Hoffman (@TrustlessState)
**Engagement**: Likes=389, Replies=29, Retweets=25
**Content**: Every few years we try out the public vs private chain thesis

Every time we learn the same lesson

Ethereum

> **Mentioned a Post** by Camila Russo (@CamiRusso):
> SO, what happens with Stripe and Circle chains?
>
> Do they end up becoming the world's payments rails, or do they fade into irrelevance and capitulate to issuing their stablecoins in established networks?

---

You may call `cluster_info` to dive deeper into the discussions around a similar topic of a post. Make sure to use the exact label.
​
posts
array
Array of matching post objects