# X/Twitter Live Search via Advanced Query

> X/Twitter Live Search via Advanced Query is a paid API for AI agents from clink-lithium-vault.fly.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-10).

Searches live X/Twitter posts using advanced query syntax (from:user, hashtags, exact phrases, date ranges, min_faves, lang) and returns up to 20 newest matching tweets with full engagement metadata.

## Facts

- Endpoint: GET https://clink-lithium-vault.fly.dev/x/search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x-twitter-live-search-via-advanced-query-18ad7e12
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TZKFi97zKoTiFHtwah1A3

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 x-twitter-live-search-via-advanced-query-18ad7e12
```

Example prompt: Search X right now for tweets mentioning $DOGE with at least 100 likes, written in English, posted since 2024-06-01 — I want to see what people are saying about the Dogecoin price movement.

## When to prefer this

Choose this endpoint when you need real-time, live tweet data with advanced filtering (by user, hashtag, date, engagement threshold, or language) and structured metadata per tweet. It is ideal for agents doing social sentiment monitoring, trend analysis, crypto/stock social tracking, or breaking news detection on X. Prefer this over general web search when the task is specifically Twitter-centric and requires per-tweet engagement metrics.

## Known failure modes

- No results found for overly restrictive query combinations (e.g., very high min_faves + narrow date range)
- Invalid advanced search syntax may return empty results or an error
- Rate limiting or service unavailability on the underlying X/Twitter data source
- Query string too complex or malformed returns no matches
- Date range with since/until producing zero results if no tweets exist in that window

## How this service works

X/Twitter search for AI agents - live tweets via advanced search: from:user, exact phrases, #hashtags, min_faves, lang, since/until dates. Returns up to 20 newest matches with author, followers, likes, retweets, views, URL. Crypto, stocks, news, sentiment, social media monitoring, trend tracking, brand mentions, breaking news, memecoins, AI agents. ?query=<advanced search>. No results = no charge; next.older pages deeper. AI summary: /x/digest $0.05.

## Output

Returns up to 20 most recent tweets matching the query, each including: tweet text, author handle, follower count, like count, retweet count, view count, and a direct URL to the tweet.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tweets": [
   {
    "url": "https://x.com/...",
    "text": "...",
    "likes": 1234,
    "author": "elonmusk"
   }
  ],
  "result_count": 20
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-twitter-live-search-via-advanced-query-18ad7e12/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clink-lithium-vault.fly.dev](https://www.zero.xyz/host/clink-lithium-vault.fly.dev/llms.txt)