# KG-NINJA Hyperxosist Twitter/X Query Builder

> KG-NINJA Hyperxosist Twitter/X Query Builder is a paid API for AI agents from api.kgninja.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Builds a structured Twitter/X search query and URL from natural language search parameters like keywords, filters, date ranges, and engagement thresholds.

## Facts

- Endpoint: POST https://api.kgninja.dev/hyperxosist-query?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kg-ninja-hyperxosist-twitter-x-query-builder-bd9514f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3_we_htiD_mDgqMeXPZVW

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 kg-ninja-hyperxosist-twitter-x-query-builder-bd9514f2 -d '<json body>'
```

Example prompt: Search X for live tweets about 'Cloudflare Workers' in English since 2024-01-01 that have at least 50 likes, exclude any tweets with links, and apply low noise filtering — give me the search URL.

## When to prefer this

Choose this endpoint when you need to construct a precise, multi-filter Twitter/X search query programmatically — especially when combining date ranges, engagement thresholds, language filters, media filters, and noise reduction in a single call. Prefer it over manual query construction or generic search APIs when the target platform is specifically X/Twitter and you need a ready-to-use search URL.

## Known failure modes

- Invalid date format in sinceDate or untilDate returns an error
- Empty or missing keywords may produce an overly broad or invalid query
- Conflicting filters (e.g. hasImages and excludeLinks simultaneously) may yield no results on X
- minFaves or minRetweets as non-numeric strings may cause parsing errors
- Unsupported language codes in the lang field may silently produce incorrect queries

## How this service works

Machine-payable agent API with free discovery and preview tools, plus x402-paid execution endpoints for structured agent results.

## Output

Returns a JSON object containing the constructed X/Twitter search query string (e.g. 'Cloudflare Workers lang:en') and a fully-formed X search URL ready to open or pass to a scraper, with all specified filters encoded.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lang": {
   "type": "string"
  },
  "mode": {
   "enum": [
    "live",
    "top"
   ],
   "type": "string"
  },
  "noise": {
   "type": "object",
   "properties": {
    "preset": {
     "enum": [
      "low",
      "medium",
      "high"
     ],
     "type": "string"
    },
    "enabled": {
     "type": "boolean"
    },
    "removed": {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "fromUser": {
   "type": "string"
  },
  "keywords": {
   "type": "string"
  },
  "minFaves": {
   "type": [
    "string",
    "number"
   ]
  },
  "hasImages": {
   "type": "boolean"
  },
  "hasVideos": {
   "type": "boolean"
  },
  "sinceDate": {
   "type": "string"
  },
  "untilDate": {
   "type": "string"
  },
  "exactPhrase": {
   "type": "string"
  },
  "minRetweets": {
   "type": [
    "string",
    "number"
   ]
  },
  "excludeLinks": {
   "type": "boolean"
  },
  "excludeWords": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "Cloudflare Workers lang:en",
  "searchUrl": "https://x.com/search?q=Cloudflare%20Workers%20lang%3Aen&src=typed_query&f=live"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kg-ninja-hyperxosist-twitter-x-query-builder-bd9514f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.kgninja.dev](https://www.zero.xyz/host/api.kgninja.dev/llms.txt)