# PayWeave Twitter Trends

> PayWeave Twitter Trends is a paid API for AI agents from twitter.payweave.services, paid per call via x402, $0.007965/call, status unknown (last checked 2026-09-15).

Fetches trending topics on X/Twitter for a specified geographic location using a Yahoo WOEID

## Facts

- Endpoint: GET https://twitter.payweave.services/trends
- Price: $0.007965/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/payweave-twitter-trends-f4651d4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JcvsCusK-v6xSO1j9Zbsw

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 payweave-twitter-trends-f4651d4f
```

Example prompt: What are the top 50 trending topics on Twitter right now globally — use WOEID 1 for worldwide and return 50 trends.

## When to prefer this

Choose this endpoint when you need location-specific or worldwide trending topics from X/Twitter indexed by Yahoo WOEID. It is ideal for social listening, marketing intelligence, content strategy, and real-time event monitoring. It is more cost-effective than building a direct Twitter API integration and supports pay-per-call billing in USDC via x402 with no subscription required.

## Known failure modes

- Invalid WOEID returns empty trends array or error status
- Count value outside 30–100 range may be rejected or clamped
- Rate limiting or upstream twitterapi.io outage returns non-200 status
- Missing required woeid field causes schema validation failure
- Payment failure (x402) prevents request from being processed

## How this service works

X/Twitter data — tweets, users, communities, lists, articles, and trends.

## Output

A JSON object containing a status field and a trends array, where each trend object includes the trend name, target query string, and rank. The response is forwarded verbatim from twitterapi.io. Up to 100 trends can be returned per call depending on the count parameter.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "anyOf": [
      {
       "not": {}
      },
      {
       "type": "object",
       "required": [
        "woeid"
       ],
       "properties": {
        "count": {
         "type": "string",
         "pattern": "^\\d+$",
         "description": "Number of trends to return. Minimum/default 30, max 100. Price scales with this value (15 credits/trend)."
        },
        "woeid": {
         "type": "string",
         "pattern": "^\\d+$",
         "description": "Yahoo \"Where On Earth ID\" for the location, e.g. 1 (worldwide), 2418046."
        }
       },
       "additionalProperties": false
      }
     ]
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "GET"
    },
    "bodyType": {
     "type": "string",
     "const": "json"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "example"
   ],
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "status": {
       "type": "string"
      },
      "trends": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": {}
       },
       "description": "Array of trend objects: name, target query, rank."
      }
     },
     "description": "Trends JSON forwarded verbatim from twitterapi.io.",
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/payweave-twitter-trends-f4651d4f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.payweave.services](https://www.zero.xyz/host/twitter.payweave.services/llms.txt)