SocialSchedule

SocialSchedule API — Programmazione dei social media in modo programmatico

L'API di SocialSchedule è un'API per la programmazione sui social media per la pubblicazione su più piattaforme: autentica gli spazi di lavoro, carica i media, crea post programmati, gestisci le code, ricevi webhook e estrai analisi—senza dover aspettare un componente aggiuntivo per le aziende.

Inizia gratis

Esempi di codice

Gli esempi rimangono in inglese — copia nel tuo terminale, client MCP o file di skill.

Intestazioni di autenticazione
Authorization: Bearer ssk_live_xxx
X-Workspace-Id: ws_abc123
Crea post
curl -X POST https://api.socialschedule.ai/v1/posts \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram", "tiktok"],
    "caption": "New drop is live",
    "mediaIds": ["media_01"],
    "scheduledFor": "2026-04-02T18:00:00Z",
    "utm": {
      "source": "instagram",
      "medium": "social",
      "campaign": "spring-drop"
    }
  }'
Carica media
curl -X POST https://api.socialschedule.ai/v1/media \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -F "file=@./product.mp4"
Crea webhook
curl -X POST https://api.socialschedule.ai/v1/webhooks \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/socialschedule",
    "events": ["post.published", "post.failed"]
  }'

Autenticazione e spazi di lavoro

Utilizza token bearer limitati a uno spazio di lavoro. Passa gli identificatori degli spazi di lavoro per le app agenziali multi-tenant. Per sviluppatori e agenti AI, "Autenticazione e spazi di lavoro" non è una sezione di parole d'ordine: è un sistema operativo: pianifica pilastri, redigi con AI, programma in finestre ottimali e misura i risultati che contano.

Ruota le chiavi e preferisci il minor privilegio. SocialSchedule collega questo flusso di lavoro attraverso Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile da un calendario e una coda nativi per l'AI—non una casella didascalia fissata a un editore in stile 2012. Mantieni la formattazione, le approvazioni e le analisi native della piattaforma nello stesso circuito.

Rispecchia lo stesso modello di permessi dell'app web. I campioni Curl qui sotto rimangono in inglese/tecnici per design. Quando sei pronto, apri https://app.socialschedule.ai/login per pianificare in tempo reale—oppure automatizza gli stessi passaggi con CLI, MCP, API e Skills mentre gli umani mantengono le barriere vocali del marchio.

Crea, aggiorna e annulla post programmati

Gli endpoint CRUD coprono l'intero ciclo di vita di un post programmato. Le chiavi di idempotenza aiutano i tentativi sicuri. Per sviluppatori e agenti AI, “Crea, aggiorna e annulla post programmati” non è una sezione di moda—è un sistema operativo: pianifica i pilastri, redigi con AI, programma in finestre ottimali e misura i risultati che contano.

Annulla o riprogramma quando le campagne slittano. SocialSchedule collega questo flusso di lavoro attraverso Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile da un calendario e coda nati per l'AI—non una casella di didascalia aggiunta su un editore in stile 2012. Mantieni la formattazione, le approvazioni e le analisi nativi della piattaforma nello stesso ciclo.

Supporta esplicitamente le bozze rispetto agli stati programmati. Quando sei pronto, apri https://app.socialschedule.ai/login per programmare dal vivo—oppure automatizza gli stessi passaggi con CLI, MCP, API e Skills mentre gli umani mantengono le barriere vocali del marchio.

Schemi API concettuali

Autenticati con un token bearer a livello di workspace. Crea post con obiettivi di piattaforma, varianti di didascalia, ID media e timestamp di programmazione. Usa chiavi di idempotenza per i retry.

Esempio di forma (illustrativo): `POST /v1/posts` con `{ "platforms": ["instagram","x"], "body": "...", "mediaIds": [...], "scheduledAt": "..." }`. Iscriviti ai webhook `post.published` / `post.failed` per avvisi operativi.

Preferisci bozza → approva → pianifica per la sicurezza del marchio. Limita il tasso con backoff su 429s. I dettagli completi di OpenAPI vengono forniti con il tuo workspace per sviluppatori.

Caricamento media e payload specifici per piattaforma

