{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Social Profile",
  "description": "Platform social profile (LinkedIn company, Twitter/X, etc.)",
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "description": "The social platform this profile belongs to. Commonly found in: linkedin.com/company, twitter.com, x.com.",
      "enum": ["linkedin", "twitter", "x", "github", "instagram", "youtube", "tiktok", "other"]
    },
    "profile_type": {
      "type": "string",
      "description": "Whether this profile belongs to a person, company, or organization.",
      "enum": ["person", "company", "organization", "other"]
    },
    "username_or_handle": {
      "type": "string",
      "description": "The username or @handle for this profile."
    },
    "display_name": {
      "type": "string",
      "description": "The public display name of the profile."
    },
    "bio": {
      "type": "string",
      "description": "Short biography or description text on the profile."
    },
    "follower_count": {
      "type": "number",
      "description": "Number of followers."
    },
    "following_count": {
      "type": "number",
      "description": "Number of accounts the profile is following."
    },
    "post_count": {
      "type": "number",
      "description": "Total number of posts or tweets published."
    },
    "verified": {
      "type": "boolean",
      "description": "Whether the profile has a verified badge."
    },
    "website_url": {
      "type": "string",
      "description": "External website URL listed on the profile."
    },
    "location": {
      "type": "string",
      "description": "Self-reported location of the profile."
    },
    "founded_year": {
      "type": "number",
      "description": "Year the company was founded. Applicable to company profiles."
    },
    "employee_count_range": {
      "type": "string",
      "description": "Employee count range for company profiles (e.g., '11-50')."
    },
    "industry": {
      "type": "string",
      "description": "Industry classification for company profiles."
    },
    "profile_url": {
      "type": "string",
      "description": "Canonical URL of the profile page."
    },
    "avatar_url": {
      "type": "string",
      "description": "URL to the profile avatar / profile picture."
    },
    "banner_url": {
      "type": "string",
      "description": "URL to the profile banner / header image."
    },
    "pinned_post_url": {
      "type": "string",
      "description": "URL of the pinned post on the profile."
    },
    "engagement_rate_pct": {
      "type": "number",
      "description": "Engagement rate as a percentage."
    },
    "snapshot_at": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the profile data was snapshotted."
    },
    "page_title": {
      "type": "string",
      "description": "Title of the source page. Tabstack auto-fills this from page metadata when left empty."
    },
    "favicon": {
      "type": "string",
      "format": "uri",
      "description": "Favicon URL of the source page. Tabstack auto-fills this from page metadata when left empty."
    }
  },
  "required": ["platform", "profile_type", "username_or_handle", "display_name", "profile_url"]
}