{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "name": "Best-of Iran Agent Catalog",
  "version": "1.0.0",
  "description": "Machine-readable directory of audited businesses, service categories, and inspection reports across Iran.",
  "provider": {
    "name": "Best-of Iran",
    "url": "https://brtir.ir"
  },
  "endpoints": [
    {
      "name": "searchBusinesses",
      "description": "Search and filter audited businesses by query, city, category, or min rating.",
      "url": "https://brtir.ir/api/enterprise/search",
      "method": "GET",
      "parameters": {
        "q": { "type": "string", "description": "Search query" },
        "city": { "type": "string", "description": "City slug e.g. tehran, isfahan" },
        "category": { "type": "string", "description": "Category slug e.g. restaurants, cafe" }
      }
    },
    {
      "name": "getCities",
      "description": "Retrieve all covered cities and provinces in Iran.",
      "url": "https://brtir.ir/api/enterprise/cities",
      "method": "GET"
    },
    {
      "name": "getCategories",
      "description": "Retrieve all business categories and audit pillars.",
      "url": "https://brtir.ir/api/enterprise/categories",
      "method": "GET"
    }
  ]
}