{
  "components": {
    "schemas": {
      "Certification": {
        "properties": {
          "credential_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Credential Id"
          },
          "credential_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Credential Url"
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "issued_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Issued At"
          },
          "issuer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Issuer"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          }
        },
        "title": "Certification",
        "type": "object"
      },
      "Comment": {
        "properties": {
          "author": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicAuthor"
              },
              {
                "type": "null"
              }
            ]
          },
          "comment_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment Id"
          },
          "comment_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment Url"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "metrics": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EngagementMetrics"
              },
              {
                "type": "null"
              }
            ]
          },
          "parent_comment_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parent Comment Id"
          },
          "post": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/pilot__api__scrapers__PostContext"
              },
              {
                "type": "null"
              }
            ]
          },
          "replies": {
            "items": {
              "$ref": "#/components/schemas/Reply"
            },
            "title": "Replies",
            "type": "array"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          }
        },
        "title": "Comment",
        "type": "object"
      },
      "CommentPage": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Comment"
            },
            "title": "Items",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Page"
          },
          "total": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total"
          }
        },
        "required": [
          "items",
          "count"
        ],
        "title": "CommentPage",
        "type": "object"
      },
      "CompanyEmployeesRequest": {
        "additionalProperties": false,
        "properties": {
          "companies": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Companies",
            "type": "array"
          },
          "company_headcounts": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Company Headcounts",
            "type": "array"
          },
          "detail_level": {
            "default": "basic",
            "enum": [
              "basic",
              "full"
            ],
            "title": "Detail Level",
            "type": "string"
          },
          "exclude_functions": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 30,
            "title": "Exclude Functions",
            "type": "array"
          },
          "exclude_industries": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Industries",
            "type": "array"
          },
          "exclude_locations": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Locations",
            "type": "array"
          },
          "exclude_past_titles": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Past Titles",
            "type": "array"
          },
          "exclude_seniority_levels": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Exclude Seniority Levels",
            "type": "array"
          },
          "exclude_titles": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Titles",
            "type": "array"
          },
          "experience_levels": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Experience Levels",
            "type": "array"
          },
          "functions": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 30,
            "title": "Functions",
            "type": "array"
          },
          "industries": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Industries",
            "type": "array"
          },
          "limit": {
            "default": 100,
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "locations": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Locations",
            "type": "array"
          },
          "page": {
            "default": 1,
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "pages": {
            "default": 1,
            "maximum": 20.0,
            "minimum": 1.0,
            "title": "Pages",
            "type": "integer"
          },
          "past_titles": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Past Titles",
            "type": "array"
          },
          "query": {
            "anyOf": [
              {
                "maxLength": 300,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Query"
          },
          "recently_changed_jobs": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recently Changed Jobs"
          },
          "seniority_levels": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Seniority Levels",
            "type": "array"
          },
          "titles": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Titles",
            "type": "array"
          },
          "years_at_company": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Years At Company",
            "type": "array"
          }
        },
        "required": [
          "companies"
        ],
        "title": "CompanyEmployeesRequest",
        "type": "object"
      },
      "Course": {
        "properties": {
          "associated_with": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Associated With"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "number": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Number"
          }
        },
        "title": "Course",
        "type": "object"
      },
      "DateRange": {
        "properties": {
          "end": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "End"
          },
          "start": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Start"
          }
        },
        "title": "DateRange",
        "type": "object"
      },
      "Education": {
        "properties": {
          "activities": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Activities"
          },
          "date_range": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DateRange"
              },
              {
                "type": "null"
              }
            ]
          },
          "degree": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Degree"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "field_of_study": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Field Of Study"
          },
          "school": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "School"
          },
          "school_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "School Url"
          }
        },
        "title": "Education",
        "type": "object"
      },
      "EngagementMetrics": {
        "properties": {
          "comments": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments"
          },
          "impressions": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Impressions"
          },
          "reaction_breakdown": {
            "items": {
              "$ref": "#/components/schemas/ReactionCount"
            },
            "title": "Reaction Breakdown",
            "type": "array"
          },
          "reactions": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reactions"
          },
          "reposts": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts"
          },
          "shares": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Shares"
          },
          "views": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Views"
          }
        },
        "title": "EngagementMetrics",
        "type": "object"
      },
      "FacebookCandidate": {
        "additionalProperties": false,
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "missing_fields": {
            "description": "Unavailable core profile fields. No inferred or purchased enrichment.",
            "items": {
              "enum": [
                "display_name",
                "biography",
                "image_url"
              ],
              "type": "string"
            },
            "maxItems": 3,
            "title": "Missing Fields",
            "type": "array"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_type": {
            "anyOf": [
              {
                "enum": [
                  "person",
                  "page"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Type"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PublicProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "rank": {
            "description": "Absolute one-based position after canonical account deduplication, preserving native order.",
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Rank",
            "type": "integer"
          },
          "status": {
            "const": "candidate",
            "title": "Status",
            "type": "string"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "query",
          "rank",
          "status",
          "missing_fields",
          "profile_url"
        ],
        "title": "FacebookCandidate",
        "type": "object"
      },
      "FacebookComment": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/FacebookCommentAuthor"
          },
          "comment_id": {
            "title": "Comment Id",
            "type": "string"
          },
          "comment_scope": {
            "enum": [
              "top_level",
              "top_level_candidate"
            ],
            "title": "Comment Scope",
            "type": "string"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "parent_comment_id": {
            "title": "Parent Comment Id",
            "type": "null"
          },
          "post_url": {
            "title": "Post Url",
            "type": "string"
          },
          "relation_evidence": {
            "const": "comment_permalink",
            "title": "Relation Evidence",
            "type": "string"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "comment_id",
          "url",
          "post_url",
          "author",
          "timestamp",
          "text",
          "likes_count",
          "parent_comment_id",
          "comment_scope",
          "relation_evidence"
        ],
        "title": "FacebookComment",
        "type": "object"
      },
      "FacebookCommentAuthor": {
        "additionalProperties": false,
        "properties": {
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Url"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "username",
          "profile_url",
          "profile_id",
          "display_name",
          "image_url"
        ],
        "title": "FacebookCommentAuthor",
        "type": "object"
      },
      "FacebookCommentsPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "description": "Unknown upstream completeness; a final cached page does not prove exhaustion.",
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "group_url": {
            "title": "Group Url",
            "type": "null"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/FacebookComment"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "keyword": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Keyword"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "local_filters": {
            "items": {
              "enum": [
                "keyword",
                "since_date",
                "until_date"
              ],
              "type": "string"
            },
            "title": "Local Filters",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "post_url": {
            "title": "Post Url",
            "type": "string"
          },
          "query": {
            "title": "Query",
            "type": "null"
          },
          "query_handling": {
            "title": "Query Handling",
            "type": "null"
          },
          "requested_collection_size": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "since_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since Date"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          },
          "until_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Until Date"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "query",
          "keyword",
          "since_date",
          "until_date",
          "local_filters",
          "query_handling",
          "group_url",
          "post_url"
        ],
        "title": "FacebookCommentsPage",
        "type": "object"
      },
      "FacebookCommentsRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 100,
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "keyword": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional literal case-insensitive substring checked on returned text; not Boolean search syntax.",
            "title": "Keyword"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "post_url": {
            "maxLength": 512,
            "minLength": 1,
            "title": "Post Url",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "since_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive lower UTC date checked against returned timestamps.",
            "title": "Since Date"
          },
          "until_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exclusive upper UTC date checked against returned timestamps.",
            "title": "Until Date"
          }
        },
        "required": [
          "post_url"
        ],
        "title": "FacebookCommentsRequest",
        "type": "object"
      },
      "FacebookGroupCandidate": {
        "additionalProperties": false,
        "properties": {
          "admin_moderator_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Admin Moderator Count"
          },
          "average_posts_per_day": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Average Posts Per Day"
          },
          "content_retrieved": {
            "const": false,
            "title": "Content Retrieved",
            "type": "boolean"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "group_id": {
            "title": "Group Id",
            "type": "string"
          },
          "group_url": {
            "title": "Group Url",
            "type": "string"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "members_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Members Count"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "posts_last_month": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Last Month"
          },
          "posts_today": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Today"
          },
          "privacy": {
            "anyOf": [
              {
                "enum": [
                  "public",
                  "private"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Privacy"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "relation_evidence": {
            "const": "public_group_profile",
            "title": "Relation Evidence",
            "type": "string"
          },
          "vanity": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Vanity"
          },
          "visibility": {
            "anyOf": [
              {
                "enum": [
                  "visible",
                  "hidden"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Visibility"
          }
        },
        "required": [
          "group_id",
          "group_url",
          "name",
          "vanity",
          "privacy",
          "visibility",
          "members_count",
          "description",
          "location",
          "image_url",
          "posts_today",
          "posts_last_month",
          "average_posts_per_day",
          "created_at",
          "admin_moderator_count",
          "query",
          "content_retrieved",
          "relation_evidence"
        ],
        "title": "FacebookGroupCandidate",
        "type": "object"
      },
      "FacebookGroupPost": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/PostAuthor"
          },
          "comments_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Count"
          },
          "geotag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostGeotag"
              },
              {
                "type": "null"
              }
            ]
          },
          "group_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Group Title"
          },
          "group_url": {
            "title": "Group Url",
            "type": "string"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/PostMedia"
            },
            "maxItems": 500,
            "title": "Media",
            "type": "array"
          },
          "media_complete": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "False when the provider reports media missing from this post; null when completeness cannot be established.",
            "title": "Media Complete"
          },
          "media_count_reported": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Media count reported by the source provider, when available.",
            "title": "Media Count Reported"
          },
          "mentions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Caption/text mentions, separate from actual tags.",
            "title": "Mentions"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "quotes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quotes Count"
          },
          "relation_evidence": {
            "const": "group_permalink",
            "title": "Relation Evidence",
            "type": "string"
          },
          "reposts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts Count"
          },
          "tagged_users": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual source tags; null means unavailable.",
            "title": "Tagged Users"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "UTC ISO 8601 time; null means unavailable, never inferred epoch zero.",
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "views_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Views Count"
          }
        },
        "required": [
          "post_id",
          "url",
          "author",
          "timestamp",
          "text",
          "media",
          "geotag",
          "tagged_users",
          "mentions",
          "group_url",
          "group_title",
          "relation_evidence"
        ],
        "title": "FacebookGroupPost",
        "type": "object"
      },
      "FacebookGroupPostsPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "description": "Unknown upstream completeness; a final cached page does not prove exhaustion.",
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "group_url": {
            "title": "Group Url",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/FacebookGroupPost"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "keyword": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Keyword"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "local_filters": {
            "items": {
              "enum": [
                "keyword",
                "since_date",
                "until_date"
              ],
              "type": "string"
            },
            "title": "Local Filters",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "post_url": {
            "title": "Post Url",
            "type": "null"
          },
          "query": {
            "title": "Query",
            "type": "null"
          },
          "query_handling": {
            "title": "Query Handling",
            "type": "null"
          },
          "requested_collection_size": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "since_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since Date"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          },
          "until_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Until Date"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "query",
          "keyword",
          "since_date",
          "until_date",
          "local_filters",
          "query_handling",
          "group_url",
          "post_url"
        ],
        "title": "FacebookGroupPostsPage",
        "type": "object"
      },
      "FacebookGroupPostsRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "description": "Finite upstream collection bound. limit only pages this immutable snapshot.",
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "group_url": {
            "maxLength": 512,
            "minLength": 1,
            "title": "Group Url",
            "type": "string"
          },
          "keyword": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional literal case-insensitive substring checked on returned text; not Boolean search syntax.",
            "title": "Keyword"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "since_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive lower UTC date checked against returned timestamps.",
            "title": "Since Date"
          },
          "until_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exclusive upper UTC date checked against returned timestamps.",
            "title": "Until Date"
          }
        },
        "required": [
          "group_url"
        ],
        "title": "FacebookGroupPostsRequest",
        "type": "object"
      },
      "FacebookGroupSearchPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "content_retrieved": {
            "const": false,
            "title": "Content Retrieved",
            "type": "boolean"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/FacebookGroupCandidate"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "const": "unavailable_or_invalid_group_rows",
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "query_handling": {
            "const": "upstream_hint",
            "title": "Query Handling",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "search_source": {
            "const": "public_web_index",
            "title": "Search Source",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "query",
          "requested_collection_size",
          "search_source",
          "query_handling",
          "filters_enforced",
          "collection_complete",
          "content_retrieved",
          "partial_reasons"
        ],
        "title": "FacebookGroupSearchPage",
        "type": "object"
      },
      "FacebookGroupSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "description": "One group-name query. Public web-index candidates are not an exhaustive Facebook search.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "query"
        ],
        "title": "FacebookGroupSearchRequest",
        "type": "object"
      },
      "FacebookPageCandidate": {
        "additionalProperties": false,
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "profile_id": {
            "title": "Profile Id",
            "type": "string"
          },
          "profile_type": {
            "const": "page",
            "title": "Profile Type",
            "type": "string"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "profile_url",
          "profile_id",
          "profile_type",
          "query",
          "biography",
          "location",
          "website_url",
          "is_verified"
        ],
        "title": "FacebookPageCandidate",
        "type": "object"
      },
      "FacebookPageSearchPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "description": "Unknown upstream completeness; a final cached page does not prove exhaustion.",
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/FacebookPageCandidate"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "query_handling": {
            "const": "upstream_hint",
            "title": "Query Handling",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "query",
          "query_handling",
          "filters_enforced"
        ],
        "title": "FacebookPageSearchPage",
        "type": "object"
      },
      "FacebookPageSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "description": "Finite upstream collection bound. limit only pages this immutable snapshot.",
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "maxLength": 200,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "query"
        ],
        "title": "FacebookPageSearchRequest",
        "type": "object"
      },
      "FacebookPeopleRequest": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "locations": {
            "description": "Up to five location hints of 1\u2013100 characters, appended in caller order to one native query. Ambiguous names remain text; no city resolution or AND/OR geographic filters are enforced.",
            "items": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 5,
            "title": "Locations",
            "type": "array"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "description": "Free-text name, optionally with employer/city. Echoed exactly; matching does not verify identity or enforce filters.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "query"
        ],
        "title": "FacebookPeopleRequest",
        "type": "object"
      },
      "FacebookPostSearchPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "description": "Unknown upstream completeness; a final cached page does not prove exhaustion.",
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "group_url": {
            "title": "Group Url",
            "type": "null"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/FacebookSearchPost"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "keyword": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Keyword"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "local_filters": {
            "items": {
              "enum": [
                "keyword",
                "since_date",
                "until_date"
              ],
              "type": "string"
            },
            "title": "Local Filters",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "post_url": {
            "title": "Post Url",
            "type": "null"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "query_handling": {
            "const": "upstream_hint",
            "title": "Query Handling",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "since_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since Date"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          },
          "until_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Until Date"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "query",
          "keyword",
          "since_date",
          "until_date",
          "local_filters",
          "query_handling",
          "group_url",
          "post_url"
        ],
        "title": "FacebookPostSearchPage",
        "type": "object"
      },
      "FacebookPostSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "description": "Finite upstream collection bound. limit only pages this immutable snapshot.",
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "keyword": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional literal case-insensitive substring checked on returned text; not Boolean search syntax.",
            "title": "Keyword"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "description": "One upstream public keyword query; matching and recall are not guaranteed.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "since_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive lower UTC date checked against returned timestamps.",
            "title": "Since Date"
          },
          "until_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exclusive upper UTC date checked against returned timestamps.",
            "title": "Until Date"
          }
        },
        "required": [
          "query"
        ],
        "title": "FacebookPostSearchRequest",
        "type": "object"
      },
      "FacebookPostsRequest": {
        "additionalProperties": false,
        "description": "Collect recent posts, dated Page history, or cursor-based personal history.",
        "properties": {
          "archive": {
            "default": false,
            "title": "Archive",
            "type": "boolean"
          },
          "archive_cursor": {
            "anyOf": [
              {
                "maxLength": 262144,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Archive Cursor"
          },
          "archive_end_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Archive End Date"
          },
          "archive_kind": {
            "anyOf": [
              {
                "enum": [
                  "person",
                  "page"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Required in archive mode: Pages use date windows; personal profiles use a continuation cursor with expanded photo albums.",
            "title": "Archive Kind"
          },
          "archive_window_days": {
            "default": 30,
            "maximum": 30.0,
            "minimum": 1.0,
            "title": "Archive Window Days",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "per_target_limit": {
            "default": 40,
            "description": "Maximum posts in one collection: 40 recent by default, up to 500 in archive mode. Personal archives require at least 5 so provider cursors can advance; they default to 100.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Per Target Limit",
            "type": "integer"
          },
          "profiles": {
            "items": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "retain_media": {
            "default": false,
            "description": "Preserve photos/video thumbnails. Recent jobs allow 20 unique images and 32 MiB over 30 seconds; archive jobs allow 100 images and 96 MiB over 120 seconds. Each image is capped at 10 MiB and 40 million pixels. Shared bearer/global quotas still apply. No video download; assets expire after 24 hours. Cached pages/replay never download again.",
            "title": "Retain Media",
            "type": "boolean"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "FacebookPostsRequest",
        "type": "object"
      },
      "FacebookProfile": {
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "input_index": {
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Input Index",
            "type": "integer"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_type": {
            "anyOf": [
              {
                "enum": [
                  "person",
                  "page"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Type"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PublicProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "target": {
            "title": "Target",
            "type": "string"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "target",
          "input_index",
          "profile_url"
        ],
        "title": "FacebookProfile",
        "type": "object"
      },
      "FacebookProfilePage": {
        "properties": {
          "count": {
            "maximum": 10.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/FacebookProfile"
            },
            "maxItems": 10,
            "title": "Items",
            "type": "array"
          },
          "unresolved": {
            "items": {
              "$ref": "#/components/schemas/UnresolvedProfile"
            },
            "maxItems": 10,
            "title": "Unresolved",
            "type": "array"
          }
        },
        "required": [
          "unresolved",
          "items",
          "count"
        ],
        "title": "FacebookProfilePage",
        "type": "object"
      },
      "FacebookProfileRequest": {
        "additionalProperties": false,
        "description": "One to ten Facebook handles, numeric IDs, or canonical profile/page URLs.",
        "properties": {
          "profiles": {
            "items": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "FacebookProfileRequest",
        "type": "object"
      },
      "FacebookSearchPost": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/PostAuthor"
          },
          "comments_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Count"
          },
          "geotag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostGeotag"
              },
              {
                "type": "null"
              }
            ]
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/PostMedia"
            },
            "maxItems": 500,
            "title": "Media",
            "type": "array"
          },
          "media_complete": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "False when the provider reports media missing from this post; null when completeness cannot be established.",
            "title": "Media Complete"
          },
          "media_count_reported": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Media count reported by the source provider, when available.",
            "title": "Media Count Reported"
          },
          "mentions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Caption/text mentions, separate from actual tags.",
            "title": "Mentions"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "quotes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quotes Count"
          },
          "relation_evidence": {
            "const": "search_query",
            "title": "Relation Evidence",
            "type": "string"
          },
          "reposts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts Count"
          },
          "tagged_users": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual source tags; null means unavailable.",
            "title": "Tagged Users"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "UTC ISO 8601 time; null means unavailable, never inferred epoch zero.",
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "views_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Views Count"
          }
        },
        "required": [
          "post_id",
          "url",
          "author",
          "timestamp",
          "text",
          "media",
          "geotag",
          "tagged_users",
          "mentions",
          "query",
          "relation_evidence"
        ],
        "title": "FacebookSearchPost",
        "type": "object"
      },
      "GoogleLensJob": {
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "poll_url": {
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoogleLensSearchPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "GoogleLensJob",
        "type": "object"
      },
      "GoogleLensMatch": {
        "properties": {
          "image_expires_at": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Expires At"
          },
          "image_height": {
            "anyOf": [
              {
                "maximum": 100000.0,
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Height"
          },
          "image_kind": {
            "anyOf": [
              {
                "const": "thumbnail",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Kind"
          },
          "image_sha256": {
            "anyOf": [
              {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Sha256"
          },
          "image_url": {
            "anyOf": [
              {
                "maxLength": 4096,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "image_width": {
            "anyOf": [
              {
                "maximum": 100000.0,
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Width"
          },
          "source": {
            "anyOf": [
              {
                "maxLength": 512,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source"
          },
          "source_icon_url": {
            "anyOf": [
              {
                "maxLength": 4096,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Icon Url"
          },
          "title": {
            "maxLength": 4096,
            "minLength": 1,
            "title": "Title",
            "type": "string"
          },
          "type": {
            "enum": [
              "visual",
              "exact"
            ],
            "title": "Type",
            "type": "string"
          },
          "url": {
            "maxLength": 4096,
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "type",
          "title",
          "url"
        ],
        "title": "GoogleLensMatch",
        "type": "object"
      },
      "GoogleLensSearchPage": {
        "properties": {
          "count": {
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "discriminator": {
                "mapping": {
                  "exact": "#/components/schemas/GoogleLensMatch",
                  "text": "#/components/schemas/GoogleLensText",
                  "visual": "#/components/schemas/GoogleLensMatch"
                },
                "propertyName": "type"
              },
              "oneOf": [
                {
                  "$ref": "#/components/schemas/GoogleLensMatch"
                },
                {
                  "$ref": "#/components/schemas/GoogleLensText"
                }
              ]
            },
            "maxItems": 100,
            "title": "Items",
            "type": "array"
          },
          "partial": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Partial"
          }
        },
        "required": [
          "items",
          "count"
        ],
        "title": "GoogleLensSearchPage",
        "type": "object"
      },
      "GoogleLensSearchRequest": {
        "additionalProperties": false,
        "description": "Search one public HTTPS image or an owner-scoped uploaded image.",
        "oneOf": [
          {
            "properties": {
              "asset_id": {
                "type": "null"
              },
              "image_url": {
                "type": "string"
              }
            },
            "required": [
              "image_url"
            ]
          },
          {
            "properties": {
              "asset_id": {
                "type": "string"
              },
              "image_url": {
                "type": "null"
              }
            },
            "required": [
              "asset_id"
            ]
          }
        ],
        "properties": {
          "asset_id": {
            "anyOf": [
              {
                "pattern": "^rasset_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Private image from POST /scrapers/assets; mutually exclusive with image_url.",
            "title": "Asset Id"
          },
          "image_url": {
            "anyOf": [
              {
                "maxLength": 4096,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Public HTTPS image URL, or the exact relative URL returned by POST /scrapers/assets.",
            "title": "Image Url"
          },
          "limit": {
            "default": 20,
            "description": "Maximum total records across all requested types, interleaved in the requested order.",
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "search_types": {
            "description": "Requested Lens modes; defaults to visual matches.",
            "items": {
              "enum": [
                "visual",
                "exact",
                "text"
              ],
              "type": "string"
            },
            "maxItems": 3,
            "minItems": 1,
            "title": "Search Types",
            "type": "array",
            "uniqueItems": true
          }
        },
        "title": "GoogleLensSearchRequest",
        "type": "object"
      },
      "GoogleLensText": {
        "properties": {
          "text": {
            "maxLength": 20000,
            "minLength": 1,
            "title": "Text",
            "type": "string"
          },
          "type": {
            "const": "text",
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "type",
          "text"
        ],
        "title": "GoogleLensText",
        "type": "object"
      },
      "GoogleSearchPage": {
        "properties": {
          "count": {
            "maximum": 500.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/GoogleSearchResult"
            },
            "maxItems": 500,
            "title": "Items",
            "type": "array"
          }
        },
        "required": [
          "items",
          "count"
        ],
        "title": "GoogleSearchPage",
        "type": "object"
      },
      "GoogleSearchRequest": {
        "additionalProperties": false,
        "description": "One to five queries of up to 32 words; search operators are supported.",
        "properties": {
          "country": {
            "anyOf": [
              {
                "maxLength": 2,
                "minLength": 2,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Supported two-letter search country code, such as us or gb.",
            "title": "Country"
          },
          "language": {
            "anyOf": [
              {
                "maxLength": 5,
                "minLength": 2,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Search interface language, such as en, zh-CN or pt-BR; does not restrict result language.",
            "title": "Language"
          },
          "limit": {
            "default": 20,
            "description": "Maximum organic results per distinct query.",
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "pages": {
            "default": 1,
            "description": "Maximum pages per query.",
            "maximum": 3.0,
            "minimum": 1.0,
            "title": "Pages",
            "type": "integer"
          },
          "queries": {
            "items": {
              "maxLength": 512,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 5,
            "minItems": 1,
            "title": "Queries",
            "type": "array"
          }
        },
        "required": [
          "queries"
        ],
        "title": "GoogleSearchRequest",
        "type": "object"
      },
      "GoogleSearchResult": {
        "properties": {
          "query": {
            "title": "Query",
            "type": "string"
          },
          "rank": {
            "minimum": 1.0,
            "title": "Rank",
            "type": "integer"
          },
          "snippet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Snippet"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "query",
          "rank",
          "title",
          "url"
        ],
        "title": "GoogleSearchResult",
        "type": "object"
      },
      "Honor": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "issued_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Issued At"
          },
          "issuer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Issuer"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          }
        },
        "title": "Honor",
        "type": "object"
      },
      "Image": {
        "properties": {
          "height": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Height"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "width": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Width"
          }
        },
        "required": [
          "url"
        ],
        "title": "Image",
        "type": "object"
      },
      "InstagramCandidate": {
        "additionalProperties": false,
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_business": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Business"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "missing_fields": {
            "description": "Unavailable core profile fields. No inferred or purchased enrichment.",
            "items": {
              "enum": [
                "display_name",
                "biography",
                "image_url"
              ],
              "type": "string"
            },
            "maxItems": 3,
            "title": "Missing Fields",
            "type": "array"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PublicProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "rank": {
            "description": "Absolute one-based position after canonical account deduplication, preserving native order.",
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Rank",
            "type": "integer"
          },
          "status": {
            "const": "candidate",
            "title": "Status",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "query",
          "rank",
          "status",
          "missing_fields",
          "username",
          "profile_url"
        ],
        "title": "InstagramCandidate",
        "type": "object"
      },
      "InstagramGraphEdge": {
        "additionalProperties": false,
        "properties": {
          "biography": {
            "title": "Biography",
            "type": "null"
          },
          "created_at": {
            "title": "Created At",
            "type": "null"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "location": {
            "title": "Location",
            "type": "null"
          },
          "profile_id": {
            "title": "Profile Id",
            "type": "string"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "relation": {
            "enum": [
              "followers",
              "following"
            ],
            "title": "Relation",
            "type": "string"
          },
          "relation_evidence": {
            "const": "source_attribution",
            "title": "Relation Evidence",
            "type": "string"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          }
        },
        "required": [
          "username",
          "profile_url",
          "profile_id",
          "biography",
          "location",
          "created_at",
          "is_private",
          "is_verified",
          "source_profile",
          "relation",
          "relation_evidence"
        ],
        "title": "InstagramGraphEdge",
        "type": "object"
      },
      "InstagramGraphPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "description": "Unknown upstream completeness; a final cached page does not prove exhaustion.",
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/InstagramGraphEdge"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "relation": {
            "enum": [
              "followers",
              "following"
            ],
            "title": "Relation",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          },
          "upstream_continuation_available": {
            "const": false,
            "title": "Upstream Continuation Available",
            "type": "boolean"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "source_profile",
          "relation",
          "upstream_continuation_available"
        ],
        "title": "InstagramGraphPage",
        "type": "object"
      },
      "InstagramGraphRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 100,
            "description": "One finite first collection. Raw continuation tokens are never accepted or returned; cached pages cannot continue the upstream graph.",
            "maximum": 1000.0,
            "minimum": 25.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "profile": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Profile",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "profile"
        ],
        "title": "InstagramGraphRequest",
        "type": "object"
      },
      "InstagramHighlightContentPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "content_scope": {
            "const": "saved_highlight_stories",
            "title": "Content Scope",
            "type": "string"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/InstagramHighlightStory"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "media_retained": {
            "const": false,
            "title": "Media Retained",
            "type": "boolean"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "requested_collection_size": {
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "requested_highlight_limit": {
            "maximum": 25.0,
            "minimum": 1.0,
            "title": "Requested Highlight Limit",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "source_profile",
          "requested_collection_size",
          "requested_highlight_limit",
          "content_scope",
          "collection_complete",
          "partial_reasons",
          "media_retained"
        ],
        "title": "InstagramHighlightContentPage",
        "type": "object"
      },
      "InstagramHighlightContentRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "description": "Finite number of actual Story items; limit only pages the saved collection.",
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "highlight_limit": {
            "default": 5,
            "description": "Maximum saved Highlight reels expanded for this profile.",
            "maximum": 25.0,
            "minimum": 1.0,
            "title": "Highlight Limit",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "profile": {
            "maxLength": 512,
            "minLength": 1,
            "title": "Profile",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "profile"
        ],
        "title": "InstagramHighlightContentRequest",
        "type": "object"
      },
      "InstagramHighlightStory": {
        "additionalProperties": false,
        "properties": {
          "caption": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Caption"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "null"
          },
          "hashtags": {
            "items": {
              "type": "string"
            },
            "maxItems": 100,
            "title": "Hashtags",
            "type": "array"
          },
          "height": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Height"
          },
          "highlight_id": {
            "pattern": "^[1-9][0-9]{0,39}$",
            "title": "Highlight Id",
            "type": "string"
          },
          "highlight_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Highlight Title"
          },
          "highlight_url": {
            "title": "Highlight Url",
            "type": "string"
          },
          "links": {
            "items": {
              "type": "string"
            },
            "maxItems": 100,
            "title": "Links",
            "type": "array"
          },
          "media_id": {
            "description": "Observed numeric media component of the Story ID.",
            "pattern": "^[1-9][0-9]{0,39}$",
            "title": "Media Id",
            "type": "string"
          },
          "media_retained": {
            "const": false,
            "title": "Media Retained",
            "type": "boolean"
          },
          "media_type": {
            "enum": [
              "image",
              "video"
            ],
            "title": "Media Type",
            "type": "string"
          },
          "media_url": {
            "title": "Media Url",
            "type": "string"
          },
          "mentions": {
            "items": {
              "type": "string"
            },
            "maxItems": 100,
            "title": "Mentions",
            "type": "array"
          },
          "music_artist": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Music Artist"
          },
          "music_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Music Title"
          },
          "owner_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Owner Id"
          },
          "position": {
            "minimum": 1.0,
            "title": "Position",
            "type": "integer"
          },
          "relation_evidence": {
            "const": "observed_owner_and_highlight",
            "title": "Relation Evidence",
            "type": "string"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "story_id": {
            "description": "Observed Story ID, including its validated owner suffix when returned.",
            "pattern": "^[1-9][0-9]{0,39}(?:_[1-9][0-9]{0,39})?$",
            "title": "Story Id",
            "type": "string"
          },
          "thumbnail_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Thumbnail Url"
          },
          "timestamp": {
            "title": "Timestamp",
            "type": "string"
          },
          "width": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Width"
          }
        },
        "required": [
          "story_id",
          "media_id",
          "source_profile",
          "owner_id",
          "highlight_id",
          "highlight_title",
          "highlight_url",
          "timestamp",
          "expires_at",
          "media_type",
          "media_url",
          "thumbnail_url",
          "width",
          "height",
          "caption",
          "music_title",
          "music_artist",
          "mentions",
          "hashtags",
          "links",
          "position",
          "relation_evidence",
          "media_retained"
        ],
        "title": "InstagramHighlightStory",
        "type": "object"
      },
      "InstagramHighlightSummary": {
        "additionalProperties": false,
        "properties": {
          "content_retrieved": {
            "const": false,
            "title": "Content Retrieved",
            "type": "boolean"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "highlight_id": {
            "title": "Highlight Id",
            "type": "string"
          },
          "latest_story_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Latest Story At"
          },
          "relation_evidence": {
            "const": "profile_container",
            "title": "Relation Evidence",
            "type": "string"
          },
          "reported_media_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reported Media Count"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "required": [
          "highlight_id",
          "source_profile",
          "title",
          "cover_image_url",
          "reported_media_count",
          "created_at",
          "updated_at",
          "latest_story_at",
          "content_retrieved",
          "relation_evidence"
        ],
        "title": "InstagramHighlightSummary",
        "type": "object"
      },
      "InstagramHighlightsPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "description": "Unknown upstream completeness; a final cached page does not prove exhaustion.",
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "content_available": {
            "const": false,
            "title": "Content Available",
            "type": "boolean"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/InstagramHighlightSummary"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "profile_reason": {
            "anyOf": [
              {
                "enum": [
                  "private",
                  "not_found",
                  "rate_limited",
                  "fetch_failed",
                  "partial_response"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Reason"
          },
          "profile_status": {
            "enum": [
              "success",
              "partial",
              "private",
              "not_found",
              "unavailable",
              "rate_limited"
            ],
            "title": "Profile Status",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "source_profile",
          "profile_status",
          "profile_reason",
          "content_available"
        ],
        "title": "InstagramHighlightsPage",
        "type": "object"
      },
      "InstagramHighlightsRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 10,
            "description": "Maximum saved Highlight summaries; use the content route for actual Story items.",
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "profile": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Profile",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "profile"
        ],
        "title": "InstagramHighlightsRequest",
        "type": "object"
      },
      "InstagramPeopleRequest": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "locations": {
            "description": "Up to five location hints of 1\u2013100 characters, appended in caller order to one native query. Ambiguous names remain text; no city resolution or AND/OR geographic filters are enforced.",
            "items": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 5,
            "title": "Locations",
            "type": "array"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "description": "Free-text name, optionally with employer/city. Echoed exactly; matching does not verify identity or enforce filters.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "query"
        ],
        "title": "InstagramPeopleRequest",
        "type": "object"
      },
      "InstagramPostsRequest": {
        "additionalProperties": false,
        "description": "Collect recent posts or continue a dated public-profile archive.",
        "properties": {
          "archive": {
            "default": false,
            "description": "Walk a dated public profile window. Continue the same window using next_archive_cursor, then use next_archive_end_date.",
            "title": "Archive",
            "type": "boolean"
          },
          "archive_cursor": {
            "anyOf": [
              {
                "maxLength": 262144,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Opaque continuation returned as next_archive_cursor by the previous completed archive job for the same profile and date window.",
            "title": "Archive Cursor"
          },
          "archive_end_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive UTC date at the end of the archive window; required with archive=true.",
            "title": "Archive End Date"
          },
          "archive_window_days": {
            "default": 30,
            "description": "Maximum UTC days in this archive window, up to 365. Post and runtime bounds still apply; follow the returned cursor before moving to an older window.",
            "maximum": 365.0,
            "minimum": 1.0,
            "title": "Archive Window Days",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "per_target_limit": {
            "default": 50,
            "description": "Maximum posts per profile: 50 by default, up to 500 across the collection. Larger windows collect carousel media for more posts. Archive mode defaults to 500 if omitted.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Per Target Limit",
            "type": "integer"
          },
          "post_urls": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "maxItems": 10,
                "minItems": 1,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Look up up to ten specific public posts for this single profile, including full carousel media. Each post must belong to or explicitly list the profile as a coauthor. Cannot be combined with archive mode.",
            "title": "Post Urls"
          },
          "profiles": {
            "items": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "retain_media": {
            "default": false,
            "description": "Preserve photos/video thumbnails. Recent jobs allow 20 unique images and 32 MiB over 30 seconds; archive jobs allow 100 images and 96 MiB over 120 seconds. Each image is capped at 10 MiB and 40 million pixels. Shared bearer/global quotas still apply. No video download; assets expire after 24 hours. Cached pages/replay never download again.",
            "title": "Retain Media",
            "type": "boolean"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "InstagramPostsRequest",
        "type": "object"
      },
      "InstagramProfile": {
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "input_index": {
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Input Index",
            "type": "integer"
          },
          "is_business": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Business"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PublicProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "target": {
            "title": "Target",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "target",
          "input_index",
          "username",
          "profile_url"
        ],
        "title": "InstagramProfile",
        "type": "object"
      },
      "InstagramProfilePage": {
        "properties": {
          "count": {
            "maximum": 10.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/InstagramProfile"
            },
            "maxItems": 10,
            "title": "Items",
            "type": "array"
          },
          "unresolved": {
            "items": {
              "$ref": "#/components/schemas/UnresolvedProfile"
            },
            "maxItems": 10,
            "title": "Unresolved",
            "type": "array"
          }
        },
        "required": [
          "unresolved",
          "items",
          "count"
        ],
        "title": "InstagramProfilePage",
        "type": "object"
      },
      "InstagramProfileRequest": {
        "additionalProperties": false,
        "description": "One to ten Instagram handles or canonical public profile URLs.",
        "properties": {
          "profiles": {
            "items": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "InstagramProfileRequest",
        "type": "object"
      },
      "InstagramTaggedPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "description": "Unknown upstream completeness; a final cached page does not prove exhaustion.",
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/InstagramTaggedPost"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "requested_collection_size": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "tagged_profile": {
            "title": "Tagged Profile",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "tagged_profile"
        ],
        "title": "InstagramTaggedPage",
        "type": "object"
      },
      "InstagramTaggedPost": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/PostAuthor"
          },
          "comments_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Count"
          },
          "geotag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostGeotag"
              },
              {
                "type": "null"
              }
            ]
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/PostMedia"
            },
            "maxItems": 500,
            "title": "Media",
            "type": "array"
          },
          "media_complete": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "False when the provider reports media missing from this post; null when completeness cannot be established.",
            "title": "Media Complete"
          },
          "media_count_reported": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Media count reported by the source provider, when available.",
            "title": "Media Count Reported"
          },
          "mentions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Caption/text mentions, separate from actual tags.",
            "title": "Mentions"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "quotes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quotes Count"
          },
          "relation_evidence": {
            "const": "tagged_users",
            "description": "Actual returned tag fields establish this relation; a caption mention or echoed target does not.",
            "title": "Relation Evidence",
            "type": "string"
          },
          "reposts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts Count"
          },
          "tagged_profile": {
            "title": "Tagged Profile",
            "type": "string"
          },
          "tagged_users": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual source tags; null means unavailable.",
            "title": "Tagged Users"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "UTC ISO 8601 time; null means unavailable, never inferred epoch zero.",
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "views_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Views Count"
          }
        },
        "required": [
          "post_id",
          "url",
          "author",
          "timestamp",
          "text",
          "media",
          "geotag",
          "tagged_users",
          "mentions",
          "tagged_profile",
          "relation_evidence"
        ],
        "title": "InstagramTaggedPost",
        "type": "object"
      },
      "InstagramTaggedRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "profile": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Profile",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "profile"
        ],
        "title": "InstagramTaggedRequest",
        "type": "object"
      },
      "Language": {
        "properties": {
          "name": {
            "title": "Name",
            "type": "string"
          },
          "proficiency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Proficiency"
          }
        },
        "required": [
          "name"
        ],
        "title": "Language",
        "type": "object"
      },
      "Media": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "image": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Image"
              },
              {
                "type": "null"
              }
            ]
          },
          "kind": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Kind"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          }
        },
        "title": "Media",
        "type": "object"
      },
      "NetworkPolicy": {
        "additionalProperties": false,
        "properties": {
          "asn": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Asn"
          },
          "country": {
            "pattern": "^[A-Za-z]{2}$",
            "title": "Country",
            "type": "string"
          },
          "locale": {
            "anyOf": [
              {
                "maxLength": 64,
                "minLength": 2,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Locale"
          },
          "mobile": {
            "default": true,
            "title": "Mobile",
            "type": "boolean"
          },
          "region": {
            "anyOf": [
              {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Region"
          }
        },
        "required": [
          "country"
        ],
        "title": "NetworkPolicy",
        "type": "object"
      },
      "NetworkResponse": {
        "additionalProperties": false,
        "properties": {
          "asn": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Asn"
          },
          "country": {
            "pattern": "^[A-Za-z]{2}$",
            "title": "Country",
            "type": "string"
          },
          "last_exit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VerifiedExit"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "locale": {
            "anyOf": [
              {
                "maxLength": 64,
                "minLength": 2,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Locale"
          },
          "mobile": {
            "default": true,
            "title": "Mobile",
            "type": "boolean"
          },
          "region": {
            "anyOf": [
              {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Region"
          },
          "timezone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Timezone"
          }
        },
        "required": [
          "country"
        ],
        "title": "NetworkResponse",
        "type": "object"
      },
      "PeopleSearchPage_FacebookCandidate_": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "effective_query": {
            "description": "Text sent to native account search, including location hints. Instagram commas become spaces to keep one query.",
            "title": "Effective Query",
            "type": "string"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "description": "City and employer restrictions are not enforced. Returned accounts are candidates, never verified identities.",
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/FacebookCandidate"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "location_handling": {
            "enum": [
              "not_requested",
              "query_hint"
            ],
            "title": "Location Handling",
            "type": "string"
          },
          "locations": {
            "items": {
              "type": "string"
            },
            "title": "Locations",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "query",
          "locations",
          "effective_query",
          "location_handling",
          "filters_enforced"
        ],
        "title": "PeopleSearchPage[FacebookCandidate]",
        "type": "object"
      },
      "PeopleSearchPage_InstagramCandidate_": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "effective_query": {
            "description": "Text sent to native account search, including location hints. Instagram commas become spaces to keep one query.",
            "title": "Effective Query",
            "type": "string"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "description": "City and employer restrictions are not enforced. Returned accounts are candidates, never verified identities.",
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/InstagramCandidate"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "location_handling": {
            "enum": [
              "not_requested",
              "query_hint"
            ],
            "title": "Location Handling",
            "type": "string"
          },
          "locations": {
            "items": {
              "type": "string"
            },
            "title": "Locations",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "query",
          "locations",
          "effective_query",
          "location_handling",
          "filters_enforced"
        ],
        "title": "PeopleSearchPage[InstagramCandidate]",
        "type": "object"
      },
      "PeopleSearchPage_TikTokCandidate_": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "effective_query": {
            "description": "Text sent to native account search, including location hints. Instagram commas become spaces to keep one query.",
            "title": "Effective Query",
            "type": "string"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "description": "City and employer restrictions are not enforced. Returned accounts are candidates, never verified identities.",
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/TikTokCandidate"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "location_handling": {
            "enum": [
              "not_requested",
              "query_hint"
            ],
            "title": "Location Handling",
            "type": "string"
          },
          "locations": {
            "items": {
              "type": "string"
            },
            "title": "Locations",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "query",
          "locations",
          "effective_query",
          "location_handling",
          "filters_enforced"
        ],
        "title": "PeopleSearchPage[TikTokCandidate]",
        "type": "object"
      },
      "PeopleSearchPage_XCandidate_": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "effective_query": {
            "description": "Text sent to native account search, including location hints. Instagram commas become spaces to keep one query.",
            "title": "Effective Query",
            "type": "string"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "description": "City and employer restrictions are not enforced. Returned accounts are candidates, never verified identities.",
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/XCandidate"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "location_handling": {
            "enum": [
              "not_requested",
              "query_hint"
            ],
            "title": "Location Handling",
            "type": "string"
          },
          "locations": {
            "items": {
              "type": "string"
            },
            "title": "Locations",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "query",
          "locations",
          "effective_query",
          "location_handling",
          "filters_enforced"
        ],
        "title": "PeopleSearchPage[XCandidate]",
        "type": "object"
      },
      "PeopleSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "company_headcounts": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Company Headcounts",
            "type": "array"
          },
          "company_locations": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 70,
            "title": "Company Locations",
            "type": "array"
          },
          "current_companies": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Current Companies",
            "type": "array"
          },
          "current_titles": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Current Titles",
            "type": "array"
          },
          "detail_level": {
            "default": "basic",
            "enum": [
              "basic",
              "full"
            ],
            "title": "Detail Level",
            "type": "string"
          },
          "exclude_company_locations": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 70,
            "title": "Exclude Company Locations",
            "type": "array"
          },
          "exclude_current_companies": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Current Companies",
            "type": "array"
          },
          "exclude_current_titles": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Current Titles",
            "type": "array"
          },
          "exclude_functions": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 30,
            "title": "Exclude Functions",
            "type": "array"
          },
          "exclude_industries": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Industries",
            "type": "array"
          },
          "exclude_locations": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 70,
            "title": "Exclude Locations",
            "type": "array"
          },
          "exclude_past_companies": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Past Companies",
            "type": "array"
          },
          "exclude_past_titles": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Past Titles",
            "type": "array"
          },
          "exclude_schools": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Exclude Schools",
            "type": "array"
          },
          "exclude_seniority_levels": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Exclude Seniority Levels",
            "type": "array"
          },
          "experience_levels": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Experience Levels",
            "type": "array"
          },
          "first_names": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "First Names",
            "type": "array"
          },
          "functions": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 30,
            "title": "Functions",
            "type": "array"
          },
          "industries": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Industries",
            "type": "array"
          },
          "languages": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Languages",
            "type": "array"
          },
          "last_names": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Last Names",
            "type": "array"
          },
          "limit": {
            "default": 100,
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "locations": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 70,
            "title": "Locations",
            "type": "array"
          },
          "page": {
            "default": 1,
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "pages": {
            "default": 1,
            "maximum": 20.0,
            "minimum": 1.0,
            "title": "Pages",
            "type": "integer"
          },
          "past_companies": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Past Companies",
            "type": "array"
          },
          "past_titles": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Past Titles",
            "type": "array"
          },
          "query": {
            "anyOf": [
              {
                "maxLength": 300,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Query"
          },
          "recently_changed_jobs": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recently Changed Jobs"
          },
          "recently_posted": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recently Posted"
          },
          "schools": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "title": "Schools",
            "type": "array"
          },
          "seniority_levels": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Seniority Levels",
            "type": "array"
          },
          "years_at_company": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Years At Company",
            "type": "array"
          }
        },
        "title": "PeopleSearchRequest",
        "type": "object"
      },
      "Position": {
        "properties": {
          "company": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Company"
          },
          "company_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Company Url"
          },
          "date_range": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DateRange"
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "duration": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Duration"
          },
          "employment_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Employment Type"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "skills": {
            "items": {
              "type": "string"
            },
            "title": "Skills",
            "type": "array"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "workplace_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workplace Type"
          }
        },
        "title": "Position",
        "type": "object"
      },
      "Post": {
        "properties": {
          "author": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicAuthor"
              },
              {
                "type": "null"
              }
            ]
          },
          "comments": {
            "items": {
              "$ref": "#/components/schemas/Comment"
            },
            "title": "Comments",
            "type": "array"
          },
          "content_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Type"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/Media"
            },
            "title": "Media",
            "type": "array"
          },
          "metrics": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EngagementMetrics"
              },
              {
                "type": "null"
              }
            ]
          },
          "post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Post Id"
          },
          "post_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Post Url"
          },
          "posted_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posted At"
          },
          "reactions": {
            "items": {
              "$ref": "#/components/schemas/Reaction"
            },
            "title": "Reactions",
            "type": "array"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          }
        },
        "title": "Post",
        "type": "object"
      },
      "PostAuthor": {
        "additionalProperties": false,
        "properties": {
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "profile_url"
        ],
        "title": "PostAuthor",
        "type": "object"
      },
      "PostCommentsRequest": {
        "additionalProperties": false,
        "properties": {
          "freshness": {
            "anyOf": [
              {
                "enum": [
                  "hour",
                  "day",
                  "week",
                  "month",
                  "three_months",
                  "six_months",
                  "year"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Freshness"
          },
          "include_replies": {
            "default": true,
            "title": "Include Replies",
            "type": "boolean"
          },
          "limit": {
            "default": 100,
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "pages": {
            "default": 1,
            "maximum": 20.0,
            "minimum": 1.0,
            "title": "Pages",
            "type": "integer"
          },
          "posts": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Posts",
            "type": "array"
          },
          "replies_limit": {
            "default": 5,
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Replies Limit",
            "type": "integer"
          },
          "since": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          }
        },
        "required": [
          "posts"
        ],
        "title": "PostCommentsRequest",
        "type": "object"
      },
      "PostGeotag": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "latitude": {
            "anyOf": [
              {
                "maximum": 90.0,
                "minimum": -90.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Latitude"
          },
          "longitude": {
            "anyOf": [
              {
                "maximum": 180.0,
                "minimum": -180.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Longitude"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          }
        },
        "title": "PostGeotag",
        "type": "object"
      },
      "PostMedia": {
        "additionalProperties": false,
        "properties": {
          "asset": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RetainedPostAsset"
              },
              {
                "type": "null"
              }
            ]
          },
          "bitrate": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bitrate"
          },
          "group_index": {
            "description": "Zero-based position in the source carousel or album; variants share a group.",
            "maximum": 499.0,
            "minimum": 0.0,
            "title": "Group Index",
            "type": "integer"
          },
          "mime_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mime Type"
          },
          "retention_reason": {
            "anyOf": [
              {
                "enum": [
                  "not_requested",
                  "video_not_retained",
                  "count_limit",
                  "job_byte_limit",
                  "destination_rejected",
                  "source_unavailable",
                  "unsupported_format",
                  "invalid_image",
                  "too_large",
                  "quota_exceeded",
                  "timeout",
                  "download_failed",
                  "storage_unavailable"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "not_requested",
            "title": "Retention Reason"
          },
          "retention_status": {
            "default": "skipped",
            "enum": [
              "retained",
              "skipped",
              "failed"
            ],
            "title": "Retention Status",
            "type": "string"
          },
          "role": {
            "enum": [
              "original",
              "thumbnail"
            ],
            "title": "Role",
            "type": "string"
          },
          "type": {
            "enum": [
              "image",
              "video"
            ],
            "title": "Type",
            "type": "string"
          },
          "url": {
            "description": "Original public source reference; may expire. Separate from the authenticated retained asset URL.",
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "type",
          "url",
          "role",
          "group_index"
        ],
        "title": "PostMedia",
        "type": "object"
      },
      "PostPage": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Post"
            },
            "title": "Items",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Page"
          },
          "total": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total"
          }
        },
        "required": [
          "items",
          "count"
        ],
        "title": "PostPage",
        "type": "object"
      },
      "PostSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "author_companies": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Author Companies",
            "type": "array"
          },
          "author_industries": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Author Industries",
            "type": "array"
          },
          "author_keywords": {
            "anyOf": [
              {
                "maxLength": 300,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author Keywords"
          },
          "author_profiles": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Author Profiles",
            "type": "array"
          },
          "authors_employers": {
            "items": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Authors Employers",
            "type": "array"
          },
          "comments_freshness": {
            "anyOf": [
              {
                "enum": [
                  "hour",
                  "day",
                  "week",
                  "month",
                  "three_months",
                  "six_months",
                  "year"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Freshness"
          },
          "comments_limit": {
            "default": 0,
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Comments Limit",
            "type": "integer"
          },
          "content_type": {
            "default": "all",
            "enum": [
              "all",
              "videos",
              "images",
              "jobs",
              "live_videos",
              "documents",
              "collaborative_articles"
            ],
            "title": "Content Type",
            "type": "string"
          },
          "freshness": {
            "anyOf": [
              {
                "enum": [
                  "hour",
                  "day",
                  "week",
                  "month",
                  "three_months",
                  "six_months",
                  "year"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Freshness"
          },
          "limit": {
            "default": 100,
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "mentioned_companies": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Mentioned Companies",
            "type": "array"
          },
          "mentioned_profiles": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "title": "Mentioned Profiles",
            "type": "array"
          },
          "page": {
            "default": 1,
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "pages": {
            "default": 1,
            "maximum": 20.0,
            "minimum": 1.0,
            "title": "Pages",
            "type": "integer"
          },
          "queries": {
            "items": {
              "maxLength": 85,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Queries",
            "type": "array"
          },
          "reactions_limit": {
            "default": 0,
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Reactions Limit",
            "type": "integer"
          },
          "since": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          },
          "sort": {
            "default": "relevance",
            "enum": [
              "relevance",
              "date"
            ],
            "title": "Sort",
            "type": "string"
          }
        },
        "required": [
          "queries"
        ],
        "title": "PostSearchRequest",
        "type": "object"
      },
      "PostTarget": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 1000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "input_index": {
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Input Index",
            "type": "integer"
          },
          "reason": {
            "anyOf": [
              {
                "enum": [
                  "not_found",
                  "private",
                  "unavailable",
                  "malformed_data",
                  "ambiguous"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          },
          "status": {
            "enum": [
              "resolved",
              "unresolved"
            ],
            "title": "Status",
            "type": "string"
          },
          "target": {
            "title": "Target",
            "type": "string"
          }
        },
        "required": [
          "target",
          "input_index",
          "status",
          "collected_count",
          "reason"
        ],
        "title": "PostTarget",
        "type": "object"
      },
      "PostUnresolved": {
        "additionalProperties": false,
        "properties": {
          "input_index": {
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Input Index",
            "type": "integer"
          },
          "reason": {
            "enum": [
              "not_found",
              "private",
              "unavailable",
              "malformed_data",
              "ambiguous"
            ],
            "title": "Reason",
            "type": "string"
          },
          "target": {
            "title": "Target",
            "type": "string"
          }
        },
        "required": [
          "target",
          "input_index",
          "reason"
        ],
        "title": "PostUnresolved",
        "type": "object"
      },
      "Profile": {
        "properties": {
          "about": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "About"
          },
          "certifications": {
            "items": {
              "$ref": "#/components/schemas/Certification"
            },
            "title": "Certifications",
            "type": "array"
          },
          "connection_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Connection Count"
          },
          "courses": {
            "items": {
              "$ref": "#/components/schemas/Course"
            },
            "title": "Courses",
            "type": "array"
          },
          "current_positions": {
            "items": {
              "$ref": "#/components/schemas/Position"
            },
            "title": "Current Positions",
            "type": "array"
          },
          "education": {
            "items": {
              "$ref": "#/components/schemas/Education"
            },
            "title": "Education",
            "type": "array"
          },
          "experience": {
            "items": {
              "$ref": "#/components/schemas/Position"
            },
            "title": "Experience",
            "type": "array"
          },
          "first_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "First Name"
          },
          "follower_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Follower Count"
          },
          "headline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Headline"
          },
          "honors": {
            "items": {
              "$ref": "#/components/schemas/Honor"
            },
            "title": "Honors",
            "type": "array"
          },
          "image": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Image"
              },
              {
                "type": "null"
              }
            ]
          },
          "languages": {
            "items": {
              "$ref": "#/components/schemas/Language"
            },
            "title": "Languages",
            "type": "array"
          },
          "last_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Name"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "profile_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Url"
          },
          "projects": {
            "items": {
              "$ref": "#/components/schemas/Project"
            },
            "title": "Projects",
            "type": "array"
          },
          "public_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Id"
          },
          "publications": {
            "items": {
              "$ref": "#/components/schemas/Publication"
            },
            "title": "Publications",
            "type": "array"
          },
          "recommendations": {
            "items": {
              "$ref": "#/components/schemas/Recommendation"
            },
            "title": "Recommendations",
            "type": "array"
          },
          "skills": {
            "items": {
              "$ref": "#/components/schemas/Skill"
            },
            "title": "Skills",
            "type": "array"
          },
          "volunteering": {
            "items": {
              "$ref": "#/components/schemas/Volunteering"
            },
            "title": "Volunteering",
            "type": "array"
          }
        },
        "title": "Profile",
        "type": "object"
      },
      "ProfileCommentsRequest": {
        "additionalProperties": false,
        "properties": {
          "freshness": {
            "anyOf": [
              {
                "enum": [
                  "hour",
                  "day",
                  "week",
                  "month",
                  "three_months",
                  "six_months",
                  "year"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Freshness"
          },
          "limit": {
            "default": 100,
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "pages": {
            "default": 1,
            "maximum": 20.0,
            "minimum": 1.0,
            "title": "Pages",
            "type": "integer"
          },
          "profiles": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          },
          "since": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "ProfileCommentsRequest",
        "type": "object"
      },
      "ProfileDetailsRequest": {
        "additionalProperties": false,
        "properties": {
          "detail_level": {
            "default": "full",
            "enum": [
              "basic",
              "full"
            ],
            "title": "Detail Level",
            "type": "string"
          },
          "profiles": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "ProfileDetailsRequest",
        "type": "object"
      },
      "ProfilePage": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Profile"
            },
            "title": "Items",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Page"
          },
          "total": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total"
          }
        },
        "required": [
          "items",
          "count"
        ],
        "title": "ProfilePage",
        "type": "object"
      },
      "ProfilePostsRequest": {
        "additionalProperties": false,
        "properties": {
          "comments_limit": {
            "default": 0,
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Comments Limit",
            "type": "integer"
          },
          "freshness": {
            "anyOf": [
              {
                "enum": [
                  "hour",
                  "day",
                  "week",
                  "month",
                  "three_months",
                  "six_months",
                  "year"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Freshness"
          },
          "include_quotes": {
            "default": true,
            "title": "Include Quotes",
            "type": "boolean"
          },
          "include_reposts": {
            "default": true,
            "title": "Include Reposts",
            "type": "boolean"
          },
          "limit": {
            "default": 100,
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "pages": {
            "default": 1,
            "maximum": 20.0,
            "minimum": 1.0,
            "title": "Pages",
            "type": "integer"
          },
          "profiles": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          },
          "reactions_limit": {
            "default": 0,
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Reactions Limit",
            "type": "integer"
          },
          "since": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "ProfilePostsRequest",
        "type": "object"
      },
      "ProfileReactionsRequest": {
        "additionalProperties": false,
        "properties": {
          "freshness": {
            "anyOf": [
              {
                "enum": [
                  "hour",
                  "day",
                  "week",
                  "month",
                  "three_months",
                  "six_months",
                  "year"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Freshness"
          },
          "limit": {
            "default": 100,
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "pages": {
            "default": 1,
            "maximum": 20.0,
            "minimum": 1.0,
            "title": "Pages",
            "type": "integer"
          },
          "profiles": {
            "items": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          },
          "since": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "ProfileReactionsRequest",
        "type": "object"
      },
      "Project": {
        "properties": {
          "date_range": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DateRange"
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          }
        },
        "title": "Project",
        "type": "object"
      },
      "PublicAuthor": {
        "properties": {
          "headline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Headline"
          },
          "image": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Image"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "profile_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Url"
          },
          "public_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Id"
          }
        },
        "title": "PublicAuthor",
        "type": "object"
      },
      "PublicError": {
        "additionalProperties": false,
        "properties": {
          "detail": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "retry_after_s": {
            "maximum": 86400,
            "minimum": 1,
            "type": [
              "integer",
              "null"
            ]
          },
          "status": {
            "maximum": 599,
            "minimum": 400,
            "type": "integer"
          }
        },
        "required": [
          "error",
          "status",
          "detail",
          "retry_after_s"
        ],
        "type": "object"
      },
      "PublicProfileLink": {
        "properties": {
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "title": "PublicProfileLink",
        "type": "object"
      },
      "Publication": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "publisher": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Publisher"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          }
        },
        "title": "Publication",
        "type": "object"
      },
      "Reaction": {
        "properties": {
          "author": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicAuthor"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "kind": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Kind"
          },
          "post": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/pilot__api__scrapers__PostContext"
              },
              {
                "type": "null"
              }
            ]
          },
          "reaction_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reaction Id"
          }
        },
        "title": "Reaction",
        "type": "object"
      },
      "ReactionCount": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "kind": {
            "title": "Kind",
            "type": "string"
          }
        },
        "required": [
          "kind",
          "count"
        ],
        "title": "ReactionCount",
        "type": "object"
      },
      "ReactionPage": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Reaction"
            },
            "title": "Items",
            "type": "array"
          },
          "next_page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Page"
          },
          "total": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total"
          }
        },
        "required": [
          "items",
          "count"
        ],
        "title": "ReactionPage",
        "type": "object"
      },
      "Recommendation": {
        "properties": {
          "author": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicAuthor"
              },
              {
                "type": "null"
              }
            ]
          },
          "relationship": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Relationship"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          }
        },
        "title": "Recommendation",
        "type": "object"
      },
      "RedditAuthor": {
        "additionalProperties": false,
        "properties": {
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_deleted": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Deleted"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Url"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "username",
          "profile_id",
          "profile_url",
          "image_url",
          "is_deleted"
        ],
        "title": "RedditAuthor",
        "type": "object"
      },
      "RedditCommentsPage": {
        "additionalProperties": false,
        "properties": {
          "collapsed_replies_requested": {
            "const": true,
            "title": "Collapsed Replies Requested",
            "type": "boolean"
          },
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/RedditTreeComment"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "max_depth": {
            "const": 100,
            "title": "Max Depth",
            "type": "integer"
          },
          "missing_ancestor_ids": {
            "items": {
              "type": "string"
            },
            "maxItems": 100000,
            "title": "Missing Ancestor Ids",
            "type": "array"
          },
          "nested_replies_requested": {
            "const": true,
            "title": "Nested Replies Requested",
            "type": "boolean"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "enum": [
                "unavailable_or_invalid_rows",
                "missing_ancestors",
                "empty_unverified",
                "collection_limit",
                "depth_limit",
                "upstream_incomplete",
                "source_unavailable",
                "summary_unavailable"
              ],
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "post_url": {
            "title": "Post Url",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "sort": {
            "enum": [
              "best",
              "top",
              "new",
              "controversial",
              "old",
              "qa"
            ],
            "title": "Sort",
            "type": "string"
          },
          "thread_status": {
            "enum": [
              "observed",
              "empty",
              "private",
              "not_found",
              "unavailable",
              "unknown"
            ],
            "title": "Thread Status",
            "type": "string"
          },
          "tree_complete": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Accessible upstream tree completeness, when proven by a source summary; null is unknown. Deleted text and private comments are never recovered.",
            "title": "Tree Complete"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "post_url",
          "post_id",
          "sort",
          "thread_status",
          "collection_complete",
          "tree_complete",
          "max_depth",
          "missing_ancestor_ids",
          "nested_replies_requested",
          "collapsed_replies_requested",
          "partial_reasons"
        ],
        "title": "RedditCommentsPage",
        "type": "object"
      },
      "RedditCommentsRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 100,
            "description": "Finite total comment bound, including all accessible nested replies and deleted/removed placeholders.",
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "post_url": {
            "description": "One explicit public Reddit post permalink. Comment-target, share and redirect URLs are not accepted.",
            "maxLength": 512,
            "minLength": 1,
            "title": "Post Url",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "sort": {
            "default": "best",
            "enum": [
              "best",
              "top",
              "new",
              "controversial",
              "old",
              "qa"
            ],
            "title": "Sort",
            "type": "string"
          }
        },
        "required": [
          "post_url"
        ],
        "title": "RedditCommentsRequest",
        "type": "object"
      },
      "RedditSearchComment": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/RedditAuthor"
          },
          "comment_id": {
            "title": "Comment Id",
            "type": "string"
          },
          "content_state": {
            "enum": [
              "available",
              "deleted",
              "removed",
              "deleted_or_removed",
              "unknown"
            ],
            "title": "Content State",
            "type": "string"
          },
          "full_id": {
            "title": "Full Id",
            "type": "string"
          },
          "kind": {
            "const": "comment",
            "title": "Kind",
            "type": "string"
          },
          "parent_evidence": {
            "enum": [
              "post_context",
              "parent_id",
              "unknown"
            ],
            "title": "Parent Evidence",
            "type": "string"
          },
          "parent_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parent Id"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "post_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Post Title"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "relation_evidence": {
            "const": "search_result_permalink",
            "title": "Relation Evidence",
            "type": "string"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "subreddit": {
            "title": "Subreddit",
            "type": "string"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "full_id",
          "post_id",
          "url",
          "subreddit",
          "author",
          "text",
          "content_state",
          "timestamp",
          "score",
          "query",
          "relation_evidence",
          "kind",
          "comment_id",
          "parent_id",
          "parent_evidence",
          "post_title"
        ],
        "title": "RedditSearchComment",
        "type": "object"
      },
      "RedditSearchItem": {
        "discriminator": {
          "mapping": {
            "comment": "#/components/schemas/RedditSearchComment",
            "post": "#/components/schemas/RedditSearchPost"
          },
          "propertyName": "kind"
        },
        "oneOf": [
          {
            "$ref": "#/components/schemas/RedditSearchPost"
          },
          {
            "$ref": "#/components/schemas/RedditSearchComment"
          }
        ],
        "title": "RedditSearchItem"
      },
      "RedditSearchPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "content_type": {
            "enum": [
              "posts",
              "comments",
              "both"
            ],
            "title": "Content Type",
            "type": "string"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/RedditSearchItem"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "const": "unavailable_or_invalid_rows",
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "query_handling": {
            "const": "upstream_hint",
            "title": "Query Handling",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "sort": {
            "enum": [
              "relevance",
              "new",
              "top",
              "hot",
              "comments"
            ],
            "title": "Sort",
            "type": "string"
          },
          "subreddits": {
            "items": {
              "type": "string"
            },
            "title": "Subreddits",
            "type": "array"
          },
          "time_filter": {
            "enum": [
              "all",
              "hour",
              "day",
              "week",
              "month",
              "year"
            ],
            "title": "Time Filter",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "query",
          "content_type",
          "sort",
          "time_filter",
          "subreddits",
          "collection_complete",
          "query_handling",
          "filters_enforced",
          "partial_reasons"
        ],
        "title": "RedditSearchPage",
        "type": "object"
      },
      "RedditSearchPost": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/RedditAuthor"
          },
          "comments_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Count"
          },
          "content_state": {
            "enum": [
              "available",
              "deleted",
              "removed",
              "deleted_or_removed",
              "unknown"
            ],
            "title": "Content State",
            "type": "string"
          },
          "full_id": {
            "title": "Full Id",
            "type": "string"
          },
          "is_nsfw": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Nsfw"
          },
          "kind": {
            "const": "post",
            "title": "Kind",
            "type": "string"
          },
          "outbound_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Outbound Url"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "relation_evidence": {
            "const": "search_result_permalink",
            "title": "Relation Evidence",
            "type": "string"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "subreddit": {
            "title": "Subreddit",
            "type": "string"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timestamp"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "full_id",
          "post_id",
          "url",
          "subreddit",
          "author",
          "text",
          "content_state",
          "timestamp",
          "score",
          "query",
          "relation_evidence",
          "kind",
          "title",
          "comments_count",
          "outbound_url",
          "is_nsfw"
        ],
        "title": "RedditSearchPost",
        "type": "object"
      },
      "RedditSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "content_type": {
            "default": "posts",
            "enum": [
              "posts",
              "comments",
              "both"
            ],
            "title": "Content Type",
            "type": "string"
          },
          "include_nsfw": {
            "default": false,
            "title": "Include Nsfw",
            "type": "boolean"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "description": "One Reddit query with optional native operators. Returned rows do not guarantee matching or exhaustive recall.",
            "maxLength": 700,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "sort": {
            "default": "relevance",
            "enum": [
              "relevance",
              "new",
              "top",
              "hot",
              "comments"
            ],
            "title": "Sort",
            "type": "string"
          },
          "subreddits": {
            "description": "At most five explicit public communities. Omit for all-Reddit search; related-community discovery is disabled.",
            "items": {
              "type": "string"
            },
            "maxItems": 5,
            "title": "Subreddits",
            "type": "array"
          },
          "time_filter": {
            "default": "all",
            "enum": [
              "all",
              "hour",
              "day",
              "week",
              "month",
              "year"
            ],
            "title": "Time Filter",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "title": "RedditSearchRequest",
        "type": "object"
      },
      "RedditTreeComment": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/RedditAuthor"
          },
          "captured_sequence": {
            "minimum": 0.0,
            "title": "Captured Sequence",
            "type": "integer"
          },
          "children_ids": {
            "description": "Actual direct children in this collection, using Reddit fullnames. Absence does not imply no further replies exist.",
            "items": {
              "type": "string"
            },
            "maxItems": 1000,
            "title": "Children Ids",
            "type": "array"
          },
          "comment_id": {
            "title": "Comment Id",
            "type": "string"
          },
          "content_state": {
            "enum": [
              "available",
              "deleted",
              "removed",
              "deleted_or_removed",
              "unknown"
            ],
            "title": "Content State",
            "type": "string"
          },
          "depth": {
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Depth",
            "type": "integer"
          },
          "direct_reply_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Direct Reply Count"
          },
          "edited_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Edited At"
          },
          "full_id": {
            "title": "Full Id",
            "type": "string"
          },
          "parent_id": {
            "title": "Parent Id",
            "type": "string"
          },
          "parent_present_in_collection": {
            "description": "Whether this parent is the requested post or appears anywhere in the cached collection, including other pages.",
            "title": "Parent Present In Collection",
            "type": "boolean"
          },
          "path": {
            "items": {
              "type": "string"
            },
            "maxItems": 101,
            "minItems": 1,
            "title": "Path",
            "type": "array"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "post_url": {
            "title": "Post Url",
            "type": "string"
          },
          "relation_evidence": {
            "const": "observed_parent_and_path",
            "title": "Relation Evidence",
            "type": "string"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "subreddit": {
            "title": "Subreddit",
            "type": "string"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "comment_id",
          "full_id",
          "post_id",
          "url",
          "post_url",
          "subreddit",
          "author",
          "text",
          "content_state",
          "timestamp",
          "edited_at",
          "score",
          "depth",
          "parent_id",
          "path",
          "parent_present_in_collection",
          "children_ids",
          "direct_reply_count",
          "captured_sequence",
          "relation_evidence"
        ],
        "title": "RedditTreeComment",
        "type": "object"
      },
      "Reply": {
        "properties": {
          "author": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicAuthor"
              },
              {
                "type": "null"
              }
            ]
          },
          "comment_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment Id"
          },
          "comment_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment Url"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "metrics": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EngagementMetrics"
              },
              {
                "type": "null"
              }
            ]
          },
          "parent_comment_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parent Comment Id"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          }
        },
        "title": "Reply",
        "type": "object"
      },
      "ResearchAsset": {
        "properties": {
          "asset_id": {
            "title": "Asset Id",
            "type": "string"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "media_type": {
            "enum": [
              "image/jpeg",
              "image/png",
              "image/webp"
            ],
            "title": "Media Type",
            "type": "string"
          },
          "sha256": {
            "title": "Sha256",
            "type": "string"
          },
          "size_bytes": {
            "title": "Size Bytes",
            "type": "integer"
          },
          "url": {
            "description": "Bearer-authenticated, relative Hive download URL.",
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "asset_id",
          "media_type",
          "size_bytes",
          "sha256",
          "expires_at",
          "url"
        ],
        "title": "ResearchAsset",
        "type": "object"
      },
      "ResearchCapacity": {
        "additionalProperties": false,
        "properties": {
          "available": {
            "description": "Whether shared research admission is currently available. Individual requests can still be unavailable.",
            "title": "Available",
            "type": "boolean"
          },
          "reason": {
            "anyOf": [
              {
                "enum": [
                  "capacity_limited",
                  "service_unavailable"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Minimum delay before rechecking, when known. Elapsed time does not prove recovery.",
            "title": "Retry After S"
          }
        },
        "required": [
          "available",
          "retry_after_s",
          "reason"
        ],
        "title": "ResearchCapacity",
        "type": "object"
      },
      "RetainedPostAsset": {
        "additionalProperties": false,
        "properties": {
          "asset_id": {
            "title": "Asset Id",
            "type": "string"
          },
          "expires_at": {
            "description": "Unix seconds; assets expire after 24 hours and may be deleted earlier.",
            "title": "Expires At",
            "type": "integer"
          },
          "media_type": {
            "enum": [
              "image/jpeg",
              "image/png",
              "image/webp"
            ],
            "title": "Media Type",
            "type": "string"
          },
          "sha256": {
            "description": "SHA-256 of exact retained bytes, without transcoding.",
            "pattern": "^[0-9a-f]{64}$",
            "title": "Sha256",
            "type": "string"
          },
          "size_bytes": {
            "maximum": 10485760.0,
            "minimum": 1.0,
            "title": "Size Bytes",
            "type": "integer"
          },
          "url": {
            "description": "Relative Hive URL; download with the same bearer, never send it to the source host.",
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "asset_id",
          "url",
          "sha256",
          "size_bytes",
          "media_type",
          "expires_at"
        ],
        "title": "RetainedPostAsset",
        "type": "object"
      },
      "Screenshot": {
        "additionalProperties": false,
        "properties": {
          "data_base64": {
            "maxLength": 5592408,
            "minLength": 1,
            "title": "Data Base64",
            "type": "string"
          },
          "full_page": {
            "title": "Full Page",
            "type": "boolean"
          },
          "height": {
            "maximum": 16384,
            "minimum": 1,
            "title": "Height",
            "type": "integer"
          },
          "media_type": {
            "pattern": "^image/png$",
            "title": "Media Type",
            "type": "string"
          },
          "sha256": {
            "pattern": "^[a-f0-9]{64}$",
            "title": "Sha256",
            "type": "string"
          },
          "size_bytes": {
            "maximum": 4194304,
            "minimum": 1,
            "title": "Size Bytes",
            "type": "integer"
          },
          "width": {
            "maximum": 16384,
            "minimum": 1,
            "title": "Width",
            "type": "integer"
          }
        },
        "required": [
          "media_type",
          "data_base64",
          "sha256",
          "size_bytes",
          "width",
          "height",
          "full_page"
        ],
        "title": "Screenshot",
        "type": "object"
      },
      "SherlockSearchPage": {
        "properties": {
          "count": {
            "maximum": 500.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/UsernameCandidate"
            },
            "maxItems": 500,
            "title": "Items",
            "type": "array"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when a work or result limit omitted results; null means completeness is unknown. Candidate matches do not establish identity.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "truncated"
        ],
        "title": "SherlockSearchPage",
        "type": "object"
      },
      "SherlockSearchRequest": {
        "additionalProperties": false,
        "description": "Discover candidate accounts for one to five public usernames.",
        "properties": {
          "limit": {
            "default": 20,
            "description": "Maximum candidates per distinct username.",
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "usernames": {
            "items": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 5,
            "minItems": 1,
            "title": "Usernames",
            "type": "array"
          }
        },
        "required": [
          "usernames"
        ],
        "title": "SherlockSearchRequest",
        "type": "object"
      },
      "Skill": {
        "properties": {
          "endorsements": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Endorsements"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "Skill",
        "type": "object"
      },
      "SocialJob_FacebookCommentsPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FacebookCommentsPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[FacebookCommentsPage]",
        "type": "object"
      },
      "SocialJob_FacebookGroupPostsPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FacebookGroupPostsPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[FacebookGroupPostsPage]",
        "type": "object"
      },
      "SocialJob_FacebookGroupSearchPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FacebookGroupSearchPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[FacebookGroupSearchPage]",
        "type": "object"
      },
      "SocialJob_FacebookPageSearchPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FacebookPageSearchPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[FacebookPageSearchPage]",
        "type": "object"
      },
      "SocialJob_FacebookPostSearchPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FacebookPostSearchPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[FacebookPostSearchPage]",
        "type": "object"
      },
      "SocialJob_InstagramGraphPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InstagramGraphPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[InstagramGraphPage]",
        "type": "object"
      },
      "SocialJob_InstagramHighlightContentPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InstagramHighlightContentPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[InstagramHighlightContentPage]",
        "type": "object"
      },
      "SocialJob_InstagramHighlightsPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InstagramHighlightsPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[InstagramHighlightsPage]",
        "type": "object"
      },
      "SocialJob_InstagramTaggedPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InstagramTaggedPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[InstagramTaggedPage]",
        "type": "object"
      },
      "SocialJob_PeopleSearchPage_FacebookCandidate__": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeopleSearchPage_FacebookCandidate_"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[PeopleSearchPage[FacebookCandidate]]",
        "type": "object"
      },
      "SocialJob_PeopleSearchPage_InstagramCandidate__": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeopleSearchPage_InstagramCandidate_"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[PeopleSearchPage[InstagramCandidate]]",
        "type": "object"
      },
      "SocialJob_PeopleSearchPage_TikTokCandidate__": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeopleSearchPage_TikTokCandidate_"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[PeopleSearchPage[TikTokCandidate]]",
        "type": "object"
      },
      "SocialJob_PeopleSearchPage_XCandidate__": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeopleSearchPage_XCandidate_"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[PeopleSearchPage[XCandidate]]",
        "type": "object"
      },
      "SocialJob_RedditCommentsPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RedditCommentsPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[RedditCommentsPage]",
        "type": "object"
      },
      "SocialJob_RedditSearchPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RedditSearchPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[RedditSearchPage]",
        "type": "object"
      },
      "SocialJob_SocialPostsPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SocialPostsPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[SocialPostsPage]",
        "type": "object"
      },
      "SocialJob_TelegramGroupDetailsPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TelegramGroupDetailsPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[TelegramGroupDetailsPage]",
        "type": "object"
      },
      "SocialJob_TelegramGroupMessagesPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TelegramGroupMessagesPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[TelegramGroupMessagesPage]",
        "type": "object"
      },
      "SocialJob_TelegramGroupSearchPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TelegramGroupSearchPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[TelegramGroupSearchPage]",
        "type": "object"
      },
      "SocialJob_XGraphPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/XGraphPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[XGraphPage]",
        "type": "object"
      },
      "SocialJob_XQueryPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/XQueryPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[XQueryPage]",
        "type": "object"
      },
      "SocialJob_XQuotesPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/XQuotesPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[XQuotesPage]",
        "type": "object"
      },
      "SocialJob_XSpaceDiscoveryPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/XSpaceDiscoveryPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[XSpaceDiscoveryPage]",
        "type": "object"
      },
      "SocialJob_XSpaceRecordingPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/XSpaceRecordingPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[XSpaceRecordingPage]",
        "type": "object"
      },
      "SocialJob_XSpaceTranscriptPage_": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "integer"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "expires_at": {
            "title": "Expires At",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "poll_url": {
            "description": "Relative Hive URL. Poll with the same bearer; wait_seconds up to 25 waits for completion. GET returns this envelope (200), with the completed first page under result. Terminal jobs never launch another paid run on replay; eligible saved archive data has an explicit recover endpoint.",
            "title": "Poll Url",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/XSpaceTranscriptPage"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          },
          "service": {
            "title": "Service",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "outcome_unknown"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "service",
          "operation",
          "status",
          "created_at",
          "expires_at",
          "poll_url"
        ],
        "title": "SocialJob[XSpaceTranscriptPage]",
        "type": "object"
      },
      "SocialPost": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/PostAuthor"
          },
          "comments_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Count"
          },
          "context": {
            "items": {
              "$ref": "#/components/schemas/pilot__api__social_posts__PostContext"
            },
            "maxItems": 2,
            "title": "Context",
            "type": "array"
          },
          "geotag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostGeotag"
              },
              {
                "type": "null"
              }
            ]
          },
          "input_index": {
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Input Index",
            "type": "integer"
          },
          "is_pinned": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Pinned"
          },
          "is_quote": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Quote"
          },
          "is_repost": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Repost"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/PostMedia"
            },
            "maxItems": 500,
            "title": "Media",
            "type": "array"
          },
          "media_complete": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "False when the provider reports media missing from this post; null when completeness cannot be established.",
            "title": "Media Complete"
          },
          "media_count_reported": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Media count reported by the source provider, when available.",
            "title": "Media Count Reported"
          },
          "mentions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Caption/text mentions, separate from actual tags.",
            "title": "Mentions"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "quotes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quotes Count"
          },
          "reposts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts Count"
          },
          "tagged_users": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual source tags; null means unavailable.",
            "title": "Tagged Users"
          },
          "target": {
            "title": "Target",
            "type": "string"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "UTC ISO 8601 time; null means unavailable, never inferred epoch zero.",
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "views_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Views Count"
          }
        },
        "required": [
          "post_id",
          "url",
          "author",
          "timestamp",
          "text",
          "media",
          "geotag",
          "tagged_users",
          "mentions",
          "target",
          "input_index",
          "context"
        ],
        "title": "SocialPost",
        "type": "object"
      },
      "SocialPostsPage": {
        "additionalProperties": false,
        "properties": {
          "archive_end_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Archive End Date"
          },
          "archive_start_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Archive Start Date"
          },
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "history_complete": {
            "description": "Full platform history is unknown. Pages cover only the cached collection.",
            "title": "History Complete",
            "type": "null"
          },
          "history_scope": {
            "default": "collected_window",
            "description": "Date windows continue through next_archive_end_date; cursor windows continue through next_archive_cursor. Page numbers only traverse the cached result.",
            "enum": [
              "collected_window",
              "recent_public_timeline",
              "archive_date_window",
              "archive_cursor_window"
            ],
            "title": "History Scope",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/SocialPost"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_archive_cursor": {
            "anyOf": [
              {
                "maxLength": 262144,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Submit as archive_cursor in a new Instagram or Facebook personal archive job with the same profile and window settings after consuming cached pages. Null when the provider reached the visible end or could not safely continue.",
            "title": "Next Archive Cursor"
          },
          "next_archive_end_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Submit a new archive job ending on this date after consuming all cached pages. Null when the date range is exhausted or the current window hit its collection cap; narrow a capped window before continuing.",
            "title": "Next Archive End Date"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "per_target_limit": {
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Per Target Limit",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "targets": {
            "items": {
              "$ref": "#/components/schemas/PostTarget"
            },
            "maxItems": 10,
            "title": "Targets",
            "type": "array"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          },
          "unresolved": {
            "items": {
              "$ref": "#/components/schemas/PostUnresolved"
            },
            "maxItems": 10,
            "title": "Unresolved",
            "type": "array"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "targets",
          "unresolved",
          "per_target_limit",
          "history_complete"
        ],
        "title": "SocialPostsPage",
        "type": "object"
      },
      "TelegramGroup": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "group_url": {
            "title": "Group Url",
            "type": "string"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "members_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Members Count"
          },
          "observed_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Observed At"
          },
          "online_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Online Count"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          }
        },
        "required": [
          "group_url",
          "username",
          "title",
          "description",
          "members_count",
          "online_count",
          "is_verified",
          "image_url",
          "observed_at"
        ],
        "title": "TelegramGroup",
        "type": "object"
      },
      "TelegramGroupCandidate": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "group_url": {
            "title": "Group Url",
            "type": "string"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "matched_all_words": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Matched All Words"
          },
          "observed_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Observed At"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "rank": {
            "minimum": 1.0,
            "title": "Rank",
            "type": "integer"
          },
          "relation_evidence": {
            "const": "public_group_index",
            "title": "Relation Evidence",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          }
        },
        "required": [
          "group_url",
          "username",
          "title",
          "description",
          "query",
          "rank",
          "matched_all_words",
          "language",
          "observed_at",
          "relation_evidence"
        ],
        "title": "TelegramGroupCandidate",
        "type": "object"
      },
      "TelegramGroupDetailsPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "group_url": {
            "title": "Group Url",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/TelegramGroup"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "const": "unavailable_or_invalid_rows",
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "requested_collection_size": {
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "group_url"
        ],
        "title": "TelegramGroupDetailsPage",
        "type": "object"
      },
      "TelegramGroupDetailsRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 1,
            "maximum": 1.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "group_url": {
            "description": "One public group handle, @username or https://t.me/username URL. Invite links, private chats and message links are rejected.",
            "maxLength": 256,
            "minLength": 1,
            "title": "Group Url",
            "type": "string"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "group_url"
        ],
        "title": "TelegramGroupDetailsRequest",
        "type": "object"
      },
      "TelegramGroupMessagesPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "group_url": {
            "title": "Group Url",
            "type": "string"
          },
          "history_complete": {
            "title": "History Complete",
            "type": "null"
          },
          "history_scope": {
            "const": "public_accessible_snapshot",
            "title": "History Scope",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/TelegramMessage"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "keyword": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Keyword"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "const": "unavailable_or_invalid_rows",
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "requested_collection_size": {
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "since": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          },
          "until": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Until"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "group_url",
          "keyword",
          "since",
          "until",
          "history_scope",
          "history_complete",
          "filters_enforced"
        ],
        "title": "TelegramGroupMessagesPage",
        "type": "object"
      },
      "TelegramGroupMessagesRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "group_url": {
            "description": "One public discussion group. Broadcast channels are not accepted as group message data.",
            "maxLength": 256,
            "minLength": 1,
            "title": "Group Url",
            "type": "string"
          },
          "keyword": {
            "anyOf": [
              {
                "maxLength": 200,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional upstream keyword hint in the selected group. Whole-word matching, * endings and + clauses depend on the source.",
            "title": "Keyword"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "since": {
            "anyOf": [
              {
                "maxLength": 40,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive timezone-aware timestamp hint. Results remain a bounded snapshot, not full history.",
            "title": "Since"
          },
          "until": {
            "anyOf": [
              {
                "maxLength": 40,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exclusive timezone-aware timestamp hint, after since when both are present.",
            "title": "Until"
          }
        },
        "required": [
          "group_url"
        ],
        "title": "TelegramGroupMessagesRequest",
        "type": "object"
      },
      "TelegramGroupSearchPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "content_retrieved": {
            "const": false,
            "title": "Content Retrieved",
            "type": "boolean"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/TelegramGroupCandidate"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "const": "unavailable_or_invalid_rows",
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "query_handling": {
            "const": "upstream_hint",
            "title": "Query Handling",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "search_source": {
            "const": "public_web_index",
            "title": "Search Source",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "requested_collection_size",
          "collection_complete",
          "partial_reasons",
          "query",
          "language",
          "search_source",
          "query_handling",
          "filters_enforced",
          "content_retrieved"
        ],
        "title": "TelegramGroupSearchPage",
        "type": "object"
      },
      "TelegramGroupSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 50,
            "maximum": 200.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "language": {
            "anyOf": [
              {
                "pattern": "^[a-z]{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional two-letter language hint passed to the public index.",
            "title": "Language"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "description": "One topic or group-name query over a public Telegram index. Results are group candidates, not exhaustive discovery.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "query"
        ],
        "title": "TelegramGroupSearchRequest",
        "type": "object"
      },
      "TelegramMedia": {
        "additionalProperties": false,
        "properties": {
          "kind": {
            "enum": [
              "photo",
              "video",
              "document",
              "sticker",
              "voice",
              "audio",
              "animation",
              "unknown"
            ],
            "title": "Kind",
            "type": "string"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Public source reference, which may expire; no media bytes are retained by this operation.",
            "title": "Url"
          }
        },
        "required": [
          "kind",
          "url"
        ],
        "title": "TelegramMedia",
        "type": "object"
      },
      "TelegramMessage": {
        "additionalProperties": false,
        "properties": {
          "edited": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Edited"
          },
          "group_url": {
            "title": "Group Url",
            "type": "string"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/TelegramMedia"
            },
            "maxItems": 100,
            "title": "Media",
            "type": "array"
          },
          "message_id": {
            "title": "Message Id",
            "type": "string"
          },
          "relation_evidence": {
            "const": "observed_group_message",
            "title": "Relation Evidence",
            "type": "string"
          },
          "reply_to_message_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reply To Message Id"
          },
          "reply_to_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reply To Url"
          },
          "sender": {
            "$ref": "#/components/schemas/TelegramSender"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "title": "Timestamp",
            "type": "string"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "group_url",
          "message_id",
          "url",
          "text",
          "timestamp",
          "edited",
          "sender",
          "reply_to_message_id",
          "reply_to_url",
          "media",
          "relation_evidence"
        ],
        "title": "TelegramMessage",
        "type": "object"
      },
      "TelegramSender": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "profile_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Url"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "name",
          "username",
          "profile_url"
        ],
        "title": "TelegramSender",
        "type": "object"
      },
      "TikTokCandidate": {
        "additionalProperties": false,
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "friends_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Friends Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_organization": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Organization"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_seller": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Seller"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "missing_fields": {
            "description": "Unavailable core profile fields. No inferred or purchased enrichment.",
            "items": {
              "enum": [
                "display_name",
                "biography",
                "image_url"
              ],
              "type": "string"
            },
            "maxItems": 3,
            "title": "Missing Fields",
            "type": "array"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PublicProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "rank": {
            "description": "Absolute one-based position after canonical account deduplication, preserving native order.",
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Rank",
            "type": "integer"
          },
          "status": {
            "const": "candidate",
            "title": "Status",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "query",
          "rank",
          "status",
          "missing_fields",
          "username",
          "profile_url"
        ],
        "title": "TikTokCandidate",
        "type": "object"
      },
      "TikTokPeopleRequest": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "locations": {
            "description": "Up to five location hints of 1\u2013100 characters, appended in caller order to one native query. Ambiguous names remain text; no city resolution or AND/OR geographic filters are enforced.",
            "items": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 5,
            "title": "Locations",
            "type": "array"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "description": "Free-text name, optionally with employer/city. Echoed exactly; matching does not verify identity or enforce filters.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "query"
        ],
        "title": "TikTokPeopleRequest",
        "type": "object"
      },
      "TikTokPostsRequest": {
        "additionalProperties": false,
        "description": "Collect recent videos or a dated window of public videos and slideshows.",
        "properties": {
          "archive": {
            "default": false,
            "description": "Collect one dated profile window. Follow next_archive_end_date with a new Idempotency-Key to continue backward.",
            "title": "Archive",
            "type": "boolean"
          },
          "archive_end_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive UTC end date; required with archive=true.",
            "title": "Archive End Date"
          },
          "archive_window_days": {
            "default": 30,
            "description": "Inclusive days in the archive window. Narrow a window that reaches the collection cap.",
            "maximum": 30.0,
            "minimum": 1.0,
            "title": "Archive Window Days",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "per_target_limit": {
            "default": 50,
            "description": "Maximum videos per profile: 50 by default or up to 1,000 in one dated archive window. Archive mode defaults to 1,000 if omitted.",
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Per Target Limit",
            "type": "integer"
          },
          "profiles": {
            "items": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "retain_media": {
            "default": false,
            "description": "Preserve photos/video thumbnails. Recent jobs allow 20 unique images and 32 MiB over 30 seconds; archive jobs allow 100 images and 96 MiB over 120 seconds. Each image is capped at 10 MiB and 40 million pixels. Shared bearer/global quotas still apply. No video download; assets expire after 24 hours. Cached pages/replay never download again.",
            "title": "Retain Media",
            "type": "boolean"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "TikTokPostsRequest",
        "type": "object"
      },
      "TikTokProfile": {
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "friends_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Friends Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "input_index": {
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Input Index",
            "type": "integer"
          },
          "is_organization": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Organization"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_seller": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Seller"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PublicProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "target": {
            "title": "Target",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "target",
          "input_index",
          "username",
          "profile_url"
        ],
        "title": "TikTokProfile",
        "type": "object"
      },
      "TikTokProfilePage": {
        "properties": {
          "count": {
            "maximum": 10.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/TikTokProfile"
            },
            "maxItems": 10,
            "title": "Items",
            "type": "array"
          },
          "unresolved": {
            "items": {
              "$ref": "#/components/schemas/UnresolvedProfile"
            },
            "maxItems": 10,
            "title": "Unresolved",
            "type": "array"
          }
        },
        "required": [
          "unresolved",
          "items",
          "count"
        ],
        "title": "TikTokProfilePage",
        "type": "object"
      },
      "TikTokProfileRequest": {
        "additionalProperties": false,
        "description": "One to ten TikTok usernames or canonical public @username URLs.",
        "properties": {
          "profiles": {
            "items": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "TikTokProfileRequest",
        "type": "object"
      },
      "UnresolvedProfile": {
        "properties": {
          "input_index": {
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Input Index",
            "type": "integer"
          },
          "reason": {
            "enum": [
              "not_found",
              "private",
              "unavailable",
              "malformed_data",
              "ambiguous"
            ],
            "title": "Reason",
            "type": "string"
          },
          "target": {
            "title": "Target",
            "type": "string"
          }
        },
        "required": [
          "target",
          "input_index",
          "reason"
        ],
        "title": "UnresolvedProfile",
        "type": "object"
      },
      "UsernameCandidate": {
        "description": "A matching public handle is a candidate, not evidence of shared identity.",
        "properties": {
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "site": {
            "title": "Site",
            "type": "string"
          },
          "status": {
            "const": "candidate",
            "title": "Status",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          }
        },
        "required": [
          "username",
          "site",
          "profile_url",
          "status"
        ],
        "title": "UsernameCandidate",
        "type": "object"
      },
      "VerifiedExit": {
        "properties": {
          "asn": {
            "title": "Asn",
            "type": "string"
          },
          "country": {
            "title": "Country",
            "type": "string"
          },
          "ip": {
            "title": "Ip",
            "type": "string"
          },
          "region": {
            "title": "Region",
            "type": "string"
          },
          "timezone": {
            "title": "Timezone",
            "type": "string"
          },
          "verified_at": {
            "title": "Verified At",
            "type": "string"
          }
        },
        "required": [
          "ip",
          "country",
          "region",
          "asn",
          "timezone",
          "verified_at"
        ],
        "title": "VerifiedExit",
        "type": "object"
      },
      "Volunteering": {
        "properties": {
          "cause": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cause"
          },
          "date_range": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DateRange"
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "organization": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Organization"
          },
          "role": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Role"
          }
        },
        "title": "Volunteering",
        "type": "object"
      },
      "WaybackRequest": {
        "additionalProperties": false,
        "properties": {
          "date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "YYYY-MM-DD; provide exactly one year or date.",
            "title": "Date"
          },
          "url": {
            "description": "Exact public HTTP/HTTPS URL to look up; it is never fetched from its live host.",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Url",
            "type": "string"
          },
          "year": {
            "anyOf": [
              {
                "maximum": 2100.0,
                "minimum": 1996.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Year"
          }
        },
        "required": [
          "url"
        ],
        "title": "WaybackRequest",
        "type": "object"
      },
      "WaybackResponse": {
        "properties": {
          "archive_url": {
            "title": "Archive Url",
            "type": "string"
          },
          "cache_expires_at": {
            "title": "Cache Expires At",
            "type": "number"
          },
          "cache_hit": {
            "title": "Cache Hit",
            "type": "boolean"
          },
          "capture_datetime": {
            "title": "Capture Datetime",
            "type": "string"
          },
          "capture_timestamp": {
            "title": "Capture Timestamp",
            "type": "string"
          },
          "capture_validation": {
            "enum": [
              "cdx_and_replay_url",
              "cdx_replay_and_memento_datetime"
            ],
            "title": "Capture Validation",
            "type": "string"
          },
          "cdx_digest": {
            "title": "Cdx Digest",
            "type": "string"
          },
          "content_type": {
            "title": "Content Type",
            "type": "string"
          },
          "decoding_lossy": {
            "title": "Decoding Lossy",
            "type": "boolean"
          },
          "encoding": {
            "title": "Encoding",
            "type": "string"
          },
          "history_complete": {
            "description": "Unknown; this lookup does not enumerate all historical captures.",
            "title": "History Complete",
            "type": "null"
          },
          "html": {
            "description": "Decoded identity replay HTML, with no local rewriting or script execution.",
            "title": "Html",
            "type": "string"
          },
          "html_base64": {
            "description": "Exact decoded HTTP entity bytes; decode base64 before comparing sha256.",
            "title": "Html Base64",
            "type": "string"
          },
          "replay_mode": {
            "const": "id_",
            "title": "Replay Mode",
            "type": "string"
          },
          "requested_period": {
            "title": "Requested Period",
            "type": "string"
          },
          "selected_capture_timestamp": {
            "title": "Selected Capture Timestamp",
            "type": "string"
          },
          "selection": {
            "enum": [
              "earliest_returned_capture",
              "archive_redirect_to_indexed_capture"
            ],
            "title": "Selection",
            "type": "string"
          },
          "sha256": {
            "title": "Sha256",
            "type": "string"
          },
          "size_bytes": {
            "title": "Size Bytes",
            "type": "integer"
          },
          "text": {
            "description": "Text extracted from HTML without executing JavaScript or loading assets.",
            "title": "Text",
            "type": "string"
          },
          "text_truncated": {
            "title": "Text Truncated",
            "type": "boolean"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url",
          "requested_period",
          "capture_timestamp",
          "selected_capture_timestamp",
          "capture_datetime",
          "archive_url",
          "capture_validation",
          "selection",
          "replay_mode",
          "cdx_digest",
          "html",
          "html_base64",
          "text",
          "text_truncated",
          "content_type",
          "encoding",
          "decoding_lossy",
          "size_bytes",
          "sha256",
          "cache_hit",
          "cache_expires_at"
        ],
        "title": "WaybackResponse",
        "type": "object"
      },
      "XCandidate": {
        "additionalProperties": false,
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Account creation timestamp in ISO 8601 UTC.",
            "title": "Created At"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_blue_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Blue Verified"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Verification observation; absent or null when the source supplies only an ambiguous untyped flag.",
            "title": "Is Verified"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "listed_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Listed Count"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "media_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Media Count"
          },
          "missing_fields": {
            "description": "Unavailable core profile fields. No inferred or purchased enrichment.",
            "items": {
              "enum": [
                "display_name",
                "biography",
                "image_url"
              ],
              "type": "string"
            },
            "maxItems": 3,
            "title": "Missing Fields",
            "type": "array"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PublicProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "rank": {
            "description": "Absolute one-based position after canonical account deduplication, preserving native order.",
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Rank",
            "type": "integer"
          },
          "status": {
            "const": "candidate",
            "title": "Status",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          },
          "verification_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verification Type"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "query",
          "rank",
          "status",
          "missing_fields",
          "username",
          "profile_url"
        ],
        "title": "XCandidate",
        "type": "object"
      },
      "XDumpMedia": {
        "properties": {
          "media_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Media Id"
          },
          "type": {
            "enum": [
              "photo",
              "video",
              "animated_gif"
            ],
            "title": "Type",
            "type": "string"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "video_variants": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/XDumpMediaVariant"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Video Variants"
          }
        },
        "required": [
          "type",
          "url"
        ],
        "title": "XDumpMedia",
        "type": "object"
      },
      "XDumpMediaVariant": {
        "properties": {
          "bitrate": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bitrate"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "title": "XDumpMediaVariant",
        "type": "object"
      },
      "XDumpPost": {
        "properties": {
          "author": {
            "title": "Author",
            "type": "string"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "in_reply_to_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "In Reply To Post Id"
          },
          "in_reply_to_user_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "In Reply To User Id"
          },
          "is_quote": {
            "title": "Is Quote",
            "type": "boolean"
          },
          "is_reply": {
            "title": "Is Reply",
            "type": "boolean"
          },
          "is_repost": {
            "title": "Is Repost",
            "type": "boolean"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/XDumpMedia"
            },
            "title": "Media",
            "type": "array"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "post_id",
          "url",
          "author",
          "created_at",
          "text",
          "media",
          "is_reply",
          "is_quote",
          "is_repost"
        ],
        "title": "XDumpPost",
        "type": "object"
      },
      "XDumpPostsPage": {
        "properties": {
          "has_more": {
            "description": "More posts are cached now; poll the job while it is still running.",
            "title": "Has More",
            "type": "boolean"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "next_after": {
            "title": "Next After",
            "type": "integer"
          },
          "posts": {
            "items": {
              "$ref": "#/components/schemas/XDumpPost"
            },
            "title": "Posts",
            "type": "array"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "partial",
              "timelines_exhausted"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "status",
          "posts",
          "next_after",
          "has_more"
        ],
        "title": "XDumpPostsPage",
        "type": "object"
      },
      "XDumpRequest": {
        "additionalProperties": false,
        "description": "Collect signed-in browser timelines for one public X profile.",
        "properties": {
          "profiles": {
            "items": {
              "type": "string"
            },
            "maxItems": 1,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          },
          "tabs": {
            "items": {
              "enum": [
                "tweets",
                "legacy_tweets",
                "with_replies",
                "reposts",
                "media",
                "photos",
                "legacy_media"
              ],
              "type": "string"
            },
            "maxItems": 7,
            "minItems": 1,
            "title": "Tabs",
            "type": "array"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "XDumpRequest",
        "type": "object"
      },
      "XDumpResumeRequest": {
        "additionalProperties": false,
        "description": "Select paused tabs and an inclusive continuation window at saved cursors.",
        "properties": {
          "end_page": {
            "anyOf": [
              {
                "maximum": 1000000.0,
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive stop page; reaching this bound leaves the job partial.",
            "title": "End Page"
          },
          "start_page": {
            "anyOf": [
              {
                "maximum": 1000000.0,
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Must equal last_page + 1 for every selected tab; cursors cannot skip pages.",
            "title": "Start Page"
          },
          "tabs": {
            "anyOf": [
              {
                "items": {
                  "enum": [
                    "tweets",
                    "legacy_tweets",
                    "with_replies",
                    "reposts",
                    "media",
                    "photos",
                    "legacy_media"
                  ],
                  "type": "string"
                },
                "maxItems": 7,
                "minItems": 1,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tabs"
          }
        },
        "title": "XDumpResumeRequest",
        "type": "object"
      },
      "XDumpStatus": {
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "number"
          },
          "error_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error Code"
          },
          "history_coverage": {
            "description": "A count comparison, never a guarantee of full history.",
            "enum": [
              "unverified",
              "below_profile_count",
              "matches_profile_count",
              "above_profile_count"
            ],
            "title": "History Coverage",
            "type": "string"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "max_runs": {
            "default": 32,
            "title": "Max Runs",
            "type": "integer"
          },
          "media_count": {
            "title": "Media Count",
            "type": "integer"
          },
          "media_post_count": {
            "title": "Media Post Count",
            "type": "integer"
          },
          "next_run_at": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Run At"
          },
          "post_count": {
            "title": "Post Count",
            "type": "integer"
          },
          "profile": {
            "title": "Profile",
            "type": "string"
          },
          "profile_reported_posts": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Reported Posts"
          },
          "revision": {
            "default": 1,
            "title": "Revision",
            "type": "integer"
          },
          "run_count": {
            "default": 0,
            "title": "Run Count",
            "type": "integer"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "partial",
              "timelines_exhausted"
            ],
            "title": "Status",
            "type": "string"
          },
          "tabs": {
            "items": {
              "$ref": "#/components/schemas/XDumpTabStatus"
            },
            "title": "Tabs",
            "type": "array"
          },
          "unreconciled_post_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unreconciled Post Count"
          },
          "updated_at": {
            "title": "Updated At",
            "type": "number"
          }
        },
        "required": [
          "job_id",
          "profile",
          "status",
          "error_code",
          "tabs",
          "post_count",
          "media_count",
          "media_post_count",
          "profile_reported_posts",
          "unreconciled_post_count",
          "history_coverage",
          "created_at",
          "updated_at"
        ],
        "title": "XDumpStatus",
        "type": "object"
      },
      "XDumpTabStatus": {
        "properties": {
          "end_page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "End Page"
          },
          "last_page": {
            "title": "Last Page",
            "type": "integer"
          },
          "no_new_pages": {
            "title": "No New Pages",
            "type": "integer"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "tab": {
            "enum": [
              "tweets",
              "legacy_tweets",
              "with_replies",
              "reposts",
              "media",
              "photos",
              "legacy_media"
            ],
            "title": "Tab",
            "type": "string"
          }
        },
        "required": [
          "tab",
          "status",
          "last_page",
          "no_new_pages"
        ],
        "title": "XDumpTabStatus",
        "type": "object"
      },
      "XGraphEdge": {
        "additionalProperties": false,
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "is_blue_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Blue Verified"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Verified"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "listed_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Listed Count"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "media_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Media Count"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/XProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "relation": {
            "enum": [
              "followers",
              "following"
            ],
            "title": "Relation",
            "type": "string"
          },
          "relation_evidence": {
            "description": "Source attribution is explicit in the row; provider expansion requires a privately reviewed single-source/direction contract and fixture. The source root is excluded.",
            "enum": [
              "source_attribution",
              "provider_expansion"
            ],
            "title": "Relation Evidence",
            "type": "string"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          },
          "verification_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verification Type"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "username",
          "profile_url",
          "source_profile",
          "relation",
          "relation_evidence"
        ],
        "title": "XGraphEdge",
        "type": "object"
      },
      "XGraphPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "graph_complete": {
            "description": "Full public graph completeness is unknown, including when next_page is null.",
            "title": "Graph Complete",
            "type": "null"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/XGraphEdge"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "enum": [
                "rejected_rows",
                "missing_optional_fields"
              ],
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "relation": {
            "enum": [
              "followers",
              "following"
            ],
            "title": "Relation",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 2000.0,
            "minimum": 5.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "source_profile",
          "relation",
          "requested_collection_size",
          "graph_complete",
          "partial_reasons"
        ],
        "title": "XGraphPage",
        "type": "object"
      },
      "XGraphRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 100,
            "description": "Maximum rows in one public graph collection; page limit only pages that immutable result. No upstream graph continuation is available.",
            "maximum": 2000.0,
            "minimum": 5.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "profile": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Profile",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "profile"
        ],
        "title": "XGraphRequest",
        "type": "object"
      },
      "XIncomingQuote": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/PostAuthor"
          },
          "comments_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Count"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "geotag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostGeotag"
              },
              {
                "type": "null"
              }
            ]
          },
          "in_reply_to_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual reply parent when returned; a quote-provider target is never reused as a reply parent.",
            "title": "In Reply To Post Id"
          },
          "is_quote": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Quote"
          },
          "is_reply": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Reply"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/PostMedia"
            },
            "maxItems": 500,
            "title": "Media",
            "type": "array"
          },
          "media_complete": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "False when the provider reports media missing from this post; null when completeness cannot be established.",
            "title": "Media Complete"
          },
          "media_count_reported": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Media count reported by the source provider, when available.",
            "title": "Media Count Reported"
          },
          "mentions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Caption/text mentions, separate from actual tags.",
            "title": "Mentions"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "quoted_post_id": {
            "description": "Actual original-post ID returned with this quote. It must match the requested target.",
            "pattern": "^[1-9][0-9]{0,24}$",
            "title": "Quoted Post Id",
            "type": "string"
          },
          "quotes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quotes Count"
          },
          "relation_evidence": {
            "const": "provider_quote_target",
            "description": "The returned row explicitly names the original post in the reviewed quote-provider output; request echo and search membership alone cannot establish this relationship.",
            "title": "Relation Evidence",
            "type": "string"
          },
          "relation_kind": {
            "const": "incoming_quote",
            "title": "Relation Kind",
            "type": "string"
          },
          "relation_target_post_id": {
            "pattern": "^[1-9][0-9]{0,24}$",
            "title": "Relation Target Post Id",
            "type": "string"
          },
          "reposts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts Count"
          },
          "tagged_users": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual source tags; null means unavailable.",
            "title": "Tagged Users"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "UTC ISO 8601 time; null means unavailable, never inferred epoch zero.",
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "views_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Views Count"
          }
        },
        "required": [
          "post_id",
          "url",
          "author",
          "timestamp",
          "text",
          "media",
          "geotag",
          "tagged_users",
          "mentions",
          "relation_kind",
          "relation_evidence",
          "relation_target_post_id",
          "quoted_post_id",
          "in_reply_to_post_id",
          "conversation_id",
          "is_reply",
          "is_quote"
        ],
        "title": "XIncomingQuote",
        "type": "object"
      },
      "XPeopleRequest": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "locations": {
            "description": "Up to five location hints of 1\u2013100 characters, appended in caller order to one native query. Ambiguous names remain text; no city resolution or AND/OR geographic filters are enforced.",
            "items": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 5,
            "title": "Locations",
            "type": "array"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "description": "Free-text name, optionally with employer/city. Echoed exactly; matching does not verify identity or enforce filters.",
            "maxLength": 200,
            "minLength": 1,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "query"
        ],
        "title": "XPeopleRequest",
        "type": "object"
      },
      "XPostRelationRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 100,
            "maximum": 800.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "post_id": {
            "pattern": "^[1-9][0-9]{0,24}$",
            "title": "Post Id",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "post_id"
        ],
        "title": "XPostRelationRequest",
        "type": "object"
      },
      "XPostSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 100,
            "maximum": 800.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "from_username": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "From Username"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "mention_username": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mention Username"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "query": {
            "default": "",
            "description": "One X web-search query. from:, to:, @mention, since: and until: may be supplied here or through the structured fields. Search recall is unknown.",
            "maxLength": 512,
            "title": "Query",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "since_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since Date"
          },
          "to_username": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "To Username"
          },
          "until_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exclusive upper UTC date in the effective search query.",
            "title": "Until Date"
          }
        },
        "title": "XPostSearchRequest",
        "type": "object"
      },
      "XPostsRequest": {
        "additionalProperties": false,
        "description": "Collect recent X posts or a dated archive window, then page the cached result.",
        "properties": {
          "archive": {
            "default": false,
            "description": "Search one profile by date instead of collecting only its recent timeline. Use next_archive_end_date from the result to request the preceding window with a new Idempotency-Key.",
            "title": "Archive",
            "type": "boolean"
          },
          "archive_end_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive UTC date at the end of this archive window. Required with archive=true.",
            "title": "Archive End Date"
          },
          "archive_window_days": {
            "default": 30,
            "description": "Number of inclusive days in one archive search. Use a smaller window if truncated is true; cached page numbers do not extend history.",
            "maximum": 30.0,
            "minimum": 1.0,
            "title": "Archive Window Days",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "media_filter": {
            "default": "any",
            "description": "Archive search filter. Use images to find older photo posts without scrolling through text replies.",
            "enum": [
              "any",
              "images",
              "videos"
            ],
            "title": "Media Filter",
            "type": "string"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "per_target_limit": {
            "default": 50,
            "description": "Maximum posts per profile: 50 by default, up to 100 for recent mode and 1,000 for one dated archive window. Archive mode defaults to 1,000 if omitted.",
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Per Target Limit",
            "type": "integer"
          },
          "profiles": {
            "items": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "retain_media": {
            "default": false,
            "description": "Preserve photos/video thumbnails. Recent jobs allow 20 unique images and 32 MiB over 30 seconds; archive jobs allow 100 images and 96 MiB over 120 seconds. Each image is capped at 10 MiB and 40 million pixels. Shared bearer/global quotas still apply. No video download; assets expire after 24 hours. Cached pages/replay never download again.",
            "title": "Retain Media",
            "type": "boolean"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "XPostsRequest",
        "type": "object"
      },
      "XProfile": {
        "properties": {
          "biography": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Biography"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Account creation timestamp in ISO 8601 UTC.",
            "title": "Created At"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "followers_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Followers Count"
          },
          "following_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Following Count"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "input_index": {
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Input Index",
            "type": "integer"
          },
          "is_blue_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Blue Verified"
          },
          "is_private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Private"
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Verification observation; absent or null when the source supplies only an ambiguous untyped flag.",
            "title": "Is Verified"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "listed_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Listed Count"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "media_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Media Count"
          },
          "posts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posts Count"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "public_links": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PublicProfileLink"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Public Links"
          },
          "target": {
            "title": "Target",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          },
          "verification_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verification Type"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url"
          }
        },
        "required": [
          "target",
          "input_index",
          "username",
          "profile_url"
        ],
        "title": "XProfile",
        "type": "object"
      },
      "XProfileLink": {
        "additionalProperties": false,
        "properties": {
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "title": "XProfileLink",
        "type": "object"
      },
      "XProfilePage": {
        "properties": {
          "count": {
            "maximum": 10.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/XProfile"
            },
            "maxItems": 10,
            "title": "Items",
            "type": "array"
          },
          "unresolved": {
            "items": {
              "$ref": "#/components/schemas/UnresolvedProfile"
            },
            "maxItems": 10,
            "title": "Unresolved",
            "type": "array"
          }
        },
        "required": [
          "unresolved",
          "items",
          "count"
        ],
        "title": "XProfilePage",
        "type": "object"
      },
      "XProfileRequest": {
        "additionalProperties": false,
        "description": "One to ten X handles or canonical x.com or twitter.com profile URLs.",
        "properties": {
          "profiles": {
            "items": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Profiles",
            "type": "array"
          }
        },
        "required": [
          "profiles"
        ],
        "title": "XProfileRequest",
        "type": "object"
      },
      "XQueryPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "effective_query": {
            "title": "Effective Query",
            "type": "string"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "filters_enforced": {
            "const": false,
            "description": "Search operators are sent upstream; matching and recall are not independently guaranteed.",
            "title": "Filters Enforced",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/XQueryPost"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "const": "rejected_rows_or_unknown_parent",
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "query_scope": {
            "enum": [
              "post_search",
              "conversation_candidates"
            ],
            "title": "Query Scope",
            "type": "string"
          },
          "requested_collection_size": {
            "maximum": 800.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "search_complete": {
            "title": "Search Complete",
            "type": "null"
          },
          "target_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Post Id"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "effective_query",
          "query_scope",
          "requested_collection_size",
          "target_post_id",
          "search_complete",
          "filters_enforced",
          "partial_reasons"
        ],
        "title": "XQueryPage",
        "type": "object"
      },
      "XQueryPost": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/PostAuthor"
          },
          "comments_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Count"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "effective_query": {
            "title": "Effective Query",
            "type": "string"
          },
          "geotag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostGeotag"
              },
              {
                "type": "null"
              }
            ]
          },
          "in_reply_to_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual returned parent ID; null is unknown and never inferred from conversation membership.",
            "title": "In Reply To Post Id"
          },
          "is_quote": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Quote"
          },
          "is_reply": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Reply"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/PostMedia"
            },
            "maxItems": 500,
            "title": "Media",
            "type": "array"
          },
          "media_complete": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "False when the provider reports media missing from this post; null when completeness cannot be established.",
            "title": "Media Complete"
          },
          "media_count_reported": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Media count reported by the source provider, when available.",
            "title": "Media Count Reported"
          },
          "mentions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Caption/text mentions, separate from actual tags.",
            "title": "Mentions"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "quoted_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual returned outgoing quote target; this does not enumerate incoming quotes.",
            "title": "Quoted Post Id"
          },
          "quotes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quotes Count"
          },
          "relation_evidence": {
            "enum": [
              "search_query",
              "parent_id",
              "conversation_and_parent_id"
            ],
            "title": "Relation Evidence",
            "type": "string"
          },
          "relation_kind": {
            "enum": [
              "search_match",
              "conversation_candidate",
              "direct_reply",
              "nested_reply"
            ],
            "title": "Relation Kind",
            "type": "string"
          },
          "relation_target_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Relation Target Post Id"
          },
          "reposts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts Count"
          },
          "tagged_users": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual source tags; null means unavailable.",
            "title": "Tagged Users"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "UTC ISO 8601 time; null means unavailable, never inferred epoch zero.",
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "views_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Views Count"
          }
        },
        "required": [
          "post_id",
          "url",
          "author",
          "timestamp",
          "text",
          "media",
          "geotag",
          "tagged_users",
          "mentions",
          "effective_query",
          "relation_kind",
          "relation_evidence",
          "relation_target_post_id",
          "in_reply_to_post_id",
          "conversation_id",
          "quoted_post_id",
          "is_reply",
          "is_quote"
        ],
        "title": "XQueryPost",
        "type": "object"
      },
      "XQuotesPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/XIncomingQuote"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "const": "rejected_rows",
              "type": "string"
            },
            "title": "Partial Reasons",
            "type": "array"
          },
          "quotes_complete": {
            "description": "Full incoming quote coverage is unknown, including when cached next_page is null.",
            "title": "Quotes Complete",
            "type": "null"
          },
          "requested_collection_size": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "target_post_id": {
            "title": "Target Post Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          },
          "upstream_continuation_available": {
            "const": false,
            "title": "Upstream Continuation Available",
            "type": "boolean"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "target_post_id",
          "requested_collection_size",
          "quotes_complete",
          "upstream_continuation_available",
          "partial_reasons"
        ],
        "title": "XQuotesPage",
        "type": "object"
      },
      "XQuotesRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 100,
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "post_id": {
            "pattern": "^[1-9][0-9]{0,24}$",
            "title": "Post Id",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "post_id"
        ],
        "title": "XQuotesRequest",
        "type": "object"
      },
      "XSpaceDiscoveryItem": {
        "additionalProperties": false,
        "properties": {
          "host_relationship": {
            "title": "Host Relationship",
            "type": "null"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "post_url": {
            "title": "Post Url",
            "type": "string"
          },
          "relation_evidence": {
            "const": "authored_post_space_link",
            "title": "Relation Evidence",
            "type": "string"
          },
          "shared_by": {
            "title": "Shared By",
            "type": "string"
          },
          "space_urls": {
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Space Urls",
            "type": "array"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timestamp"
          }
        },
        "required": [
          "post_id",
          "post_url",
          "timestamp",
          "text",
          "shared_by",
          "space_urls",
          "relation_evidence",
          "host_relationship"
        ],
        "title": "XSpaceDiscoveryItem",
        "type": "object"
      },
      "XSpaceDiscoveryPage": {
        "additionalProperties": false,
        "properties": {
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "discovery_scope": {
            "const": "authored_space_links",
            "title": "Discovery Scope",
            "type": "string"
          },
          "effective_query": {
            "title": "Effective Query",
            "type": "string"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/XSpaceDiscoveryItem"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "requested_collection_size": {
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Requested Collection Size",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "search_complete": {
            "title": "Search Complete",
            "type": "null"
          },
          "source_profile": {
            "title": "Source Profile",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "collection_complete",
          "partial_reasons",
          "source_profile",
          "requested_collection_size",
          "effective_query",
          "search_complete",
          "discovery_scope"
        ],
        "title": "XSpaceDiscoveryPage",
        "type": "object"
      },
      "XSpaceDiscoveryRequest": {
        "additionalProperties": false,
        "properties": {
          "collection_size": {
            "default": 20,
            "description": "Finite authored-post search window. limit only pages the saved collection.",
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Collection Size",
            "type": "integer"
          },
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "profile": {
            "maxLength": 512,
            "minLength": 1,
            "title": "Profile",
            "type": "string"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          }
        },
        "required": [
          "profile"
        ],
        "title": "XSpaceDiscoveryRequest",
        "type": "object"
      },
      "XSpaceParticipant": {
        "additionalProperties": false,
        "properties": {
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image Url"
          },
          "profile_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Id"
          },
          "profile_url": {
            "title": "Profile Url",
            "type": "string"
          },
          "username": {
            "title": "Username",
            "type": "string"
          }
        },
        "required": [
          "username",
          "profile_url",
          "profile_id",
          "display_name",
          "image_url"
        ],
        "title": "XSpaceParticipant",
        "type": "object"
      },
      "XSpaceRecording": {
        "additionalProperties": false,
        "properties": {
          "access_evidence": {
            "anyOf": [
              {
                "const": "playlist_and_audio_sample",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Access Evidence"
          },
          "audio_retained": {
            "const": false,
            "title": "Audio Retained",
            "type": "boolean"
          },
          "creator": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/XSpaceParticipant"
              },
              {
                "type": "null"
              }
            ]
          },
          "ended_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ended At"
          },
          "hosts": {
            "items": {
              "$ref": "#/components/schemas/XSpaceParticipant"
            },
            "maxItems": 100,
            "title": "Hosts",
            "type": "array"
          },
          "recording_status": {
            "enum": [
              "accessible",
              "expired",
              "inaccessible",
              "missing_reference",
              "unverified"
            ],
            "title": "Recording Status",
            "type": "string"
          },
          "recording_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recording Url"
          },
          "relation_evidence": {
            "const": "observed_space_id",
            "title": "Relation Evidence",
            "type": "string"
          },
          "replay_reported": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Replay Reported"
          },
          "space_id": {
            "title": "Space Id",
            "type": "string"
          },
          "space_url": {
            "title": "Space Url",
            "type": "string"
          },
          "speakers": {
            "items": {
              "$ref": "#/components/schemas/XSpaceParticipant"
            },
            "maxItems": 100,
            "title": "Speakers",
            "type": "array"
          },
          "started_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started At"
          },
          "state": {
            "enum": [
              "ended",
              "live",
              "scheduled",
              "unknown"
            ],
            "title": "State",
            "type": "string"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          }
        },
        "required": [
          "space_id",
          "space_url",
          "title",
          "state",
          "started_at",
          "ended_at",
          "creator",
          "hosts",
          "speakers",
          "replay_reported",
          "recording_url",
          "recording_status",
          "access_evidence",
          "audio_retained",
          "relation_evidence"
        ],
        "title": "XSpaceRecording",
        "type": "object"
      },
      "XSpaceRecordingPage": {
        "additionalProperties": false,
        "properties": {
          "audio_retained": {
            "const": false,
            "title": "Audio Retained",
            "type": "boolean"
          },
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/XSpaceRecording"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "space_id": {
            "title": "Space Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "collection_complete",
          "partial_reasons",
          "space_id",
          "audio_retained"
        ],
        "title": "XSpaceRecordingPage",
        "type": "object"
      },
      "XSpaceRecordingRequest": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "space_id": {
            "description": "One explicit public Space ID or canonical x.com/i/spaces URL.",
            "maxLength": 512,
            "minLength": 8,
            "title": "Space Id",
            "type": "string"
          }
        },
        "required": [
          "space_id"
        ],
        "title": "XSpaceRecordingRequest",
        "type": "object"
      },
      "XSpaceTranscript": {
        "additionalProperties": false,
        "properties": {
          "audio_retained": {
            "const": false,
            "title": "Audio Retained",
            "type": "boolean"
          },
          "duration_seconds": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Duration Seconds"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "method": {
            "anyOf": [
              {
                "const": "speech_to_text",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Method"
          },
          "prefix_limited": {
            "title": "Prefix Limited",
            "type": "boolean"
          },
          "relation_evidence": {
            "enum": [
              "source_url",
              "source_request"
            ],
            "title": "Relation Evidence",
            "type": "string"
          },
          "segments": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/XSpaceTranscriptSegment"
                },
                "maxItems": 2000,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Segments"
          },
          "space_id": {
            "title": "Space Id",
            "type": "string"
          },
          "space_url": {
            "title": "Space Url",
            "type": "string"
          },
          "text": {
            "anyOf": [
              {
                "maxLength": 200000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "transcribed_seconds": {
            "anyOf": [
              {
                "exclusiveMinimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Transcribed Seconds"
          },
          "transcript_complete": {
            "title": "Transcript Complete",
            "type": "null"
          },
          "transcript_status": {
            "enum": [
              "available",
              "unavailable",
              "missing_transcript"
            ],
            "title": "Transcript Status",
            "type": "string"
          }
        },
        "required": [
          "space_id",
          "space_url",
          "title",
          "transcript_status",
          "text",
          "language",
          "duration_seconds",
          "transcribed_seconds",
          "segments",
          "prefix_limited",
          "transcript_complete",
          "method",
          "audio_retained",
          "relation_evidence"
        ],
        "title": "XSpaceTranscript",
        "type": "object"
      },
      "XSpaceTranscriptPage": {
        "additionalProperties": false,
        "properties": {
          "audio_retained": {
            "const": false,
            "title": "Audio Retained",
            "type": "boolean"
          },
          "collected_count": {
            "maximum": 2000.0,
            "minimum": 0.0,
            "title": "Collected Count",
            "type": "integer"
          },
          "collection_complete": {
            "title": "Collection Complete",
            "type": "null"
          },
          "collection_limit": {
            "maximum": 2000.0,
            "minimum": 1.0,
            "title": "Collection Limit",
            "type": "integer"
          },
          "count": {
            "maximum": 50.0,
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "expires_at": {
            "description": "Unix seconds; the collection expires 24 hours after submission. Polling, replay and cached pages do not renew it.",
            "title": "Expires At",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/XSpaceTranscript"
            },
            "maxItems": 50,
            "title": "Items",
            "type": "array"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "next_page": {
            "anyOf": [
              {
                "maximum": 500.0,
                "minimum": 2.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Page"
          },
          "page": {
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "partial": {
            "description": "Collection-wide flag repeated on every cached page: missing candidate core fields, unresolved post targets, or image retention failures/limits can set it, even when absent from this page.",
            "title": "Partial",
            "type": "boolean"
          },
          "partial_reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Partial Reasons",
            "type": "array"
          },
          "requested_max_minutes": {
            "maximum": 30.0,
            "minimum": 1.0,
            "title": "Requested Max Minutes",
            "type": "integer"
          },
          "result_id": {
            "pattern": "^rresult_[a-f0-9]{32}$",
            "title": "Result Id",
            "type": "string"
          },
          "space_id": {
            "title": "Space Id",
            "type": "string"
          },
          "truncated": {
            "anyOf": [
              {
                "const": true,
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when collection omitted results; null means completeness is unknown.",
            "title": "Truncated"
          }
        },
        "required": [
          "items",
          "count",
          "result_id",
          "page",
          "limit",
          "next_page",
          "collected_count",
          "collection_limit",
          "expires_at",
          "truncated",
          "partial",
          "collection_complete",
          "partial_reasons",
          "space_id",
          "requested_max_minutes",
          "audio_retained"
        ],
        "title": "XSpaceTranscriptPage",
        "type": "object"
      },
      "XSpaceTranscriptRequest": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "max_minutes": {
            "default": 5,
            "description": "Finite prefix transcription bound; longer recordings are clipped. No full-recording guarantee.",
            "maximum": 30.0,
            "minimum": 1.0,
            "title": "Max Minutes",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "description": "One-based cached page. Initial collection requires page 1; later pages require result_id and cannot extend the collected window.",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Page",
            "type": "integer"
          },
          "result_id": {
            "anyOf": [
              {
                "pattern": "^rresult_[a-f0-9]{32}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Owner- and operation-bound immutable collection. Keep the same business request, ordered inputs and limit. Cached pages require no Idempotency-Key and launch no additional work.",
            "title": "Result Id"
          },
          "space_id": {
            "description": "One explicit public Space ID or canonical x.com/i/spaces URL.",
            "maxLength": 512,
            "minLength": 8,
            "title": "Space Id",
            "type": "string"
          }
        },
        "required": [
          "space_id"
        ],
        "title": "XSpaceTranscriptRequest",
        "type": "object"
      },
      "XSpaceTranscriptSegment": {
        "additionalProperties": false,
        "properties": {
          "end_seconds": {
            "exclusiveMinimum": 0.0,
            "title": "End Seconds",
            "type": "number"
          },
          "start_seconds": {
            "minimum": 0.0,
            "title": "Start Seconds",
            "type": "number"
          },
          "text": {
            "maxLength": 10000,
            "minLength": 1,
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "start_seconds",
          "end_seconds",
          "text"
        ],
        "title": "XSpaceTranscriptSegment",
        "type": "object"
      },
      "pilot__api__scrapers__PostContext": {
        "properties": {
          "author": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicAuthor"
              },
              {
                "type": "null"
              }
            ]
          },
          "post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Post Id"
          },
          "post_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Post Url"
          },
          "posted_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Posted At"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          }
        },
        "title": "PostContext",
        "type": "object"
      },
      "pilot__api__social_posts__PostContext": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/PostAuthor"
          },
          "comments_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comments Count"
          },
          "geotag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostGeotag"
              },
              {
                "type": "null"
              }
            ]
          },
          "kind": {
            "enum": [
              "repost",
              "quote"
            ],
            "title": "Kind",
            "type": "string"
          },
          "likes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Likes Count"
          },
          "media": {
            "items": {
              "$ref": "#/components/schemas/PostMedia"
            },
            "maxItems": 500,
            "title": "Media",
            "type": "array"
          },
          "media_complete": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "False when the provider reports media missing from this post; null when completeness cannot be established.",
            "title": "Media Complete"
          },
          "media_count_reported": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Media count reported by the source provider, when available.",
            "title": "Media Count Reported"
          },
          "mentions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Caption/text mentions, separate from actual tags.",
            "title": "Mentions"
          },
          "post_id": {
            "title": "Post Id",
            "type": "string"
          },
          "quotes_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quotes Count"
          },
          "reposts_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reposts Count"
          },
          "tagged_users": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PostAuthor"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual source tags; null means unavailable.",
            "title": "Tagged Users"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "UTC ISO 8601 time; null means unavailable, never inferred epoch zero.",
            "title": "Timestamp"
          },
          "url": {
            "title": "Url",
            "type": "string"
          },
          "views_count": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Views Count"
          }
        },
        "required": [
          "post_id",
          "url",
          "author",
          "timestamp",
          "text",
          "media",
          "geotag",
          "tagged_users",
          "mentions",
          "kind"
        ],
        "title": "PostContext",
        "type": "object"
      }
    },
    "securitySchemes": {
      "HiveKey": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Managed browsers, network access, resources, and research. Authenticate every request with your Hive API key.",
    "title": "Hive API",
    "version": "1.0.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/books/artifacts/{artifact_id}/content": {
      "get": {
        "operationId": "get_artifact_content_books_artifacts__artifact_id__content_get",
        "parameters": [
          {
            "in": "path",
            "name": "artifact_id",
            "required": true,
            "schema": {
              "title": "Artifact Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Range",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Range"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Artifact Content"
      }
    },
    "/books/downloads": {
      "post": {
        "operationId": "submit_download_books_downloads_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "title": "Body"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Submit Download"
      }
    },
    "/books/downloads/{download_id}": {
      "get": {
        "operationId": "get_download_books_downloads__download_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "download_id",
            "required": true,
            "schema": {
              "title": "Download Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Download"
      }
    },
    "/books/items/{book_id}": {
      "get": {
        "operationId": "get_item_books_items__book_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "book_id",
            "required": true,
            "schema": {
              "title": "Book Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Item"
      }
    },
    "/books/queries": {
      "post": {
        "operationId": "submit_query_books_queries_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "title": "Body"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Submit Query"
      }
    },
    "/books/queries/{query_id}": {
      "get": {
        "operationId": "get_query_books_queries__query_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "query_id",
            "required": true,
            "schema": {
              "title": "Query Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Query"
      }
    },
    "/browser/capture": {
      "post": {
        "description": "Create an isolated temporary browser, navigate once, return bounded current text and a full-page PNG, and close browser and egress ownership. Defaults to direct internet access through the public-only Relay guard; use_proxy=true opts into managed proxy access. Does not reuse profiles, log in, solve challenges, or guarantee access. navigation_status reports the target HTTP response, including denial. A full-page image exceeding 16 million pixels or 4 MiB fails; text_truncated reports text limits.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "asn": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Asn"
                  },
                  "browser": {
                    "default": "chrome",
                    "pattern": "^(chrome|firefox)$",
                    "title": "Browser",
                    "type": "string"
                  },
                  "country": {
                    "default": "US",
                    "pattern": "^[A-Za-z]{2}$",
                    "title": "Country",
                    "type": "string"
                  },
                  "identity_token": {
                    "anyOf": [
                      {
                        "maxLength": 128,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Identity Token"
                  },
                  "max_text_chars": {
                    "default": 20000,
                    "maximum": 100000,
                    "minimum": 1,
                    "title": "Max Text Chars",
                    "type": "integer"
                  },
                  "mobile": {
                    "default": true,
                    "title": "Mobile",
                    "type": "boolean"
                  },
                  "region": {
                    "anyOf": [
                      {
                        "maxLength": 100,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Region"
                  },
                  "timeout_s": {
                    "default": 30,
                    "maximum": 60,
                    "minimum": 5,
                    "title": "Timeout S",
                    "type": "integer"
                  },
                  "url": {
                    "maxLength": 4096,
                    "minLength": 1,
                    "title": "Url",
                    "type": "string"
                  },
                  "use_proxy": {
                    "default": false,
                    "title": "Use Proxy",
                    "type": "boolean"
                  },
                  "wait_ms": {
                    "default": 500,
                    "maximum": 5000,
                    "minimum": 0,
                    "title": "Wait Ms",
                    "type": "integer"
                  },
                  "window_size": {
                    "default": "1280x720",
                    "pattern": "^[1-9][0-9]{2,3}x[1-9][0-9]{2,3}$",
                    "title": "Window Size",
                    "type": "string"
                  }
                },
                "required": [
                  "url"
                ],
                "title": "CaptureRequest",
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "blocked_requests": {
                      "minimum": 0,
                      "title": "Blocked Requests",
                      "type": "integer"
                    },
                    "navigation_status": {
                      "anyOf": [
                        {
                          "maximum": 599,
                          "minimum": 100,
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Navigation Status"
                    },
                    "screenshot": {
                      "$ref": "#/components/schemas/Screenshot"
                    },
                    "text": {
                      "maxLength": 100000,
                      "title": "Text",
                      "type": "string"
                    },
                    "text_truncated": {
                      "title": "Text Truncated",
                      "type": "boolean"
                    },
                    "title": {
                      "maxLength": 512,
                      "title": "Title",
                      "type": "string"
                    }
                  },
                  "required": [
                    "title",
                    "text",
                    "text_truncated",
                    "navigation_status",
                    "blocked_requests",
                    "screenshot"
                  ],
                  "title": "CaptureResponse",
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Capture capacity unavailable"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Capture deadline exceeded"
          }
        },
        "summary": "Capture public URL text and a full-page PNG"
      }
    },
    "/browser/profiles": {
      "get": {
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "properties": {
                      "browser": {
                        "enum": [
                          "chrome",
                          "firefox"
                        ],
                        "title": "Browser",
                        "type": "string"
                      },
                      "created_at": {
                        "title": "Created At",
                        "type": "string"
                      },
                      "engine": {
                        "enum": [
                          "donut",
                          "camoufox"
                        ],
                        "title": "Engine",
                        "type": "string"
                      },
                      "id": {
                        "title": "Id",
                        "type": "string"
                      },
                      "network": {
                        "anyOf": [
                          {
                            "$ref": "#/components/schemas/NetworkResponse"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null
                      },
                      "runtime_version": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "title": "Runtime Version"
                      },
                      "schema_version": {
                        "title": "Schema Version",
                        "type": "integer"
                      },
                      "status": {
                        "title": "Status",
                        "type": "string"
                      },
                      "updated_at": {
                        "title": "Updated At",
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "browser",
                      "engine",
                      "schema_version",
                      "runtime_version",
                      "status",
                      "created_at",
                      "updated_at"
                    ],
                    "title": "ProfileResponse",
                    "type": "object"
                  },
                  "type": "array"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "List your browser profiles"
      },
      "post": {
        "parameters": [
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "browser": {
                    "anyOf": [
                      {
                        "enum": [
                          "chrome",
                          "firefox"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Browser"
                  },
                  "network": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/NetworkPolicy"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null
                  }
                },
                "title": "ProfileCreate",
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "browser": {
                      "enum": [
                        "chrome",
                        "firefox"
                      ],
                      "title": "Browser",
                      "type": "string"
                    },
                    "created_at": {
                      "title": "Created At",
                      "type": "string"
                    },
                    "engine": {
                      "enum": [
                        "donut",
                        "camoufox"
                      ],
                      "title": "Engine",
                      "type": "string"
                    },
                    "id": {
                      "title": "Id",
                      "type": "string"
                    },
                    "network": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/NetworkResponse"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "default": null
                    },
                    "runtime_version": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Runtime Version"
                    },
                    "schema_version": {
                      "title": "Schema Version",
                      "type": "integer"
                    },
                    "status": {
                      "title": "Status",
                      "type": "string"
                    },
                    "updated_at": {
                      "title": "Updated At",
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "browser",
                    "engine",
                    "schema_version",
                    "runtime_version",
                    "status",
                    "created_at",
                    "updated_at"
                  ],
                  "title": "ProfileResponse",
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Generate a persistent browser identity"
      }
    },
    "/browser/profiles/{profile_id}": {
      "delete": {
        "parameters": [
          {
            "in": "path",
            "name": "profile_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Delete an idle browser profile"
      },
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "profile_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "browser": {
                      "enum": [
                        "chrome",
                        "firefox"
                      ],
                      "title": "Browser",
                      "type": "string"
                    },
                    "created_at": {
                      "title": "Created At",
                      "type": "string"
                    },
                    "engine": {
                      "enum": [
                        "donut",
                        "camoufox"
                      ],
                      "title": "Engine",
                      "type": "string"
                    },
                    "id": {
                      "title": "Id",
                      "type": "string"
                    },
                    "network": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/NetworkResponse"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "default": null
                    },
                    "runtime_version": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Runtime Version"
                    },
                    "schema_version": {
                      "title": "Schema Version",
                      "type": "integer"
                    },
                    "status": {
                      "title": "Status",
                      "type": "string"
                    },
                    "updated_at": {
                      "title": "Updated At",
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "browser",
                    "engine",
                    "schema_version",
                    "runtime_version",
                    "status",
                    "created_at",
                    "updated_at"
                  ],
                  "title": "ProfileResponse",
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Inspect your browser profile"
      }
    },
    "/browser/session": {
      "delete": {
        "parameters": [
          {
            "in": "query",
            "name": "session_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Close a browser session"
      },
      "get": {
        "parameters": [
          {
            "in": "query",
            "name": "session_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "automation_protocol": {
                      "enum": [
                        "cdp",
                        "playwright"
                      ],
                      "type": "string"
                    },
                    "browser": {
                      "enum": [
                        "chrome",
                        "firefox"
                      ],
                      "type": "string"
                    },
                    "cdp_url": {
                      "type": "string"
                    },
                    "engine": {
                      "enum": [
                        "donut",
                        "camoufox"
                      ],
                      "type": "string"
                    },
                    "lease_expires_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "max_expires_at": {
                      "description": "Fixed one-hour session deadline. Renewal cannot extend it.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "profile": {
                      "properties": {
                        "browser": {
                          "enum": [
                            "chrome",
                            "firefox"
                          ],
                          "title": "Browser",
                          "type": "string"
                        },
                        "created_at": {
                          "title": "Created At",
                          "type": "string"
                        },
                        "engine": {
                          "enum": [
                            "donut",
                            "camoufox"
                          ],
                          "title": "Engine",
                          "type": "string"
                        },
                        "id": {
                          "title": "Id",
                          "type": "string"
                        },
                        "network": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/NetworkResponse"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "default": null
                        },
                        "runtime_version": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Runtime Version"
                        },
                        "schema_version": {
                          "title": "Schema Version",
                          "type": "integer"
                        },
                        "status": {
                          "title": "Status",
                          "type": "string"
                        },
                        "updated_at": {
                          "title": "Updated At",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "browser",
                        "engine",
                        "schema_version",
                        "runtime_version",
                        "status",
                        "created_at",
                        "updated_at"
                      ],
                      "title": "ProfileResponse",
                      "type": "object"
                    },
                    "profile_id": {
                      "pattern": "^[0-9a-f]{32}$",
                      "type": "string"
                    },
                    "session_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "viewer_url": {
                      "type": "string"
                    },
                    "ws_endpoint": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "session_id",
                    "automation_protocol"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Inspect a browser session"
      },
      "post": {
        "parameters": [
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "asn": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Asn"
                  },
                  "browser": {
                    "anyOf": [
                      {
                        "enum": [
                          "chrome",
                          "firefox"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Browser"
                  },
                  "country": {
                    "default": "US",
                    "description": "Proxy exit country when use_proxy is true. Does not change the exit IP of a direct session.",
                    "pattern": "^[A-Za-z]{2}$",
                    "title": "Country",
                    "type": "string"
                  },
                  "identity_token": {
                    "anyOf": [
                      {
                        "maxLength": 128,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Identity Token"
                  },
                  "mobile": {
                    "default": true,
                    "title": "Mobile",
                    "type": "boolean"
                  },
                  "profile_id": {
                    "anyOf": [
                      {
                        "pattern": "^[0-9a-f]{32}$",
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Profile Id"
                  },
                  "region": {
                    "anyOf": [
                      {
                        "maxLength": 100,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Region"
                  },
                  "use_proxy": {
                    "default": false,
                    "description": "Opt into managed proxy access. Omit to inherit a profile's saved network; otherwise access is direct. False conflicts with a network-bound profile.",
                    "title": "Use Proxy",
                    "type": "boolean"
                  },
                  "window_size": {
                    "default": "1280x720",
                    "pattern": "^[1-9][0-9]{2,3}x[1-9][0-9]{2,3}$",
                    "title": "Window Size",
                    "type": "string"
                  }
                },
                "title": "BrowserRequest",
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "automation_protocol": {
                      "enum": [
                        "cdp",
                        "playwright"
                      ],
                      "type": "string"
                    },
                    "browser": {
                      "enum": [
                        "chrome",
                        "firefox"
                      ],
                      "type": "string"
                    },
                    "cdp_url": {
                      "type": "string"
                    },
                    "engine": {
                      "enum": [
                        "donut",
                        "camoufox"
                      ],
                      "type": "string"
                    },
                    "lease_expires_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "max_expires_at": {
                      "description": "Fixed one-hour session deadline. Renewal cannot extend it.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "profile": {
                      "properties": {
                        "browser": {
                          "enum": [
                            "chrome",
                            "firefox"
                          ],
                          "title": "Browser",
                          "type": "string"
                        },
                        "created_at": {
                          "title": "Created At",
                          "type": "string"
                        },
                        "engine": {
                          "enum": [
                            "donut",
                            "camoufox"
                          ],
                          "title": "Engine",
                          "type": "string"
                        },
                        "id": {
                          "title": "Id",
                          "type": "string"
                        },
                        "network": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/NetworkResponse"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "default": null
                        },
                        "runtime_version": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Runtime Version"
                        },
                        "schema_version": {
                          "title": "Schema Version",
                          "type": "integer"
                        },
                        "status": {
                          "title": "Status",
                          "type": "string"
                        },
                        "updated_at": {
                          "title": "Updated At",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "browser",
                        "engine",
                        "schema_version",
                        "runtime_version",
                        "status",
                        "created_at",
                        "updated_at"
                      ],
                      "title": "ProfileResponse",
                      "type": "object"
                    },
                    "profile_id": {
                      "pattern": "^[0-9a-f]{32}$",
                      "type": "string"
                    },
                    "session_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "viewer_url": {
                      "type": "string"
                    },
                    "ws_endpoint": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "session_id",
                    "automation_protocol"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Create a persistent browser session"
      }
    },
    "/browser/session/renew": {
      "post": {
        "parameters": [
          {
            "in": "query",
            "name": "session_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "automation_protocol": {
                      "enum": [
                        "cdp",
                        "playwright"
                      ],
                      "type": "string"
                    },
                    "browser": {
                      "enum": [
                        "chrome",
                        "firefox"
                      ],
                      "type": "string"
                    },
                    "cdp_url": {
                      "type": "string"
                    },
                    "engine": {
                      "enum": [
                        "donut",
                        "camoufox"
                      ],
                      "type": "string"
                    },
                    "lease_expires_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "max_expires_at": {
                      "description": "Fixed one-hour session deadline. Renewal cannot extend it.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "profile": {
                      "properties": {
                        "browser": {
                          "enum": [
                            "chrome",
                            "firefox"
                          ],
                          "title": "Browser",
                          "type": "string"
                        },
                        "created_at": {
                          "title": "Created At",
                          "type": "string"
                        },
                        "engine": {
                          "enum": [
                            "donut",
                            "camoufox"
                          ],
                          "title": "Engine",
                          "type": "string"
                        },
                        "id": {
                          "title": "Id",
                          "type": "string"
                        },
                        "network": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/NetworkResponse"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "default": null
                        },
                        "runtime_version": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Runtime Version"
                        },
                        "schema_version": {
                          "title": "Schema Version",
                          "type": "integer"
                        },
                        "status": {
                          "title": "Status",
                          "type": "string"
                        },
                        "updated_at": {
                          "title": "Updated At",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "browser",
                        "engine",
                        "schema_version",
                        "runtime_version",
                        "status",
                        "created_at",
                        "updated_at"
                      ],
                      "title": "ProfileResponse",
                      "type": "object"
                    },
                    "profile_id": {
                      "pattern": "^[0-9a-f]{32}$",
                      "type": "string"
                    },
                    "session_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "viewer_url": {
                      "type": "string"
                    },
                    "ws_endpoint": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "session_id",
                    "automation_protocol"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Extend the existing browser lease"
      }
    },
    "/capabilities": {
      "get": {
        "description": "Inspect each scraper's operation_status and operation_health. Each health entry has reason (null, rate_limited, timeout, invalid_response, capacity_limited, service_unavailable, not_found, or invalid_request), observed_at (Unix seconds or null), and retry_after_s (remaining minimum recheck delay or null when unknown). Capacity is shared across operations on this deployment. GET /scrapers/capacity reports availability and retry guidance. Hive manages service recovery; clients do not manage its upstream accounts. Google Lens private image jobs require scrapers.google_lens.private_image_ready=true. Discovery never starts research. An elapsed delay does not prove recovery; recover existing jobs with the original idempotency key.",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Discover services and supported constraints"
      }
    },
    "/exchange/image": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "count": {
                    "maximum": 4,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "prompt": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  }
                },
                "required": [
                  "prompt"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Generate image artifacts"
      }
    },
    "/exchange/llm": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "max_tokens": {
                    "maximum": 16384,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "messages": {
                    "items": {
                      "properties": {
                        "content": {
                          "type": "string"
                        },
                        "role": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "role",
                        "content"
                      ],
                      "type": "object"
                    },
                    "minItems": 1,
                    "type": "array"
                  },
                  "response_format": {
                    "type": "object"
                  }
                },
                "required": [
                  "messages"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Generate a completion"
      }
    },
    "/healthz": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Read service availability"
      }
    },
    "/network/pin": {
      "get": {
        "parameters": [
          {
            "in": "query",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "region",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "asn",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "mobile",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Discover an available geographic and ASN pin"
      }
    },
    "/network/tunnels": {
      "delete": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "description": "Revocation outcome, including revoked count for bulk deletion.",
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Revoke all tunnels owned by this API key"
      },
      "post": {
        "parameters": [
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "asn": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Asn"
                  },
                  "country": {
                    "pattern": "^[A-Za-z]{2}$",
                    "title": "Country",
                    "type": "string"
                  },
                  "identity_token": {
                    "anyOf": [
                      {
                        "maxLength": 128,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Identity Token"
                  },
                  "idle_timeout_s": {
                    "anyOf": [
                      {
                        "minimum": 1,
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Idle Timeout S"
                  },
                  "max_bytes": {
                    "anyOf": [
                      {
                        "minimum": 1,
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Max Bytes"
                  },
                  "max_connections": {
                    "anyOf": [
                      {
                        "minimum": 1,
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Max Connections"
                  },
                  "mobile": {
                    "default": true,
                    "title": "Mobile",
                    "type": "boolean"
                  },
                  "region": {
                    "anyOf": [
                      {
                        "maxLength": 100,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Region"
                  },
                  "source_ip": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Source Ip"
                  },
                  "ttl_s": {
                    "anyOf": [
                      {
                        "minimum": 1,
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Ttl S"
                  }
                },
                "required": [
                  "country"
                ],
                "title": "TunnelRequest",
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "created_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "credentials": {
                      "additionalProperties": false,
                      "properties": {
                        "password": {
                          "type": "string"
                        },
                        "username": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "username",
                        "password"
                      ],
                      "type": "object"
                    },
                    "endpoints": {
                      "additionalProperties": false,
                      "properties": {
                        "http": {
                          "additionalProperties": false,
                          "properties": {
                            "host": {
                              "type": "string"
                            },
                            "port": {
                              "type": "integer"
                            },
                            "scheme": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "scheme",
                            "host",
                            "port"
                          ],
                          "type": "object"
                        },
                        "socks5": {
                          "additionalProperties": false,
                          "properties": {
                            "host": {
                              "type": "string"
                            },
                            "port": {
                              "type": "integer"
                            },
                            "scheme": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "scheme",
                            "host",
                            "port"
                          ],
                          "type": "object"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "id": {
                      "type": "string"
                    },
                    "lease_expires_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "limits": {
                      "additionalProperties": false,
                      "properties": {
                        "idle_timeout_s": {
                          "type": "integer"
                        },
                        "max_bytes": {
                          "type": "integer"
                        },
                        "max_connections": {
                          "type": "integer"
                        },
                        "max_ttl_s": {
                          "type": "integer"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "network": {
                      "additionalProperties": false,
                      "properties": {
                        "connection_type": {
                          "type": "string"
                        },
                        "exit": {
                          "additionalProperties": false,
                          "properties": {
                            "asn": {
                              "type": "string"
                            },
                            "country": {
                              "type": "string"
                            },
                            "hosting": {
                              "type": "boolean"
                            },
                            "ip": {
                              "type": "string"
                            },
                            "isp": {
                              "type": "string"
                            },
                            "mobile": {
                              "type": "boolean"
                            },
                            "region": {
                              "type": "string"
                            },
                            "verified_at": {
                              "format": "date-time",
                              "type": "string"
                            }
                          },
                          "required": [],
                          "type": "object"
                        },
                        "quality": {
                          "additionalProperties": false,
                          "properties": {
                            "verified": {
                              "type": "boolean"
                            }
                          },
                          "required": [],
                          "type": "object"
                        },
                        "rotatable": {
                          "type": "boolean"
                        },
                        "rotation": {
                          "additionalProperties": false,
                          "properties": {
                            "rotated": {
                              "type": "boolean"
                            }
                          },
                          "required": [],
                          "type": "object"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "source_bound": {
                      "type": "boolean"
                    },
                    "status": {
                      "type": "string"
                    },
                    "terminal_reason": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "updated_at": {
                      "format": "date-time",
                      "type": "string"
                    }
                  },
                  "required": [],
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Create a verified network tunnel"
      }
    },
    "/network/tunnels/{tunnel_id}": {
      "delete": {
        "parameters": [
          {
            "in": "path",
            "name": "tunnel_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "description": "Revocation outcome, including revoked count for bulk deletion.",
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Revoke a tunnel"
      },
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "tunnel_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "created_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "endpoints": {
                      "additionalProperties": false,
                      "properties": {
                        "http": {
                          "additionalProperties": false,
                          "properties": {
                            "host": {
                              "type": "string"
                            },
                            "port": {
                              "type": "integer"
                            },
                            "scheme": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "scheme",
                            "host",
                            "port"
                          ],
                          "type": "object"
                        },
                        "socks5": {
                          "additionalProperties": false,
                          "properties": {
                            "host": {
                              "type": "string"
                            },
                            "port": {
                              "type": "integer"
                            },
                            "scheme": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "scheme",
                            "host",
                            "port"
                          ],
                          "type": "object"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "id": {
                      "type": "string"
                    },
                    "lease_expires_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "limits": {
                      "additionalProperties": false,
                      "properties": {
                        "idle_timeout_s": {
                          "type": "integer"
                        },
                        "max_bytes": {
                          "type": "integer"
                        },
                        "max_connections": {
                          "type": "integer"
                        },
                        "max_ttl_s": {
                          "type": "integer"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "network": {
                      "additionalProperties": false,
                      "properties": {
                        "connection_type": {
                          "type": "string"
                        },
                        "exit": {
                          "additionalProperties": false,
                          "properties": {
                            "asn": {
                              "type": "string"
                            },
                            "country": {
                              "type": "string"
                            },
                            "hosting": {
                              "type": "boolean"
                            },
                            "ip": {
                              "type": "string"
                            },
                            "isp": {
                              "type": "string"
                            },
                            "mobile": {
                              "type": "boolean"
                            },
                            "region": {
                              "type": "string"
                            },
                            "verified_at": {
                              "format": "date-time",
                              "type": "string"
                            }
                          },
                          "required": [],
                          "type": "object"
                        },
                        "quality": {
                          "additionalProperties": false,
                          "properties": {
                            "verified": {
                              "type": "boolean"
                            }
                          },
                          "required": [],
                          "type": "object"
                        },
                        "rotatable": {
                          "type": "boolean"
                        },
                        "rotation": {
                          "additionalProperties": false,
                          "properties": {
                            "rotated": {
                              "type": "boolean"
                            }
                          },
                          "required": [],
                          "type": "object"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "source_bound": {
                      "type": "boolean"
                    },
                    "status": {
                      "type": "string"
                    },
                    "terminal_reason": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "updated_at": {
                      "format": "date-time",
                      "type": "string"
                    }
                  },
                  "required": [],
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Inspect a tunnel"
      }
    },
    "/network/tunnels/{tunnel_id}/credentials": {
      "post": {
        "parameters": [
          {
            "in": "path",
            "name": "tunnel_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "credentials": {
                      "additionalProperties": false,
                      "properties": {
                        "password": {
                          "type": "string"
                        },
                        "username": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "username",
                        "password"
                      ],
                      "type": "object"
                    },
                    "id": {
                      "type": "string"
                    }
                  },
                  "required": [],
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Replace tunnel credentials"
      }
    },
    "/network/tunnels/{tunnel_id}/renew": {
      "post": {
        "parameters": [
          {
            "in": "path",
            "name": "tunnel_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "ttl_s": {
                    "minimum": 1,
                    "type": "integer"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "created_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "endpoints": {
                      "additionalProperties": false,
                      "properties": {
                        "http": {
                          "additionalProperties": false,
                          "properties": {
                            "host": {
                              "type": "string"
                            },
                            "port": {
                              "type": "integer"
                            },
                            "scheme": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "scheme",
                            "host",
                            "port"
                          ],
                          "type": "object"
                        },
                        "socks5": {
                          "additionalProperties": false,
                          "properties": {
                            "host": {
                              "type": "string"
                            },
                            "port": {
                              "type": "integer"
                            },
                            "scheme": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "scheme",
                            "host",
                            "port"
                          ],
                          "type": "object"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "id": {
                      "type": "string"
                    },
                    "lease_expires_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "limits": {
                      "additionalProperties": false,
                      "properties": {
                        "idle_timeout_s": {
                          "type": "integer"
                        },
                        "max_bytes": {
                          "type": "integer"
                        },
                        "max_connections": {
                          "type": "integer"
                        },
                        "max_ttl_s": {
                          "type": "integer"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "network": {
                      "additionalProperties": false,
                      "properties": {
                        "connection_type": {
                          "type": "string"
                        },
                        "exit": {
                          "additionalProperties": false,
                          "properties": {
                            "asn": {
                              "type": "string"
                            },
                            "country": {
                              "type": "string"
                            },
                            "hosting": {
                              "type": "boolean"
                            },
                            "ip": {
                              "type": "string"
                            },
                            "isp": {
                              "type": "string"
                            },
                            "mobile": {
                              "type": "boolean"
                            },
                            "region": {
                              "type": "string"
                            },
                            "verified_at": {
                              "format": "date-time",
                              "type": "string"
                            }
                          },
                          "required": [],
                          "type": "object"
                        },
                        "quality": {
                          "additionalProperties": false,
                          "properties": {
                            "verified": {
                              "type": "boolean"
                            }
                          },
                          "required": [],
                          "type": "object"
                        },
                        "rotatable": {
                          "type": "boolean"
                        },
                        "rotation": {
                          "additionalProperties": false,
                          "properties": {
                            "rotated": {
                              "type": "boolean"
                            }
                          },
                          "required": [],
                          "type": "object"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "source_bound": {
                      "type": "boolean"
                    },
                    "status": {
                      "type": "string"
                    },
                    "terminal_reason": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "updated_at": {
                      "format": "date-time",
                      "type": "string"
                    }
                  },
                  "required": [],
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Extend the lease without changing the exit"
      }
    },
    "/network/tunnels/{tunnel_id}/rotate": {
      "post": {
        "parameters": [
          {
            "in": "path",
            "name": "tunnel_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "created_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "endpoints": {
                      "additionalProperties": false,
                      "properties": {
                        "http": {
                          "additionalProperties": false,
                          "properties": {
                            "host": {
                              "type": "string"
                            },
                            "port": {
                              "type": "integer"
                            },
                            "scheme": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "scheme",
                            "host",
                            "port"
                          ],
                          "type": "object"
                        },
                        "socks5": {
                          "additionalProperties": false,
                          "properties": {
                            "host": {
                              "type": "string"
                            },
                            "port": {
                              "type": "integer"
                            },
                            "scheme": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "scheme",
                            "host",
                            "port"
                          ],
                          "type": "object"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "id": {
                      "type": "string"
                    },
                    "lease_expires_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "limits": {
                      "additionalProperties": false,
                      "properties": {
                        "idle_timeout_s": {
                          "type": "integer"
                        },
                        "max_bytes": {
                          "type": "integer"
                        },
                        "max_connections": {
                          "type": "integer"
                        },
                        "max_ttl_s": {
                          "type": "integer"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "network": {
                      "additionalProperties": false,
                      "properties": {
                        "connection_type": {
                          "type": "string"
                        },
                        "exit": {
                          "additionalProperties": false,
                          "properties": {
                            "asn": {
                              "type": "string"
                            },
                            "country": {
                              "type": "string"
                            },
                            "hosting": {
                              "type": "boolean"
                            },
                            "ip": {
                              "type": "string"
                            },
                            "isp": {
                              "type": "string"
                            },
                            "mobile": {
                              "type": "boolean"
                            },
                            "region": {
                              "type": "string"
                            },
                            "verified_at": {
                              "format": "date-time",
                              "type": "string"
                            }
                          },
                          "required": [],
                          "type": "object"
                        },
                        "quality": {
                          "additionalProperties": false,
                          "properties": {
                            "verified": {
                              "type": "boolean"
                            }
                          },
                          "required": [],
                          "type": "object"
                        },
                        "rotatable": {
                          "type": "boolean"
                        },
                        "rotation": {
                          "additionalProperties": false,
                          "properties": {
                            "rotated": {
                              "type": "boolean"
                            }
                          },
                          "required": [],
                          "type": "object"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "source_bound": {
                      "type": "boolean"
                    },
                    "status": {
                      "type": "string"
                    },
                    "terminal_reason": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "updated_at": {
                      "format": "date-time",
                      "type": "string"
                    }
                  },
                  "required": [],
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Select a verified different exit with the same constraints"
      }
    },
    "/readyz": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Read service availability"
      }
    },
    "/resources/captcha": {
      "post": {
        "parameters": [
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "description": "Provide captcha_type and the matching site_key/page_url or image_b64, or the equivalent descriptor.",
                "properties": {
                  "action": {
                    "type": "string"
                  },
                  "browser_context": {
                    "additionalProperties": false,
                    "description": "Optional context from the browser submitting the token. Cookie values are transient and are not stored in Hive resource records. Only include cookies needed for this CAPTCHA. Context support depends on solver availability; unsupported combinations fail explicitly.",
                    "properties": {
                      "cookies": {
                        "items": {
                          "additionalProperties": false,
                          "properties": {
                            "domain": {
                              "type": "string"
                            },
                            "expires": {
                              "description": "Unix timestamp; omit or use -1 for session cookies.",
                              "type": "number"
                            },
                            "http_only": {
                              "default": false,
                              "type": "boolean"
                            },
                            "name": {
                              "type": "string"
                            },
                            "path": {
                              "type": "string"
                            },
                            "secure": {
                              "default": false,
                              "type": "boolean"
                            },
                            "value": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "name",
                            "value",
                            "domain",
                            "path"
                          ],
                          "type": "object"
                        },
                        "maxItems": 100,
                        "type": "array"
                      },
                      "user_agent": {
                        "maxLength": 1024,
                        "minLength": 1,
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "captcha_type": {
                    "enum": [
                      "recaptcha_v2",
                      "recaptcha_v2_enterprise",
                      "recaptcha_v3",
                      "hcaptcha",
                      "turnstile",
                      "image"
                    ],
                    "type": "string"
                  },
                  "descriptor": {
                    "additionalProperties": false,
                    "properties": {
                      "action": {
                        "type": "string"
                      },
                      "browser_context": {
                        "additionalProperties": false,
                        "description": "Optional context from the browser submitting the token. Cookie values are transient and are not stored in Hive resource records. Only include cookies needed for this CAPTCHA. Context support depends on solver availability; unsupported combinations fail explicitly.",
                        "properties": {
                          "cookies": {
                            "items": {
                              "additionalProperties": false,
                              "properties": {
                                "domain": {
                                  "type": "string"
                                },
                                "expires": {
                                  "description": "Unix timestamp; omit or use -1 for session cookies.",
                                  "type": "number"
                                },
                                "http_only": {
                                  "default": false,
                                  "type": "boolean"
                                },
                                "name": {
                                  "type": "string"
                                },
                                "path": {
                                  "type": "string"
                                },
                                "secure": {
                                  "default": false,
                                  "type": "boolean"
                                },
                                "value": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "name",
                                "value",
                                "domain",
                                "path"
                              ],
                              "type": "object"
                            },
                            "maxItems": 100,
                            "type": "array"
                          },
                          "user_agent": {
                            "maxLength": 1024,
                            "minLength": 1,
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "enterprise": {
                        "type": "boolean"
                      },
                      "image_b64": {
                        "type": "string"
                      },
                      "min_score": {
                        "maximum": 1,
                        "minimum": 0,
                        "type": "number"
                      },
                      "page_url": {
                        "format": "uri",
                        "type": "string"
                      },
                      "site_key": {
                        "type": "string"
                      },
                      "type": {
                        "enum": [
                          "recaptcha_v2",
                          "recaptcha_v2_enterprise",
                          "recaptcha_v3",
                          "hcaptcha",
                          "turnstile",
                          "image"
                        ],
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "enterprise": {
                    "type": "boolean"
                  },
                  "image_b64": {
                    "type": "string"
                  },
                  "min_score": {
                    "maximum": 1,
                    "minimum": 0,
                    "type": "number"
                  },
                  "page_url": {
                    "format": "uri",
                    "type": "string"
                  },
                  "site_key": {
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Create a captcha resource"
      }
    },
    "/resources/mail": {
      "post": {
        "parameters": [
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "pattern": "^[A-Za-z]{2}$",
                    "type": "string"
                  },
                  "domain": {
                    "type": "string"
                  },
                  "service": {
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Create a mail resource"
      }
    },
    "/resources/network": {
      "post": {
        "parameters": [
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "asn": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Asn"
                  },
                  "country": {
                    "pattern": "^[A-Za-z]{2}$",
                    "title": "Country",
                    "type": "string"
                  },
                  "identity_token": {
                    "anyOf": [
                      {
                        "maxLength": 128,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Identity Token"
                  },
                  "mobile": {
                    "default": true,
                    "title": "Mobile",
                    "type": "boolean"
                  },
                  "region": {
                    "anyOf": [
                      {
                        "maxLength": 100,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Region"
                  }
                },
                "required": [
                  "country"
                ],
                "title": "NetworkConstraints",
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Create a network resource"
      }
    },
    "/resources/phone": {
      "post": {
        "parameters": [
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "pattern": "^[A-Za-z]{2}$",
                    "type": "string"
                  },
                  "service": {
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Create a phone resource"
      }
    },
    "/resources/{resource_id}": {
      "delete": {
        "parameters": [
          {
            "in": "path",
            "name": "resource_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Release a resource"
      },
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "resource_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Read a resource"
      }
    },
    "/resources/{resource_id}/poll": {
      "post": {
        "parameters": [
          {
            "in": "path",
            "name": "resource_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Poll resource progress"
      }
    },
    "/resources/{resource_id}/renew": {
      "post": {
        "parameters": [
          {
            "in": "path",
            "name": "resource_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Reuse the same key and request to replay a successful allocation.",
            "in": "header",
            "name": "Idempotency-Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Extend the resource lease"
      }
    },
    "/scrapers/assets": {
      "post": {
        "description": "Upload private image bytes (10 MiB maximum); retained encrypted for 24 hours.",
        "operationId": "upload_research_image_scrapers_assets_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "image/jpeg": {
              "schema": {
                "format": "binary",
                "type": "string"
              }
            },
            "image/png": {
              "schema": {
                "format": "binary",
                "type": "string"
              }
            },
            "image/webp": {
              "schema": {
                "format": "binary",
                "type": "string"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResearchAsset"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Upload Research Image"
      }
    },
    "/scrapers/assets/{asset_id}": {
      "delete": {
        "description": "Delete an image. Already-submitted jobs retain their private input copy until completion.",
        "operationId": "delete_research_image_scrapers_assets__asset_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "asset_id",
            "required": true,
            "schema": {
              "title": "Asset Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Delete Research Image"
      },
      "get": {
        "description": "Download this bearer's uploaded image, Lens thumbnail or retained post image before its expiry.",
        "operationId": "download_research_image_scrapers_assets__asset_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "asset_id",
            "required": true,
            "schema": {
              "title": "Asset Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "image/jpeg": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "image/png": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "image/webp": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Download Research Image"
      }
    },
    "/scrapers/capacity": {
      "get": {
        "description": "Read service availability and retry guidance without starting work.",
        "operationId": "research_capacity_scrapers_capacity_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResearchCapacity"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Research Capacity"
      }
    },
    "/scrapers/facebook/group/posts": {
      "post": {
        "description": "One chronological collection from an explicit public group URL; observed group permalinks establish membership.",
        "operationId": "group_posts_scrapers_facebook_group_posts_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacebookGroupPostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookGroupPostsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_FacebookGroupPostsPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Group Posts"
      }
    },
    "/scrapers/facebook/groups/search": {
      "post": {
        "description": "Search group names and public profiles; private group content is never retrieved.",
        "operationId": "group_search_scrapers_facebook_groups_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay and cached pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay and cached pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacebookGroupSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookGroupSearchPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_FacebookGroupSearchPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Group Search"
      }
    },
    "/scrapers/facebook/pages/search": {
      "post": {
        "description": "One finite public page search. Page candidates are not groups or verified identities.",
        "operationId": "page_search_scrapers_facebook_pages_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacebookPageSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookPageSearchPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_FacebookPageSearchPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Page Search"
      }
    },
    "/scrapers/facebook/people/search": {
      "post": {
        "description": "Collect at most 50 native people candidates, including numeric profiles without usernames. Opaque people links retain their returned URL without an inferred numeric ID or username; details/posts still require supported handle or numeric targets. Location texts are appended in caller order as query hints, never enforced city filters. Prefer: respond-async returns promptly; default wait is at most 20 seconds. Cached pages/replays launch no new work.",
        "operationId": "facebook_people_search_scrapers_facebook_people_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages need no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages need no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacebookPeopleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PeopleSearchPage_FacebookCandidate_"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_PeopleSearchPage_FacebookCandidate__"
                }
              }
            },
            "description": "Durable native people search; poll the owner-scoped URL."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Facebook People Search"
      }
    },
    "/scrapers/facebook/post/comments": {
      "post": {
        "description": "One top-level public-comment collection. Nested replies and full thread completeness are unavailable.",
        "operationId": "comments_scrapers_facebook_post_comments_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacebookCommentsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookCommentsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_FacebookCommentsPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Comments"
      }
    },
    "/scrapers/facebook/posts/search": {
      "post": {
        "description": "One public post query; requested literal keyword/date filters are checked locally on returned fields.",
        "operationId": "post_search_scrapers_facebook_posts_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacebookPostSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookPostSearchPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_FacebookPostSearchPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Post Search"
      }
    },
    "/scrapers/facebook/profile/details": {
      "post": {
        "description": "Retrieve public Facebook profile or page details for up to ten targets.",
        "operationId": "facebook_profile_details_scrapers_facebook_profile_details_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacebookProfileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookProfilePage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Facebook Profile Details"
      }
    },
    "/scrapers/facebook/profile/posts": {
      "post": {
        "description": "Return recent public person/page posts, including numeric profiles. At most 40 posts per target; pages cannot recover older history. Prefer: respond-async submits promptly.",
        "operationId": "facebook_profile_posts_scrapers_facebook_profile_posts_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages need no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages need no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacebookPostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialPostsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_SocialPostsPage_"
                }
              }
            },
            "description": "Durable job; poll the returned owner-scoped URL."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Facebook Profile Posts"
      }
    },
    "/scrapers/google/search": {
      "post": {
        "description": "Search Google for bounded organic results, preserving each query and its reported rank.",
        "operationId": "google_search_scrapers_google_search_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoogleSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoogleSearchPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Google Search"
      }
    },
    "/scrapers/google_lens/jobs": {
      "post": {
        "description": "Submit once and safely replay the same key and body for seven days. Poll the returned URL; interrupted work is not automatically repeated.",
        "operationId": "submit_google_lens_job_scrapers_google_lens_jobs_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoogleLensSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoogleLensJob"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Submit Google Lens Job"
      }
    },
    "/scrapers/google_lens/jobs/{job_id}": {
      "get": {
        "description": "Poll without starting a new search. Results expire after 24 hours.",
        "operationId": "get_google_lens_job_scrapers_google_lens_jobs__job_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoogleLensJob"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Get Google Lens Job"
      }
    },
    "/scrapers/google_lens/search": {
      "post": {
        "description": "Find visual or exact image matches and extract text using Google Lens. Results share one total limit; a search can return no matches.",
        "operationId": "google_lens_search_scrapers_google_lens_search_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoogleLensSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoogleLensSearchPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Google Lens Search"
      }
    },
    "/scrapers/instagram/people/search": {
      "post": {
        "description": "Collect at most 50 native account candidates. Commas become spaces; locations are query hints. Missing biography/avatar fields are explicit. Prefer: respond-async returns promptly; default wait is at most 20 seconds. Cached pages/replays launch no new work.",
        "operationId": "instagram_people_search_scrapers_instagram_people_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages need no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages need no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstagramPeopleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PeopleSearchPage_InstagramCandidate_"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_PeopleSearchPage_InstagramCandidate__"
                }
              }
            },
            "description": "Durable native account search; poll the owner-scoped URL."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Instagram People Search"
      }
    },
    "/scrapers/instagram/profile/details": {
      "post": {
        "description": "Retrieve public Instagram profile details for up to ten handles or URLs.",
        "operationId": "instagram_profile_details_scrapers_instagram_profile_details_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstagramProfileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstagramProfilePage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Instagram Profile Details"
      }
    },
    "/scrapers/instagram/profile/followers": {
      "post": {
        "description": "One attributed public follower collection, nullable metadata and unknown full graph; cached pages only.",
        "operationId": "instagram_followers_scrapers_instagram_profile_followers_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstagramGraphRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstagramGraphPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_InstagramGraphPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Instagram Followers"
      }
    },
    "/scrapers/instagram/profile/following": {
      "post": {
        "description": "One attributed public following collection; native continuation is unavailable through this public API.",
        "operationId": "instagram_following_scrapers_instagram_profile_following_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstagramGraphRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstagramGraphPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_InstagramGraphPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Instagram Following"
      }
    },
    "/scrapers/instagram/profile/highlights": {
      "post": {
        "description": "Saved public Highlight metadata only; finite summaries and fixed profile outcome, with no Story content or complete-history claim.",
        "operationId": "instagram_highlights_scrapers_instagram_profile_highlights_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstagramHighlightsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstagramHighlightsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_InstagramHighlightsPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Instagram Highlights"
      }
    },
    "/scrapers/instagram/profile/highlights/content": {
      "post": {
        "description": "Actual saved Story items with IDs, dates and media references; media bytes are not retained.",
        "operationId": "content_scrapers_instagram_profile_highlights_content_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay and cached pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay and cached pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstagramHighlightContentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstagramHighlightContentPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_InstagramHighlightContentPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Content"
      }
    },
    "/scrapers/instagram/profile/posts": {
      "post": {
        "description": "Return a cached page or wait up to 20 seconds. Prefer: respond-async submits promptly. Media URLs may expire; full history is unknown.",
        "operationId": "instagram_profile_posts_scrapers_instagram_profile_posts_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages need no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages need no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstagramPostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialPostsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_SocialPostsPage_"
                }
              }
            },
            "description": "Durable job; poll the returned owner-scoped URL."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Instagram Profile Posts"
      }
    },
    "/scrapers/instagram/profile/tagged": {
      "post": {
        "description": "Collect genuinely tagged incoming posts with their actual source authors; mentions alone never establish a tag.",
        "operationId": "instagram_tagged_scrapers_instagram_profile_tagged_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstagramTaggedRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstagramTaggedPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_InstagramTaggedPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Instagram Tagged"
      }
    },
    "/scrapers/jobs/{job_id}": {
      "get": {
        "description": "Wait up to 25 seconds for completion without starting or replaying work.",
        "operationId": "get_social_research_job_scrapers_jobs__job_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "wait_seconds",
            "required": false,
            "schema": {
              "default": 0,
              "maximum": 25,
              "minimum": 0,
              "title": "Wait Seconds",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/SocialJob_SocialPostsPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_PeopleSearchPage_InstagramCandidate__"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_PeopleSearchPage_XCandidate__"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_PeopleSearchPage_FacebookCandidate__"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_PeopleSearchPage_TikTokCandidate__"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_XGraphPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_XQueryPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_XQuotesPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_FacebookPageSearchPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_FacebookGroupSearchPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_FacebookPostSearchPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_FacebookGroupPostsPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_FacebookCommentsPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_InstagramGraphPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_InstagramTaggedPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_InstagramHighlightsPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_InstagramHighlightContentPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_RedditSearchPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_RedditCommentsPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_TelegramGroupSearchPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_TelegramGroupDetailsPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_TelegramGroupMessagesPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_XSpaceDiscoveryPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_XSpaceRecordingPage_"
                    },
                    {
                      "$ref": "#/components/schemas/SocialJob_XSpaceTranscriptPage_"
                    }
                  ],
                  "title": "Response Get Social Research Job Scrapers Jobs  Job Id  Get"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Get Social Research Job"
      }
    },
    "/scrapers/jobs/{job_id}/recover": {
      "post": {
        "description": "Recover accepted terminal X archive data through GET-only reads. No new provider run; original result expiry remains.",
        "operationId": "recover_social_research_job_scrapers_jobs__job_id__recover_post",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_SocialPostsPage_"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_SocialPostsPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Recover Social Research Job"
      }
    },
    "/scrapers/linkedin/company/employees": {
      "post": {
        "description": "Retrieve public LinkedIn data using the documented filters and pagination fields.",
        "operationId": "company_employees_scrapers_linkedin_company_employees_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompanyEmployeesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfilePage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Company Employees"
      }
    },
    "/scrapers/linkedin/people/search": {
      "post": {
        "description": "Retrieve public LinkedIn data using the documented filters and pagination fields.",
        "operationId": "people_search_scrapers_linkedin_people_search_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PeopleSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfilePage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "People Search"
      }
    },
    "/scrapers/linkedin/post/comments": {
      "post": {
        "description": "Retrieve public LinkedIn data using the documented filters and pagination fields.",
        "operationId": "post_comments_scrapers_linkedin_post_comments_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostCommentsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommentPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Post Comments"
      }
    },
    "/scrapers/linkedin/post/search": {
      "post": {
        "description": "Retrieve public LinkedIn data using the documented filters and pagination fields.",
        "operationId": "post_search_scrapers_linkedin_post_search_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Post Search"
      }
    },
    "/scrapers/linkedin/profile/comments": {
      "post": {
        "description": "Retrieve public LinkedIn data using the documented filters and pagination fields.",
        "operationId": "profile_comments_scrapers_linkedin_profile_comments_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfileCommentsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommentPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Profile Comments"
      }
    },
    "/scrapers/linkedin/profile/details": {
      "post": {
        "description": "Retrieve public LinkedIn data using the documented filters and pagination fields.",
        "operationId": "profile_details_scrapers_linkedin_profile_details_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfileDetailsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfilePage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Profile Details"
      }
    },
    "/scrapers/linkedin/profile/posts": {
      "post": {
        "description": "Retrieve public LinkedIn data using the documented filters and pagination fields.",
        "operationId": "profile_posts_scrapers_linkedin_profile_posts_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfilePostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Profile Posts"
      }
    },
    "/scrapers/linkedin/profile/reactions": {
      "post": {
        "description": "Retrieve public LinkedIn data using the documented filters and pagination fields.",
        "operationId": "profile_reactions_scrapers_linkedin_profile_reactions_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfileReactionsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReactionPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Profile Reactions"
      }
    },
    "/scrapers/reddit/post/comments": {
      "post": {
        "description": "Expand accessible nested and collapsed replies while preserving observed parents, paths and deleted placeholders.",
        "operationId": "comments_scrapers_reddit_post_comments_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay and cached pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay and cached pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RedditCommentsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RedditCommentsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_RedditCommentsPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Comments"
      }
    },
    "/scrapers/reddit/search": {
      "post": {
        "description": "One finite public keyword search over posts, comments or both, with actual source IDs.",
        "operationId": "search_scrapers_reddit_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay and cached pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay and cached pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RedditSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RedditSearchPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_RedditSearchPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Search"
      }
    },
    "/scrapers/sherlock/search": {
      "post": {
        "description": "Discover public username candidates with Sherlock. Matching handles do not establish identity; completeness may be unknown.",
        "operationId": "sherlock_search_scrapers_sherlock_search_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SherlockSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SherlockSearchPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Sherlock Search"
      }
    },
    "/scrapers/telegram/group/details": {
      "post": {
        "description": "Read observed public discussion-group metadata; channels and bots do not become groups.",
        "operationId": "group_details_scrapers_telegram_group_details_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay, polling and cached pages start no additional work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay, polling and cached pages start no additional work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TelegramGroupDetailsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TelegramGroupDetailsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_TelegramGroupDetailsPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Group Details"
      }
    },
    "/scrapers/telegram/group/messages": {
      "post": {
        "description": "Collect up to 200 accessible group messages with sender, timestamp, reply links and media references.",
        "operationId": "group_messages_scrapers_telegram_group_messages_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay, polling and cached pages start no additional work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay, polling and cached pages start no additional work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TelegramGroupMessagesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TelegramGroupMessagesPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_TelegramGroupMessagesPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Group Messages"
      }
    },
    "/scrapers/telegram/groups/search": {
      "post": {
        "description": "Discover public group candidates by topic or name; no member list or group content is collected.",
        "operationId": "group_search_scrapers_telegram_groups_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay, polling and cached pages start no additional work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay, polling and cached pages start no additional work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TelegramGroupSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TelegramGroupSearchPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_TelegramGroupSearchPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Group Search"
      }
    },
    "/scrapers/tiktok/people/search": {
      "post": {
        "description": "Collect at most 50 native user candidates with available profile fields. Location texts are appended in caller order as query hints, never enforced city filters. Prefer: respond-async returns promptly; default wait is at most 20 seconds. Cached pages/replays launch no new work.",
        "operationId": "tiktok_people_search_scrapers_tiktok_people_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages need no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages need no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TikTokPeopleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PeopleSearchPage_TikTokCandidate_"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_PeopleSearchPage_TikTokCandidate__"
                }
              }
            },
            "description": "Durable native user search; poll the owner-scoped URL."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Tiktok People Search"
      }
    },
    "/scrapers/tiktok/profile/details": {
      "post": {
        "description": "Retrieve public TikTok profile details for up to ten usernames or profile URLs.",
        "operationId": "tiktok_profile_details_scrapers_tiktok_profile_details_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TikTokProfileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TikTokProfilePage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Tiktok Profile Details"
      }
    },
    "/scrapers/tiktok/profile/posts": {
      "post": {
        "description": "Return public videos and ordered slideshow images, with separate cover thumbnails and source authors. Prefer: respond-async submits promptly.",
        "operationId": "tiktok_profile_posts_scrapers_tiktok_profile_posts_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages need no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages need no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TikTokPostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialPostsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_SocialPostsPage_"
                }
              }
            },
            "description": "Durable job; poll the returned owner-scoped URL."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Tiktok Profile Posts"
      }
    },
    "/scrapers/x/people/search": {
      "post": {
        "description": "Collect at most 50 native account candidates with available profile fields. Locations are query hints, not filters. Prefer: respond-async returns promptly; default wait is at most 20 seconds. Cached pages/replays launch no new work.",
        "operationId": "x_people_search_scrapers_x_people_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages need no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages need no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XPeopleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PeopleSearchPage_XCandidate_"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_PeopleSearchPage_XCandidate__"
                }
              }
            },
            "description": "Durable native account search; poll the owner-scoped URL."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "X People Search"
      }
    },
    "/scrapers/x/post/quotes": {
      "post": {
        "description": "Collect incoming quotes whose returned original-post ID matches the requested target. One bounded collection, with unknown full coverage.",
        "operationId": "quotes_scrapers_x_post_quotes_post",
        "parameters": [
          {
            "description": "Required for initial collection; result_id pages require no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; result_id pages require no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XQuotesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XQuotesPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_XQuotesPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Quotes"
      }
    },
    "/scrapers/x/post/replies": {
      "post": {
        "description": "Search conversation candidates by post ID. Only returned parent IDs establish direct or nested replies; this is not a complete reply tree.",
        "operationId": "replies_scrapers_x_post_replies_post",
        "parameters": [
          {
            "description": "Required for initial collection; result_id pages require no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; result_id pages require no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XPostRelationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XQueryPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_XQueryPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Replies"
      }
    },
    "/scrapers/x/posts/search": {
      "post": {
        "description": "One bounded X web query with preserved source authors; operators and recall remain upstream-dependent.",
        "operationId": "post_search_scrapers_x_posts_search_post",
        "parameters": [
          {
            "description": "Required for initial collection; result_id pages require no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; result_id pages require no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XPostSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XQueryPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_XQueryPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Post Search"
      }
    },
    "/scrapers/x/profile/details": {
      "post": {
        "description": "Retrieve public X profile details for up to ten handles or profile URLs.",
        "operationId": "x_profile_details_scrapers_x_profile_details_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XProfileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XProfilePage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "X Profile Details"
      }
    },
    "/scrapers/x/profile/dumps": {
      "post": {
        "description": "Start a resumable signed-in browser collection. A finished timeline does not prove complete account history.",
        "operationId": "submit_x_dump_scrapers_x_profile_dumps_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XDumpRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XDumpStatus"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XDumpStatus"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Submit X Dump"
      }
    },
    "/scrapers/x/profile/dumps/{job_id}": {
      "get": {
        "description": "Read progress. wait_seconds waits for completion; after_revision waits for a progress change instead.",
        "operationId": "get_x_dump_scrapers_x_profile_dumps__job_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "wait_seconds",
            "required": false,
            "schema": {
              "default": 0,
              "maximum": 25,
              "minimum": 0,
              "title": "Wait Seconds",
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "after_revision",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "minimum": 0,
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "After Revision"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XDumpStatus"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Get X Dump"
      }
    },
    "/scrapers/x/profile/dumps/{job_id}/posts": {
      "get": {
        "description": "Page deduplicated posts and media source URLs; start at after=0 and follow next_after.",
        "operationId": "get_x_dump_posts_scrapers_x_profile_dumps__job_id__posts_get",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "after",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "After",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 200,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XDumpPostsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Get X Dump Posts"
      }
    },
    "/scrapers/x/profile/dumps/{job_id}/resume": {
      "post": {
        "description": "Continue selected paused tabs at saved cursors. Optional page bounds cannot skip or rewind upstream pages.",
        "operationId": "resume_x_dump_scrapers_x_profile_dumps__job_id__resume_post",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "retry_stalled",
            "required": false,
            "schema": {
              "default": false,
              "title": "Retry Stalled",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/XDumpResumeRequest"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Request"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XDumpStatus"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Resume X Dump"
      }
    },
    "/scrapers/x/profile/followers": {
      "post": {
        "description": "Collect attributed public followers; nullable profile fields and unknown full graph. Pages read the cached collection.",
        "operationId": "followers_scrapers_x_profile_followers_post",
        "parameters": [
          {
            "description": "Required for initial collection; result_id pages require no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; result_id pages require no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XGraphRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XGraphPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_XGraphPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Followers"
      }
    },
    "/scrapers/x/profile/following": {
      "post": {
        "description": "Conditional public following collection. Unqualified ambiguous output fails; the source root cannot become an edge.",
        "operationId": "following_scrapers_x_profile_following_post",
        "parameters": [
          {
            "description": "Required for initial collection; result_id pages require no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; result_id pages require no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XGraphRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XGraphPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_XGraphPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Following"
      }
    },
    "/scrapers/x/profile/posts": {
      "post": {
        "description": "Return recent posts or a dated X archive window. Cached pages read one immutable result; next_archive_end_date starts the next older job. Prefer: respond-async submits promptly.",
        "operationId": "x_profile_posts_scrapers_x_profile_posts_post",
        "parameters": [
          {
            "description": "Required for initial collection; cached result_id pages need no key.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; cached result_id pages need no key.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XPostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialPostsPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_SocialPostsPage_"
                }
              }
            },
            "description": "Durable job; poll the returned owner-scoped URL."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "X Profile Posts"
      }
    },
    "/scrapers/x/profile/spaces": {
      "post": {
        "description": "Find actual Space links in posts by a handle; sharing alone does not establish hosting.",
        "operationId": "discovery_scrapers_x_profile_spaces_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay and cached pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay and cached pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XSpaceDiscoveryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XSpaceDiscoveryPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_XSpaceDiscoveryPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Discovery"
      }
    },
    "/scrapers/x/space/recording": {
      "post": {
        "description": "Resolve one observed replay reference and check a bounded audio sample; bytes are not retained.",
        "operationId": "recording_scrapers_x_space_recording_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay and cached pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay and cached pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XSpaceRecordingRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XSpaceRecordingPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_XSpaceRecordingPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Recording"
      }
    },
    "/scrapers/x/space/transcript": {
      "post": {
        "description": "Transcribe a finite recorded Space prefix with real returned text and optional timed segments.",
        "operationId": "transcript_scrapers_x_space_transcript_post",
        "parameters": [
          {
            "description": "Required for initial collection; replay and cached pages start no new work.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Required for initial collection; replay and cached pages start no new work.",
              "title": "Idempotency-Key"
            }
          },
          {
            "in": "header",
            "name": "prefer",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prefer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XSpaceTranscriptRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XSpaceTranscriptPage"
                }
              }
            },
            "description": "Successful Response"
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialJob_XSpaceTranscriptPage_"
                }
              }
            },
            "description": "Accepted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting immutable request or unavailable recovery"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research job or result expired"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Transcript"
      }
    },
    "/statusz": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Conflicting state or idempotency key"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Result expired"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Requested service or constraints unavailable"
          }
        },
        "summary": "Read service availability"
      }
    },
    "/web/wayback": {
      "post": {
        "description": "Resolve one existing HTML capture within a year or date. Blocked or throttled archive access never means no capture exists.",
        "operationId": "get_wayback_web_wayback_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WaybackRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WaybackResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid research request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Invalid Hive authentication"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Archive access blocked"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Public profile not found"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research rate limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicError"
                }
              }
            },
            "description": "Research timed out"
          }
        },
        "summary": "Get Wayback"
      }
    }
  },
  "security": [
    {
      "HiveKey": []
    }
  ]
}