Carica i media, quindi fai riferimento agli ID dei media dalle chiamate di creazione dei post. Allegare campi specifici per piattaforma dove le reti li richiedono. Per sviluppatori e agenti AI, "Caricamento media e payload specifici per piattaforma" non è una sezione di buzzword: è un sistema operativo: pianifica i pilastri, redigi con AI, programma in finestre ottimali e misura i risultati che contano.

Valida i rapporti di aspetto prima del giorno di lancio. SocialSchedule collega questo flusso di lavoro attraverso Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile da un calendario e coda nativi AI - non una casella di didascalia aggiunta a un editore in stile 2012. Mantieni la formattazione, le approvazioni e le analisi nativi della piattaforma nello stesso loop.

Riutilizza i media attraverso varianti di piattaforma quando appropriato. Quando sei pronto, apri https://app.socialschedule.ai/login per programmare dal vivo o automatizza gli stessi passaggi con CLI, MCP, API e Skills mentre gli esseri umani mantengono le linee guida della voce del brand.

Calendari, code e strumenti per il momento ottimale

Elenca le finestre del calendario e metti in coda i post per i momenti di pubblicazione ottimali. Crea strumenti interni che mostrano la stessa settimana che vedono i marketer. Per sviluppatori e agenti AI, "Calendari, code e strumenti per il momento ottimale" non è una sezione alla moda, ma un sistema operativo: pianifica pilastri, redigi con AI, programma in finestre ottimali e misura i risultati che contano.

Colma le lacune in modo programmato dopo le revisioni analitiche. SocialSchedule collega questo flusso di lavoro su Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile da un calendario e una coda nativa dell'AI, non da una casella di didascalia aggiunta a uno stile di pubblicazione del 2012. Mantieni il formato nativo della piattaforma, le approvazioni e le analisi nello stesso loop.

Combina con Skills per una pianificazione di livello superiore. Quando sei pronto, apri https://app.socialschedule.ai/login per pianificare dal vivo—oppure automatizza gli stessi passaggi con CLI, MCP, API e Skills mentre gli esseri umani mantengono le linee guida per la voce del brand.

Endpoint di analisi che contano

Recupera metriche di coinvolgimento e consegna per contenuti programmati. Potenzia i portali client e i dashboard interni. Per sviluppatori e agenti di AI, “Endpoint di analisi che contano” non è una sezione alla moda—è un sistema operativo: pianifica pilastri, redigi con AI, programma in finestre ottimali e misura risultati che contano.

Evita report di vanità inutili nelle email automatizzate. SocialSchedule connette questo flusso di lavoro attraverso Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile da un calendario e coda nativi per l'AI—non una casella di didascalia aggiuntiva su un editore in stile 2012. Mantieni il formato, le approvazioni e le analisi nativi della piattaforma nello stesso ciclo.

Chiudi il ciclo nei lavori di generazione della prossima settimana. Quando sei pronto, apri https://app.socialschedule.ai/login per programmare dal vivo—oppure automatizza gli stessi passaggi con CLI, MCP, API e Skills mentre gli esseri umani mantengono le linee guida sul tono del marchio.

Webhook per eventi pubblicati / falliti

Iscriviti agli eventi post.published e post.failed. Attiva avvisi Slack o ticketing quando le pubblicazioni falliscono. Per sviluppatori e agenti AI, "Webhook per eventi pubblicati / falliti" non è una sezione di parole d'ordine—è un sistema operativo: pianifica colonne, redigi con l'AI, programma in finestre ottimali e misura i risultati che contano.

Verifica le firme prima di fidarti dei payload. SocialSchedule collega questo flusso di lavoro tra Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile da un calendario e una coda nativi dell'AI—non una casella di didascalia aggiunta a forza su un editore in stile 2012. Mantieni la formattazione, le approvazioni e le analisi native della piattaforma nello stesso loop.

Mantieni gli handler del webhook idempotenti. Quando sei pronto, apri https://app.socialschedule.ai/login per programmare dal vivo—oppure automatizza gli stessi passaggi con CLI, MCP, API e Skills mentre gli esseri umani mantengono le guide sul tono del brand.

Limiti di utilizzo, idempotenza e migliori pratiche

