Tools Search - UseAgents Documentation

Search the UseAgents tool directory using natural language. The endpoint returns ranked tools with metadata such as descriptions, supported languages, frameworks, and categories.

This endpoint requires authentication. Include your API key in the Authorization header.

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
`updatedAt`	string \| null	ISO timestamp when the tool was last updated

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",
      "updatedAt": "2026-07-23T12:00:00.000Z"
    }
  ]
}

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

​Endpoint

​Query parameters

​Response

​Example request

​Example response

​Query writing tips

​Use this endpoint when

Endpoint

Query parameters

Response

Example request

Example response

Query writing tips

Use this endpoint when