# HubVibe X Pulse — Twitter/X Sentiment & Volume Analytics

> HubVibe X Pulse — Twitter/X Sentiment & Volume Analytics is a paid API for AI agents from hubvibe-io.com, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-01).

Returns aggregated Twitter/X post volume (hourly or daily), engagement metrics, language mix, top hashtags, and link/media share rates for any search query over the past 1–7 days — no individual posts or authors exposed.

## Facts

- Endpoint: POST https://hubvibe-io.com/work/social/x_pulse?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hubvibe-x-pulse-twitter-x-sentiment-volume-analytics-db538b31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gH3d_g97pAZmC6Imgqv8r

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 hubvibe-x-pulse-twitter-x-sentiment-volume-analytics-db538b31 -d '<json body>'
```

Example prompt: What's the tweet volume and engagement on X for 'climate change' over the last 3 days — break it down by day and tell me the top hashtags and language mix?

## When to prefer this

Choose this endpoint when you need quantified, aggregated Twitter/X signal — post volume trends, engagement rates, hashtag associations, and language distribution — for any keyword, hashtag, or boolean query, without needing access to individual post content. Ideal for brand monitoring, campaign measurement, trend detection, and competitive benchmarking. Prefer over general news APIs when specifically tracking social (not editorial) activity on X/Twitter.

## Known failure modes

- Empty results if query matches no recent posts within the time window
- Rate limiting or timeout if the X API backend is congested
- Invalid query syntax if unsupported X operators are used
- Language code not recognized if an invalid ISO 639-1 code is passed
- Sample size of 0 may return volume data only with no engagement metrics

## How this service works

Twitter / X sentiment and volume for any topic, as numbers, live: post volume per hour or day over the last 1-7 days, and over a sample of recent posts the engagement totals and rate (likes, reposts, replies, quotes, impressions), language mix, top hashtags and link/media share. Aggregates only: no post text or authors. Input: query (X operators allowed); optional days, granularity, sample, lang.

## Output

Returns aggregated time-series post volume (per hour or day), engagement totals and rate (likes, reposts, replies, quotes, impressions) across a sample of recent posts, language distribution, top hashtags, and link/media share percentages. No individual post text or author data is included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "maximum": 7,
   "minimum": 1
  },
  "lang": {
   "type": "string",
   "maxLength": 2,
   "minLength": 2
  },
  "query": {
   "type": "string",
   "maxLength": 400,
   "minLength": 1
  },
  "sample": {
   "type": "integer",
   "maximum": 100,
   "minimum": 0
  },
  "language": {
   "type": "string",
   "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
   "maxLength": 35
  },
  "granularity": {
   "enum": [
    "hour",
    "day"
   ],
   "type": "string"
  },
  "include_retweets": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "as_of": "2026-09-27T08:59:45Z",
   "query": "open source",
   "sample": {
    "read": 20,
    "pages": 1,
    "requested": 20,
    "x_cost_usd": 0.1
   },
   "source": "x-api-v2",
   "volume": {
    "total": 21636,
    "buckets": [
     {
      "end": "2026-09-27T00:00:00.000Z",
      "count": 7200,
      "start": "2026-09-26T00:00:00.000Z"
     }
    ],
    "bucket_count": 4
   },
   "window": {
    "end": "2026-09-27T08:59:45Z",
    "days": 3,
    "start": "2026-09-24T09:00:00Z"
   },
   "checked_at": "2026-09-26T18:00:00Z",
   "engagement": {
    "languages": {
     "en": 20
    },
    "max_likes": 120,
    "mean_likes": 17,
    "posts_read": 20,
    "likes_total": 340,
    "quotes_total": 5,
    "top_hashtags": [
     {
      "tag": "opensource",
      "posts": 4
     }
    ],
    "replies_total": 27,
    "reposts_total": 41,
    "with_links_pct": 40,
    "with_media_pct": 15,
    "bookmarks_total": 12,
    "max_impressions": 18000,
    "mean_impressions": 2560,
    "impressions_total": 51200,
    "with_hashtags_pct": 35,
    "engagement_rate_pct": 0.807,
    "possibly_sensitive_pct": 0
   },
   "granularity": "day",
   "effective_query": "open source lang:en -is:retweet"
  },
  "status": "ok",
  "worker": "social.x_pulse",
  "price_usd": 0.5,
  "provenance": {
   "steps": [
    {
     "ms": 312,
     "ok": true,
     "step": "quote",
     "reason": "provider_timeout",
     "provider": "coinbase-advanced-trade-public"
    }
   ],
   "attempts": 1,
   "elapsed_ms": 340,
   "providers_used": [
    "coinbase-advanced-trade-public"
   ]
  },
  "receipt_id": "rcpt_9f1c2b3a4d5e6f70",
  "attribution": [
   {
    "url": "https://translate.google.com",
    "text": "Translated by Google"
   }
  ],
  "receipt_url": "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hubvibe-x-pulse-twitter-x-sentiment-volume-analytics-db538b31/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hubvibe-io.com](https://www.zero.xyz/host/hubvibe-io.com/llms.txt)