Social API

Plan, check, schedule and publish real estate social posts, and make listing videos. Send your key (made in your CRM under Social › API keys) as Authorization: Bearer sk_…. Each key acts for one site, as the agent who made it.

GET /v1/social/accountsConnected Facebook, Instagram, LinkedIn, YouTube, Google Business and TikTok accounts.
GET /v1/social/planSuggested posts for the next four weeks, from the site's content plan.
POST /v1/social/captionsAI captions per network for an idea (1 AI credit), each checked against RECO's rules.
GET/POST /v1/social/posts, PUT/DELETE /v1/social/posts/{id}Posts: drafts, checks (RECO rules and numbers against live data), schedule.
POST /v1/social/posts/{id}/schedule, /approveSchedule, or send for a manager's approval; approve.
GET/POST /v1/social/keywordsKeyword replies on comments and messages.
GET/POST /v1/media/videosListing videos (reels and squares; 1 video credit each).
GET/POST /v1/media/assets, POST /v1/media/slideshowsYour own photos and clips; slideshows from them.
GET/POST/DELETE /v1/social/webhooksWebhooks: post.published, post.failed, post.pending_approval, signed with X-BuildSocial-Signature: t=…,v1=… (HMAC-SHA256 of t.body with your secret).

Machine-readable description: /openapi.json. Sign up or make keys at app.buildsocial.ca.

Errors are JSON: {"error": {"code", "message"}}. Limits: 300 requests a minute per key.