Company Search (by Name or Keyword)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "limit": {
      "type": "integer",
      "description": "Results per page (max 20)"
    },
    "query": {
      "type": "string",
      "description": "Search keyword or company name"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "companies": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Opaque internal business identifier on the upstream review platform (a 24-character hex string). Not a phone number or any other contact detail."
              },
              "name": {
                "type": "string",
                "description": "The company's display name."
              },
              "stars": {
                "type": "number",
                "description": "0-5 star rating, observed in half-star increments."
              },
              "domain": {
                "type": "string",
                "description": "The company's registered domain, e.g. 'www.amazon.com'."
              },
              "location": {
                "type": "object",
                "properties": {
                  "city": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "street": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "country": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "postcode": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "coordinates": {
                    "type": "object",
                    "properties": {
                      "lat": {
                        "type": "number"
                      },
                      "lon": {
                        "type": "number"
                      }
                    },
                    "description": "Present on every company observed, even when the rest of `location` is null.",
                    "additionalProperties": true
                  },
                  "countryCode": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "approximateArea": {
                    "type": "array",
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      }
                    },
                    "description": "A bounding box: two [longitude, latitude] corner pairs, observed on every company in both fixtures."
                  }
                },
                "description": "The company's registered business location on the upstream platform. City, street, postcode, country, and countryCode were all observed null for several companies in the same result set (location data is not always on file) -- treat every one of those fields as possibly absent, not guaranteed present.",
                "additionalProperties": true
              },
              "verified": {
                "type": "boolean",
                "description": "Whether the business has claimed/verified its profile."
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Business category tags. Observed as an empty array for at least one company."
              },
              "trust_score": {
                "type": "number",
                "description": "0-5 scale, observed with one decimal place."
              },
              "website_url": {
                "type": "string",
                "description": "Full https URL to the company's own website."
              },
              "review_count": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "description": "Up to `limit` matching companies for the current page. Empty array when nothing matches the query (confirmed against examples/nomatch-empty.json), not omitted and not null."
        },
        "total_hits": {
          "type": "integer",
          "description": "Total matching companies across all pages, not just this page."
        },
        "total_pages": {
          "type": "integer"
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed, including the zero-match case."
    }
  },
  "description": "The search result page, as returned at routing.responseResultPath ($.output) after shaping. A query matching no companies still returns this same shape with an empty `data.companies` array and `total_hits`/`total_pages` at 0 (see examples/nomatch-empty.json), not an error and not a differently-shaped response.",
  "additionalProperties": true
}