Geliştirici Kılavuzu

How to Automate Social Media Posting with Python

Whether you\'re building a content pipeline for your startup, automating posts for clients, or integrating social publishing into your SaaS product, Python makes it easy. This tutorial walks through everything from your first upload to a production ready automation script.

Sosyal medya otomasyonu için Neden Python

Python is the go-to language for automation. It\'s readable, has a massive ecosystem, and it\'s perfect for scripts that run on a schedule. And when it comes to posting to social media programmatically, the alternative to using an API like Upload-Post is building OAuth integrations for each platform yourself. That means handling TikTok\'s Content Posting API, Instagram\'s Graph API, YouTube\'s Data API, and so on. Each with its own authentication flow, rate limits, and quirks.

With the social media posting API, you make one API call and it posts to all ten platforms. The Python SDK makes this even simpler.

Ortamınızı ayarlama.

1. SDK\'yı yükleyin

pip install upload-post

2. API anahtarınızı alın

Create a free account at app.upload-post.com and generate an API key from the API Anahtarları kontrol paneli. Store it as an environment variable:

export UPLOAD_POST_API_KEY="your-api-key-here"

3. Sosyal hesaplarınızı bağlayın

In the Upload-Post dashboard, create a profile (e.g. "mybrand") and connect your TikTok, Instagram, YouTube and any other accounts you want to post to. The profile name is what you\'ll reference in your code.

İlk yüklemeniz: bir video paylaşmak

import os
from upload_post import UploadPostClient

client = UploadPostClient(
    api_key=os.environ["UPLOAD_POST_API_KEY"]
)

response = client.upload_video(
    video_path="my-video.mp4",
    title="Yeni ürünümüzün uygulamada",
    user="mybrand",
    platforms=["tiktok", "instagram", "youtube"]
)

if response["success"]:
    for platform, result in response["results"].items():
        if result["success"]:
            print(f"{platform}: {result['url']}")
        else:
            print(f"{platform}: upload failed")
else:
    print("Upload failed:", response)

That\'s a working script. Run it and your video goes live on three platforms. Now let\'s make it do more.

Fotoğraflar ve karuseller gönderiliyor.

response = client.upload_photos(
    photos=["slide-1.jpg", "slide-2.jpg", "slide-3.jpg"],
    title="Yaz koleksiyonu lookbook\'u",
    description="Her parça, Portekiz\'de yapıldı. Biyografideki bağlantıdan alışveriş yapın.",
    user="mybrand",
    platforms=["instagram", "tiktok", "linkedin"]
)

print(response)

Instagram creates a carousel post, TikTok creates a slideshow, and LinkedIn shows a multi-image post. Each platform gets the format it prefers.

Metin içeriği gönderiliyor.

For text only posts (think Twitter threads, LinkedIn updates, or Reddit submissions):

response = client.upload_text(
    title="API\'mize büyük bir güncelleme gönderdik. İşte neler değişti...",
    user="mybrand",
    platforms=["x", "linkedin", "threads", "bluesky"]
)

print(response)

If your text exceeds the character limit on a platform, the API handles it smartly. On X, text over 280 characters automatically becomes a thread. On Threads, the split happens at 500 characters. On Bluesky, at 300.

Platforma özgü parametreler kullanma

The title parameter sets the default caption for all platforms, but you\'ll often want different copy for each one. Here\'s how to customize per platform:

import requests
import os

API_KEY = os.environ["UPLOAD_POST_API_KEY"]

with open("product-demo.mp4", "rb") as video:
    response = requests.post(
        "https://api.upload-post.com/api/upload",
        headers={"Yetkilendirme": f"Apikey {API_KEY}"},
        files={"video": video},
        data={
            "user": "mybrand",
            "title": "Check this out",
            # Platform specific titles
            "tiktok_title": "POV: ürününüz kendini satıyor #ecommerce #dropshipping",
            "instagram_title": "Yeni sürüm. Erken erişim için biyografideki bağlantı.",
            "youtube_title": "Ürün Tanıtımı | Tam İnceleme",
            "youtube_description": "Bu videoda tam olarak nasıl çalıştığını gösteriyoruz...",
            "linkedin_title": "Toplulukla en son ürün lansmanımızı paylaşmaktan heyecan duyuyoruz.",
            # Platform specific settings
            "platform[]": ["tiktok", "instagram", "youtube", "linkedin"],
            "privacy_level": "PUBLIC_TO_EVERYONE",
            "media_type": "REELS",
            "tags[]": ["product", "demo", "review"],
            "privacyStatus": "public",
        }
    )

print(response.json())

This example uses the requests library directly instead of the SDK, which gives you access to every single API parameter. Check the full API reference for all available options per platform.

Gönderileri daha sonra planlama

from datetime import datetime, timedelta

# Schedule for tomorrow at 9 AM
tomorrow_9am = (datetime.now() + timedelta(days=1)).replace(
    hour=9, minute=0, second=0, microsecond=0
)

response = client.upload_video(
    video_path="tomorrows-content.mp4",
    title="Günaydın! Beslemeniz için taze içerik",
    user="mybrand",
    platforms=["tiktok", "instagram"],
    scheduled_date=tomorrow_9am.isoformat(),
    timezone="Amerika/New_York"
)

