Rate limits and authentication | OpenAlex technical documentation (original) (raw)

The API is rate-limited. The limits are:

If you hit the API more than 100k times in a day or more than 10 in a second, you'll get 429 errors instead of useful data.

Are those rate limits too low for you? No problem! We can raise those limits as high as you need if you subscribe to . And if you're an academic researcher we can likely do it for free; just drop us a line at .

Are you scrolling through a list of entities, calling the API for each? You can go way faster by squishing 50 requests into one using our . Here's showing how.

The OpenAlex API doesn't require authentication. However, it is helpful for us to know who's behind each API call, for two reasons:

Like Crossref (whose approach we are shamelessly stealing), we prefer carrots to sticks for this. So, depending on your preferences, you'll be in one of two API pools:

The polite pool has much faster and more consistent response times. It's a good place to be.

To get into the polite pool, you just have to give us an email where we can contact you. You can give us this email in one of two ways:

Calling the API in your browser

Because the API is all GET requests without fancy authentication, you can view any request in your browser. This is a very useful and pleasant way to explore the API and debug scripts; we use it all the time.

The common pool has slower and less consistent response times. It's a less good place to be. We encourage everyone to get in the polite pool

However, this is much nicer if you install an extension to pretty-print the JSON; and are popular, free choices. Here's what an API response looks like with one of these extensions enabled: