Crm · Social posts
Get social post
Gets a social post by organization ID and post ID, including each account's publication result and any collected statistics. The response includes signed media URLs. Set includeMediaMetadata to true to request media sizes; it defaults to false.
Permissions
Send an API key of the organization in the path, using the X-API-Key header.
Who may call it
- Organization access and the
social.readpermission are required.
Request
Path parameters
-
organizationIdidrequired -
postIdidrequired
Query parameters
-
includeMediaMetadatabooleandefault
false
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
--request GET 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/crm/communication/socialPosts/YOUR_POST_ID' \
--header 'X-API-Key: YOUR_API_KEY'const response = await fetch("https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/crm/communication/socialPosts/YOUR_POST_ID", {
method: "GET",
headers: {
"X-API-Key": "YOUR_API_KEY"
},
redirect: 'error',
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) throw new Error(`campai HTTP ${response.status}`);
const text = await response.text();
const result = text ? JSON.parse(text) : null;
console.log(JSON.stringify(result, null, 2));<?php
$context = stream_context_create(['http' => [
'method' => 'GET',
'header' => [
'X-API-Key: YOUR_API_KEY',
],
'timeout' => 30,
'follow_location' => 0,
'ignore_errors' => true,
]]);
$text = @file_get_contents('https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/crm/communication/socialPosts/YOUR_POST_ID', false, $context);
preg_match('/^HTTP\/\S+ (\d{3})/', $http_response_header[0] ?? '', $match);
$status = (int) ($match[1] ?? 0);
if ($text === false || $status < 200 || $status >= 300) {
throw new RuntimeException("campai HTTP $status (0 means no response)");
}
$result = $text === '' ? null : json_decode($text, true, 512, JSON_THROW_ON_ERROR);
echo json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
Response
200 Successful response
Content-Type: application/json
-
statusstringscheduledpendingpublishingprocessingpublishedpartiallyPublishedfailedunconfirmed -
scheduledAtstring · date-timenullable -
publicationDatestring · date-time -
postIdid -
textstring -
mediaCountintegerat least 0
-
deliveriesobject[]13 properties
-
statusstringpendingpublishingprocessingpublishedfailedunconfirmed -
urlstringnullable -
errorDetailsobjectnullable6 properties
-
categorystringauthenticationpermissionvalidationrateLimittemporaryunknown -
actionstringreconnectreviewPermissionseditPostretryLatercheckPlatformcontactSupport -
codestringnullable -
reasonstringnullable26 values
apiQuotayoutubeUploadLimitvideoDurationmediaFormatinvalidMediavideoFrameRatemediaDimensionsmediaDownloaduploadAbortedmediaDomainprivacySettingpostingLimitaccountRestrictedduplicateVideocontentRightscontentPolicyverifyEmailmediaTypeemptyPostunconfirmedplatformRejectedwordpressNotPublishedcontainerFailedyoutubeFailedfacebookFailedtiktokFailed -
stagestringpreflightuploadpublishpoll -
occurredAtstring · date-time
-
-
publishedAtstring · date-timenullable -
accountIdid -
canRetryboolean -
canCheckboolean -
canRepublishboolean -
canDismissboolean -
textstringnullable -
mediaobject[]nullable5 properties
-
resourcestringat least 1 characters
-
mimeTypestringat least 1 characters
-
kindstringimagevideo -
urlstring -
sizenumbernullable
-
-
settingsobject8 properties
-
titlestringnullable -
boardIdstringnullable -
privacystringnullable -
disableCommentboolean -
disableDuetboolean -
disableStitchboolean -
brandContentboolean -
brandOrganicboolean
-
-
statisticsobjectnullabledeliveries[].statisticsis null when there is no statistics record for the account.5 properties
-
statusstringpendingavailablemissingPermissionnotFoundunsupportedfailed -
metricsobject7 properties
-
viewsintegernullableat least 0
-
reachintegernullableat least 0
-
likesintegernullableat least 0
-
commentsintegernullableat least 0
-
sharesintegernullableat least 0
-
savesintegernullableat least 0
-
clicksintegernullableat least 0
-
-
fetchedAtstring · date-timenullable -
refreshableAtstring · date-timenullabledeliveries[].statistics.refreshableAtis null when statistics cannot be refreshed manually. -
refreshingboolean
-
-
-
mediaobject[]5 properties
-
resourcestringat least 1 characters
-
mimeTypestringat least 1 characters
-
kindstringimagevideo -
urlstring -
sizenumbernullablemedia[].sizeanddeliveries[].media[].sizeare null when media metadata is not requested, the metadata lookup fails, or it has no content length.
-
{
"status": "scheduled",
"scheduledAt": "2026-06-15T22:30:00Z",
"publicationDate": "2026-06-15T22:30:00Z",
"postId": "000000000000000000000001",
"text": "string",
"mediaCount": 0,
"deliveries": [
{
"status": "pending",
"url": "string",
"errorDetails": {
"category": "authentication",
"action": "reconnect",
"code": "string",
"reason": "apiQuota",
"stage": "preflight",
"occurredAt": "2026-06-15T22:30:00Z"
},
"publishedAt": "2026-06-15T22:30:00Z",
"accountId": "000000000000000000000001",
"canRetry": true,
"canCheck": true,
"canRepublish": true,
"canDismiss": true,
"text": "string",
"media": [
{
"resource": "string",
"mimeType": "string",
"kind": "image",
"url": "string",
"size": 1
}
],
"settings": {
"title": "string",
"boardId": "string",
"privacy": "string",
"disableComment": true,
"disableDuet": true,
"disableStitch": true,
"brandContent": true,
"brandOrganic": true
},
"statistics": {
"status": "pending",
"metrics": {
"views": 0,
"reach": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"clicks": 0
},
"fetchedAt": "2026-06-15T22:30:00Z",
"refreshableAt": "2026-06-15T22:30:00Z",
"refreshing": true
}
}
],
"media": [
{
"resource": "string",
"mimeType": "string",
"kind": "image",
"url": "string",
"size": 1
}
]
}
Errors
Other errors
| Status | Error | When |
|---|---|---|
| 404 | No fixed message | Returns HTTP 404 if the post is not found in the organization. |
Errors nearly every request can meet are listed under Errors.