hubvibe-io.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.",
  "properties": {
    "attribution": {
      "$ref": "#/components/schemas/Attribution"
    },
    "billing_warning": {
      "description": "Present only when the charge was recorded with a caveat.",
      "examples": [
        "settlement pending"
      ],
      "type": "string"
    },
    "price_usd": {
      "description": "What this call cost, in USD.",
      "examples": [
        0.02
      ],
      "type": "number"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    },
    "receipt_id": {
      "description": "Receipt id for this job.",
      "examples": [
        "rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "receipt_url": {
      "description": "Where to fetch the machine-readable receipt (free, no payment).",
      "examples": [
        "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "result": {
      "properties": {
        "as_of": {
          "description": "End of the window analysed.",
          "examples": [
            "2026-09-27T08:59:45Z"
          ],
          "type": "string"
        },
        "checked_at": {
          "description": "When this node read the source (UTC). Nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "effective_query": {
          "description": "The query sent to X (lang: and -is:retweet added unless given).",
          "examples": [
            "open source lang:en -is:retweet"
          ],
          "type": "string"
        },
        "engagement": {
          "description": "Engagement aggregates over the sample; null when sample is 0.",
          "properties": {
            "bookmarks_total": {
              "description": "Bookmarks summed.",
              "examples": [
                12
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "engagement_rate_pct": {
              "description": "(likes+reposts+replies+quotes)/impressions, percent.",
              "examples": [
                0.807
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "impressions_total": {
              "description": "Impressions summed.",
              "examples": [
                51200
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "languages": {
              "additionalProperties": {
                "type": "integer"
              },
              "description": "Posts per language code.",
              "examples": [
                {
                  "en": 20
                }
              ],
              "properties": {},
              "required": [],
              "type": "object"
            },
            "likes_total": {
              "description": "Likes summed.",
              "examples": [
                340
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "max_impressions": {
              "description": "Most-seen post's impressions.",
              "examples": [
                18000
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "max_likes": {
              "description": "Most-liked post's likes.",
              "examples": [
                120
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "mean_impressions": {
              "description": "Mean impressions per post.",
              "examples": [
                2560
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "mean_likes": {
              "description": "Mean likes per post.",
              "examples": [
                17
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "possibly_sensitive_pct": {
              "description": "Share X flags as possibly sensitive.",
              "examples": [
                0
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "posts_read": {
              "description": "Posts in the sample.",
              "examples": [
                20
              ],
              "type": "integer"
            },
            "quotes_total": {
              "description": "Quotes summed.",
              "examples": [
                5
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "replies_total": {
              "description": "Replies summed.",
              "examples": [
                27
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "reposts_total": {
              "description": "Reposts summed.",
              "examples": [
                41
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "top_hashtags": {
              "description": "Up to 10 most-used hashtags.",
              "examples": [
                [
                  {
                    "posts": 4,
                    "tag": "opensource"
                  }
                ]
              ],
              "items": {
                "description": "One hashtag.",
                "properties": {
                  "posts": {
                    "description": "Posts using it.",
                    "examples": [
                      4
                    ],
                    "type": "integer"
                  },
                  "tag": {
                    "description": "Hashtag, lower-cased.",
                    "examples": [
                      "opensource"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "tag",
                  "posts"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "with_hashtags_pct": {
              "description": "Share of posts with a hashtag.",
              "examples": [
                35
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "with_links_pct": {
              "description": "Share of posts linking outside X.",
              "examples": [
                40
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "with_media_pct": {
              "description": "Share of posts with photos or video.",
              "examples": [
                15
              ],
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "posts_read",
            "likes_total",
            "reposts_total",
            "replies_total",
            "quotes_total",
            "impressions_total",
            "bookmarks_total",
            "mean_likes",
            "mean_impressions",
            "max_likes",
            "max_impressions",
            "engagement_rate_pct",
            "languages",
            "top_hashtags",
            "with_hashtags_pct",
            "with_links_pct",
            "with_media_pct",
            "possibly_sensitive_pct"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "granularity": {
          "description": "Volume bucket size.",
          "enum": [
            "hour",
            "day"
          ],
          "examples": [
            "day"
          ],
          "type": "string"
        },
        "query": {
          "description": "The query as given.",
          "examples": [
            "open source"
          ],
          "type": "string"
        },
        "sample": {
          "description": "The sample the engagement figures rest on.",
          "properties": {
            "pages": {
              "description": "Search pages fetched.",
              "examples": [
                1
              ],
              "type": "integer"
            },
            "read": {
              "description": "Posts actually read.",
              "examples": [
                20
              ],
              "type": "integer"
            },
            "requested": {
              "description": "Posts asked to read.",
              "examples": [
                20
              ],
              "type": "integer"
            },
            "x_cost_usd": {
              "description": "What X bills for the posts read, at $0.005 each.",
              "examples": [
                0.1
              ],
              "type": "number"
            }
          },
          "required": [
            "requested",
            "read",
            "pages",
            "x_cost_usd"
          ],
          "type": "object"
        },
        "source": {
          "const": "x-api-v2",
          "description": "Data source.",
          "type": "string"
        },
        "volume": {
          "description": "Post volume from X's recent-counts endpoint.",
          "properties": {
            "bucket_count": {
              "description": "Buckets returned.",
              "examples": [
                4
              ],
              "type": "integer"
            },
            "buckets": {
              "description": "Counts per bucket, oldest first.",
              "items": {
                "description": "One bucket.",
                "properties": {
                  "count": {
                    "description": "Posts in the bucket.",
                    "examples": [
                      7200
                    ],
                    "type": "integer"
                  },
                  "end": {
                    "description": "Bucket end.",
                    "examples": [
                      "2026-09-27T00:00:00.000Z"
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "start": {
                    "description": "Bucket start.",
                    "examples": [
                      "2026-09-26T00:00:00.000Z"
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "start",
                  "end",
                  "count"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "total": {
              "description": "Posts matching the query in the window.",
              "examples": [
                21636
              ],
              "type": "integer"
            }
          },
          "required": [
            "total",
            "buckets",
            "bucket_count"
          ],
          "type": "object"
        },
        "window": {
          "description": "The window analysed.",
          "properties": {
            "days": {
              "description": "Days covered.",
              "examples": [
                3
              ],
              "type": "integer"
            },
            "end": {
              "description": "Window end (RFC 3339), a few seconds before the call.",
              "examples": [
                "2026-09-27T08:59:45Z"
              ],
              "type": "string"
            },
            "start": {
              "description": "Window start (RFC 3339).",
              "examples": [
                "2026-09-24T09:00:00Z"
              ],
              "type": "string"
            }
          },
          "required": [
            "start",
            "end",
            "days"
          ],
          "type": "object"
        }
      },
      "required": [
        "query",
        "effective_query",
        "window",
        "granularity",
        "volume",
        "sample",
        "engagement",
        "source",
        "as_of",
        "checked_at"
      ],
      "type": "object"
    },
    "status": {
      "const": "ok",
      "description": "Present only on a delivered result.",
      "type": "string"
    },
    "worker": {
      "description": "Catalog name of the worker that ran.",
      "examples": [
        "market.quote"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "worker",
    "price_usd",
    "result",
    "provenance",
    "receipt_id",
    "receipt_url"
  ],
  "title": "social.x_pulse response",
  "type": "object"
}