Nearwick business directory

Every country with businesses listed on Nearwick, with how many each lists and the address of its directory.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

The kinds of business a country lists, each group with its subcategories and counts, and the towns and regions with the most listings. Use a category slug with search_businesses.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code, such as GH for Ghana or CA for Canada.",
      "minLength": 2,
      "maxLength": 2
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false
}

Search one country's listed businesses by words, category, town or region, and what the page carries. Returns up to 24 a page, each with its Nearwick page address to cite. Results are A to Z, or newest details first.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code, such as GH for Ghana or CA for Canada.",
      "minLength": 2,
      "maxLength": 2
    },
    "query": {
      "type": "string",
      "description": "Words in the name, description or address, such as \"pharmacy\" or a business name.",
      "maxLength": 80
    },
    "category": {
      "type": "string",
      "description": "A category or group slug from list_categories, such as \"pharmacies\".",
      "maxLength": 60
    },
    "city": {
      "type": "string",
      "description": "A town or city, such as \"Accra\".",
      "maxLength": 80
    },
    "region": {
      "type": "string",
      "description": "A region, such as \"Greater Accra\".",
      "maxLength": 80
    },
    "has": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "website",
          "hours",
          "map"
        ]
      },
      "description": "Only pages that carry all of these: a website, opening hours, a map pin."
    },
    "managed": {
      "type": "boolean",
      "description": "Only businesses that manage their own page."
    },
    "sort": {
      "type": "string",
      "enum": [
        "name",
        "recent"
      ],
      "description": "\"name\" (A to Z, the default) or \"recent\" (newest details first)."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "The page of results, from 1."
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false
}

Suggestions for what someone is looking for, in their own words, such as "a pharmacy in Osu open on Sunday" or "a hotel in Kumasi with a website". Reads the kind of business, the town or neighbourhood, the days and what the page must carry, and returns up to 8 listings in order of fit, each with the reasons it was suggested, and the search that shows every match. When nothing fits everything, the answer says how the request was widened.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code, such as GH for Ghana or CA for Canada.",
      "minLength": 2,
      "maxLength": 2
    },
    "request": {
      "type": "string",
      "description": "What the person is looking for, in plain words, such as \"a pharmacy in Osu open on Sunday\".",
      "minLength": 2,
      "maxLength": 200
    }
  },
  "required": [
    "country",
    "request"
  ],
  "additionalProperties": false
}

Everything a business's Nearwick page says: what and where it is, its website, opening hours and description where listed, what its own website states and when that was read, dated checks, and whether the business manages the page. Use the country code and the slug from its page address (/{country}/b/{slug}).

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code, such as GH for Ghana or CA for Canada.",
      "minLength": 2,
      "maxLength": 2
    },
    "slug": {
      "type": "string",
      "description": "The business's slug, from search_businesses or its page address.",
      "maxLength": 160
    }
  },
  "required": [
    "country",
    "slug"
  ],
  "additionalProperties": false
}