Topic

Topics have one of 4 styles: Question, Idea, Problem, and "Talk". They form the basis of all communication that takes place in Get Satisfaction. In the Get Satisfaction API, topics are represented as an Atom feed, with at least 1 entry. This first entry of a topic feed is the content for the topic itself. Every entry after the first is a reply to the original topic. For detailed information, please refer to the annotated sample feed below:

Posting Topics

To create a topic on Get Satisfaction, you will post to https://api.getsatisfaction.com/topics with a series of required and optional parameters that will be form-encoded. You can look at https://api.getsatisfaction.com/topics/new to see a mock HTML form that describes the parameters that are available.

The required parameters include:

topic[company_id]

The Get Satisfaction specific record ID of the company that you are posting this topic to. The is the <span class="id" /> tag in a company hcard. Use either this option or topic[company_domain] to set the company, but not both.

topic[company_domain]

An alternative to using topic[company_id], company_domain allows you to specify the owning company of topic using its name. The companies domain is the first element of the URL path in the main Get Satisfaction API: For example, twitter's address on Get satisfaction is https://getsatisfaction.com/twitter, and its domain is 'twitter', whereas I want sandy's domain is 'iwantsandy'

topic[style]

Specifies the topic's style: either question, idea, problem, or answer.

topic[subject]

The single-sentence summary of a topic that shows up in topic listings.

topic[additional_detail]

A full description of the topic.

The optional parameters include:

topic[keywords]

A comma-separated list of tags that are to be associated with topic

topic[products]

A comma-separated list of product names that should be associated with this topic

topic[emotitag][face]

A value that describes the emoticon face to attach to this topic: one of happy, sad, indifferent, or silly.

topic[emotitag][feeling]

A word or two describing in more detail how you are feeling. Examples include anxious, thankful, or frustrated.

topic[emotitag][intensity]

A rating of 0-3 that describes the intensity of how you are feeling, 3 being the most intense, 0 being the baseline.