Topic Lists

Different methods to access topic lists

As with other resources in satisfaction, there are many ways to slice, dice, filter, sort, and page topic data. In general, the API uses different resources to segment the data, such as /companies/satisfaction/topics which represents all of the topics posted to getsatisfaction. Additionally, you can pass any number of query parameters to additionally filter or sort a given list of topics.

Available topic list resources

/topics

All of the topics in satisfaction

/flagged/topics

Every topic with atleast 1 abuse or spam flag, sorted by most flagged topics first

/companies/XXXXX/topics

All of the topics posted to a company

Example call that represents all of the topics in iwantsandy: http://api.getsatisfaction.com/companies/iwantsandy/topics

/people/XXXXX/topics

All of the topics posted by a person

Example call that represents all of the topics that I have created: http://api.getsatisfaction.com/people/scott/topics

/people/XXXXX/followed/topics

All of the topics followed by a person

Example call that represents all of the topics that I am currently following: http://api.getsatisfaction.com/people/scott/followed/topics/topics

/products/XXXXX/topics

All of the topics that are about a product

Example call that represents all of the topics are about an apple iBook: http://api.getsatisfaction.com/products/apple_ibook/topics

/tags/XXXXX/topics

All of the topics tagged with a given tag

Example call that represents all of the topics tagged with 'bug': http://api.getsatisfaction.com/tags/bug/topics

Available query parameters for topic 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 topic list. Pair it with limit.

Example call to show items 30-45 of the topics in the twitter community: http://api.getsatisfaction.com/companies/twitter/topics?limit=15&page=3

query

q

full text search for topics using query. please note that this disabled other options besides page and limit

Example call searching for "My twitter stream is missing updates": http://api.getsatisfaction.com/topics?q=My+twitter+stream+is+missing+updates

sort

Sorts the list of topics returned. Go figure. Available options include:

recently_created

Sorts by the topics most recently created first

recently_active

Sorts by the topics most recently posted to or marked by someone who also has the problem/question/idea

first.

most_flagged

Topics with the most spam or abuse flags are first

most_me_toos

Topics with the most people who also have the problem/question/idea first

unanswered

Only show topics with no replies

Example call to show the most popular topics first in the twitter community: http://api.getsatisfaction.com/companies/twitter/topics?sort=most_me_toos

style

Filter topics by style: options are question, idea, problem, and talk,

Example call to show only questions: http://api.getsatisfaction.com/topics?style=question

Sample atom response for a topic feed