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",
            "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",
        "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",
        "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