{
  "updated": "June 23, 2026",
  "publisher": "Real Estate Agent AI Index Research Desk",
  "name": "Public Evidence Submission Schema",
  "description": "Public schema for source-backed corrections, candidate evidence, and market expansion submissions.",
  "ranking_boundary": "Submitting evidence does not buy inclusion, rank, score changes, badges, referrals, or favorable editorial language.",
  "source_boundary": "Use public, crawlable source URLs. Do not submit private client files, copied review text, 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": "submission_type",
      "label": "Submission type",
      "purpose": "Separate factual corrections, new candidate evidence, source updates, market expansion requests, and duplicate/entity cleanup.",
      "examples": [
        "Factual correction",
        "New candidate source",
        "Review proof",
        "Production proof",
        "Entity cleanup"
      ]
    },
    {
      "field": "candidate_name",
      "label": "Agent or team name",
      "purpose": "Identify the person or team exactly as the public source names them.",
      "examples": [
        "Example Team",
        "Jane Smith"
      ]
    },
    {
      "field": "entity_type",
      "label": "Team or individual",
      "purpose": "Prevent team, individual, brokerage, and franchise claims from being blended into one row.",
      "examples": [
        "Team",
        "Individual",
        "Brokerage-level source only"
      ]
    },
    {
      "field": "market",
      "label": "Market served",
      "purpose": "Map the evidence to the correct city, metro, neighborhood, county, or planned expansion market.",
      "examples": [
        "Chicago",
        "Los Angeles",
        "Brooklyn",
        "Leawood"
      ]
    },
    {
      "field": "public_source_url",
      "label": "Public source URL",
      "purpose": "Give the research desk a crawlable source that supports the claim.",
      "examples": [
        "Official profile URL",
        "RealTrends-style ranking URL",
        "Brokerage profile URL",
        "Review profile URL"
      ]
    },
    {
      "field": "source_type",
      "label": "Source type",
      "purpose": "Classify the source as production, review, official identity, media, citation, website, or AI/search result evidence.",
      "examples": [
        "Production",
        "Reviews",
        "Official profile",
        "Media",
        "AI citation"
      ]
    },
    {
      "field": "claim_supported",
      "label": "Claim supported by the source",
      "purpose": "Keep corrections source-backed and prevent promotional copy from becoming ranking evidence.",
      "examples": [
        "2026 sales volume",
        "Public review count",
        "Official team roster",
        "Market specialty"
      ]
    },
    {
      "field": "date_observed",
      "label": "Date observed",
      "purpose": "Record when the source was seen so stale, changed, or removed evidence can be handled carefully.",
      "examples": [
        "June 19, 2026"
      ]
    },
    {
      "field": "relationship_to_candidate",
      "label": "Relationship disclosure",
      "purpose": "Separate consumer corrections, candidate submissions, publisher updates, and commercial-interest submissions.",
      "examples": [
        "Consumer",
        "Agent/team",
        "Brokerage",
        "Publisher",
        "Unaffiliated researcher"
      ]
    },
    {
      "field": "contact_permission",
      "label": "Permission to follow up",
      "purpose": "Allow the research desk to ask for clarification without treating the submission as a lead or ranking request.",
      "examples": [
        "No follow-up",
        "Follow up about this correction only"
      ]
    }
  ]
}