Ambassador

The Ambassador Developer Hub

Welcome to the Ambassador developer hub. You'll find comprehensive guides and documentation to help you start working with Ambassador as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Rate Limits

Ambassador closely monitors usage of its APIs to ensure a quality experience for users of the Ambassador platform. Below, you'll find the limits by which a company can consume the Ambassador API.

Method
Requests per minute

ambassador/all

30

ambassador/get

30

event/record

30

company/stats

10

ambassador/stats

10

All other methods

60

Tips to minimize API requests

The tips below are there to help you code defensively and reduce the possibility of being rate limited.

Batch Processing

If you need to make a lot of requests, please consider running a batch process that calls the Ambassador API at scheduled intervals or off-peak hours.

Caching

Store API responses in your application or on your site if you expect a lot of use. For example, don’t try to call the Ambassador API on every page load of your website landing page. Instead, call the API infrequently and load the response into a local cache. When users hit your website load the cached version of the results.

Webhooks

Instead of polling the Ambassador API to retrieve information, you can be notified via an HTTP request of specific activity in the Ambassador platform. For more information, please read our Webhooks documentation.