Developer Documentation

People lists are represented as an XHTML unordered list of hCards.

Available people list resources

/people

All of the people in get satisfaction

/companies/XXXXX/people

All of the people who have participated in a given company Example call that represents all of the people that have been to apple's get satisfaction site:
https://api.getsatisfaction.com/companies/apple/people

/companies/XXXXX/employees

All of the people who are employees of a given company Example call that represents all of the employess of Get Satisfaction: https://api.getsatisfaction.com/companies/satisfaction/employees

/topics/XXXXX/people

All of the people participating in a topic Example call that shows who has posted in Topic 256: https://api.getsatisfaction.com/topics/256/people

Available query parameters for product lists

limit

used to specify the number of items that will appear within a single page of results for the feed. 30 is the max

page

Scroll the page X of the people list. Pair it with limit. Example call to show items 15-30 of the people list: https://api.getsatisfaction.com/people?limit=15&page;=2

query

q

full text search for people using query. please note that this disables the sort parameter Example call searching for "scott": https://api.getsatisfaction.com/people?q=scott

Sample xhtml response for a people list

<title>People in Satisfaction</title>  
  
<h1>People</h1>  
<ul>  
  <li>  
    <div class="vcard person">  
      <a href="https://localhost:3000/people/167761" class="fn nickname url">Mr.B</a>    
      <span class="note">the more you learn the less you know</span>  
      <span class="canonical_name">mrb</span>  
    </div>  
  </li>  
  
  <li><div class="vcard person">...</div></li>  
  <li><div class="vcard person">...</div></li>  
  <li><div class="vcard person">...</div></li>  
</ul>  
<a href="https://localhost:3000/people?page=1" rel="self">self</a>  
<a href="https://localhost:3000/people?page=1" rel="first">first</a>  
<a href="https://localhost:3000/people?page=2" rel="next">next</a>  
<a href="https://localhost:3000/people?page=568" rel="last">last</a>  

• Follow us on Twitter
• Visit us on Facebook
• Read our Blog
• Get Satisfaction.tv