API PER I SOCIAL MEDIA · REST
API per i social media per sviluppatori
Un’unica API REST per pubblicare, programmare e gestire i post su oltre 15 social network dal tuo prodotto, dal backend o da un flusso di automazione. JSON su HTTPS, una chiave Bearer e una specifica OpenAPI 3.
curl -X POST https://api.onlypult.com/v1/posts \
-H "Authorization: Bearer op_…" \
-H "Content-Type: application/json" \
-d '{
"profile_ids": ["1234", "5678"],
"content": "Launch day is here.",
"media_urls": ["https://cdn.example.com/a.png"],
"publish_at": "2026-07-07 14:00"
}' HTTP/1.1 201 Created
{ "data": {
"id": "abc123",
"status": "scheduled",
"content": "Launch day is here.",
"profile_ids": ["1234", "5678"],
"publish_at": "2026-07-07 14:00",
"published_at": null,
"media": […],
"error": null
} } La fattura non cresce con la portata dei tuoi clienti. Paghi un piano, non ogni account collegato.
Nessun piano separato per sviluppatori. L’API funziona durante la prova gratuita, senza carta.
Un endpoint, tre modalità: is_draft: true, publish_now: true o publish_at. Niente viene pubblicato per sbaglio.
Chiamala da qualsiasi client HTTP
I tuoi clienti collegano gli account tramite OAuth: niente password condivise e nessuna app Meta da creare.
Com’è fatta ogni richiesta
Una chiave personale da Impostazioni → API Keys: op_ più 64 caratteri esadecimali. Viene mostrata una sola volta alla creazione e salvata solo come hash.
Ogni risposta riuscita è JSON dentro un envelope data. POST /posts restituisce 201 con il post creato.
Gli elenchi accettano page e limit (fino a 100) e restituiscono meta con total, page, limit e pages.
Ogni risposta contiene X-RateLimit-Limit, -Remaining e -Reset, così puoi distribuire le richieste invece di scontrarti con un 429.
Programma un post in tre chiamate
Chiedi all’account il fuso orario e la data di fine del piano, scegli i profili e crea il post. publish_at usa "Y-m-d H:i" nel fuso orario dell’account.
Risposte facili da elaborare
Gli elenchi arrivano con meta per la paginazione. Gli errori di validazione restituiscono un codice stabile, un messaggio, il campo e un flag retryable.
GET /v1/posts?status=scheduled&page=1&limit=20
{ "data": [
{ "id": "abc123", "status": "scheduled", … }
],
"meta": {
"total": 100, "page": 1,
"limit": 20, "pages": 5
} } HTTP/1.1 422 Unprocessable Entity
{ "error": {
"code": "publish_date_after_plan",
"message": "Cannot schedule posts after your plan end date…",
"retryable": false,
"field": "publish_at"
} } Codici di errore
400, 401 e 404 restituiscono { name, message, code, status }. Gli errori di validazione (422) restituiscono un oggetto error con un codice stabile. Se retryable è false, non ripetere la stessa richiesta.
Endpoint per tutto il ciclo di vita del post
Inizia in cinque minuti
Due errori frequenti: inviare publish_at in ISO-8601 UTC invece di "Y-m-d H:i" nel fuso dell’account e ripetere un 422 con retryable false. Si correggono entrambi in un minuto.
L’API è inclusa in tutti i piani. Nessun costo di accesso.
Nessun sovrapprezzo per un piano sviluppatori, nessun costo per profilo collegato, nessuna prova accorciata quando crei una chiave. L’accesso programmatico è incluso ovunque, dalla prova ai piani più alti.
La fattura non cresce con ogni profilo collegato.
Incluso nel piano che hai già.
7 giorni gratis, senza carta, API inclusa.
Domande frequenti
Su quali social network posso pubblicare tramite l’API?
Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Threads, X, Telegram, WordPress, Google Business Profile e altri: oltre 15 canali in totale. GET /profiles/platforms restituisce l’elenco aggiornato.
Posso pubblicare su più profili con una sola richiesta?
Sì. Passa più ID in profile_ids e il post va su ciascuno di essi: come bozza, programmato o subito.
Come allego immagini e video?
Passa fino a 10 URL pubblici in media_urls e Onlypult scarica i file da solo. Per i file del tuo archivio, caricali con POST /media/upload-url o POST /media/upload e passa gli ID restituiti in media_ids.
Quali piani includono l’API?
Tutti, compresa la prova gratuita, senza piano sviluppatori a parte e senza costi per profilo.
Esiste un server MCP per gli agenti IA?
Sì. Claude, ChatGPT, Cursor e altri agenti hanno le stesse funzioni tramite il server MCP di Onlypult. Le guide di collegamento sono nella sezione sugli agenti IA.
Quali sono i limiti di utilizzo?
Ogni risposta contiene X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset (un timestamp unix) per la tua chiave. Distribuisci le richieste in base a questi header; se ricevi un 429, attendi l’orario di reset.
Esiste una specifica OpenAPI?
Sì, OpenAPI 3.0 all’indirizzo onlypult.com/dev/openapi.yaml. Puoi generare un client oppure importarla in Postman o Insomnia. Il riferimento interattivo è su onlypult.com/dev/api.html.
Come funziona la paginazione?
Gli elenchi come GET /posts accettano page (da 1) e limit (da 1 a 100, 20 di default) e restituiscono meta con total, page, limit e pages.
Quale formato orario usa la programmazione?
publish_at è una stringa nel formato "Y-m-d H:i" nel fuso orario dell’account, ad esempio "2026-07-07 14:00". GET /account restituisce il fuso orario e plan_end_at.
Come viene versionata l’API?
L’API è versionata (v1) con retrocompatibilità all’interno di una versione principale, così la tua integrazione continua a funzionare mentre rilasciamo aggiornamenti.
Collega la pubblicazione al tuo codice
In tutti i piani · 7 giorni gratis · senza carta
