api.socialfetch.dev

{
  "description": "Standard success response envelope.",
  "properties": {
    "data": {
      "description": "Endpoint-specific response payload.",
      "properties": {
        "comments": {
          "description": "Top-level comments for the resolved video.",
          "items": {
            "description": "A single top-level comment on a YouTube video.",
            "properties": {
              "author": {
                "description": "Comment author.",
                "properties": {
                  "avatarUrl": {
                    "description": "Profile image URL for the commenter when available.",
                    "nullable": true,
                    "type": "string"
                  },
                  "channelUrl": {
                    "description": "Channel page URL when available.",
                    "nullable": true,
                    "type": "string"
                  },
                  "creator": {
                    "description": "Whether the commenter is the video creator.",
                    "type": "boolean"
                  },
                  "displayName": {
                    "description": "Display name shown on the commenter channel.",
                    "nullable": true,
                    "type": "string"
                  },
                  "handle": {
                    "description": "Public YouTube channel handle without a leading @.",
                    "minLength": 1,
                    "type": "string"
                  },
                  "platformUserId": {
                    "description": "YouTube channel id when available.",
                    "type": "string"
                  },
                  "verified": {
                    "description": "Whether the commenter channel is verified.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "handle",
                  "displayName",
                  "verified",
                  "creator",
                  "avatarUrl",
                  "channelUrl"
                ],
                "type": "object"
              },
              "createdAt": {
                "description": "ISO-8601 timestamp when the comment was published.",
                "type": "string"
              },
              "id": {
                "description": "Stable identifier for the comment.",
                "minLength": 1,
                "type": "string"
              },
              "likeCount": {
                "description": "Like count on the comment.",
                "minimum": 0,
                "type": "integer"
              },
              "publishedTimeText": {
                "description": "Human-readable relative publish time when available.",
                "nullable": true,
                "type": "string"
              },
              "repliesCursor": {
                "description": "Use as `cursor` on comment replies. Null when unavailable.",
                "nullable": true,
                "type": "string"
              },
              "replyCount": {
                "description": "Direct reply count for the comment thread.",
                "minimum": 0,
                "type": "integer"
              },
              "text": {
                "description": "Comment text.",
                "type": "string"
              }
            },
            "required": [
              "id",
              "text",
              "createdAt",
              "publishedTimeText",
              "likeCount",
              "replyCount",
              "repliesCursor",
              "author"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "lookupStatus": {
          "description": "Whether the video was resolved for this request.",
          "enum": [
            "found",
            "not_found"
          ],
          "type": "string"
        },
        "page": {
          "description": "Pagination information for this response.",
          "properties": {
            "hasMore": {
              "description": "Whether another page of comments is available.",
              "type": "boolean"
            },
            "nextCursor": {
              "description": "Cursor to pass in the next request when more pages exist.",
              "nullable": true,
              "type": "string"
            }
          },
          "required": [
            "nextCursor",
            "hasMore"
          ],
          "type": "object"
        }
      },
      "required": [
        "lookupStatus",
        "comments",
        "page"
      ],
      "type": "object"
    },
    "meta": {
      "description": "Metadata describing the request and billing outcome.",
      "properties": {
        "cached": {
          "description": "True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.",
          "type": "boolean"
        },
        "creditsCharged": {
          "description": "Credits charged for this request.",
          "minimum": 0,
          "type": "integer"
        },
        "requestId": {
          "description": "Unique request identifier for tracing this API call.",
          "minLength": 1,
          "type": "string"
        },
        "version": {
          "description": "Public API version that served the response.",
          "enum": [
            "v1"
          ],
          "type": "string"
        }
      },
      "required": [
        "requestId",
        "creditsCharged",
        "version"
      ],
      "type": "object"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "type": "object"
}