print(f"Planlandı! İş Kimliği: {response['job_id']}")
print(f"Şurada yayımlanacak: {response['scheduled_date']}")

You can schedule up to 365 days in advance. For more details on scheduling and the queue system, read our scheduling guide.

Tam bir otomasyon oluşturma: klasör izleyici

Here\'s a practical script that watches a folder for new video files and automatically uploads them. This is great for agencies that receive client content in a shared folder:

import os
import time
import json
from upload_post import UploadPostClient

client = UploadPostClient(
    api_key=os.environ["UPLOAD_POST_API_KEY"]
)

WATCH_FOLDER = "/path/to/content/inbox"
PROCESSED_FILE = "/path/to/content/processed.json"
CHECK_INTERVAL = 60  # seconds

def load_processed():
    if os.path.exists(PROCESSED_FILE):
        with open(PROCESSED_FILE) as f:
            return set(json.load(f))
    return set()

def save_processed(processed):
    with open(PROCESSED_FILE, "w") as f:
        json.dump(list(processed), f)

def upload_video(filepath):
    filename = os.path.basename(filepath)
    title = filename.rsplit(".", 1)[0].replace("-", " ").replace("_", " ")

    response = client.upload_video(
        video_path=filepath,
        title=title,
        user="mybrand",
        platforms=["tiktok", "instagram", "youtube"],
        add_to_queue=True,
        async_upload=True
    )
    return response

print(f"Watching {WATCH_FOLDER} for new videos...")

processed = load_processed()

while True:
    for filename in os.listdir(WATCH_FOLDER):
        if filename in processed:
            continue
        if not filename.lower().endswith((".mp4", ".mov")):
            continue

        filepath = os.path.join(WATCH_FOLDER, filename)
        print(f"New file detected: {filename}")

        try:
            result = upload_video(filepath)
            print(f"  Queued successfully: {result.get('job_id', 'done')}")
            processed.add(filename)
            save_processed(processed)
        except Exception as e:
            print(f"  Error: {e}")

    time.sleep(CHECK_INTERVAL)

Run this script in the background (or as a systemd service) and every time someone drops a video in the folder, it gets published to all your connected platforms. If you need something more robust, consider using n8n or Make.com for a managed workflow.

API ile doğrudan çalışmak (SDK olmadan)

If you prefer not to use the SDK or need lower level control, you can use the requests library directly. Here\'s the equivalent of the SDK upload:

import requests

API_KEY = "your-api-key-here"
API_URL = "https://api.upload-post.com/api/upload"

# Upload a video
with open("video.mp4", "rb") as f:
    response = requests.post(
        API_URL,
        headers={"Yetkilendirme": f"Apikey {API_KEY}"},
        files={"video": ("video.mp4", f, "video/mp4")},
        data={
            "user": "mybrand",
            "title": "Python istekleri ile gönderildi.",
            "platform[]": ["tiktok", "instagram"],
        }
    )

print(response.status_code)
print(response.json())

API anahtarınızı doğrulama

Before running a big batch, it\'s a good idea to validate that your key works and check your plan limits:

response = requests.get(
    "https://api.upload-post.com/api/uploadposts/me",
    headers={"Yetkilendirme": f"Apikey {API_KEY}"}
)

data = response.json()
print(f"E-posta: {data['email']}")
print(f"Plan: {data['plan']}")

Hata yönetimi en iyi uygulamaları

When building production scripts, handle these common scenarios:

import requests

def upload_with_retry(video_path, title, platforms, max_retries=3):
    for attempt in range(max_retries):
        try:
            with open(video_path, "rb") as f:
                response = requests.post(
                    "https://api.upload-post.com/api/upload",
                    headers={"Yetkilendirme": f"Apikey {API_KEY}"},
                    files={"video": f},
                    data={
                        "user": "mybrand",
                        "title": title,
                        "platform[]": platforms,
                        "async_upload": "true",
                    },
                    timeout=120
                )

            if response.status_code == 200:
                return response.json()
            elif response.status_code == 429:
                # Rate limited, check usage
                usage = response.json().get("usage", {})
                print(f"Rate limited. Used {usage.get('count')}/{usage.get('limit')}")
                return None
            elif response.status_code == 401:
                print("Invalid API key")
                return None
            else:
                print(f"Attempt {attempt + 1} failed: {response.status_code}")

        except requests.exceptions.Timeout:
            print(f"Attempt {attempt + 1} timed out, retrying...")

    print(f"Tüm {max_retries} denemeleri {video_path} için başarısız oldu")
    return None

Yükleme geçmişini kontrol etme

You can pull your upload history to verify what went through or build a reporting dashboard:

response = requests.get(
    "https://api.upload-post.com/api/uploadposts/history?page=1&limit=20",
    headers={"Yetkilendirme": f"Apikey {API_KEY}"}
)

for entry in response.json()["history"]:
    status = "OK" if entry["success"] else "FAILED"
    print(f"[{status}] {entry['platform']} - {entry['post_title']} - {entry['post_url']}")

Sonraki adımlar

Now that you have the basics, here are some ideas for what to build next:

Bugün Python ile otomatikleştirmeye başlayın

Install the SDK, grab your API key, and publish your first video in under 5 minutes. The free plan includes 10 uploads per month.

pip install upload-post