Social Actions Tuner API
The Social Actions Tuner API is built around POST requests to http://satunerapi.preludeinteractive.com/filter.php. The API takes one POST parameter, 'data', which is JSON. In some cases you will need to URL-encode, add slashes, or UTF-8 encode social actions data. These are two request types and four formats:
Training Request
http://satunerapi.preludeinteractive.com/training_json.json. For now, these are static:
- version
- domain
- content_type
- input_type
- output_type
'examples' is an array of Social Actions, with additional 'id' and 'output' parameters.
- 'id' is some unique identifier so your app can tell the difference between actions that are being trained/classified if necessary. The tuner API doesn't care about 'id' but it should be present for later features.
- 'output' indicates with 'yes' or 'no' whether or not the action is a positive or negative example.
'training_state' is optional. For the first training request, it can be empty. For following training requests, it should include the returned training state from the API.
Training Response
http://satunerapi.preludeinteractive.com/training_state.json. Note the inclusion of 'training_state', which you should store in your app for later training and classifying.
Filter Request
http://satunerapi.preludeinteractive.com/classify_example.json. This request includes unclassified social actions and the training state.
Filter Response
http://satunerapi.preludeinteractive.com/sorted_actions.json. This response contains the unique IDs of the social actions (as generated by your app), and a floating point score for each. Currently the results are sorted (closeness descending).