Getting Started

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.