SocialPost
The SocialPost entity represents individual social media posts scheduled and tracked via Ayrshare integration.
Overview
Fields
| Field | Type | Description |
|---|---|---|
content | text | Post text content |
postType | enum | Type of post |
platform | enum | Target platform |
status | enum | Current status |
scheduledAt | datetime | When to publish |
ayrshareId | varchar | Ayrshare post ID |
mediaUrl | url | Attached media |
contentProductionId | link | Related content |
clipId | link | Related clip |
Post Types
| Type | Purpose | Best For |
|---|---|---|
| Promo | Announce new content | Episode releases |
| Reminder | Remind about upcoming | Livestream alerts |
| Clip | Share video clip | Short-form content |
| Episode Link | Link to full content | Drive traffic |
| Quote | Quotable moment | Engagement |
| Behind Scenes | BTS content | Community building |
| Engagement | Questions, polls | Audience interaction |
Status Flow
| Status | Description | Ayrshare State |
|---|---|---|
| Draft | Work in progress | Not sent |
| Scheduled | Ready to publish | Queued |
| Published | Live on platform | Published |
| Failed | Error occurred | — |
Supported Platforms
| Platform | Character Limit | Media Types |
|---|---|---|
| X/Twitter | 280 | Images, Videos, GIFs |
| 63,206 | Images, Videos, Links | |
| 2,200 | Images, Videos, Reels | |
| 3,000 | Images, Videos, Documents | |
| YouTube | 5,000 | Videos only |
| TikTok | 4,000 | Videos only |
Ayrshare Integration
Scheduling Flow
Cancellation Flow
Analytics Tracking
Published posts have performance tracked:
Metrics Tracked
| Metric | Description |
|---|---|
impressions | Times shown to users |
likes | Like/favorite count |
comments | Comment count |
shares | Retweet/share count |
clicks | Link clicks |
engagement_rate | Interactions / Impressions |
Relationships
Linked to ContentProduction
Linked to Clip
API Operations
Create SocialPost
http
POST /api/v1/SocialPost
Content-Type: application/json
{
"content": "🎙️ New episode out now! Check out our conversation with...",
"postType": "Episode Link",
"platform": "X",
"status": "Scheduled",
"scheduledAt": "2026-02-10T15:00:00.000Z",
"mediaUrl": "https://cdn.example.com/thumbnail.jpg",
"contentProductionId": "content-id-here"
}1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
Update to Draft (Cancel Schedule)
http
PUT /api/v1/SocialPost/{id}
Content-Type: application/json
{
"status": "Draft"
}1
2
3
4
5
6
2
3
4
5
6
This triggers the Bridge to cancel the Ayrshare scheduled post.
Get Post with Analytics
http
GET /api/v1/SocialPost/{id}1
Templates
Create consistent posts with templates:
Episode Announcement
🎙️ NEW EPISODE
{title}
📺 Watch now: {link}
#podcast #newepisode1
2
3
4
5
6
7
2
3
4
5
6
7
Livestream Reminder
🔴 GOING LIVE in 1 hour!
{title}
Join us at {time}
📺 {link}1
2
3
4
5
6
2
3
4
5
6
Quote Post
💬 "{quote}"
— {guest}, on {show}
Full episode: {link}1
2
3
4
5
2
3
4
5
Best Practices
Optimal Posting Times
- X/Twitter: 9am, 12pm, 3pm
- Facebook: 1pm - 4pm
- Instagram: 11am, 2pm
- LinkedIn: 7am - 8am, 12pm, 5pm - 6pm
Platform-Specific Content
Don't copy-paste the same post everywhere. Adapt for each platform's style.
Avoid Over-Posting
Space posts at least 2-3 hours apart to avoid overwhelming followers.
Use Media
Posts with images/videos get 2-3x more engagement than text-only.
Schedule Ahead
Schedule your week's posts on Monday. Aim for consistent posting rhythm.
Related
- Social Workflow — Full posting workflow
- ContentProduction — Source content
- Clip — Video clips
- Analytics Dashboard — Performance tracking
- Ayrshare API — API reference