Social Posts

The following endpoint can be used to retrieve information about posts that were sent to social media.

List by Post Id

Example Request

https://api.oktopost.com/v2/postlog?postId=004000000000001

Example Result

{
	"Result": true,
	"Postlogs": [
		{
			"Id": "007000000000001",
			"PostId": "004000000000001",
			"CampaignId": "002000000000001",
			"MessageId": "005000000000001",
			"CredentialId": "003-001000000000001-12345678",
			"LinkId": "008000000000001", // deprecated
			"LinkIds": [...],
			"Created": "2017-05-02 10:29:04",
			"Modified": "2017-05-07 02:58:18",
			"Status": "success",
			"Network": "Twitter",
			"RemoteId": "xxxx",
			"RemoteUrl": "http://twitter.com/Oktopost/status/xxxx",
			"Error": ""
		}
	]
}

Get Single Social Post

Example Request

https://api.oktopost.com/v2/postlog/007000000000001

Example Result

{
	"Result": true,
	"Postlog": {
		"Id": "007000000000001",
		"PostId": "004000000000001",
		"CampaignId": "002000000000001",
		"MessageId": "005000000000001",
		"CredentialId": "003-001000000000001-12345678",
		"LinkId": "008000000000001", // deprecated
		"LinkIds": [...],
		"Created": "2017-05-02 10:29:04",
		"Modified": "2017-05-07 02:58:18",
		"Status": "success",
		"Network": "Twitter",
		"RemoteId": "xxxx",
		"RemoteUrl": "http://twitter.com/Oktopost/status/xxxx",
		"Error": ""
	}
}

Get Social Post Stats

To get updated stats per social post, add stats=1 to the query parameters, like so:

https://api.oktopost.com/v2/postlog/007000000000001?stats=1

This will result in:

{
	"Result": true,
	"Postlog": {
		"Id": "007000000000001",
		"PostId": "004000000000001",
		"CampaignId": "002000000000001",
		"MessageId": "005000000000001",
		"CredentialId": "003-001000000000001-12345678",
		"LinkId": "008000000000001", // deprecated
		"LinkIds": [...],
		"Created": "2017-05-02 10:29:04",
		"Modified": "2017-05-07 02:58:18",
		"Status": "success",
		"Network": "Twitter",
		"RemoteId": "xxxx",
		"RemoteUrl": "http://twitter.com/Oktopost/status/xxxx",
		"Error": ""
	},
	"Stats": {
		"LinkClicks": 4,
		"Conversions": 1,
		"Comments": 1,
		"Likes": 1,
		"Shares": 0,
		"ImpressionsAdded": 69,
		"MediaClicksAdded": 0,
		"DetailExpandsAdded": 0,
		"UserFollowsAdded": 0
	}
}

Feedback and Knowledge Base