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.

Un post non è uscito? GET /posts?status=failed lo mostra e POST /posts/retry-all-failed rimanda tutto con una sola chiamata.
oppure guarda il flusso completo
7 giorni gratis Nessuna carta Disdici quando vuoi
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
} }
POST /posts publish_at è nel fuso orario dell’account
Non a profilo

La fattura non cresce con la portata dei tuoi clienti. Paghi un piano, non ogni account collegato.

Inclusa in tutti i piani

Nessun piano separato per sviluppatori. L’API funziona durante la prova gratuita, senza carta.

Bozza, programmazione o pubblicazione

Un endpoint, tre modalità: is_draft: true, publish_now: true o publish_at. Niente viene pubblicato per sbaglio.

Chiamala da qualsiasi client HTTP

curl
Node.js
Python
PHP
Go
n8n
Make
Zapier
Integrazioni ufficiali con le piattaforme

I tuoi clienti collegano gli account tramite OAuth: niente password condivise e nessuna app Meta da creare.

Com’è fatta ogni richiesta

Autenticazione
Authorization: Bearer op_…

Una chiave personale da Impostazioni → API Keys: op_ più 64 caratteri esadecimali. Viene mostrata una sola volta alla creazione e salvata solo come hash.

Risposte
{ "data": … }

Ogni risposta riuscita è JSON dentro un envelope data. POST /posts restituisce 201 con il post creato.

Paginazione
?page=1&limit=20 → meta

Gli elenchi accettano page e limit (fino a 100) e restituiscono meta con total, page, limit e pages.

Limiti di utilizzo
X-RateLimit-Remaining

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.

1 GET /account
timezone, plan_end_at
2 GET /profiles
ID dei profili
3 POST /posts
is_draft · publish_now · publish_at

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.

Elenco con paginazione
GET /v1/posts?status=scheduled&page=1&limit=20

{ "data": [
    { "id": "abc123", "status": "scheduled", … }
  ],
  "meta": {
    "total": 100, "page": 1,
    "limit": 20, "pages": 5
  } }
Errore di validazione
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.

Codice
Quando
Cosa fare
400
Un parametro della query non è valido, ad es. publish_after
Correggere la richiesta
401
La chiave API manca o non è valida
Controllare l’header Authorization
404
Il profilo o il post non esiste in questo account
Controllare l’ID
422 plan_expired
L’abbonamento è scaduto
Rinnovare il piano, senza ripetere
422 publish_date_after_plan
publish_at è successivo alla fine del piano
Scegliere una data precedente
422 publish_date_invalid
publish_at non è un orario di pubblicazione valido
Inviare "Y-m-d H:i" nel fuso dell’account
422 post_empty
Il post non ha testo, media né sondaggio
Aggiungere contenuto
422 validation_error
Un altro campo non è valido, vedi error.field
Seguire retryable
429
Limite di richieste superato
Attendere X-RateLimit-Reset

Endpoint per tutto il ciclo di vita del post

Cosa ti serve
Endpoint
Fuso orario e fine del piano
GET /account
Profili collegati
GET /profiles
Piattaforme supportate
GET /profiles/platforms
Media da URL (fino a 10)
media_urls in POST /posts
Media tramite upload di file
POST /media/upload-url · POST /media/upload
Bozza, programmazione o pubblicazione immediata
POST /posts
Elencare e filtrare i post
GET /posts?status=…&profile_id=…
Modificare o eliminare un post
PUT /posts/{id} · DELETE /posts/{id}
Pubblicare subito una bozza
POST /posts/{id}/publish
Ripubblicare i post non riusciti
POST /posts/{id}/retry · POST /posts/retry-all-failed
Analisi
GET /analytics/{id}/overview · /top-posts · /best-time

Oltre 15 canali con un’unica integrazione

Un unico livello di integrazione per tutti i canali su cui pubblicano i tuoi clienti.

Inizia in cinque minuti

1 Crea una chiave API in Impostazioni → API Keys. Copiala subito: viene mostrata una sola volta.
2 Chiama GET /account per timezone e plan_end_at, poi GET /profiles per gli ID dei profili.
3 Chiama POST /posts con is_draft, publish_now o publish_at.
URL di base
https://api.onlypult.com/v1

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.

Non ad account

La fattura non cresce con ogni profilo collegato.

Nessun piano sviluppatori a parte

Incluso nel piano che hai già.

Funziona durante la prova

7 giorni gratis, senza carta, API inclusa.

Vedi i prezzi

Domande frequenti

Generali
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.

Per ingegneri
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

Prova gratis