• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • Stop wasting time looking for files and revisions. Connect your Gmail, DriveDropbox, and Slack accounts and in less than 2 minutes, Dokkio will automatically organize all your file attachments. Learn more and claim your free account.


Rate Limits

Page history last edited by Brandon Geiger 11 years ago

<< Back to Swarm API Documentation


Rate limiting

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.


Consumer Key

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



See Code Samples



Membership Options

CPHs are regulated by your membership level. Below is the breakdown of memberships and CPHs:


  • No membership:              100 CPH
  • Basic membership:           200 CPH
  • Premium membership:     1,000 CPH
  • Exclusive membership:     2,000 CPH


To get started with a membership, apply for a consumer key.



<< Back to Swarm API Documentation






Comments (0)

You don't have permission to comment on this page.