Vendor Data Feed

IT service providers can voluntarily submit structured data by hosting a JSON file on their own domain. This file provides pointers to help our system find and verify the truth — it is not a source of truth itself. Review counts, ratings, and scores are always determined from objective sources.

Ready to submit? Start here to generate your unique feed URL and get step-by-step instructions. Already submitted? Check your status.

How It Works

  1. Register with your work email to generate a unique feed URL for your domain (e.g., https://yourcompany.com/a8f3c9d2e1b4.json)
  2. Create a JSON file following the schema below and host it at that URL on your domain
  3. Click “Verify” in your submission dashboard — our system fetches the file, validates it, and recalculates your score automatically
  4. Track progress on the status page: URL Submitted → Processing → Score Updated

What to Include

The feed helps us find accurate data faster. Include anything that helps us verify your company's information:

  • Review URLs — Links to your profiles on Clutch, Google Business, G2, Glassdoor, Indeed, and other platforms where you are reviewed
  • Security certifications — Links to external pages showing your certifications (audit firm listings, certificate databases) or to the certificates themselves (PDF letters, badge pages)
  • Office locations — Addresses of your Chicago-area offices to verify geographic eligibility
  • Company details — Legal name, headcount, year founded, services offered, industries served
  • Contract terms — Typical contract length, month-to-month availability, exit terms, price lock periods
  • Support details — Hours of coverage, SLA response time, onsite availability
  • Notable events — Awards, partnerships, acquisitions, office expansions, and other company milestones with dates and optional evidence links

JSON Schema

The full JSON Schema is available at /schemas/vendor-feed-v1.json. Here is a comprehensive example:

{
  "$schema": "https://itsupportchicago.net/schemas/vendor-feed-v1.json",
  "version": 1,
  "company": {
    "legal_name": "Acme IT Solutions, LLC",
    "dba": "Acme IT",
    "url": "https://acmeit.com",
    "hq_address": "123 N Michigan Ave, Suite 400, Chicago, IL 60601",
    "office_locations": [
      { "city": "Chicago", "state": "IL", "address": "123 N Michigan Ave" },
      { "city": "Naperville", "state": "IL", "address": "456 Main St" }
    ],
    "headcount": 85,
    "year_founded": 2012,
    "contact_email": "info@acmeit.com"
  },
  "review_urls": [
    { "platform": "Clutch", "url": "https://clutch.co/profile/acme-it" },
    { "platform": "Google Business", "url": "https://g.co/kgs/abc123" },
    { "platform": "G2", "url": "https://g2.com/products/acme-it/reviews" },
    { "platform": "Glassdoor", "url": "https://glassdoor.com/Reviews/acme-it" },
    { "platform": "Indeed", "url": "https://indeed.com/cmp/acme-it/reviews" }
  ],
  "certifications": [
    {
      "name": "SOC 2 Type II",
      "status": "current",
      "issuer": "Schellman",
      "valid_through": "2027-03-15",
      "evidence_url": "https://acmeit.com/compliance/soc2-letter.pdf"
    },
    {
      "name": "ISO 27001",
      "status": "current",
      "issuer": "BSI",
      "valid_through": "2026-11-30",
      "evidence_url": "https://www.bsi-global.com/cert/acme-it"
    }
  ],
  "services": [
    "Managed IT", "Co-managed IT", "Cybersecurity",
    "Cloud Services", "Help Desk", "Network Management"
  ],
  "industries_served": [
    "Healthcare", "Legal", "Financial Services", "Manufacturing"
  ],
  "support": {
    "hours": "24x7",
    "sla_response_minutes": 15,
    "onsite_available": true,
    "onsite_cities": ["Chicago", "Naperville", "Schaumburg"]
  },
  "contract": {
    "typical_term_years": 1,
    "month_to_month_available": true,
    "exit_notice_days": 30,
    "price_lock_years": 1
  },
  "notable_events": [
    {
      "title": "Named to CRN MSP 500 List",
      "date": "2026-03-15",
      "type": "award",
      "description": "Recognized as a top managed service provider in North America.",
      "url": "https://acmeit.com/press/crn-msp-500"
    },
    {
      "title": "Strategic Partnership with Microsoft",
      "date": "2025-11-01",
      "type": "partnership"
    }
  ],
  "corrections": {
    "note": "We completed our CMMC Level 2 assessment in May 2026.",
    "contact_email": "compliance@acmeit.com"
  }
}

Trust Model

Your feed is a helpful input, not an override:

  • Review counts and ratings are always sourced from third-party platforms, never from your feed
  • Review URLs help us find the right profiles faster — we verify the data at those URLs objectively
  • Certification evidence links are flagged as “vendor-claimed with evidence” until an admin or automated check verifies them
  • All vendor-submitted data is clearly labeled on your profile page
  • False or misleading data may result in removal from rankings

Important Notes

  • The file must be served over HTTPS from your own domain
  • The URL path contains a unique key generated during registration — this prevents others from discovering or replacing your feed
  • Maximum file size: 100KB
  • You can update the file at any time and re-trigger processing from your status dashboard