# aiworker Social Mentions Search

> aiworker Social Mentions Search is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Searches Hacker News and Polymarket for recent posts and comments matching a topic, returning ranked mentions with source attribution and event context

## Facts

- Endpoint: POST https://aiworker.duckdns.org/v1/social/mentions
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiworker-social-mentions-search-009f95df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RYUDaLiNUL7ESjlfi6nu1

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 aiworker-social-mentions-search-009f95df -d '<json body>'
```

Example prompt: Search for recent mentions of 'Ethereum' across Hacker News and Polymarket from the last 24 hours — give me up to 30 results, newest first.

## When to prefer this

Choose this endpoint when you need real-time community and prediction-market sentiment for a specific topic aggregated from Hacker News and Polymarket in a single call. It is ideal for crypto, DeFi, and macro-event monitoring where you want both technical-community (HN) and prediction-market (Polymarket) perspectives together. Prefer it over generic web search when you want structured, ranked results with point scores, source attribution, and event context rather than raw HTML.

## Known failure modes

- Upstream Hacker News or Polymarket API unavailable — source marked ok:false in the sources array
- Query too short (under 2 chars) or too long (over 120 chars) — validation error returned
- hours out of range (must be 1–168) — request rejected
- limit out of range (must be 1–50) — request rejected
- No matching mentions found — items array is empty with valid source statuses
- Payment not confirmed via x402 — request not processed

## How this service works

Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1

## Output

A JSON object containing an array of mention items (each with URL, source, author, text snippet, points, published timestamp, and optional Polymarket event metadata), a per-source mention count breakdown, source health status for each upstream API, the query echo, the time window used, and generated/disclaimer attribution fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hours": {
   "type": "integer",
   "default": 48,
   "maximum": 168,
   "minimum": 1,
   "description": "Only mentions published within the last N hours (default 48)."
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1,
   "description": "Maximum mentions to return, newest first (default 20)."
  },
  "query": {
   "type": "string",
   "maxLength": 120,
   "minLength": 2,
   "description": "Topic to look for, matched whole-word and case-insensitively against post text (and Polymarket event titles)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "url": "https://news.ycombinator.com/item?id=43211234",
    "kind": "story",
    "text": "Keystone's independent analysis of the Coldcard exploit",
    "event": null,
    "author": "anon84",
    "points": 87,
    "source": "hackernews",
    "published": "2026-09-11T14:02:00.000Z"
   },
   {
    "url": "https://polymarket.com/event/fed-decision-in-september-762",
    "kind": "comment",
    "text": "if the fed holds, bitcoin rips",
    "event": {
     "slug": "fed-decision-in-september-762",
     "title": "Fed decision in September?"
    },
    "author": "Sandy-Evaluator-Speedboat",
    "points": null,
    "source": "polymarket",
    "published": "2026-09-11T12:10:17.000Z"
   }
  ],
  "query": "bitcoin",
  "counts": {
   "hackernews": 1,
   "polymarket": 1
  },
  "sources": [
   {
    "ok": true,
    "url": "https://hn.algolia.com/api/v1/search_by_date",
    "name": "hackernews"
   },
   {
    "ok": true,
    "url": "https://gamma-api.polymarket.com/comments",
    "name": "polymarket"
   }
  ],
  "disclaimer": "…",
  "attribution": "…",
  "generated_at": "2026-09-11T20:00:00.000Z",
  "window_hours": 48
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aiworker-social-mentions-search-009f95df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiworker.duckdns.org](https://www.zero.xyz/host/aiworker.duckdns.org/llms.txt)