Base URL
The UseAgents API is HTTPS-only and follows standard REST patterns. All requests use the following base URL:Authentication
Protected endpoints require anAuthorization header with your API key as a Bearer token.
Response codes
UseAgents uses standard HTTP status codes. In general:2xxmeans the request succeeded4xxmeans the request was invalid, unauthorized, or rate limited5xxmeans 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 returns429 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