question

Upvote
Accepted
Catherine Wong avatar image
154 ●15 ●20 ●32

Entitiy Search API HTTP status code

I am using the Entitiy Search API. What HTTP status code is returned if I issue a request but the daily limit of my access token has been reached?

permid-apiintelligent-tagging-apiopen-permid-apihttpentitystatus
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

1 Answer

Upvotes
Accepted
Steven McCoy avatar image
1.2k ●23 ●30 ●44

HTTP/429 is used for both exceeding ones permitted request rate and for exceeding the daily permitted request count.

HTTP/503 is also noteworthy here for when the server has reached capacity and is unable to fulfil the request.

One would have to parse the response text to determine which limit is breached.

The OpenCalais User Guide §1.3 states the account limits start at 0.5-1 per second, 5,000 per day, and 100KB maximum article size.

icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

andy avatar image andy

Thank for the reply. What is the permitted request rate in this case?

Steven McCoy avatar image Steven McCoy andy

@andy it would have been provided alongside your credentials and daily quota. Note that requests exceeding the request rate will count against the daily quota and thus the client should be designed to throttle itself.

andy avatar image andy Steven McCoy

I see that I must wait 750 milliseconds in between each request now. I was not told explicitly what my daily quota is, but having read the documentation is it 5000 per day?

Show more comments