Rispetta i limiti di utilizzo; diminuisci la velocità; riprova con chiavi di idempotenza. Registra gli ID di correlazione per il supporto. Per sviluppatori e agenti AI, 'Limiti di utilizzo, idempotenza e migliori pratiche' non è una sezione alla moda: è un sistema operativo: pianifica i pilastri, redigi con AI, programma in finestre ottimali e misura i risultati che contano.

Preferisci bozza→approvazione→programmazione per la sicurezza del marchio. SocialSchedule collega questo flusso di lavoro su Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile da un calendario e una coda nativi per l'AI—non una casella di didascalia aggiunta su un editore in stile 2012. Mantieni la formattazione, le approvazioni e le analisi native della piattaforma nello stesso loop.

Documenta i tuoi manuali di automazione interni. Quando sei pronto, apri https://app.socialschedule.ai/login per programmare in diretta—oppure automatizza gli stessi passaggi con CLI, MCP, API e Skills mentre gli esseri umani mantengono le linee guida della voce del marchio.

Guida rapida all'API per piattaforme comuni

I percorsi comuni includono la pianificazione di post su Instagram tramite API, aggiornamenti aziendali su LinkedIn e lanci su più piattaforme. Iniziate con un test di integrazione su una piattaforma, poi espandete. Per sviluppatori e agenti AI, “guida rapida all'API per piattaforme comuni” non è una sezione di buzzword—è un sistema operativo: pianifica pilastri, redigi con AI, pianifica in finestre ottimali e misura i risultati che contano.

Le agenzie possono costruire portali per i clienti sull'API. SocialSchedule collega questo flusso di lavoro su Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile da un calendario e una coda nativi per l'AI—non una casella di didascalia aggiunta a un editore in stile 2012. Mantieni il formato nativo della piattaforma, le approvazioni e le analisi nello stesso ciclo.

MCP potrebbe essere più veloce per l'interfaccia utente degli agenti; l'API vince per il tuo backend. Crea una chiave API nell'app e invia il tuo primo post pianificato. Quando sei pronto, apri https://app.socialschedule.ai/login per pianificare dal vivo—oppure automatizza gli stessi passaggi con CLI, MCP, API e Skills mentre gli esseri umani mantengono le linee guida sul tono del brand.

Domande frequenti

SocialSchedule offre un'API pubblica?+

Sì. L'API di SocialSchedule supporta la programmazione programmatica, i media, le code, i webhook e l'analitica.

Posso programmare post su Instagram tramite API?+

Sì, per gli account Instagram collegati al tuo workspace (soggetto alle politiche e ai permessi della piattaforma).

Quali piattaforme sono supportate nell'API?+

Le piattaforme disponibili in SocialSchedule—Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, Google Business Profile—quando collegate.

Come funziona l'autenticazione?+

Utilizza una chiave API bearer limitata a un workspace. Tieni le chiavi in un gestore di segreti.

Ci sono webhook per eventi di pubblicazione?+

Sì. Iscriviti agli eventi pubblicati e falliti per avvisi operativi.

Posso recuperare analitiche tramite l'API?+

Sì. Estrai metriche per alimentare dashboard e loop di automazione.

Quali sono i limiti di richiesta?+

I limiti di richiesta si applicano per workspace/token. Rallenta su 429 e utilizza chiavi di idempotenza per riprovare in sicurezza.

C'è un SDK ufficiale?+

Inizia con l'API REST e esempi curl; SDK/client comunitari possono essere aggiunti man mano che il sistema si stabilizza.

Come si confronta l'API con il server MCP?+

L'API è ideale per i tuoi server e prodotti; il MCP è ideale per agenti AI che richiamano gli strumenti in modo interattivo.

Le agenzie possono creare portali per clienti sull'API?+

Sì. Molte agenzie avvolgono l'API per calendari e approvazioni rivolti ai clienti.

Come carico i media?+

Utilizza l'endpoint di caricamento media, quindi fai riferimento agli ID media restituiti quando crei post.

Dove sono la OpenAPI / documentazione di riferimento?+

Utilizza questa guida per le prime configurazioni; i dettagli completi di OpenAPI sono inclusi nella documentazione del tuo workspace per sviluppatori.

Crea una chiave API e programma la pianificazione

Pubblicazione multi-piattaforma con webhook, code e analisi.

Inizia gratis