# Twitter/X Posts & Tweets Search

> Twitter/X Posts & Tweets Search is a paid API for AI agents from social.duoleads.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Searches public X (Twitter) posts by keyword or phrase, returning the latest matching tweets newest-first with full engagement metrics, author details, and pagination cursor.

## Facts

- Endpoint: GET https://social.duoleads.com/v1/x/search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-x-posts-tweets-search-0e1be9b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Ya7EXO0_bUi6JmDUpQWj

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 twitter-x-posts-tweets-search-0e1be9b0
```

Example prompt: Search X for the latest public tweets mentioning 'climate summit' and show me the most recent ones with their like counts and author handles.

## When to prefer this

Choose this endpoint when you need to search public X/Twitter posts by keyword or phrase with rich per-tweet metadata (engagement metrics, author verification, language, parent tweet linkage) in a normalized schema. Prefer it over generic web search when you specifically need X post data for social listening, brand monitoring, or trend research. It is more targeted than the cross-platform Social Search endpoint when you only need X data, and more flexible than the X User Profile Lookup when you need topic-based search rather than a specific account.

## Known failure modes

- Bad or malformed query input is accepted but may return zero results at no charge
- No matching tweets returns an empty items array without billing
- Rate limiting or upstream X API restrictions may reduce result freshness
- Pagination with an invalid or expired cursor may return empty or repeat results
- Very broad queries may return unrelated or low-quality tweets

## How this service works

Twitter/X Posts & Tweets Search: the latest public tweets on X matching a keyword or phrase, newest first. Per tweet the text, author handle and name, verification, followers, likes, replies, retweets, views, language, time and URL in one schema shared by every platform; parent_id names the replied-to or quoted tweet; next_cursor gives the next page. For social listening, brand monitoring and research. Bad input is free; not found or no match is not charged.

## Output

Returns a JSON object with an array of tweet items (newest first), each containing tweet ID, URL, text, language, type, author object (handle, display name, verified flag, follower count), engagement metrics (likes, views, replies, reposts), platform, parent tweet ID for replies/quotes, creation timestamp, and media URLs. Also includes the search query echo, an as_of timestamp, a next_cursor for pagination, a request ID, and a disclaimer about data provenance.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 200,
       "description": "Search text (1-200 characters)."
      },
      "cursor": {
       "type": "string",
       "maxLength": 512,
       "description": "next_cursor of the previous page."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-15T12:00:00.000Z",
  "items": [
   {
    "id": "1910000000000000001",
    "url": "https://x.com/synth_alpha/status/1910000000000000001",
    "lang": "en",
    "text": "Trying the synthwidget beta today, the dark mode is great",
    "type": "post",
    "author": {
     "handle": "synth_alpha",
     "verified": true,
     "followers": 1234,
     "display_name": "Synthetic Alpha"
    },
    "metrics": {
     "likes": 11,
     "views": 780,
     "replies": 4,
     "reposts": 2
    },
    "platform": "x",
    "parent_id": "1910000000000000901",
    "created_at": "2026-10-01T18:50:27.000Z",
    "media_urls": []
   },
   {
    "id": "1910000000000000002",
    "url": "https://x.com/synth_beta/status/1910000000000000002",
    "lang": "en",
    "text": "synthwidget support never answered my ticket",
    "type": "post",
    "author": {
     "handle": "synth_beta",
     "verified": false,
     "followers": 88,
     "display_name": "Synthetic Beta"
    },
    "metrics": {
     "likes": 0,
     "views": 45,
     "replies": 1,
     "reposts": 0
    },
    "platform": "x",
    "parent_id": "1910000000000000001",
    "created_at": "2026-10-02T09:00:00.000Z",
    "media_urls": []
   }
  ],
  "query": {
   "q": "synthetic widgets",
   "cursor": null
  },
  "source": "public data via third-party provider; not affiliated with the platform",
  "complete": true,
  "platform": "x",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000",
  "next_cursor": "synthcursor_2"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-posts-tweets-search-0e1be9b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.duoleads.com](https://www.zero.xyz/host/social.duoleads.com/llms.txt)