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": "The same instant as checked_at: YouTube does not stamp its statistics.",
          "examples": [
            "2026-09-27T12:00:00Z"
          ],
          "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"
        },
        "item_count": {
          "description": "Videos returned.",
          "examples": [
            3
          ],
          "type": "integer"
        },
        "items": {
          "description": "Videos, in YouTube's search order (or the order of the ids asked); ids YouTube does not know are absent.",
          "items": {
            "description": "One video, with its live statistics.",
            "properties": {
              "channel_id": {
                "description": "Uploading channel id.",
                "examples": [
                  "UCoBPd2jgYzQ5m8k3f1nR9wA"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "channel_title": {
                "description": "Uploading channel name.",
                "examples": [
                  "Coinbase Developer Platform"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "comment_count": {
                "description": "Comments; null when hidden or comments are off.",
                "examples": [
                  112
                ],
                "type": [
                  "integer",
                  "null"
                ]
              },
              "description": {
                "description": "Description, cut at 500 characters; null when empty.",
                "examples": [
                  "A short intro to open source licences."
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "duration_seconds": {
                "description": "Length in whole seconds from contentDetails.duration; 0 for a live or upcoming stream; null when YouTube did not return the video's details.",
                "examples": [
                  754
                ],
                "type": [
                  "integer",
                  "null"
                ]
              },
              "like_count": {
                "description": "Likes; null when the uploader hides them.",
                "examples": [
                  2225
                ],
                "type": [
                  "integer",
                  "null"
                ]
              },
              "live": {
                "description": "Live or upcoming broadcast (liveBroadcastContent is not none); null when not stated.",
                "examples": [
                  false
                ],
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "published_at": {
                "description": "Upload time as YouTube states it (ISO 8601).",
                "examples": [
                  "2026-05-14T16:00:12Z"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "thumbnail_url": {
                "description": "Thumbnail URL, the high size when YouTube offers it.",
                "examples": [
                  "https://i.ytimg.com/vi/IJhS_fv5Ktk/hqdefault.jpg"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "title": {
                "description": "Title.",
                "examples": [
                  "Open source licensing explained"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "description": "Watch URL.",
                "examples": [
                  "https://www.youtube.com/watch?v=IJhS_fv5Ktk"
                ],
                "type": "string"
              },
              "video_id": {
                "description": "YouTube video id.",
                "examples": [
                  "IJhS_fv5Ktk"
                ],
                "type": "string"
              },
              "view_count": {
                "description": "Views; null when YouTube does not send it.",
                "examples": [
                  52004
                ],
                "type": [
                  "integer",
                  "null"
                ]
              }
            },
            "required": [
              "video_id",
              "url",
              "title",
              "description",
              "channel_id",
              "channel_title",
              "published_at",
              "duration_seconds",
              "view_count",
              "like_count",
              "comment_count",
              "live",
              "thumbnail_url"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "query": {
          "description": "The query as given; null when video_ids were looked up.",
          "examples": [
            "open source licensing"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "source": {
          "const": "youtube-data-api",
          "description": "Data source.",
          "type": "string"
        },
        "total_results": {
          "description": "YouTube's estimated total matches for the query (pageInfo.totalResults); null when not sent.",
          "examples": [
            19113
          ],
          "type": [
            "integer",
            "null"
          ]
        },
        "video_ids": {
          "description": "The ids asked for, in order; null when a query was searched.",
          "examples": [
            [
              "IJhS_fv5Ktk"
            ]
          ],
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "required": [
        "query",
        "video_ids",
        "total_results",
        "items",
        "item_count",
        "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": "video.youtube response",
  "type": "object"
}