{
  "updated": "June 23, 2026",
  "publisher": "Real Estate Agent AI Index Research Desk",
  "name": "Factual Correction Request Schema",
  "description": "Public schema for factual correction requests that require public source support and preserve ranking independence.",
  "ranking_boundary": "Correction requests can improve factual accuracy but cannot buy inclusion, rank movement, score changes, badges, referrals, or favorable editorial language.",
  "source_boundary": "Use public, crawlable source URLs. Do not submit private client files, copied review text, reviewer names, MLS-only screenshots, private financial records, or confidential documents.",
  "review_boundary": "Do not copy review text, rating snippets, or portal profile content unless source terms permit it; use source links and aggregate proof labels instead.",
  "fields": [
    {
      "field": "correction_type",
      "label": "Correction type",
      "purpose": "Classify whether the request concerns identity, category, market, source URL, score input, duplicate cleanup, or outdated evidence.",
      "examples": [
        "Identity correction",
        "Market correction",
        "Duplicate/entity cleanup",
        "Outdated source"
      ]
    },
    {
      "field": "candidate_name",
      "label": "Agent or team name",
      "purpose": "Identify the public row that should be reviewed.",
      "examples": [
        "Example Team",
        "Jane Smith"
      ]
    },
    {
      "field": "reported_profile_url",
      "label": "Reported profile URL",
      "purpose": "Preserve the exact Index profile that opened the correction form.",
      "examples": [
        "https://realestateagentaiindex.com/directory/example-team"
      ]
    },
    {
      "field": "entity_type",
      "label": "Team or individual",
      "purpose": "Keep individual, team, brokerage, and franchise evidence from being blended.",
      "examples": [
        "Team",
        "Individual",
        "Brokerage-level source only"
      ]
    },
    {
      "field": "market",
      "label": "Market",
      "purpose": "Route the correction to the right market ledger.",
      "examples": [
        "Chicago",
        "Los Angeles",
        "New York Metro"
      ]
    },
    {
      "field": "public_source_url",
      "label": "Public source URL",
      "purpose": "Provide a crawlable source that supports the requested correction.",
      "examples": [
        "Official profile URL",
        "Brokerage roster URL",
        "Public ranking URL"
      ]
    },
    {
      "field": "field_to_correct",
      "label": "Field to correct",
      "purpose": "Name the exact public field or claim that should be reviewed.",
      "examples": [
        "Team vs individual",
        "Market",
        "Source URL",
        "Review count",
        "Production source"
      ]
    },
    {
      "field": "current_public_value",
      "label": "Current public value",
      "purpose": "Help the research desk find the current claim without guessing.",
      "examples": [
        "Listed as a team",
        "Shows Los Angeles",
        "Uses old brokerage profile"
      ]
    },
    {
      "field": "requested_public_value",
      "label": "Requested value",
      "purpose": "State the factual correction supported by the public source.",
      "examples": [
        "Individual agent",
        "New York Metro",
        "Updated official profile URL"
      ]
    },
    {
      "field": "relationship_to_candidate",
      "label": "Relationship disclosure",
      "purpose": "Separate consumer reports, candidate requests, brokerage requests, and unaffiliated research.",
      "examples": [
        "Consumer",
        "Agent/team",
        "Brokerage",
        "Unaffiliated researcher"
      ]
    },
    {
      "field": "contact_permission",
      "label": "Permission to follow up",
      "purpose": "Allow clarification without turning the correction into a lead or ranking request.",
      "examples": [
        "No follow-up",
        "Follow up about this correction only"
      ]
    }
  ]
}