<< Back to Swarm API Documentation

Description:

Allows you to get the wall of a swarm. The wall for a swarm has all of the current activity in that swarm in chronological order.

URL:

http://api.swarmforce.com/<version>/GetWallBySwarm/

Return Formats: 

JSON

HTTP Method(s):

POST

API rate limited (about rate limiting):

1 call per request

Parameters:

• swarm_id.  Required.  Specifies the ID of the swarm whose tweets you are trying to access. 
  • Example: 1026 (the id for the Social Revolution swarm)
• count.  Optional.  Specifies the number of wall items to retrieve for the given call. Current maximum is 100.
• page. Optional. Specifies the page of results to retrieve.
• consumer_key. Optional. Specifies your application's consumer key. Does not count an API request against your IP address. Apply for one now.
• format. Optional. Specifies the requested return format. Current the only supported return format is JSON.

Response (about return values): 

          JSON Object (truncated):

     {

[

     {

          "date":"2009-06-03 12:58:59",

          "display_date":"June 3rd",

          "public_id":"182336EQWDbghIOS8ja4",

          "karma":"87.723",

          "public_link":"http://www.swarmforce.com/profile/?id=182336EQWDbghIOS8ja4",

          "event":"karma hit threshold",

          "html":"<div class='wallText'><a href='/profile/?id=182336EQWDbghIOS8ja4'>Brandon Geiger's</a> karma just hit 100</div></div>",

          "html_image":"<div class='wallImage'><img src='http://www.swarmforce.com/_images/user_generated/users/182336EQWDbghIOS8ja4/main/bvQ8V2N5Jahu.png' /></div>"

    }

]

}

Usage examples:   

See Code Samples

Do you have an example to share in the language of your choice? Please share!

<< Back to Swarm API Documentation