---
title: "Find companies by user need through query parameters"
method: GET
path: "/api/agent/search"
---

# Find companies by user need through query parameters

`GET /api/agent/search`

## Request

- Base URL: `https://agentready.ch`
- URL: `https://agentready.ch/api/agent/search`
- Auth: none declared

## Query parameters

- `need` string, required
- `location` string
- `language` string
- `action` string
- `category` string
- `limit` integer

## Response `200`

Ranked matches with fit score, why, next best action and available functions.

---

[API](https://skmtc.dev/agentready/apis/agentready-ch-agent-action-api.md) · [All operations](https://skmtc.dev/agentready/apis/agentready-ch-agent-action-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentready/apis/agentready-ch-agent-action-api/revisions/7b7fad548fc7?raw)