<< Back to Swarm API Documentation
The Swarm API only allows clients to make a limited number of calls in a given hour. The amount of calls you can make in a given hour is referred to as your "CPH" - "Calls per hour." The default CPH for requests with no consumer key designated is 100.
A consumer key is a token that applications consuming swarm data can use to increase their CPH. If you are consistently hitting the limit for your CPH, consider applying for a consumer key. The Basic membership is FREE, and allows you 200 CPH. You can request a consumer key here.
To specify a consumer key when making a request, declare a parameter of "consumer_key" in your request (php example):
//set arguments
$args=array("swarm_id"=>1058,"count"=>10,"format"=>"JSON","consumer_key"=>"3y5haZB7SSA2E65DhGU7IUZNjHdyKFb");
CPHs are regulated by your membership level. Below is the breakdown of memberships and CPHs:
To get started with a membership, apply for a consumer key.
<< Back to Swarm API Documentation