Discover companies

{
  "operationId": "companies_discover",
  "method": "post",
  "path": "/companies/discover",
  "summary": "Discover companies",
  "description": "Find companies matching a set of criteria. Pass either a natural-language `query` or structured `filters` (industry, headcount, location, technology, funding, keywords, …). Returns paginated company summaries.",
  "parameters": [],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/CompaniesDiscoverRequest"
        },
        "example": {
          "query": "Series A B2B SaaS companies in Europe under 50 employees",
          "limit": 25
        }
      }
    }
  },
  "responses": [
    {
      "statusCode": "200",
      "description": "Discovery results.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "success",
              "data"
            ],
            "properties": {
              "success": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "data": {
                "$ref": "#/components/schemas/CompaniesDiscoverResponse"
              },
              "meta": {
                "$ref": "#/components/schemas/AgntMeta"
              }
            }
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Validation error."
    },
    {
      "statusCode": "401",
      "description": "Unauthorized."
    }
  ]
}