Per chi

Postika per sviluppatori: una API, otto social

Integrare le API di otto social è lungo e fragile. Con Postika invii un JSON e il post esce su Instagram, LinkedIn, X o Threads, con i limiti di ogni rete già controllati.

Tre modi di integrare Postika

API REST con chiave di progetto. Ogni chiave (ptk_…) vede un solo progetto. Ideale per script, CI, backend e automazioni con n8n, Make o Zapier.
Server MCP. Per agenti IA: https://postika.app/api/mcp, trasporto Streamable HTTP, OAuth 2.1 automatico o chiave in Authorization: Bearer. Cinque strumenti: listprojects, listchannels, listposts, createpost, delete_post.
App OAuth. Se costruisci un prodotto che deve agire per conto di altri utenti Postika.

Tutta la documentazione tecnica è su /docs/api e /docs/mcp.

Creare un post: la richiesta

Una richiesta POST a https://postika.app/api/v1/posts con intestazione Authorization: Bearer ptk_… e questo corpo:

Campo	Significato
content	testo del post (ogni social applica il suo limite)
channel_ids	uno o più ID da GET /api/v1/channels
when	`YYYY-MM-DD HH:MM` nell'ora locale del progetto
mode	schedule, approval, draft o now

La risposta contiene l'ID e lo stato del post. Gli errori tornano come { "error": "…" } con uno stato 4xx: testo oltre il limite, canale sconosciuto, data mancante. Durante lo sviluppo usa approval, così nulla esce per sbaglio.

Limiti che Postika controlla per te

Social	Caratteri	Immagini	Media obbligatorio
Instagram	2.200	10	sì
TikTok	2.200	35	sì
Facebook	5.000	10	no
YouTube	5.000	solo video	sì
X	280	4	no
LinkedIn	3.000	9	no
Threads	500	10	no
Pinterest	500	1	sì

Un video per post. I media non si inviano tramite MCP: per i social che li richiedono crea una bozza e completala nell'app. La tabella completa è nello strumento limiti dei social.

Casi d'uso tipici

Annunci di release dalla CI (GitHub Actions, GitLab CI) a ogni tag.
CMS headless: ogni articolo pubblicato genera post per LinkedIn, X e Threads.
Prodotti SaaS che vogliono offrire la pubblicazione social ai propri utenti tramite app OAuth.
Agenti IA personalizzati che usano il server MCP con una chiave di progetto.

Per capire meglio il protocollo leggi MCP e social media o la voce API dei social.

Prezzi

API e chiavi sono incluse in tutti i piani, senza costi per richiesta: si paga solo il numero di canali collegati. Standard 29 € (5 canali), Team 39 € (10), Pro 49 € (30), Ultimate 99 € (100); annuale con il 20% di sconto. Post e progetti illimitati. Vedi prezzi.

Esempio di flusso con GitHub Actions

Crea una chiave in Collega IA → Chiavi di progetto e salvala come segreto del repository.
Recupera gli ID dei canali con GET /api/v1/channels.
Nel workflow che parte a ogni tag, invia POST /api/v1/posts con il testo della release, gli ID di LinkedIn, X e Threads, mode: "approval" e when per il giorno dopo alle 10:00.
Controlla nel calendario di Postika e approva.

Quando il flusso è affidabile, passa a schedule.

Domande frequenti

Serve approvare un'app con Meta, TikTok o LinkedIn per usare l'API di Postika?

No, colleghi i tuoi account social a Postika dall'app e poi usi l'API di Postika. Le integrazioni con i singoli social le gestisce Postika.

Posso caricare immagini tramite API?

Oggi l'API e il server MCP ricevono il testo del post, i canali, la data e la modalità. Per i social che richiedono media crea il post in bozza e aggiungi foto o video nell'app.

Che differenza c'è tra OAuth e chiave di progetto?

Con OAuth un client raggiunge tutti i progetti dell'utente che ha dato il consenso. Con una chiave di progetto l'accesso è limitato a quel progetto, utile per automazioni e clienti separati.

C'è un limite di richieste?

I post sono illimitati in tutti i piani. Eventuali limiti tecnici e codici di errore sono descritti nella documentazione Errors & limits su /docs.

Come elenco i canali di un progetto via API?

Con una richiesta GET a /api/v1/channels usando la chiave del progetto nell'intestazione Authorization: Bearer ptk…. La risposta restituisce l'ID di ogni canale, il social, l'account, il limite di caratteri e se richiede una foto o un video. Gli ID servono poi nel campo channelids quando crei un post.