---
title: "Find companies by user need, location, language and desired action"
method: POST
path: "/api/agent/search"
---

# Find companies by user need, location, language and desired action

`POST /api/agent/search`

## Request

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

## Request body

- object
  - `user_need` string, required
  - `location` string
  - `language` string
  - `desired_action` string: Examples: book_call, request_rate, request_quote, callback, ask_question.
  - `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)