Get CSV Post
Get details of a specific CSV import including its posts
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
socialplanner/ csv. readonlyOAuthPrivate IntegrationSub-Account TokenRequest
Headers
API Version
v3v3Path Parameters
Location Id
ve9EPM428h8vShlRW1KTCSV Id
65f92e55cc884f0d0845e447Query Parameters
Number of records to skip
0Maximum number of records to return
10Response
Successful response
Success or Failure
trueStatus Code
200Message
Fetched CSV PostRequested Results
CSV Data
CSV Id
ve9EPM428h8vShlRW1KTLocation Id
iVrVJ2uoXNF0wzcBzgl5File Name
sample.csvAccount Ids
["aF3KhyL8JIuBwzK3m7Ly_iVrVJ2uoXNF0wzcBzgl5_12554616564525983496"]File path
omaDY3RbWtTP511e/social-import/d23d68c2-82c0-1db6e2.csvCSV import status
pendingin_progresscompletedfailedin_reviewimportingdeletedcompletedPosts count
5Created By Id
SDsdfdf45Dgs4w3ssssTrace ID for debugging
FSeSDsdfdf45Dgs4w3ssssOrigin Id
FSeSDsdfdf45Dgs4w3ssssApprover Id
FSeSDsdfdf45Dgs4w3ssssDate Created
2023-08-02T00:00:00.000ZCSV file type
basicadvancebasicMedia optimization flag
trueApply watermark flag
falseChannel
oauthDate Updated
2023-08-02T00:00:00.000ZTotal count of posts in CSV
6CSV Posts
Account Ids
["aF3KhyL8JIuBwzK3m7Ly_iVrVJ2uoXNF0wzcBzgl5_12554616564525983496"]OG Tag
Tag url
https://knowledge.wharton.upenn.edu/article/impact-of-social-media/Tag description
Social media as we know it has barelyOG Image data
Image url
https://knowledge.wharton.upenn.edu/wp-content/uploads/2019/07/072619_socialmedia_phonelikes-600x440.jpgImage width
400Image height
400Image Type
image/jpgTag Title
The Impact of Social Media: Is it Irreplaceable?Tag Url
https://knowledge.wharton.upenn.edu/article/impact-of-social-media/Site Name
Knowledge at WhartonOg Tag Error
InvalidLinkPost Media List
Media Url
https://storage.googleapis.com/storage-test/omaDY3RbWtTP511e808O/media/38e53059-b92706571605.pngMedia Type
image/webpMedia Size
18362Media Width
500Media Height
500Media Aspect Ratio
1.5Media Aspect Ratio
60Media format
jpgVideo Codec
h264Video Frame Rate
21Audio Codec
aacAudio Channel
1Display Aspect Ratio
250 : 167Rotation
-90List of frames
["https://storage.googleapis.com/storage-test/frame1.jpg","https://storage.googleapis.com/storage-test/frame2.jpg"]Selected Poster
0Error
Image is larger than 10MBAlt text for accessibility. Supported on Instagram (1000), Threads (1000), Pinterest (500), Bluesky (2000), LinkedIn (4086). Limit varies by platform.
A sunset over the ocean with silhouetted palm treesInstagram media error. It can be one of the following errors: imageSize, imageType, videoType, videoDuration, videoSize, videoAspectRatio, videoWidthHeight, audioCodec, audioCodecChannels, videoCodec, videoFrameRate
imageSizeGMB media error. It can be one of the following errors: imageSize, imageDimension, imageType
imageDimensionFacebook media error. It can be one of the following errors: imageSize, imageType, videoDuration, videoSize
videoDurationLinkedIn media error. It can be one of the following errors: imageSize, imageType, videoType, videoDuration, videoSize
imageTypeTiktok media error. It can be one of the following errors: videoType, videoDuration, videoSize, videoWidthHeight, videoCodec, videoFrameRate
videoFrameRateTikok Business media error. It can be one of the following errors: videoType, videoDuration, videoSize, videoWidthHeight, videoCodec, videoFrameRate
videoTypeMedia error. It can be one of the following values: imageSize, imageWidth
imageSizePinterest media error. It can be one of the following errors: imageType, imageSize, videoType, videoDuration, videoSize, videoCodec, videoAspectRatio
videoFrameRateCommunity media error. It can be one of the following errors: imageType, imageSize, videoType, videoDuration, videoSize
imageSizeSchedule date for the post in ISO format
2022-11-23T05:53:00.000ZPost content/summary
First postFollow-up comment to be posted immediately after the main post is published.
Supported Platforms: Facebook, Instagram, LinkedIn, YouTube, TikTok
NOT Supported: Google My Business (GMB), Pinterest
Use Case: Great for adding hashtags, additional context, or engagement prompts without cluttering the main post.
- Like
summary, the follow-up comment is trimmed to the strictest limit among the post's platforms, not to each platform's own limit — a post that includes Bluesky (300) trims the comment to 300 everywhere. Send one request per platform to keep the full comment on each. - TikTok: the comment is published once the video becomes publicly viewable on TikTok (typically 1-3 minutes after the post goes out), not immediately. Max 1,200 characters.
- TikTok: only public videos are supported. Set
privacyLeveltoPUBLIC_TO_EVERYONE; friends-only and private videos are not supported.
Reference: Platform Limitations Guide
Initial CommentPost type - post, story, or reel
poststoryreelshortpostTiktok Post Details
Privacy level controlling who can view the post (video or photo).
Available Values:
PUBLIC_TO_EVERYONE- Anyone can view (default)MUTUAL_FOLLOW_FRIENDS- Only mutual followers can viewSELF_ONLY- Only you can view (private)
Note: If set to SELF_ONLY, videoDisclosure must be false.
PUBLIC_TO_EVERYONEMUTUAL_FOLLOW_FRIENDSSELF_ONLYPUBLIC_TO_EVERYONEIndicates if the post (video or photo) promotes a third-party brand or product.
Required: Must be true if videoDisclosure is enabled and you're promoting another brand.
falseAllow users to comment on the post (video or photo). Default is determined by account settings.
trueAllow users to create Duet videos with your content.
Duet: Side-by-side video featuring your content and the creator's reaction/addition.
Note: Only applicable to video posts. Ignored for photo posts.
trueAllow users to create Stitch videos with your content.
Stitch: Clips up to 5 seconds of your video that creators can use in their own videos.
Note: Only applicable to video posts. Ignored for photo posts.
trueEnable branded content disclosure. Required when the post (video or photo) is promotional content.
Validations:
- Cannot be
trueifprivacyLevelisSELF_ONLY - If enabled, at least one of
promoteYourBrandorpromoteOtherBrandmust betrue
falseIndicates if the post (video or photo) promotes your own brand or product.
Required: Must be true if videoDisclosure is enabled and you're promoting your own brand.
falseShort title for TikTok photo carousel posts.
Max length: 90 UTF-16 characters
Note: Only applicable when posting images. Ignored for video posts.
Check out these highlightsAutomatically add background music to TikTok photo carousel posts.
Note: Only applicable when posting images. Ignored for video posts.
falseGMB Post Details
Google My Business post type.
Available Types:
STANDARD- Regular update post (What's New)EVENT- Event announcement with dates and titleOFFER- Promotional offer with coupon and redemption details
Required fields by type:
- STANDARD: None additional
- EVENT:
title,startDate,endDate - OFFER:
offerTitle,startDate,endDate,termsConditions,couponCode,redeemOnlineUrl
STANDARDEVENTOFFERSTANDARDEvent title. Required when gmbEventType is EVENT.
Max length: 58 characters
Summer Sale Event 2024Offer title. Required when gmbEventType is OFFER.
50% Off All ProductsStart date and time for EVENT or OFFER posts.
Required: When gmbEventType is EVENT or OFFER.
Structure:
startDate: { year, month, day }startTime: { hours, minutes, seconds }
Start Date
Year component of the date
2022Month component of the date (1-12)
1Day component of the date (1-31)
1Start Time
Hour component of the time (0-23)
23Minute component of the time (0-59)
56Second component of the time (0-59)
34End date and time for EVENT or OFFER posts.
Required: When gmbEventType is EVENT or OFFER.
Validation: Must be after startDate.
Structure:
endDate: { year, month, day }endTime: { hours, minutes, seconds }
End Date
Year component of the date
2022Month component of the date (1-12)
1Day component of the date (1-31)
1End Time
Hour component of the time (0-23)
23Minute component of the time (0-59)
56Second component of the time (0-59)
34URL to terms and conditions page. Required for OFFER posts.
https://yoursite.com/terms-and-conditionsCall-to-action URL. Required when actionType is set (except none and call).
Required for: STANDARD and EVENT posts with actionType other than none or call.
https://yoursite.com/book-nowPromotional coupon code. Required for OFFER posts.
SAVE50URL where customers can redeem the offer online. Required for OFFER posts.
https://yoursite.com/redeem-offerCall-to-action button type for the post.
Available Actions:
none- No action buttonorder- Order onlinebook- Book appointmentshop- Shop nowlearn_more- Learn morecall- Call now (no URL required)sign_up- Sign up
Note: All actions except none and call require a url.
noneorderbookshoplearn_morecallsign_upbookError Description
Invalid media formatCSV file type
basicadvancebasicMedia optimization flag
trueApply watermark flag
falsePost status
pendingacceptedrejecteddeletedpendingDate Updated
2023-08-02T00:00:00.000Z