# SCRIPTMASTERLABS Public X (Twitter) Search

> SCRIPTMASTERLABS Public X (Twitter) Search is a paid API for AI agents from scriptmasterlabs.com, paid per call via x402, $0.0048/call, status unknown (last checked 2026-10-12).

Search public X (Twitter) posts by keyword query and return latest or top results with author and metadata, paid per call via x402.

## Facts

- Endpoint: GET https://scriptmasterlabs.com/api/x/search?utm_source=zero.xyz
- Price: $0.0048/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scriptmasterlabs-public-x-twitter-search-f7bb82bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qYMNzwp3Z85gcZd2OLe_D

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 scriptmasterlabs-public-x-twitter-search-f7bb82bc
```

Example prompt: Search X for the latest 5 posts mentioning 'x402' and show me the text and author of each one.

## When to prefer this

Choose this endpoint when you need real-time public X/Twitter post retrieval in a pay-per-call model without a long-term API subscription. Ideal for agents that need occasional social search without managing Twitter API credentials directly. Particularly suited for x402-compatible agent workflows where micropayment per call is acceptable and you want read-only access to public posts with provenance guarantees.

## Known failure modes

- Empty results if query matches no recent public posts
- Payment failure if x402 wallet balance is insufficient or payment is rejected
- Rate limiting or quota errors from the underlying Twitter API
- Invalid query parameter (empty string or exceeding 512 characters) returns validation error
- Unsupported type enum value causes schema validation failure

## How this service works

Pay-per-call APIs and a read-only provider check for x402 buyers. Inspect evidence and live terms before a caller-controlled payment; accept delivery with proof.

## Output

Returns a JSON object containing the search query, result type, product name, and an array of up to 10 posts each with post ID, public URL, post text, author username, and creation timestamp, plus provenance info confirming the underlying provider is Twitter APIs in read-only mode.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 512,
       "minLength": 1,
       "description": "Public X search query Search intents: x search, twitter search, social search, public posts, social research."
      },
      "type": {
       "enum": [
        "Latest",
        "Top"
       ],
       "type": "string",
       "description": "Search intents: x search, twitter search, social search, public posts, social research."
      },
      "max_results": {
       "enum": [
        "1",
        "2",
        "3",
        "4",
        "5",
        "6",
        "7",
        "8",
        "9",
        "10"
       ],
       "type": "string",
       "description": "Search intents: x search, twitter search, social search, public posts, social research."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "Latest",
  "query": "x402",
  "status": "ready",
  "product": "SML Public X Search",
  "results": [
   {
    "id": "<public-post-id>",
    "url": "https://x.com/<public-handle>/status/<public-post-id>",
    "text": "<public-post-text>",
    "author": {
     "username": "<public-handle>"
    },
    "created_at": "<source-timestamp>"
   }
  ],
  "provenance": {
   "provider": "twitterapis",
   "public_read_only": true
  },
  "result_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scriptmasterlabs-public-x-twitter-search-f7bb82bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scriptmasterlabs.com](https://www.zero.xyz/host/scriptmasterlabs.com/llms.txt)