Introduction - UseAgents Documentation

The UseAgents API lets you search the tool registry and build integrations around UseAgents data. Start here to understand the base URL, authentication model, response behavior, and supporting reference pages.

Base URL

The UseAgents API is HTTPS-only and follows standard REST patterns. All requests use the following base URL:

https://api.useagents.site

The UseAgents API is currently free during our public beta. No API key is required. Requests are subject to rate limits to ensure reliability.

Authentication

Protected endpoints require an Authorization header with your API key as a Bearer token.

Authorization: Bearer YOUR_API_KEY

Learn more about Authentication.

Response codes

UseAgents uses standard HTTP status codes. In general:

2xx means the request succeeded
4xx means the request was invalid, unauthorized, or rate limited
5xx means the request failed due to a server-side issue

Status	Description
`200`	Successful request.
`400`	Bad request. Check that the parameters were correct.
`401`	The API key was missing.
`403`	The API key was invalid.
`404`	The resource was not found.
`422`	Validation error with one or more fields.
`429`	The rate limit was exceeded.
`5xx`	Indicates an error with UseAgents servers.

Check Errors for a full breakdown of common failure cases.

Rate limits

Authenticated endpoints are rate limited to protect service stability and ensure fair usage. If you exceed the allowed rate, the API returns 429 Too Many Requests. Learn more on the Rate Limits page.

Versioning

UseAgents aims to keep existing integrations stable as the API evolves. Learn more on the Versioning page.

Next steps

Authentication to add the correct headers
Tools Search for the main search endpoint
Errors to troubleshoot failed requests

​Base URL

​Authentication

​Response codes

​Rate limits

​Versioning

​Next steps

Base URL

Authentication

Response codes

Rate limits

Versioning

Next steps