Want to know if a person is happier, warmer, colder or more impulsive than they normally are?

Good news – we’ve got you covered: Receptiviti enables you to establish a baseline for a person on any (or all) Receptiviti scores and compare their emotion and mental state at any point in time to their baseline. It can be done for one person or for as many people as you like. Here’s how:

Establish their baseline:

The baseline will change somewhat over time inline with what that person is experiencing and expressing, and this is normal. Deviations will become smaller over time as the amount of data that comprises the baseline increases.

1. Create a person

Create a person using the following command, where the name is John, gender is male (1) and we’re using the name as the person_handle:-

curl -v -X POST https://app.receptiviti.com/api/person -H ‘Content-Type: application/json’ -H ‘X-API-KEY: <your key>’ -H ‘X-API-SECRET-KEY: <your secret key>’ –data-binary ‘{“name”: “John”, “person_handle”: “John”, “gender”: 1}’

The response will be a JSON object. Copy the ‘_id’ field. This person id is used to uniquely identify this particular person. For the remaining examples we’ll use 5772b875b0f6f460c6995de1 as the person id

2. Submit content

Submit dated piece(s) of content for this person, using the person id from step 1:-

curl -v -X POST https://app.receptiviti.com/api/person/5772bb36b0f6f45f36f55ba7/contents -H ‘Content-Type: application/json’ -H ‘X-API-KEY: <your key>’ -H ‘X-API-SECRET-KEY: <your secret key>’ –data-binary ‘{“content_source”: 1, “content_date”: “2016-06-10”, “language_content”: “This is a very long piece of content that we want to analyse. We will save this at this time, then add more data at other times so that we can detect changes over time”}’

The response will be a JSON object containing the LIWC scores, the Receptiviti scores and a personality snapshot.

Repeat step 2 with additional content for John, each added with the date on which it was generated (not the date it was submitted to Receptiviti)

Compare any point-in-time to their baseline:

To determine whether their emotion or psychology at any moment in time is different than their baseline, compare their scores at that time to their baseline score using the data filter:

3. Use data filter to specify date range

Get a profile snapshot for John using the data filter to restrict the result to content within a particular date range. The date range is specified using the content_from_date and content_to_date query parameters:-

curl -v -X GET ‘https://app.receptiviti.com/api/person/5772bb36b0f6f45f36f55ba7/profile?content_from_date=2016-06-01&content_to_date=2016-06-15’ -H ‘X-API-KEY: <your key>’ -H ‘X-API-SECRET-KEY: <your secret key>’

The response will be a JSON object containing the LIWC scores, the Receptiviti scores and a personality snapshot.

That’s it – it’s that easy!

All our sample code is posted on github.

We’d love to hear how you’re using Receptiviti. Hit us up on Twitter and let us know!

Have questions? Get in touch.