social
insight

Retrieve an insight

get/social/{connection_id}/insight/{id}

Request

  • Base URL: http://api.unified.to
  • URL: http://api.unified.to/social/{connection_id}/insight/{id}
  • Auth: API key in header authorization

Path parameters

connection_idstring required

ID of the connection

idstring required

ID of the Insight

Query parameters

fieldsstring[]

Fields to return

rawstring

Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar

Response

Successful

idstring

Unique identifier for the insight data point

created_atstring date-time

When the insight was recorded (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

profile_idstring

The social profile these stats belong to

post_idstring

Optional: the post these stats belong to

datestring date-time

The day/timestamp of the data point

period'DAY' | 'WEEK' | 'MONTH' | 'LIFETIME' | 'TOTAL' | 'OTHER'

The aggregation period of the value

metric'FOLLOWERS' | 'FOLLOWING' | 'POSTS' | 'IMPRESSIONS' | 'REACH' | 'ENGAGEMENT' | 'PROFILE_VIEWS' | 'CLICKS' | 'VIDEO_VIEWS' | 'LIKES' | 'COMMENTS' | 'SHARES' | 'SAVES' | 'OTHER'

The metric being reported

valuenumber

The metric value

rawunknown

Changes

No recorded changes to this operation across all 1 revision of this API.