cURL Recipes

-H "X-API-Key: psk_live_YOUR_KEY" \
-H "Content-Type: application/json"

curl -X POST "https://backend.postsiva.com/unified/oauth/url" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{"platform": ["linkedin", "instagram", "facebook"]}'

curl -X POST "https://backend.postsiva.com/unified/oauth/url" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platform": ["bluesky"],
    "handle": "you.bsky.social",
    "app_password": "xxxx-xxxx-xxxx-xxxx"
  }'

curl "https://backend.postsiva.com/unified/oauth/token" \
  -H "X-API-Key: psk_live_YOUR_KEY"

curl -X POST "https://backend.postsiva.com/media/upload" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -F "media=@/path/to/image.jpg" \
  -F "media_type=image"

curl -X POST "https://backend.postsiva.com/unified/post/text" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["linkedin", "threads", "bluesky"],
    "default_text": "Hello from the Postsiva API!"
  }'

curl -X POST "https://backend.postsiva.com/unified/post/text" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["linkedin"],
    "default_text": "Company update.",
    "linkedin": {
      "linkedin_page_ids": ["108813535"],
      "post_to_personal": true
    }
  }'

curl -X POST "https://backend.postsiva.com/unified/post/text" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["facebook"],
    "default_text": "Page announcement.",
    "facebook": {
      "facebook_page_ids": ["756356074224043"]
    }
  }'

curl -X POST "https://backend.postsiva.com/unified/post/image" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["instagram"],
    "default_text": "New collection drop.",
    "default_image_id": "YOUR_MEDIA_ID"
  }'

curl -X POST "https://backend.postsiva.com/unified/post/image" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["pinterest"],
    "default_image_id": "YOUR_MEDIA_ID",
    "pinterest": {
      "board_id": "1234567890123456789",
      "pinterest_text": "Pin title",
      "pinterest_description": "Pin description."
    }
  }'

curl -X POST "https://backend.postsiva.com/unified/post/video" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["youtube"],
    "video_id": "YOUR_VIDEO_MEDIA_ID",
    "youtube": {
      "youtube_title": "My Video Title",
      "youtube_description": "Full description with links."
    }
  }'

curl -X POST "https://backend.postsiva.com/unified/post/video" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["tiktok"],
    "default_text": "Behind the scenes.",
    "video_id": "YOUR_VIDEO_MEDIA_ID",
    "tiktok": {
      "privacy_level": "PUBLIC_TO_EVERYONE"
    }
  }'

curl -X POST "https://backend.postsiva.com/unified/post/text" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["linkedin"],
    "default_text": "Scheduled for tomorrow.",
    "scheduled_time": "2026-07-10T14:30:00Z"
  }'

curl -X POST "https://backend.postsiva.com/unified/post/text" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["linkedin", "threads"],
    "default_text": "Draft — review before publish.",
    "draft": true
  }'

curl -X POST "https://backend.postsiva.com/unified/post/text" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["linkedin", "threads"],
    "default_text": "Launch copy.",
    "draft_platforms": ["linkedin"]
  }'

curl "https://backend.postsiva.com/unified/scheduled-posts?status=scheduled&limit=20" \
  -H "X-API-Key: psk_live_YOUR_KEY"

curl "https://backend.postsiva.com/unified/drafts?limit=20" \
  -H "X-API-Key: psk_live_YOUR_KEY"

curl "https://backend.postsiva.com/unified/posts?platforms=linkedin&limit=5" \
  -H "X-API-Key: psk_live_YOUR_KEY"

curl "https://backend.postsiva.com/unified/analytics?platforms=linkedin,instagram" \
  -H "X-API-Key: psk_live_YOUR_KEY"

curl -X DELETE "https://backend.postsiva.com/unified/oauth/token?platform=linkedin" \
  -H "X-API-Key: psk_live_YOUR_KEY"