Introduction

​

Base URL

The Usertour API is built on REST principles. We enforce HTTPS in every request to improve data security, integrity, and privacy. The API does not support HTTP.

All requests contain the following base URL:

https://api.usertour.io

​

Authentication

To authenticate you need to add an Authorization header with the contents of the header being Bearer ak_123456789 where ak_123456789 is your API Key.

Authorization: Bearer ak_123456789

​

Response codes

Usertour uses standard HTTP codes to indicate the success or failure of your requests.

In general, 2xx HTTP codes correspond to success, 4xx codes are for user-related failures, and 5xx codes are for infrastructure issues.

​

Rate limit

The API implements two protection mechanisms to ensure service stability:

1. Request Rate Limiter

   • Enforces per-account request limits per minute
   • Rate limits vary based on your subscription plan (see Pricing)
   • Exceeding the limit returns HTTP 429 (Too Many Requests)

2. Concurrency Limiter

   • Controls simultaneous active requests
   • Implements request queuing when at high capacity
   • Queue timeout: 15 seconds
   • Returns HTTP 503 (Service Unavailable) if queued too long
   • Note: This is a rare occurrence as we maintain sufficient capacity to minimize queuing