Analytics Tools

{
  "comparison": {
    "code1": {
      "code": "722511",
      "title": "Full-Service Restaurants",
      "description": "Establishments primarily engaged in providing food services to patrons who order and are served while seated...",
      "hierarchy": ["72", "722", "7225", "72251", "722511"]
    },
    "code2": {
      "code": "722513",
      "title": "Limited-Service Restaurants",
      "description": "Establishments primarily engaged in providing food services where patrons order or select items and pay before eating...",
      "hierarchy": ["72", "722", "7225", "72251", "722513"]
    }
  },
  "relationship": {
    "type": "siblings",
    "common_parent": {
      "code": "72251",
      "title": "Restaurants and Other Eating Places"
    },
    "divergence_level": "national_industry"
  },
  "key_differences": [
    {
      "aspect": "Service Model",
      "code1": "Table service - patrons are served while seated",
      "code2": "Counter service - patrons order and pay before eating"
    },
    {
      "aspect": "Payment Timing",
      "code1": "Bill presented after meal",
      "code2": "Payment before receiving food"
    }
  ]
}

{
  "code1": "541511",
  "code2": "541512"
}

{
  "source": {
    "code": "722511",
    "title": "Full-Service Restaurants"
  },
  "similar": [
    {
      "code": "722513",
      "title": "Limited-Service Restaurants",
      "similarity": 0.89,
      "relationship": "sibling"
    },
    {
      "code": "722514",
      "title": "Cafeterias, Grill Buffets, and Buffets",
      "similarity": 0.85,
      "relationship": "sibling"
    },
    {
      "code": "722515",
      "title": "Snack and Nonalcoholic Beverage Bars",
      "similarity": 0.78,
      "relationship": "sibling"
    },
    {
      "code": "722410",
      "title": "Drinking Places (Alcoholic Beverages)",
      "similarity": 0.72,
      "relationship": "cousin"
    }
  ]
}

{
  "code": "541511",
  "limit": 5,
  "same_sector": true
}

{
  "code": "311811",
  "title": "Retail Bakeries",
  "cross_references": {
    "exclusions": [
      {
        "text": "Manufacturing bakery products for sale to other establishments",
        "see_code": "311812",
        "see_title": "Commercial Bakeries"
      },
      {
        "text": "Retailing bakery products not baked on the premises",
        "see_code": "445291",
        "see_title": "Baked Goods Retailers"
      }
    ],
    "see_also": [
      {
        "code": "311812",
        "title": "Commercial Bakeries",
        "reason": "For wholesale bakery production"
      },
      {
        "code": "722515",
        "title": "Snack and Nonalcoholic Beverage Bars",
        "reason": "For bakery cafes with seating"
      }
    ]
  }
}

{
  "code": "541511"
}

{
  "sector": {
    "code": "72",
    "title": "Accommodation and Food Services"
  },
  "statistics": {
    "total_codes": 45,
    "subsectors": 2,
    "industry_groups": 7,
    "naics_industries": 15,
    "national_industries": 21
  },
  "subsectors": [
    {
      "code": "721",
      "title": "Accommodation",
      "code_count": 9
    },
    {
      "code": "722",
      "title": "Food Services and Drinking Places",
      "code_count": 36
    }
  ],
  "largest_industry_groups": [
    {
      "code": "7225",
      "title": "Restaurants and Other Eating Places",
      "code_count": 15
    }
  ]
}

{
  "sector_code": "54"
}

{
  "node_code": "449110",
  "title": "Furniture Retailers",
  "level": "national_industry",
  "sector_code": "44",
  "same_sector_alternatives": [
    {
      "code": "449210",
      "title": "Electronics and Appliance Retailers",
      "level": "national_industry",
      "similarity": 0.82
    },
    {
      "code": "449120",
      "title": "Home Furnishings Retailers",
      "level": "national_industry",
      "similarity": 0.79
    }
  ],
  "cross_sector_alternatives": [
    {
      "code": "459410",
      "title": "Office Supplies and Stationery Retailers",
      "level": "national_industry",
      "similarity": 0.77,
      "target_sector": "45",
      "note": "Cross-sector: 44 -> 45"
    },
    {
      "code": "423210",
      "title": "Furniture Merchant Wholesalers",
      "level": "national_industry",
      "similarity": 0.74,
      "target_sector": "42",
      "note": "Cross-sector: 44 -> 42"
    }
  ],
  "stats": {
    "same_sector_count": 5,
    "cross_sector_count": 8
  }
}

{
  "naics_code": "722511",
  "min_similarity": 0.75,
  "include_cross_sector": true,
  "limit": 5
}

{
  "naics_code": "424130",
  "title": "Industrial and Personal Service Paper Merchant Wholesalers",
  "sector_code": "42",
  "cross_sector_alternatives": [
    {
      "code": "322219",
      "title": "Other Paperboard Container Manufacturing",
      "level": "national_industry",
      "similarity": 0.79,
      "target_sector": "32",
      "relationship_note": "Cross-sector: 42 -> 32",
      "hierarchy": ["32", "322", "3222", "32221", "322219"]
    },
    {
      "code": "322299",
      "title": "All Other Converted Paper Product Manufacturing",
      "level": "national_industry",
      "similarity": 0.78,
      "target_sector": "32",
      "relationship_note": "Cross-sector: 42 -> 32",
      "hierarchy": ["32", "322", "3222", "32229", "322299"]
    }
  ],
  "total_found": 9,
  "note": "Cross-sector alternatives are codes in DIFFERENT sectors that are semantically similar. High similarity suggests the business activity might legitimately fit in either sector - evaluate based on PRIMARY activity."
}

{
  "naics_code": "541511",
  "min_similarity": 0.70,
  "top_n": 5
}

{
  "node_code": "449110",
  "title": "Furniture Retailers",
  "level": "national_industry",
  "sector_code": "44",
  "stats": {
    "same_sector_count": 5,
    "cross_sector_count": 8,
    "total_count": 13,
    "max_similarity": 0.82,
    "avg_similarity": 0.76,
    "has_cross_sector": true
  }
}

{
  "naics_code": "722511"
}

1. classify_business(description)
2. get_relationship_stats(top_result.code)
3. If has_cross_sector=true:
   a. get_cross_sector_alternatives(code)
   b. compare_codes(original_code, top_cross_sector_code)
   c. get_cross_references(both_codes)
4. Document decision if classification is ambiguous