Social

Post or schedule a video

Posts one video to one or more connected networks, now or at scheduledAt. Pedra copies the video to its own storage (max 1 GB); a Pedra video URL (img.pedra.ai) is used as is. Omit scheduledAt to post now (goes out within about a minute). Returns one post per network with status: "pending"; follow up with socialListPosts. Instagram posts as a Reel on a professional account. Video only. Pedra Pro only; a scheduled post is only published if the account is still on Pro when it's due, otherwise it fails. No credits; 25 posts per network per rolling 24 hours.

post/api/social/posts

Request

  • Base URL: https://app.pedra.ai
  • URL: https://app.pedra.ai/api/social/posts
  • Auth: none required

Request body

apiKeystring required

Account API key, sent in the request body. Get one at https://app.pedra.ai under Settings → API.

videoUrlstring uri required

Public https URL of an MP4 (max 1 GB).

scheduledAtstring date-time

ISO 8601. Omit to post now. Can't be in the past; max 180 days ahead.

timezonestring

IANA timezone (e.g. Europe/Madrid), stored for display only.

coverOffsetMsinteger

Cover frame on Instagram and TikTok, in milliseconds from the start of the video. Ignored for Facebook and YouTube.

Response

Posts created, one per network.

videoIdstring required
videoUrlstring required

The stored copy of the video.

Changes

No recorded changes to this operation across all 1 revision of this API.