AI Company Search by Plain-Language Description

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Companies per page. Default and max 100."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Natural-language description of the target companies, e.g. 'fintech startups in Singapore founded after 2020'."
    },
    "offset": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0,
      "description": "Companies to skip. Max 10,000."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Present only when the query could not be turned into a valid search, e.g. 'HTTP_400' (see examples/zzq-empty-result.json). Absent on a populated match set."
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "The company's primary domain."
          },
          "emails_count": {
            "type": "object",
            "properties": {
              "total": {
                "type": "number"
              },
              "generic": {
                "type": "number"
              },
              "personal": {
                "type": "number"
              }
            },
            "description": "Counts of email addresses on file for this domain, not the addresses themselves.",
            "additionalProperties": true
          },
          "organization": {
            "type": "string",
            "description": "The company's own public name."
          }
        },
        "additionalProperties": true
      },
      "description": "The matching companies for this page of results."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number"
        },
        "offset": {
          "type": "number"
        },
        "params": {
          "type": "object",
          "properties": {
            "query": {
              "type": "string",
              "description": "The query as submitted."
            }
          },
          "additionalProperties": true
        },
        "filters": {
          "type": "object",
          "properties": {
            "keywords": {
              "type": "object",
              "properties": {
                "match": {
                  "type": "string",
                  "description": "e.g. 'any'."
                },
                "include": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "additionalProperties": true
            },
            "headcount": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Headcount buckets, e.g. '1-10', '11-50'."
            },
            "year_founded": {
              "type": "object",
              "properties": {
                "from": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "headquarters_location": {
              "type": "object",
              "properties": {
                "include": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "country": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  }
                }
              },
              "additionalProperties": true
            }
          },
          "description": "The structured search filters the AI derived from the plain-language query.",
          "additionalProperties": true
        },
        "results": {
          "type": "number",
          "description": "Total matches across all pages."
        }
      },
      "description": "Pagination and the filters the AI inferred from the query.",
      "additionalProperties": true
    },
    "message": {
      "type": "string",
      "description": "Present only alongside code -- a human-readable reason the query failed."
    }
  },
  "description": "The discovery result, as returned at routing.responseResultPath ($.output). A query the AI cannot resolve into search filters settles as {code, message} instead of {data, meta} (see examples/zzq-empty-result.json) -- no field below is guaranteed present.",
  "additionalProperties": true
}