# Heurist Mesh: Twitter/X Search Intelligence

> Heurist Mesh: Twitter/X Search Intelligence is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Searches Twitter/X for posts and influential mentions matching a query, covering news, crypto, blockchain, and any topic of interest

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/TwitterIntelligenceAgent/twitter_search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-twitter-x-search-intelligence-5dfb65aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pNfzLRtNyRtn7RUY4wSkl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability heurist-mesh-twitter-x-search-intelligence-5dfb65aa -d '<json body>'
```

Example prompt: Search Twitter/X for recent posts and influential mentions about Solana's latest network upgrade — I want to see what the crypto community is saying about it right now.

## When to prefer this

Choose this endpoint when you need real-time social intelligence from Twitter/X — especially for crypto, blockchain, and news topics where community sentiment and influencer chatter matter. Prefer this over general web search when the signal you need lives on Twitter (e.g. trader reactions, project announcements, community discussions). Use the sibling 'Twitter account search' endpoint when you need stats on a specific account rather than broad topic search.

## Known failure modes

- Query returns no results if the topic has very low Twitter activity
- Rate limiting or Twitter API restrictions may reduce result volume
- Very broad or ambiguous queries may return noisy, off-topic posts
- Payment failure (insufficient USDC balance) results in 402 error before search is executed
- Real-time events may have a short lag before appearing in results

## How this service works

Search Twitter/X for posts and influential mentions of the query. Use this tool to find discussions about news, crypto, blockchain projects, or any other topic of interest.

## Output

A collection of Twitter/X posts and mentions matching the query, including tweet content, authors, engagement signals, and influential mentions relevant to the searched topic — particularly useful for crypto and blockchain discussions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "queries"
     ],
     "properties": {
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "limit": {
       "type": "integer",
       "description": "Number of tweets to return."
      },
      "queries": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "1-3 search terms (e.g., 'bitcoin', '$ETH', '@coinbase', '\"exact phrase\"'). Case insensitive. Do not query the same term with variations of case or synonyms. Each of the queries should be within [English: one word or two-word phrase] [Chinese or Korean: one word, no more than 5 characters]. One query should be one concept only. Never use long sentences or long phrases as keywords."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-twitter-x-search-intelligence-5dfb65aa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)