## Getting Started

- [Introduction](/content/docs/api-reference/introduction/index.html)
- [Authentication](/content/docs/api-reference/authentication/index.html)
- [Errors](/content/docs/api-reference/errors/index.html)
- [Rate Limits](/content/docs/api-reference/rate-limit/index.html)
- [Versioning](/content/docs/api-reference/versioning/index.html)

## Endpoints

- Tools

## Endpoint

```
GET /tools/search
```

Base URL:

```
https://api.useagents.site
```

## Query parameters

| Parameter | Type   | Required | Description                                                   |
|-----------|--------|----------|---------------------------------------------------------------|
| `q`      | string | Yes      | Natural-language query. Searches across tool names, descriptions, tags, languages, and categories. |

## Response

The response contains a `results` array. Each result includes:

| Field            | Type   | Description                                                              |
|------------------|--------|--------------------------------------------------------------------------|
| `id`             | string | Unique identifier for the tool                                          |
| `name`           | string | Tool name                                                             |
| `description`    | string | Full description                                                      |
| `shortDescription`| string | Brief summary                                                         |
| `languages`      | string[] | Supported languages (for example `TypeScript`)                         |
| `frameworks`     | string[] | Supported frameworks                                                   |
| `categories`      | string[] | Categories such as `Authentication` or `CLI`                         |
| `slug`           | string | URL-friendly identifier for the tool                                   |
| `image`          | string | Tool image URL                                                        |

## Example request

```
curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.useagents.site/tools/search?q=authentication%20library%20for%20Node.js"
```

## Example response

```
{
  "results": [
    {
      "id": "tool_abc123",
      "name": "Example Auth SDK",
      "description": "A TypeScript authentication library for Node.js applications.",
      "shortDescription": "Auth SDK for Node.js",
      "languages": ["TypeScript", "JavaScript"],
      "frameworks": ["Express", "Next.js"],
      "categories": ["Authentication", "SDK"],
      "slug": "example-auth-sdk",
      "image": "https://..."
    }
  ]
}
```

## Query writing tips

- Describe the job to be done, not just a package name.
- Include the language, framework, or platform when it matters.
- Include constraints such as `CLI`, `self-hosted`, or `webhooks` if they affect tool choice.

## Use this endpoint when

- Discover tools by natural-language query
- Get accurate metadata for ranking, filtering, or selection
- Build tool discovery UIs or agent integrations.